web-agent-bridge 3.4.0 → 3.9.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 (315) hide show
  1. package/LICENSE +84 -84
  2. package/README.ar.md +1565 -1304
  3. package/README.md +171 -298
  4. package/bin/agent-runner.js +474 -474
  5. package/bin/cli.js +237 -237
  6. package/bin/wab-init.js +244 -223
  7. package/bin/wab.js +80 -80
  8. package/examples/azure-dns-wab.js +83 -83
  9. package/examples/bidi-agent.js +119 -119
  10. package/examples/cloudflare-wab-dns.js +121 -121
  11. package/examples/cpanel-wab-dns.js +114 -114
  12. package/examples/cross-site-agent.js +91 -91
  13. package/examples/dns-discovery-agent.js +166 -166
  14. package/examples/gcp-dns-wab.js +76 -76
  15. package/examples/governance-agent.js +169 -169
  16. package/examples/mcp-agent.js +94 -94
  17. package/examples/next-app-router/README.md +44 -44
  18. package/examples/plesk-wab-dns.js +103 -103
  19. package/examples/puppeteer-agent.js +108 -108
  20. package/examples/route53-wab-dns.js +144 -144
  21. package/examples/saas-dashboard/README.md +55 -55
  22. package/examples/safe-mode-agent.js +96 -96
  23. package/examples/self-discovery.js +106 -0
  24. package/examples/shopify-hydrogen/README.md +74 -74
  25. package/examples/vision-agent.js +171 -171
  26. package/examples/wab-sign.js +74 -74
  27. package/examples/wab-verify.js +60 -60
  28. package/examples/wordpress-elementor/README.md +77 -77
  29. package/package.json +93 -93
  30. package/public/.well-known/agent-tools.json +180 -180
  31. package/public/.well-known/ai-assets.json +59 -59
  32. package/public/.well-known/security.txt +8 -8
  33. package/public/.well-known/wab.json +28 -28
  34. package/public/activate.html +448 -368
  35. package/public/adopt.html +236 -0
  36. package/public/adoption-metrics.html +188 -188
  37. package/public/agent-workspace.html +359 -349
  38. package/public/ai.html +198 -198
  39. package/public/api.html +397 -413
  40. package/public/atp.html +171 -0
  41. package/public/azure-dns-integration.html +289 -289
  42. package/public/browser.html +486 -486
  43. package/public/cloudflare-integration.html +380 -380
  44. package/public/commander-dashboard.html +243 -243
  45. package/public/cookies.html +210 -210
  46. package/public/cpanel-integration.html +398 -398
  47. package/public/css/agent-workspace.css +1713 -1713
  48. package/public/css/premium.css +317 -317
  49. package/public/css/styles.css +1401 -1263
  50. package/public/dashboard-shieldlink.html +295 -0
  51. package/public/dashboard.html +711 -707
  52. package/public/dns.html +436 -436
  53. package/public/docs.html +588 -588
  54. package/public/enterprise-mesh.ar.html +80 -0
  55. package/public/enterprise-mesh.html +81 -0
  56. package/public/feed.xml +89 -89
  57. package/public/gcp-dns-integration.html +318 -318
  58. package/public/governance.ar.html +70 -0
  59. package/public/governance.html +69 -0
  60. package/public/growth.html +465 -465
  61. package/public/index.html +1372 -1266
  62. package/public/integrations.html +556 -556
  63. package/public/js/activate.js +449 -145
  64. package/public/js/agent-workspace.js +1740 -1740
  65. package/public/js/auth-nav.js +117 -65
  66. package/public/js/auth-redirect.js +12 -12
  67. package/public/js/cookie-consent.js +56 -56
  68. package/public/js/dns.js +438 -438
  69. package/public/js/wab-demo-page.js +721 -721
  70. package/public/js/ws-client.js +74 -74
  71. package/public/l-preview.html +242 -0
  72. package/public/llms-full.txt +360 -360
  73. package/public/llms.txt +125 -125
  74. package/public/login.html +85 -85
  75. package/public/mesh-dashboard.html +328 -328
  76. package/public/milestones.html +346 -0
  77. package/public/one-click.html +779 -0
  78. package/public/openapi.json +669 -669
  79. package/public/partners.ar.html +145 -0
  80. package/public/partners.html +143 -0
  81. package/public/phone-shield.html +281 -281
  82. package/public/plesk-integration.html +375 -375
  83. package/public/premium-dashboard.html +2489 -2489
  84. package/public/premium.html +793 -793
  85. package/public/privacy.html +297 -297
  86. package/public/provider-onboarding.html +172 -172
  87. package/public/provider-sandbox.html +134 -134
  88. package/public/providers.html +359 -359
  89. package/public/refusals.html +172 -0
  90. package/public/register.html +105 -105
  91. package/public/registrar-integrations.html +141 -141
  92. package/public/ring4.html +292 -0
  93. package/public/robots.txt +99 -99
  94. package/public/route53-integration.html +531 -531
  95. package/public/score.html +263 -0
  96. package/public/script/wab-consent.d.ts +36 -36
  97. package/public/script/wab-consent.js +104 -104
  98. package/public/script/wab-schema.js +131 -131
  99. package/public/script/wab.d.ts +108 -108
  100. package/public/script/wab.min.js +580 -580
  101. package/public/security.txt +8 -8
  102. package/public/shieldlink.html +244 -0
  103. package/public/shieldqr.html +231 -231
  104. package/public/sitemap.xml +13 -1
  105. package/public/terms.html +256 -256
  106. package/public/trust-graph-api.ar.html +92 -0
  107. package/public/trust-graph-api.html +91 -0
  108. package/public/wab-features.html +560 -0
  109. package/public/wab-trust.html +200 -200
  110. package/public/wab-truth.html +375 -0
  111. package/public/wab-vs-protocols.html +210 -210
  112. package/public/whitepaper.html +449 -449
  113. package/script/ai-agent-bridge.js +1754 -1754
  114. package/sdk/README.md +99 -99
  115. package/sdk/agent-mesh.js +449 -449
  116. package/sdk/atp.js +103 -0
  117. package/sdk/auto-discovery.js +301 -288
  118. package/sdk/commander.js +262 -262
  119. package/sdk/governance.js +262 -262
  120. package/sdk/index.d.ts +464 -464
  121. package/sdk/index.js +653 -649
  122. package/sdk/multi-agent.js +318 -318
  123. package/sdk/safe-mode.js +221 -221
  124. package/sdk/safety-shield.js +219 -219
  125. package/sdk/schema-discovery.js +83 -83
  126. package/server/adapters/index.js +520 -520
  127. package/server/config/plans.js +412 -367
  128. package/server/config/secrets.js +102 -102
  129. package/server/control-plane/index.js +301 -301
  130. package/server/data-plane/index.js +354 -354
  131. package/server/index.js +793 -670
  132. package/server/llm/index.js +404 -404
  133. package/server/middleware/adminAuth.js +35 -35
  134. package/server/middleware/api-tier.js +170 -0
  135. package/server/middleware/auth.js +50 -50
  136. package/server/middleware/featureGate.js +88 -88
  137. package/server/middleware/rateLimits.js +100 -100
  138. package/server/middleware/sensitiveAction.js +157 -157
  139. package/server/middleware/wab-trust.js +141 -0
  140. package/server/migrations/001_add_analytics_indexes.sql +7 -7
  141. package/server/migrations/002_premium_features.sql +418 -418
  142. package/server/migrations/003_ads_integer_cents.sql +33 -33
  143. package/server/migrations/004_agent_os.sql +158 -158
  144. package/server/migrations/005_marketplace_metering.sql +126 -126
  145. package/server/migrations/006_growth_suite.sql +138 -0
  146. package/server/migrations/007_governance.sql +106 -106
  147. package/server/migrations/008_plans.sql +144 -144
  148. package/server/migrations/009_shieldqr.sql +30 -30
  149. package/server/migrations/010_extended_trust.sql +33 -33
  150. package/server/migrations/011_outreach.sql +47 -0
  151. package/server/migrations/012_shieldlink.sql +116 -0
  152. package/server/migrations/013_ct_monitor.sql +13 -0
  153. package/server/migrations/014_wab_advanced_features.sql +128 -0
  154. package/server/migrations/015_wab_truth_layer.sql +101 -0
  155. package/server/migrations/016_ring4_external_trust.sql +84 -0
  156. package/server/migrations/017_ring4_extensions.sql +69 -0
  157. package/server/migrations/018_commercial_foundations.sql +167 -0
  158. package/server/migrations/019_unify_tier_constraints.sql +133 -0
  159. package/server/migrations/020_agent_transaction_primitive.sql +119 -0
  160. package/server/models/adapters/index.js +33 -33
  161. package/server/models/adapters/mysql.js +183 -183
  162. package/server/models/adapters/postgresql.js +172 -172
  163. package/server/models/adapters/sqlite.js +7 -7
  164. package/server/models/db.js +740 -740
  165. package/server/observability/failure-analysis.js +337 -337
  166. package/server/observability/index.js +394 -394
  167. package/server/protocol/capabilities.js +223 -223
  168. package/server/protocol/index.js +243 -243
  169. package/server/protocol/schema.js +584 -584
  170. package/server/registry/certification.js +271 -271
  171. package/server/registry/index.js +326 -326
  172. package/server/routes/activate.js +478 -0
  173. package/server/routes/admin-outreach.js +239 -0
  174. package/server/routes/admin-plans.js +76 -76
  175. package/server/routes/admin-premium.js +674 -673
  176. package/server/routes/admin-shieldlink.js +137 -0
  177. package/server/routes/admin-shieldqr.js +90 -90
  178. package/server/routes/admin-trust-monitor.js +139 -83
  179. package/server/routes/admin.js +550 -549
  180. package/server/routes/adopt.js +61 -0
  181. package/server/routes/ads.js +130 -130
  182. package/server/routes/agent-workspace.js +540 -540
  183. package/server/routes/api-keys.js +127 -0
  184. package/server/routes/api.js +150 -150
  185. package/server/routes/auth.js +71 -71
  186. package/server/routes/billing.js +57 -57
  187. package/server/routes/commander.js +316 -316
  188. package/server/routes/customer-shieldlink.js +133 -0
  189. package/server/routes/demo-showcase.js +332 -332
  190. package/server/routes/demo-store.js +154 -154
  191. package/server/routes/diagnose.js +373 -0
  192. package/server/routes/discovery.js +2348 -2348
  193. package/server/routes/enterprise-mesh.js +170 -0
  194. package/server/routes/gateway.js +173 -173
  195. package/server/routes/governance-saas.js +203 -0
  196. package/server/routes/governance.js +208 -208
  197. package/server/routes/growth.js +1048 -0
  198. package/server/routes/intent.js +328 -0
  199. package/server/routes/license.js +251 -251
  200. package/server/routes/mesh.js +469 -469
  201. package/server/routes/noscript.js +543 -543
  202. package/server/routes/partners.js +201 -0
  203. package/server/routes/plans.js +33 -33
  204. package/server/routes/premium-v2.js +686 -686
  205. package/server/routes/premium.js +724 -724
  206. package/server/routes/providers.js +650 -650
  207. package/server/routes/reputation.js +411 -0
  208. package/server/routes/ring4.js +885 -0
  209. package/server/routes/runtime.js +2148 -2148
  210. package/server/routes/shieldlink.js +70 -0
  211. package/server/routes/shieldqr.js +88 -88
  212. package/server/routes/sovereign.js +465 -465
  213. package/server/routes/transactions.js +233 -0
  214. package/server/routes/truth-layer.js +670 -0
  215. package/server/routes/universal.js +200 -200
  216. package/server/routes/unsubscribe.js +51 -0
  217. package/server/routes/wab-api.js +850 -850
  218. package/server/routes/wab-cache.js +282 -0
  219. package/server/runtime/container-worker.js +111 -111
  220. package/server/runtime/container.js +448 -448
  221. package/server/runtime/distributed-worker.js +362 -362
  222. package/server/runtime/event-bus.js +210 -210
  223. package/server/runtime/index.js +253 -253
  224. package/server/runtime/queue.js +599 -599
  225. package/server/runtime/replay.js +666 -666
  226. package/server/runtime/sandbox.js +266 -266
  227. package/server/runtime/scheduler.js +534 -534
  228. package/server/runtime/session-engine.js +293 -293
  229. package/server/runtime/state-manager.js +188 -188
  230. package/server/secrets/wab-signing-key.pem +3 -0
  231. package/server/secrets/wab-signing-pub.pem +3 -0
  232. package/server/security/cross-site-redactor.js +196 -196
  233. package/server/security/dry-run.js +180 -180
  234. package/server/security/human-gate-rate-limit.js +147 -147
  235. package/server/security/human-gate-transports.js +178 -178
  236. package/server/security/human-gate.js +281 -281
  237. package/server/security/index.js +368 -368
  238. package/server/security/intent-engine.js +245 -245
  239. package/server/security/reward-guard.js +171 -171
  240. package/server/security/rollback-store.js +239 -239
  241. package/server/security/token-scope.js +404 -404
  242. package/server/security/url-policy.js +139 -139
  243. package/server/services/adoption-agent.js +182 -0
  244. package/server/services/agent-chat.js +506 -506
  245. package/server/services/agent-learning.js +601 -601
  246. package/server/services/agent-memory.js +625 -625
  247. package/server/services/agent-mesh.js +555 -555
  248. package/server/services/agent-symphony.js +717 -717
  249. package/server/services/agent-tasks.js +1807 -1807
  250. package/server/services/api-key-engine.js +292 -292
  251. package/server/services/cluster.js +894 -894
  252. package/server/services/commander.js +738 -738
  253. package/server/services/edge-compute.js +440 -440
  254. package/server/services/email.js +233 -233
  255. package/server/services/fairness-engine.js +409 -0
  256. package/server/services/fairness.js +420 -0
  257. package/server/services/governance.js +466 -466
  258. package/server/services/hosted-runtime.js +205 -205
  259. package/server/services/lfd.js +635 -635
  260. package/server/services/local-ai.js +389 -389
  261. package/server/services/marketplace.js +270 -270
  262. package/server/services/metering.js +182 -182
  263. package/server/services/modules/affiliate-intelligence.js +93 -93
  264. package/server/services/modules/agent-firewall.js +90 -90
  265. package/server/services/modules/bounty.js +89 -89
  266. package/server/services/modules/collective-bargaining.js +92 -92
  267. package/server/services/modules/dark-pattern.js +66 -66
  268. package/server/services/modules/gov-intelligence.js +45 -45
  269. package/server/services/modules/neural.js +55 -55
  270. package/server/services/modules/notary.js +49 -49
  271. package/server/services/modules/price-time-machine.js +86 -86
  272. package/server/services/modules/protocol.js +104 -104
  273. package/server/services/negotiation.js +439 -439
  274. package/server/services/outreach-agent.js +312 -0
  275. package/server/services/plans.js +214 -214
  276. package/server/services/plugins.js +771 -771
  277. package/server/services/price-intelligence.js +566 -566
  278. package/server/services/price-shield.js +1137 -1137
  279. package/server/services/provider-clients.js +740 -740
  280. package/server/services/reputation.js +465 -465
  281. package/server/services/search-engine.js +357 -357
  282. package/server/services/security.js +513 -513
  283. package/server/services/self-healing.js +843 -843
  284. package/server/services/shieldlink.js +492 -0
  285. package/server/services/shieldqr.js +322 -322
  286. package/server/services/sovereign-shield.js +542 -542
  287. package/server/services/ssl-ct-monitor.js +224 -0
  288. package/server/services/ssl-inspector.js +42 -42
  289. package/server/services/ssl-monitor.js +167 -167
  290. package/server/services/stripe.js +206 -205
  291. package/server/services/swarm.js +788 -788
  292. package/server/services/transactions.js +525 -0
  293. package/server/services/universal-scraper.js +662 -662
  294. package/server/services/verification.js +481 -481
  295. package/server/services/vision.js +1163 -1163
  296. package/server/services/wab-crypto.js +178 -178
  297. package/server/utils/cache.js +125 -125
  298. package/server/utils/migrate.js +81 -81
  299. package/server/utils/safe-fetch.js +228 -228
  300. package/server/utils/secureFields.js +50 -50
  301. package/server/ws.js +161 -161
  302. package/templates/artisan-marketplace.yaml +104 -104
  303. package/templates/book-price-scout.yaml +98 -98
  304. package/templates/electronics-price-tracker.yaml +108 -108
  305. package/templates/flight-deal-hunter.yaml +113 -113
  306. package/templates/freelancer-direct.yaml +116 -116
  307. package/templates/grocery-price-compare.yaml +93 -93
  308. package/templates/hotel-direct-booking.yaml +113 -113
  309. package/templates/local-services.yaml +98 -98
  310. package/templates/olive-oil-tunisia.yaml +88 -88
  311. package/templates/organic-farm-fresh.yaml +101 -101
  312. package/templates/restaurant-direct.yaml +97 -97
  313. package/templates/ring4/banking-sovereign.yaml +55 -0
  314. package/templates/ring4/ecommerce-sovereign.yaml +58 -0
  315. package/templates/ring4/healthcare-sovereign.yaml +60 -0
package/public/cpanel-integration.html CHANGED
@@ -1,398 +1,398 @@
1
- <!DOCTYPE html>
2
- <html lang="en">
3
- <head>
4
- <meta charset="UTF-8">
5
- <meta name="viewport" content="width=device-width,initial-scale=1">
6
- <title>WAB DNS — cPanel / WHM Integration</title>
7
- <link rel="stylesheet" href="/css/main.css">
8
- <style>
9
- body { font-family: system-ui, sans-serif; background: #0f172a; color: #e2e8f0; margin: 0; padding: 0; }
10
- .page { max-width: 880px; margin: 0 auto; padding: 40px 20px 80px; }
11
- h1 { font-size: 1.7rem; margin-bottom: 6px; }
12
- .sub { color: #94a3b8; margin-bottom: 32px; font-size: .97rem; }
13
- .card { background: #1e293b; border-radius: 10px; padding: 24px; margin-bottom: 24px; }
14
- h2 { font-size: 1.1rem; margin: 0 0 14px; }
15
- label { display: block; font-size: .85rem; color: #94a3b8; margin-bottom: 4px; margin-top: 14px; }
16
- label:first-child { margin-top: 0; }
17
- input[type=text], input[type=password], input[type=number] {
18
- width: 100%; box-sizing: border-box; background: #0f172a; border: 1px solid #334155;
19
- color: #e2e8f0; border-radius: 6px; padding: 9px 12px; font-size: .93rem;
20
- }
21
- input:focus { outline: 2px solid #6366f1; border-color: transparent; }
22
- .row { display: flex; gap: 12px; }
23
- .row > * { flex: 1; }
24
- .actions { display: flex; gap: 10px; margin-top: 20px; flex-wrap: wrap; }
25
- .btn { padding: 9px 20px; border-radius: 7px; border: none; cursor: pointer; font-size: .92rem; font-weight: 600; transition: opacity .15s; }
26
- .btn:hover { opacity: .85; }
27
- .btn:disabled { opacity: .45; cursor: not-allowed; }
28
- .btn-enable { background: #22c55e; color: #000; }
29
- .btn-disable { background: #ef4444; color: #fff; }
30
- .btn-verify { background: #6366f1; color: #fff; }
31
- .btn-secondary { background: #334155; color: #e2e8f0; }
32
- #statusBar { margin-top: 18px; min-height: 36px; padding: 10px 14px; border-radius: 7px; background: #0f172a; font-size: .88rem; color: #94a3b8; display: none; }
33
- #statusBar.ok { display: block; color: #4ade80; border: 1px solid #166534; }
34
- #statusBar.err { display: block; color: #f87171; border: 1px solid #7f1d1d; }
35
- #statusBar.info { display: block; color: #93c5fd; border: 1px solid #1e3a5f; }
36
- pre { background: #0f172a; border-radius: 7px; padding: 14px 16px; font-size: .82rem; color: #94a3b8; overflow-x: auto; white-space: pre-wrap; word-break: break-word; margin: 14px 0 0; }
37
- code { background: #0f172a; padding: 1px 5px; border-radius: 4px; font-size: .88em; }
38
- .tab-bar { display: flex; gap: 4px; margin-bottom: 14px; }
39
- .tab { padding: 5px 14px; border-radius: 6px; cursor: pointer; font-size: .84rem; background: #0f172a; color: #94a3b8; border: 1px solid #334155; }
40
- .tab.active { background: #6366f1; color: #fff; border-color: transparent; }
41
- .tab-panel { display: none; }
42
- .tab-panel.active { display: block; }
43
- .step { display: flex; gap: 14px; margin-bottom: 18px; }
44
- .step-num { flex-shrink: 0; width: 28px; height: 28px; border-radius: 50%; background: #334155; color: #e2e8f0; font-size: .82rem; font-weight: 700; display: flex; align-items: center; justify-content: center; }
45
- .step-body { flex: 1; padding-top: 3px; }
46
- .warning-box { background: #431407; border: 1px solid #9a3412; border-radius: 8px; padding: 12px 16px; font-size: .87rem; color: #fdba74; margin-bottom: 18px; }
47
- a { color: #818cf8; }
48
- </style>
49
- </head>
50
- <body>
51
- <div class="page">
52
- <h1>cPanel / WHM × WAB DNS Discovery</h1>
53
- <p class="sub">
54
- Enable or disable the WAB DNS Discovery TXT record for any cPanel-hosted domain.
55
- Works with cPanel's UAPI and WHM API — compatible with all major shared hosting providers.
56
- </p>
57
-
58
- <div class="warning-box">
59
- ⚠ <strong>Security note:</strong> Your cPanel username, password or API token, and server hostname are only used
60
- client-side to call cPanel's UAPI directly. They are <strong>never sent to WAB servers</strong>.
61
- Always use a dedicated cPanel API Token instead of your account password when possible.
62
- </div>
63
-
64
- <!-- ── STEP 1: credentials ── -->
65
- <div class="card">
66
- <h2>1. cPanel Credentials</h2>
67
- <div class="row">
68
- <div>
69
- <label>cPanel Host (FQDN or IP)</label>
70
- <input type="text" id="cpHost" placeholder="cpanel.example.com">
71
- </div>
72
- <div>
73
- <label>Port</label>
74
- <input type="number" id="cpPort" value="2083" min="1" max="65535" style="max-width:100px">
75
- </div>
76
- </div>
77
- <label>Username</label>
78
- <input type="text" id="cpUser" placeholder="myuser" autocomplete="off">
79
- <label>API Token <span style="color:#94a3b8;font-weight:400">(preferred)</span> or Password</label>
80
- <input type="password" id="cpToken" placeholder="Paste cPanel API token or password" autocomplete="off">
81
- <p style="margin:8px 0 0;font-size:.82rem;color:#64748b">
82
- Generate an API token: cPanel → <strong>Security → Manage API Tokens → Create</strong>.
83
- Make sure <code>Zone Editor</code> feature is enabled for the account.
84
- </p>
85
- </div>
86
-
87
- <!-- ── STEP 2: domain ── -->
88
- <div class="card">
89
- <h2>2. Domain</h2>
90
- <div class="row">
91
- <div>
92
- <label>Domain (must be in this cPanel account)</label>
93
- <input type="text" id="cpDomain" placeholder="example.com">
94
- </div>
95
- <div>
96
- <label>Endpoint URL <span style="color:#94a3b8;font-weight:400">(leave blank for auto)</span></label>
97
- <input type="text" id="cpEndpoint" placeholder="https://example.com/.well-known/wab.json">
98
- </div>
99
- </div>
100
- </div>
101
-
102
- <!-- ── STEP 3: actions ── -->
103
- <div class="card">
104
- <h2>3. Actions</h2>
105
- <div class="actions">
106
- <button class="btn btn-enable" id="btnEnable" onclick="cpAction('enable')">✓ Enable WAB Discovery</button>
107
- <button class="btn btn-disable" id="btnDisable" onclick="cpAction('disable')">✗ Disable WAB Discovery</button>
108
- <button class="btn btn-verify" id="btnVerify" onclick="cpVerify()">⟳ Verify Status</button>
109
- <button class="btn btn-secondary" onclick="window.open('/provider-sandbox','_blank')">Open Sandbox</button>
110
- </div>
111
- <div id="statusBar"></div>
112
- <pre id="jsonOut" style="display:none"></pre>
113
- </div>
114
-
115
- <!-- ── HOW IT WORKS ── -->
116
- <div class="card">
117
- <h2>How it works</h2>
118
- <div>
119
- <div class="step">
120
- <div class="step-num">1</div>
121
- <div class="step-body">Fetch the WAB <strong>record template</strong> for your domain to get the exact TXT value: <code>v=wab1; endpoint=https://…</code></div>
122
- </div>
123
- <div class="step">
124
- <div class="step-num">2</div>
125
- <div class="step-body">Call cPanel UAPI <code>ZoneEdit::fetch_zone_records</code> to list existing TXT records for <code>_wab</code>.</div>
126
- </div>
127
- <div class="step">
128
- <div class="step-num">3</div>
129
- <div class="step-body"><strong>Enable:</strong> if no <code>_wab</code> TXT exists → call <code>ZoneEdit::add_zone_record</code>; if it exists → call <code>ZoneEdit::edit_zone_record</code>.<br>
130
- <strong>Disable:</strong> call <code>ZoneEdit::remove_zone_record</code> to delete the line.</div>
131
- </div>
132
- <div class="step">
133
- <div class="step-num">4</div>
134
- <div class="step-body">Confirm with WAB's <code>/api/discovery/provider/status</code> — DNS propagation may take up to 60 s.</div>
135
- </div>
136
- </div>
137
- <p style="margin:14px 0 0;font-size:.84rem;color:#64748b">
138
- The cPanel UAPI calls are made from your browser directly to your server on port 2083 (HTTPS).
139
- Make sure your browser can reach the cPanel port (no firewall blocking).
140
- </p>
141
- </div>
142
-
143
- <!-- ── CODE SNIPPETS ── -->
144
- <div class="card">
145
- <h2>Code Snippets</h2>
146
- <div class="tab-bar">
147
- <div class="tab active" onclick="switchTab('nodejs')">Node.js</div>
148
- <div class="tab" onclick="switchTab('curl')">cURL</div>
149
- <div class="tab" onclick="switchTab('php')">PHP</div>
150
- </div>
151
-
152
- <div id="tab-nodejs" class="tab-panel active">
153
- <pre>// npm install node-fetch@2
154
- const fetch = require('node-fetch');
155
- const https = require('https');
156
- const agent = new https.Agent({ rejectUnauthorized: false }); // for self-signed cert hosts
157
-
158
- const HOST = 'cpanel.example.com';
159
- const PORT = 2083;
160
- const USER = 'myuser';
161
- const TOKEN = process.env.CPANEL_API_TOKEN; // or password
162
- const DOMAIN = 'example.com';
163
- const TXT_VAL = `v=wab1; endpoint=https://${DOMAIN}/.well-known/wab.json`;
164
-
165
- function cpHeaders() {
166
- // API Token auth (preferred)
167
- return { Authorization: `cpanel ${USER}:${TOKEN}` };
168
- // Password auth: use base64(user:password) with 'Basic '
169
- }
170
-
171
- function cpUrl(func, params = {}) {
172
- const qs = new URLSearchParams({ domain: DOMAIN, ...params }).toString();
173
- return `https://${HOST}:${PORT}/execute/ZoneEdit/${func}?${qs}`;
174
- }
175
-
176
- async function listWabRecords() {
177
- const r = await fetch(cpUrl('fetch_zone_records', { type: 'TXT', name: `_wab.${DOMAIN}.` }), { headers: cpHeaders(), agent });
178
- const j = await r.json();
179
- return j.data || [];
180
- }
181
-
182
- async function enableWAB() {
183
- const records = await listWabRecords();
184
- if (records.length) {
185
- const line = records[0].line;
186
- const r = await fetch(cpUrl('edit_zone_record', { line, type: 'TXT', name: `_wab.${DOMAIN}.`, txtdata: TXT_VAL, ttl: 3600 }), { headers: cpHeaders(), agent });
187
- console.log('Updated:', await r.json());
188
- } else {
189
- const r = await fetch(cpUrl('add_zone_record', { type: 'TXT', name: `_wab.${DOMAIN}.`, txtdata: TXT_VAL, ttl: 3600 }), { headers: cpHeaders(), agent });
190
- console.log('Created:', await r.json());
191
- }
192
- }
193
-
194
- async function disableWAB() {
195
- const records = await listWabRecords();
196
- if (!records.length) { console.log('Already disabled.'); return; }
197
- const r = await fetch(cpUrl('remove_zone_record', { line: records[0].line }), { headers: cpHeaders(), agent });
198
- console.log('Deleted:', await r.json());
199
- }
200
-
201
- enableWAB().catch(console.error);
202
- </pre>
203
- </div>
204
-
205
- <div id="tab-curl" class="tab-panel">
206
- <pre># cPanel API Token auth
207
- AUTH="cpanel myuser:MY_API_TOKEN"
208
-
209
- # List existing _wab TXT records
210
- curl -sk -H "Authorization: $AUTH" \
211
- "https://cpanel.example.com:2083/execute/ZoneEdit/fetch_zone_records?domain=example.com&type=TXT&name=_wab.example.com."
212
-
213
- # Add _wab TXT record (enable)
214
- curl -sk -H "Authorization: $AUTH" \
215
- "https://cpanel.example.com:2083/execute/ZoneEdit/add_zone_record?domain=example.com&type=TXT&name=_wab.example.com.&txtdata=v%3Dwab1%3B%20endpoint%3Dhttps%3A%2F%2Fexample.com%2F.well-known%2Fwab.json&ttl=3600"
216
-
217
- # Remove _wab TXT record by line number (disable)
218
- # Replace LINE_NUMBER with the value returned from fetch_zone_records
219
- curl -sk -H "Authorization: $AUTH" \
220
- "https://cpanel.example.com:2083/execute/ZoneEdit/remove_zone_record?domain=example.com&line=LINE_NUMBER"
221
- </pre>
222
- </div>
223
-
224
- <div id="tab-php" class="tab-panel">
225
- <pre>&lt;?php
226
- // cPanel UAPI via PHP — run on your hosting server or via SSH
227
- // Requires: allow_url_fopen=On or cURL
228
-
229
- define('CP_HOST', 'cpanel.example.com');
230
- define('CP_PORT', 2083);
231
- define('CP_USER', 'myuser');
232
- define('CP_TOKEN', getenv('CPANEL_API_TOKEN'));
233
- define('DOMAIN', 'example.com');
234
- define('TXT_VAL', 'v=wab1; endpoint=https://' . DOMAIN . '/.well-known/wab.json');
235
-
236
- function cp_request(string $func, array $params = []): array {
237
- $params['domain'] = DOMAIN;
238
- $url = 'https://' . CP_HOST . ':' . CP_PORT . '/execute/ZoneEdit/' . $func . '?' . http_build_query($params);
239
- $ctx = stream_context_create(['http' => [
240
- 'header' => 'Authorization: cpanel ' . CP_USER . ':' . CP_TOKEN,
241
- ], 'ssl' => ['verify_peer' => false]]);
242
- return json_decode(file_get_contents($url, false, $ctx), true);
243
- }
244
-
245
- function enable_wab(): void {
246
- $records = cp_request('fetch_zone_records', ['type' => 'TXT', 'name' => '_wab.' . DOMAIN . '.']);
247
- $payload = ['type' => 'TXT', 'name' => '_wab.' . DOMAIN . '.', 'txtdata' => TXT_VAL, 'ttl' => 3600];
248
- if (!empty($records['data'])) {
249
- $result = cp_request('edit_zone_record', array_merge($payload, ['line' => $records['data'][0]['line']]));
250
- echo 'Updated: ' . json_encode($result) . PHP_EOL;
251
- } else {
252
- $result = cp_request('add_zone_record', $payload);
253
- echo 'Created: ' . json_encode($result) . PHP_EOL;
254
- }
255
- }
256
-
257
- function disable_wab(): void {
258
- $records = cp_request('fetch_zone_records', ['type' => 'TXT', 'name' => '_wab.' . DOMAIN . '.']);
259
- if (empty($records['data'])) { echo 'Already disabled.' . PHP_EOL; return; }
260
- $result = cp_request('remove_zone_record', ['line' => $records['data'][0]['line']]);
261
- echo 'Deleted: ' . json_encode($result) . PHP_EOL;
262
- }
263
-
264
- enable_wab();
265
- </pre>
266
- </div>
267
- </div>
268
-
269
- <p style="text-align:center;margin-top:30px;font-size:.85rem;color:#475569">
270
- <a href="/provider-onboarding">← Back to Provider Onboarding</a> ·
271
- <a href="/cloudflare-integration">Cloudflare Integration</a> ·
272
- <a href="/provider-sandbox">Provider Sandbox</a> ·
273
- <a href="/dns">DNS Discovery</a>
274
- </p>
275
- </div>
276
-
277
- <script>
278
- function switchTab(name) {
279
- document.querySelectorAll('.tab').forEach(t => t.classList.remove('active'));
280
- document.querySelectorAll('.tab-panel').forEach(p => p.classList.remove('active'));
281
- document.querySelector(`#tab-${name}`).classList.add('active');
282
- event.target.classList.add('active');
283
- }
284
-
285
- function setStatus(msg, type) {
286
- const bar = document.getElementById('statusBar');
287
- bar.textContent = msg;
288
- bar.className = type;
289
- }
290
-
291
- function showJson(obj) {
292
- const pre = document.getElementById('jsonOut');
293
- pre.textContent = JSON.stringify(obj, null, 2);
294
- pre.style.display = 'block';
295
- }
296
-
297
- function getInputs() {
298
- const host = document.getElementById('cpHost').value.trim().replace(/^https?:\/\//, '').replace(/\/$/, '');
299
- const port = document.getElementById('cpPort').value.trim() || '2083';
300
- const user = document.getElementById('cpUser').value.trim();
301
- const token = document.getElementById('cpToken').value.trim();
302
- const domain = document.getElementById('cpDomain').value.trim().toLowerCase().replace(/^https?:\/\//, '').replace(/\/$/, '');
303
- const ep = document.getElementById('cpEndpoint').value.trim() || `https://${domain}/.well-known/wab.json`;
304
- return { host, port, user, token, domain, ep };
305
- }
306
-
307
- function cpBase({ host, port }) {
308
- return `https://${host}:${port}`;
309
- }
310
-
311
- function cpHeaders({ user, token }) {
312
- // cPanel API Token auth
313
- return { 'Authorization': `cpanel ${user}:${token}` };
314
- }
315
-
316
- async function cpUapi(base, headers, func, params) {
317
- const qs = new URLSearchParams(params).toString();
318
- const url = `${base}/execute/ZoneEdit/${func}?${qs}`;
319
- const r = await fetch(url, { headers, mode: 'cors' });
320
- if (!r.ok) throw new Error(`HTTP ${r.status} from cPanel`);
321
- return r.json();
322
- }
323
-
324
- async function cpAction(action) {
325
- const inp = getInputs();
326
- if (!inp.host) return setStatus('Please enter the cPanel hostname.', 'err');
327
- if (!inp.user) return setStatus('Please enter your cPanel username.', 'err');
328
- if (!inp.token) return setStatus('Please enter your cPanel API Token or password.', 'err');
329
- if (!inp.domain) return setStatus('Please enter the domain name.', 'err');
330
-
331
- document.getElementById('btnEnable').disabled = true;
332
- document.getElementById('btnDisable').disabled = true;
333
- setStatus('Fetching WAB record template…', 'info');
334
-
335
- try {
336
- const tplRes = await fetch(`/api/discovery/provider/record-template?domain=${encodeURIComponent(inp.domain)}&endpoint=${encodeURIComponent(inp.ep)}`);
337
- const tpl = await tplRes.json();
338
- const txtVal = tpl.record && tpl.record.value;
339
- if (!txtVal) throw new Error('Could not fetch WAB record template.');
340
-
341
- const base = cpBase(inp);
342
- const headers = cpHeaders(inp);
343
- const recName = `_wab.${inp.domain}.`;
344
-
345
- setStatus('Fetching existing _wab TXT records from cPanel…', 'info');
346
- const listJ = await cpUapi(base, headers, 'fetch_zone_records', { domain: inp.domain, type: 'TXT', name: recName });
347
- const existing = listJ.data && listJ.data[0];
348
-
349
- let resultJson;
350
- if (action === 'enable') {
351
- const payload = { domain: inp.domain, type: 'TXT', name: recName, txtdata: txtVal, ttl: 3600 };
352
- if (existing) {
353
- setStatus(`Updating existing record (line ${existing.line})…`, 'info');
354
- resultJson = await cpUapi(base, headers, 'edit_zone_record', { ...payload, line: existing.line });
355
- } else {
356
- setStatus('Creating new _wab TXT record…', 'info');
357
- resultJson = await cpUapi(base, headers, 'add_zone_record', payload);
358
- }
359
- if (resultJson.errors && resultJson.errors.length) throw new Error(resultJson.errors.join(', '));
360
- setStatus(`✓ _wab TXT record ${existing ? 'updated' : 'created'} for ${inp.domain}. WAB Discovery is ENABLED.`, 'ok');
361
- } else {
362
- if (!existing) {
363
- setStatus(`No _wab TXT record found for ${inp.domain} — already disabled.`, 'ok');
364
- showJson({ note: 'no record found', domain: inp.domain });
365
- return;
366
- }
367
- setStatus(`Deleting record (line ${existing.line})…`, 'info');
368
- resultJson = await cpUapi(base, headers, 'remove_zone_record', { domain: inp.domain, line: existing.line });
369
- if (resultJson.errors && resultJson.errors.length) throw new Error(resultJson.errors.join(', '));
370
- setStatus(`✓ _wab TXT record deleted for ${inp.domain}. WAB Discovery is DISABLED.`, 'ok');
371
- }
372
- showJson(resultJson);
373
- } catch (err) {
374
- setStatus(`Error: ${err.message}`, 'err');
375
- } finally {
376
- document.getElementById('btnEnable').disabled = false;
377
- document.getElementById('btnDisable').disabled = false;
378
- }
379
- }
380
-
381
- async function cpVerify() {
382
- const { domain } = getInputs();
383
- if (!domain) return setStatus('Please enter a domain name.', 'err');
384
- setStatus('Checking WAB status via DNS…', 'info');
385
- try {
386
- const r = await fetch(`/api/discovery/provider/status?domain=${encodeURIComponent(domain)}`);
387
- const j = await r.json();
388
- if (j.status === 'enabled') setStatus(`✓ ${domain} — WAB Discovery is ENABLED.`, 'ok');
389
- else if (j.status === 'partial') setStatus(`⚠ ${domain} — DNS found but endpoint has issues.`, 'info');
390
- else setStatus(`✗ ${domain} — WAB Discovery is DISABLED (no valid TXT record found).`, 'err');
391
- showJson(j);
392
- } catch (err) {
393
- setStatus(`Verify error: ${err.message}`, 'err');
394
- }
395
- }
396
- </script>
397
- </body>
398
- </html>
1
+ <!DOCTYPE html>
2
+ <html lang="en">
3
+ <head>
4
+ <meta charset="UTF-8">
5
+ <meta name="viewport" content="width=device-width,initial-scale=1">
6
+ <title>WAB DNS — cPanel / WHM Integration</title>
7
+ <link rel="stylesheet" href="/css/main.css">
8
+ <style>
9
+ body { font-family: system-ui, sans-serif; background: #0f172a; color: #e2e8f0; margin: 0; padding: 0; }
10
+ .page { max-width: 880px; margin: 0 auto; padding: 40px 20px 80px; }
11
+ h1 { font-size: 1.7rem; margin-bottom: 6px; }
12
+ .sub { color: #94a3b8; margin-bottom: 32px; font-size: .97rem; }
13
+ .card { background: #1e293b; border-radius: 10px; padding: 24px; margin-bottom: 24px; }
14
+ h2 { font-size: 1.1rem; margin: 0 0 14px; }
15
+ label { display: block; font-size: .85rem; color: #94a3b8; margin-bottom: 4px; margin-top: 14px; }
16
+ label:first-child { margin-top: 0; }
17
+ input[type=text], input[type=password], input[type=number] {
18
+ width: 100%; box-sizing: border-box; background: #0f172a; border: 1px solid #334155;
19
+ color: #e2e8f0; border-radius: 6px; padding: 9px 12px; font-size: .93rem;
20
+ }
21
+ input:focus { outline: 2px solid #6366f1; border-color: transparent; }
22
+ .row { display: flex; gap: 12px; }
23
+ .row > * { flex: 1; }
24
+ .actions { display: flex; gap: 10px; margin-top: 20px; flex-wrap: wrap; }
25
+ .btn { padding: 9px 20px; border-radius: 7px; border: none; cursor: pointer; font-size: .92rem; font-weight: 600; transition: opacity .15s; }
26
+ .btn:hover { opacity: .85; }
27
+ .btn:disabled { opacity: .45; cursor: not-allowed; }
28
+ .btn-enable { background: #22c55e; color: #000; }
29
+ .btn-disable { background: #ef4444; color: #fff; }
30
+ .btn-verify { background: #6366f1; color: #fff; }
31
+ .btn-secondary { background: #334155; color: #e2e8f0; }
32
+ #statusBar { margin-top: 18px; min-height: 36px; padding: 10px 14px; border-radius: 7px; background: #0f172a; font-size: .88rem; color: #94a3b8; display: none; }
33
+ #statusBar.ok { display: block; color: #4ade80; border: 1px solid #166534; }
34
+ #statusBar.err { display: block; color: #f87171; border: 1px solid #7f1d1d; }
35
+ #statusBar.info { display: block; color: #93c5fd; border: 1px solid #1e3a5f; }
36
+ pre { background: #0f172a; border-radius: 7px; padding: 14px 16px; font-size: .82rem; color: #94a3b8; overflow-x: auto; white-space: pre-wrap; word-break: break-word; margin: 14px 0 0; }
37
+ code { background: #0f172a; padding: 1px 5px; border-radius: 4px; font-size: .88em; }
38
+ .tab-bar { display: flex; gap: 4px; margin-bottom: 14px; }
39
+ .tab { padding: 5px 14px; border-radius: 6px; cursor: pointer; font-size: .84rem; background: #0f172a; color: #94a3b8; border: 1px solid #334155; }
40
+ .tab.active { background: #6366f1; color: #fff; border-color: transparent; }
41
+ .tab-panel { display: none; }
42
+ .tab-panel.active { display: block; }
43
+ .step { display: flex; gap: 14px; margin-bottom: 18px; }
44
+ .step-num { flex-shrink: 0; width: 28px; height: 28px; border-radius: 50%; background: #334155; color: #e2e8f0; font-size: .82rem; font-weight: 700; display: flex; align-items: center; justify-content: center; }
45
+ .step-body { flex: 1; padding-top: 3px; }
46
+ .warning-box { background: #431407; border: 1px solid #9a3412; border-radius: 8px; padding: 12px 16px; font-size: .87rem; color: #fdba74; margin-bottom: 18px; }
47
+ a { color: #818cf8; }
48
+ </style>
49
+ </head>
50
+ <body>
51
+ <div class="page">
52
+ <h1>cPanel / WHM × WAB DNS Discovery</h1>
53
+ <p class="sub">
54
+ Enable or disable the WAB DNS Discovery TXT record for any cPanel-hosted domain.
55
+ Works with cPanel's UAPI and WHM API — compatible with all major shared hosting providers.
56
+ </p>
57
+
58
+ <div class="warning-box">
59
+ ⚠ <strong>Security note:</strong> Your cPanel username, password or API token, and server hostname are only used
60
+ client-side to call cPanel's UAPI directly. They are <strong>never sent to WAB servers</strong>.
61
+ Always use a dedicated cPanel API Token instead of your account password when possible.
62
+ </div>
63
+
64
+ <!-- ── STEP 1: credentials ── -->
65
+ <div class="card">
66
+ <h2>1. cPanel Credentials</h2>
67
+ <div class="row">
68
+ <div>
69
+ <label>cPanel Host (FQDN or IP)</label>
70
+ <input type="text" id="cpHost" placeholder="cpanel.example.com">
71
+ </div>
72
+ <div>
73
+ <label>Port</label>
74
+ <input type="number" id="cpPort" value="2083" min="1" max="65535" style="max-width:100px">
75
+ </div>
76
+ </div>
77
+ <label>Username</label>
78
+ <input type="text" id="cpUser" placeholder="myuser" autocomplete="off">
79
+ <label>API Token <span style="color:#94a3b8;font-weight:400">(preferred)</span> or Password</label>
80
+ <input type="password" id="cpToken" placeholder="Paste cPanel API token or password" autocomplete="off">
81
+ <p style="margin:8px 0 0;font-size:.82rem;color:#64748b">
82
+ Generate an API token: cPanel → <strong>Security → Manage API Tokens → Create</strong>.
83
+ Make sure <code>Zone Editor</code> feature is enabled for the account.
84
+ </p>
85
+ </div>
86
+
87
+ <!-- ── STEP 2: domain ── -->
88
+ <div class="card">
89
+ <h2>2. Domain</h2>
90
+ <div class="row">
91
+ <div>
92
+ <label>Domain (must be in this cPanel account)</label>
93
+ <input type="text" id="cpDomain" placeholder="example.com">
94
+ </div>
95
+ <div>
96
+ <label>Endpoint URL <span style="color:#94a3b8;font-weight:400">(leave blank for auto)</span></label>
97
+ <input type="text" id="cpEndpoint" placeholder="https://example.com/.well-known/wab.json">
98
+ </div>
99
+ </div>
100
+ </div>
101
+
102
+ <!-- ── STEP 3: actions ── -->
103
+ <div class="card">
104
+ <h2>3. Actions</h2>
105
+ <div class="actions">
106
+ <button class="btn btn-enable" id="btnEnable" onclick="cpAction('enable')">✓ Enable WAB Discovery</button>
107
+ <button class="btn btn-disable" id="btnDisable" onclick="cpAction('disable')">✗ Disable WAB Discovery</button>
108
+ <button class="btn btn-verify" id="btnVerify" onclick="cpVerify()">⟳ Verify Status</button>
109
+ <button class="btn btn-secondary" onclick="window.open('/provider-sandbox','_blank')">Open Sandbox</button>
110
+ </div>
111
+ <div id="statusBar"></div>
112
+ <pre id="jsonOut" style="display:none"></pre>
113
+ </div>
114
+
115
+ <!-- ── HOW IT WORKS ── -->
116
+ <div class="card">
117
+ <h2>How it works</h2>
118
+ <div>
119
+ <div class="step">
120
+ <div class="step-num">1</div>
121
+ <div class="step-body">Fetch the WAB <strong>record template</strong> for your domain to get the exact TXT value: <code>v=wab1; endpoint=https://…</code></div>
122
+ </div>
123
+ <div class="step">
124
+ <div class="step-num">2</div>
125
+ <div class="step-body">Call cPanel UAPI <code>ZoneEdit::fetch_zone_records</code> to list existing TXT records for <code>_wab</code>.</div>
126
+ </div>
127
+ <div class="step">
128
+ <div class="step-num">3</div>
129
+ <div class="step-body"><strong>Enable:</strong> if no <code>_wab</code> TXT exists → call <code>ZoneEdit::add_zone_record</code>; if it exists → call <code>ZoneEdit::edit_zone_record</code>.<br>
130
+ <strong>Disable:</strong> call <code>ZoneEdit::remove_zone_record</code> to delete the line.</div>
131
+ </div>
132
+ <div class="step">
133
+ <div class="step-num">4</div>
134
+ <div class="step-body">Confirm with WAB's <code>/api/discovery/provider/status</code> — DNS propagation may take up to 60 s.</div>
135
+ </div>
136
+ </div>
137
+ <p style="margin:14px 0 0;font-size:.84rem;color:#64748b">
138
+ The cPanel UAPI calls are made from your browser directly to your server on port 2083 (HTTPS).
139
+ Make sure your browser can reach the cPanel port (no firewall blocking).
140
+ </p>
141
+ </div>
142
+
143
+ <!-- ── CODE SNIPPETS ── -->
144
+ <div class="card">
145
+ <h2>Code Snippets</h2>
146
+ <div class="tab-bar">
147
+ <div class="tab active" onclick="switchTab('nodejs')">Node.js</div>
148
+ <div class="tab" onclick="switchTab('curl')">cURL</div>
149
+ <div class="tab" onclick="switchTab('php')">PHP</div>
150
+ </div>
151
+
152
+ <div id="tab-nodejs" class="tab-panel active">
153
+ <pre>// npm install node-fetch@2
154
+ const fetch = require('node-fetch');
155
+ const https = require('https');
156
+ const agent = new https.Agent({ rejectUnauthorized: false }); // for self-signed cert hosts
157
+
158
+ const HOST = 'cpanel.example.com';
159
+ const PORT = 2083;
160
+ const USER = 'myuser';
161
+ const TOKEN = process.env.CPANEL_API_TOKEN; // or password
162
+ const DOMAIN = 'example.com';
163
+ const TXT_VAL = `v=wab1; endpoint=https://${DOMAIN}/.well-known/wab.json`;
164
+
165
+ function cpHeaders() {
166
+ // API Token auth (preferred)
167
+ return { Authorization: `cpanel ${USER}:${TOKEN}` };
168
+ // Password auth: use base64(user:password) with 'Basic '
169
+ }
170
+
171
+ function cpUrl(func, params = {}) {
172
+ const qs = new URLSearchParams({ domain: DOMAIN, ...params }).toString();
173
+ return `https://${HOST}:${PORT}/execute/ZoneEdit/${func}?${qs}`;
174
+ }
175
+
176
+ async function listWabRecords() {
177
+ const r = await fetch(cpUrl('fetch_zone_records', { type: 'TXT', name: `_wab.${DOMAIN}.` }), { headers: cpHeaders(), agent });
178
+ const j = await r.json();
179
+ return j.data || [];
180
+ }
181
+
182
+ async function enableWAB() {
183
+ const records = await listWabRecords();
184
+ if (records.length) {
185
+ const line = records[0].line;
186
+ const r = await fetch(cpUrl('edit_zone_record', { line, type: 'TXT', name: `_wab.${DOMAIN}.`, txtdata: TXT_VAL, ttl: 3600 }), { headers: cpHeaders(), agent });
187
+ console.log('Updated:', await r.json());
188
+ } else {
189
+ const r = await fetch(cpUrl('add_zone_record', { type: 'TXT', name: `_wab.${DOMAIN}.`, txtdata: TXT_VAL, ttl: 3600 }), { headers: cpHeaders(), agent });
190
+ console.log('Created:', await r.json());
191
+ }
192
+ }
193
+
194
+ async function disableWAB() {
195
+ const records = await listWabRecords();
196
+ if (!records.length) { console.log('Already disabled.'); return; }
197
+ const r = await fetch(cpUrl('remove_zone_record', { line: records[0].line }), { headers: cpHeaders(), agent });
198
+ console.log('Deleted:', await r.json());
199
+ }
200
+
201
+ enableWAB().catch(console.error);
202
+ </pre>
203
+ </div>
204
+
205
+ <div id="tab-curl" class="tab-panel">
206
+ <pre># cPanel API Token auth
207
+ AUTH="cpanel myuser:MY_API_TOKEN"
208
+
209
+ # List existing _wab TXT records
210
+ curl -sk -H "Authorization: $AUTH" \
211
+ "https://cpanel.example.com:2083/execute/ZoneEdit/fetch_zone_records?domain=example.com&type=TXT&name=_wab.example.com."
212
+
213
+ # Add _wab TXT record (enable)
214
+ curl -sk -H "Authorization: $AUTH" \
215
+ "https://cpanel.example.com:2083/execute/ZoneEdit/add_zone_record?domain=example.com&type=TXT&name=_wab.example.com.&txtdata=v%3Dwab1%3B%20endpoint%3Dhttps%3A%2F%2Fexample.com%2F.well-known%2Fwab.json&ttl=3600"
216
+
217
+ # Remove _wab TXT record by line number (disable)
218
+ # Replace LINE_NUMBER with the value returned from fetch_zone_records
219
+ curl -sk -H "Authorization: $AUTH" \
220
+ "https://cpanel.example.com:2083/execute/ZoneEdit/remove_zone_record?domain=example.com&line=LINE_NUMBER"
221
+ </pre>
222
+ </div>
223
+
224
+ <div id="tab-php" class="tab-panel">
225
+ <pre>&lt;?php
226
+ // cPanel UAPI via PHP — run on your hosting server or via SSH
227
+ // Requires: allow_url_fopen=On or cURL
228
+
229
+ define('CP_HOST', 'cpanel.example.com');
230
+ define('CP_PORT', 2083);
231
+ define('CP_USER', 'myuser');
232
+ define('CP_TOKEN', getenv('CPANEL_API_TOKEN'));
233
+ define('DOMAIN', 'example.com');
234
+ define('TXT_VAL', 'v=wab1; endpoint=https://' . DOMAIN . '/.well-known/wab.json');
235
+
236
+ function cp_request(string $func, array $params = []): array {
237
+ $params['domain'] = DOMAIN;
238
+ $url = 'https://' . CP_HOST . ':' . CP_PORT . '/execute/ZoneEdit/' . $func . '?' . http_build_query($params);
239
+ $ctx = stream_context_create(['http' => [
240
+ 'header' => 'Authorization: cpanel ' . CP_USER . ':' . CP_TOKEN,
241
+ ], 'ssl' => ['verify_peer' => false]]);
242
+ return json_decode(file_get_contents($url, false, $ctx), true);
243
+ }
244
+
245
+ function enable_wab(): void {
246
+ $records = cp_request('fetch_zone_records', ['type' => 'TXT', 'name' => '_wab.' . DOMAIN . '.']);
247
+ $payload = ['type' => 'TXT', 'name' => '_wab.' . DOMAIN . '.', 'txtdata' => TXT_VAL, 'ttl' => 3600];
248
+ if (!empty($records['data'])) {
249
+ $result = cp_request('edit_zone_record', array_merge($payload, ['line' => $records['data'][0]['line']]));
250
+ echo 'Updated: ' . json_encode($result) . PHP_EOL;
251
+ } else {
252
+ $result = cp_request('add_zone_record', $payload);
253
+ echo 'Created: ' . json_encode($result) . PHP_EOL;
254
+ }
255
+ }
256
+
257
+ function disable_wab(): void {
258
+ $records = cp_request('fetch_zone_records', ['type' => 'TXT', 'name' => '_wab.' . DOMAIN . '.']);
259
+ if (empty($records['data'])) { echo 'Already disabled.' . PHP_EOL; return; }
260
+ $result = cp_request('remove_zone_record', ['line' => $records['data'][0]['line']]);
261
+ echo 'Deleted: ' . json_encode($result) . PHP_EOL;
262
+ }
263
+
264
+ enable_wab();
265
+ </pre>
266
+ </div>
267
+ </div>
268
+
269
+ <p style="text-align:center;margin-top:30px;font-size:.85rem;color:#475569">
270
+ <a href="/provider-onboarding">← Back to Provider Onboarding</a> ·
271
+ <a href="/cloudflare-integration">Cloudflare Integration</a> ·
272
+ <a href="/provider-sandbox">Provider Sandbox</a> ·
273
+ <a href="/dns">DNS Discovery</a>
274
+ </p>
275
+ </div>
276
+
277
+ <script>
278
+ function switchTab(name) {
279
+ document.querySelectorAll('.tab').forEach(t => t.classList.remove('active'));
280
+ document.querySelectorAll('.tab-panel').forEach(p => p.classList.remove('active'));
281
+ document.querySelector(`#tab-${name}`).classList.add('active');
282
+ event.target.classList.add('active');
283
+ }
284
+
285
+ function setStatus(msg, type) {
286
+ const bar = document.getElementById('statusBar');
287
+ bar.textContent = msg;
288
+ bar.className = type;
289
+ }
290
+
291
+ function showJson(obj) {
292
+ const pre = document.getElementById('jsonOut');
293
+ pre.textContent = JSON.stringify(obj, null, 2);
294
+ pre.style.display = 'block';
295
+ }
296
+
297
+ function getInputs() {
298
+ const host = document.getElementById('cpHost').value.trim().replace(/^https?:\/\//, '').replace(/\/$/, '');
299
+ const port = document.getElementById('cpPort').value.trim() || '2083';
300
+ const user = document.getElementById('cpUser').value.trim();
301
+ const token = document.getElementById('cpToken').value.trim();
302
+ const domain = document.getElementById('cpDomain').value.trim().toLowerCase().replace(/^https?:\/\//, '').replace(/\/$/, '');
303
+ const ep = document.getElementById('cpEndpoint').value.trim() || `https://${domain}/.well-known/wab.json`;
304
+ return { host, port, user, token, domain, ep };
305
+ }
306
+
307
+ function cpBase({ host, port }) {
308
+ return `https://${host}:${port}`;
309
+ }
310
+
311
+ function cpHeaders({ user, token }) {
312
+ // cPanel API Token auth
313
+ return { 'Authorization': `cpanel ${user}:${token}` };
314
+ }
315
+
316
+ async function cpUapi(base, headers, func, params) {
317
+ const qs = new URLSearchParams(params).toString();
318
+ const url = `${base}/execute/ZoneEdit/${func}?${qs}`;
319
+ const r = await fetch(url, { headers, mode: 'cors' });
320
+ if (!r.ok) throw new Error(`HTTP ${r.status} from cPanel`);
321
+ return r.json();
322
+ }
323
+
324
+ async function cpAction(action) {
325
+ const inp = getInputs();
326
+ if (!inp.host) return setStatus('Please enter the cPanel hostname.', 'err');
327
+ if (!inp.user) return setStatus('Please enter your cPanel username.', 'err');
328
+ if (!inp.token) return setStatus('Please enter your cPanel API Token or password.', 'err');
329
+ if (!inp.domain) return setStatus('Please enter the domain name.', 'err');
330
+
331
+ document.getElementById('btnEnable').disabled = true;
332
+ document.getElementById('btnDisable').disabled = true;
333
+ setStatus('Fetching WAB record template…', 'info');
334
+
335
+ try {
336
+ const tplRes = await fetch(`/api/discovery/provider/record-template?domain=${encodeURIComponent(inp.domain)}&endpoint=${encodeURIComponent(inp.ep)}`);
337
+ const tpl = await tplRes.json();
338
+ const txtVal = tpl.record && tpl.record.value;
339
+ if (!txtVal) throw new Error('Could not fetch WAB record template.');
340
+
341
+ const base = cpBase(inp);
342
+ const headers = cpHeaders(inp);
343
+ const recName = `_wab.${inp.domain}.`;
344
+
345
+ setStatus('Fetching existing _wab TXT records from cPanel…', 'info');
346
+ const listJ = await cpUapi(base, headers, 'fetch_zone_records', { domain: inp.domain, type: 'TXT', name: recName });
347
+ const existing = listJ.data && listJ.data[0];
348
+
349
+ let resultJson;
350
+ if (action === 'enable') {
351
+ const payload = { domain: inp.domain, type: 'TXT', name: recName, txtdata: txtVal, ttl: 3600 };
352
+ if (existing) {
353
+ setStatus(`Updating existing record (line ${existing.line})…`, 'info');
354
+ resultJson = await cpUapi(base, headers, 'edit_zone_record', { ...payload, line: existing.line });
355
+ } else {
356
+ setStatus('Creating new _wab TXT record…', 'info');
357
+ resultJson = await cpUapi(base, headers, 'add_zone_record', payload);
358
+ }
359
+ if (resultJson.errors && resultJson.errors.length) throw new Error(resultJson.errors.join(', '));
360
+ setStatus(`✓ _wab TXT record ${existing ? 'updated' : 'created'} for ${inp.domain}. WAB Discovery is ENABLED.`, 'ok');
361
+ } else {
362
+ if (!existing) {
363
+ setStatus(`No _wab TXT record found for ${inp.domain} — already disabled.`, 'ok');
364
+ showJson({ note: 'no record found', domain: inp.domain });
365
+ return;
366
+ }
367
+ setStatus(`Deleting record (line ${existing.line})…`, 'info');
368
+ resultJson = await cpUapi(base, headers, 'remove_zone_record', { domain: inp.domain, line: existing.line });
369
+ if (resultJson.errors && resultJson.errors.length) throw new Error(resultJson.errors.join(', '));
370
+ setStatus(`✓ _wab TXT record deleted for ${inp.domain}. WAB Discovery is DISABLED.`, 'ok');
371
+ }
372
+ showJson(resultJson);
373
+ } catch (err) {
374
+ setStatus(`Error: ${err.message}`, 'err');
375
+ } finally {
376
+ document.getElementById('btnEnable').disabled = false;
377
+ document.getElementById('btnDisable').disabled = false;
378
+ }
379
+ }
380
+
381
+ async function cpVerify() {
382
+ const { domain } = getInputs();
383
+ if (!domain) return setStatus('Please enter a domain name.', 'err');
384
+ setStatus('Checking WAB status via DNS…', 'info');
385
+ try {
386
+ const r = await fetch(`/api/discovery/provider/status?domain=${encodeURIComponent(domain)}`);
387
+ const j = await r.json();
388
+ if (j.status === 'enabled') setStatus(`✓ ${domain} — WAB Discovery is ENABLED.`, 'ok');
389
+ else if (j.status === 'partial') setStatus(`⚠ ${domain} — DNS found but endpoint has issues.`, 'info');
390
+ else setStatus(`✗ ${domain} — WAB Discovery is DISABLED (no valid TXT record found).`, 'err');
391
+ showJson(j);
392
+ } catch (err) {
393
+ setStatus(`Verify error: ${err.message}`, 'err');
394
+ }
395
+ }
396
+ </script>
397
+ </body>
398
+ </html>