web-agent-bridge 3.4.0 → 3.8.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 (310) hide show
  1. package/LICENSE +84 -84
  2. package/README.ar.md +1563 -1304
  3. package/README.md +137 -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/azure-dns-integration.html +289 -289
  41. package/public/browser.html +486 -486
  42. package/public/cloudflare-integration.html +380 -380
  43. package/public/commander-dashboard.html +243 -243
  44. package/public/cookies.html +210 -210
  45. package/public/cpanel-integration.html +398 -398
  46. package/public/css/agent-workspace.css +1713 -1713
  47. package/public/css/premium.css +317 -317
  48. package/public/css/styles.css +1401 -1263
  49. package/public/dashboard-shieldlink.html +295 -0
  50. package/public/dashboard.html +711 -707
  51. package/public/dns.html +436 -436
  52. package/public/docs.html +588 -588
  53. package/public/enterprise-mesh.ar.html +80 -0
  54. package/public/enterprise-mesh.html +81 -0
  55. package/public/feed.xml +89 -89
  56. package/public/gcp-dns-integration.html +318 -318
  57. package/public/governance.ar.html +70 -0
  58. package/public/governance.html +69 -0
  59. package/public/growth.html +465 -465
  60. package/public/index.html +1372 -1266
  61. package/public/integrations.html +556 -556
  62. package/public/js/activate.js +449 -145
  63. package/public/js/agent-workspace.js +1740 -1740
  64. package/public/js/auth-nav.js +117 -65
  65. package/public/js/auth-redirect.js +12 -12
  66. package/public/js/cookie-consent.js +56 -56
  67. package/public/js/dns.js +438 -438
  68. package/public/js/wab-demo-page.js +721 -721
  69. package/public/js/ws-client.js +74 -74
  70. package/public/l-preview.html +242 -0
  71. package/public/llms-full.txt +360 -360
  72. package/public/llms.txt +125 -125
  73. package/public/login.html +85 -85
  74. package/public/mesh-dashboard.html +328 -328
  75. package/public/milestones.html +346 -0
  76. package/public/one-click.html +779 -0
  77. package/public/openapi.json +669 -669
  78. package/public/partners.ar.html +145 -0
  79. package/public/partners.html +143 -0
  80. package/public/phone-shield.html +281 -281
  81. package/public/plesk-integration.html +375 -375
  82. package/public/premium-dashboard.html +2489 -2489
  83. package/public/premium.html +793 -793
  84. package/public/privacy.html +297 -297
  85. package/public/provider-onboarding.html +172 -172
  86. package/public/provider-sandbox.html +134 -134
  87. package/public/providers.html +359 -359
  88. package/public/refusals.html +172 -0
  89. package/public/register.html +105 -105
  90. package/public/registrar-integrations.html +141 -141
  91. package/public/ring4.html +292 -0
  92. package/public/robots.txt +99 -99
  93. package/public/route53-integration.html +531 -531
  94. package/public/score.html +263 -0
  95. package/public/script/wab-consent.d.ts +36 -36
  96. package/public/script/wab-consent.js +104 -104
  97. package/public/script/wab-schema.js +131 -131
  98. package/public/script/wab.d.ts +108 -108
  99. package/public/script/wab.min.js +580 -580
  100. package/public/security.txt +8 -8
  101. package/public/shieldlink.html +244 -0
  102. package/public/shieldqr.html +231 -231
  103. package/public/sitemap.xml +13 -1
  104. package/public/terms.html +256 -256
  105. package/public/trust-graph-api.ar.html +92 -0
  106. package/public/trust-graph-api.html +91 -0
  107. package/public/wab-features.html +560 -0
  108. package/public/wab-trust.html +200 -200
  109. package/public/wab-truth.html +375 -0
  110. package/public/wab-vs-protocols.html +210 -210
  111. package/public/whitepaper.html +449 -449
  112. package/script/ai-agent-bridge.js +1754 -1754
  113. package/sdk/README.md +99 -99
  114. package/sdk/agent-mesh.js +449 -449
  115. package/sdk/auto-discovery.js +301 -288
  116. package/sdk/commander.js +262 -262
  117. package/sdk/governance.js +262 -262
  118. package/sdk/index.d.ts +464 -464
  119. package/sdk/index.js +649 -649
  120. package/sdk/multi-agent.js +318 -318
  121. package/sdk/safe-mode.js +221 -221
  122. package/sdk/safety-shield.js +219 -219
  123. package/sdk/schema-discovery.js +83 -83
  124. package/server/adapters/index.js +520 -520
  125. package/server/config/plans.js +412 -367
  126. package/server/config/secrets.js +102 -102
  127. package/server/control-plane/index.js +301 -301
  128. package/server/data-plane/index.js +354 -354
  129. package/server/index.js +790 -670
  130. package/server/llm/index.js +404 -404
  131. package/server/middleware/adminAuth.js +35 -35
  132. package/server/middleware/api-tier.js +170 -0
  133. package/server/middleware/auth.js +50 -50
  134. package/server/middleware/featureGate.js +88 -88
  135. package/server/middleware/rateLimits.js +100 -100
  136. package/server/middleware/sensitiveAction.js +157 -157
  137. package/server/middleware/wab-trust.js +141 -0
  138. package/server/migrations/001_add_analytics_indexes.sql +7 -7
  139. package/server/migrations/002_premium_features.sql +418 -418
  140. package/server/migrations/003_ads_integer_cents.sql +33 -33
  141. package/server/migrations/004_agent_os.sql +158 -158
  142. package/server/migrations/005_marketplace_metering.sql +126 -126
  143. package/server/migrations/006_growth_suite.sql +138 -0
  144. package/server/migrations/007_governance.sql +106 -106
  145. package/server/migrations/008_plans.sql +144 -144
  146. package/server/migrations/009_shieldqr.sql +30 -30
  147. package/server/migrations/010_extended_trust.sql +33 -33
  148. package/server/migrations/011_outreach.sql +47 -0
  149. package/server/migrations/012_shieldlink.sql +116 -0
  150. package/server/migrations/013_ct_monitor.sql +13 -0
  151. package/server/migrations/014_wab_advanced_features.sql +128 -0
  152. package/server/migrations/015_wab_truth_layer.sql +101 -0
  153. package/server/migrations/016_ring4_external_trust.sql +84 -0
  154. package/server/migrations/017_ring4_extensions.sql +69 -0
  155. package/server/migrations/018_commercial_foundations.sql +167 -0
  156. package/server/migrations/019_unify_tier_constraints.sql +133 -0
  157. package/server/models/adapters/index.js +33 -33
  158. package/server/models/adapters/mysql.js +183 -183
  159. package/server/models/adapters/postgresql.js +172 -172
  160. package/server/models/adapters/sqlite.js +7 -7
  161. package/server/models/db.js +740 -740
  162. package/server/observability/failure-analysis.js +337 -337
  163. package/server/observability/index.js +394 -394
  164. package/server/protocol/capabilities.js +223 -223
  165. package/server/protocol/index.js +243 -243
  166. package/server/protocol/schema.js +584 -584
  167. package/server/registry/certification.js +271 -271
  168. package/server/registry/index.js +326 -326
  169. package/server/routes/activate.js +478 -0
  170. package/server/routes/admin-outreach.js +239 -0
  171. package/server/routes/admin-plans.js +76 -76
  172. package/server/routes/admin-premium.js +674 -673
  173. package/server/routes/admin-shieldlink.js +137 -0
  174. package/server/routes/admin-shieldqr.js +90 -90
  175. package/server/routes/admin-trust-monitor.js +139 -83
  176. package/server/routes/admin.js +550 -549
  177. package/server/routes/adopt.js +61 -0
  178. package/server/routes/ads.js +130 -130
  179. package/server/routes/agent-workspace.js +540 -540
  180. package/server/routes/api-keys.js +127 -0
  181. package/server/routes/api.js +150 -150
  182. package/server/routes/auth.js +71 -71
  183. package/server/routes/billing.js +57 -57
  184. package/server/routes/commander.js +316 -316
  185. package/server/routes/customer-shieldlink.js +133 -0
  186. package/server/routes/demo-showcase.js +332 -332
  187. package/server/routes/demo-store.js +154 -154
  188. package/server/routes/diagnose.js +373 -0
  189. package/server/routes/discovery.js +2348 -2348
  190. package/server/routes/enterprise-mesh.js +170 -0
  191. package/server/routes/gateway.js +173 -173
  192. package/server/routes/governance-saas.js +203 -0
  193. package/server/routes/governance.js +208 -208
  194. package/server/routes/growth.js +1048 -0
  195. package/server/routes/intent.js +328 -0
  196. package/server/routes/license.js +251 -251
  197. package/server/routes/mesh.js +469 -469
  198. package/server/routes/noscript.js +543 -543
  199. package/server/routes/partners.js +201 -0
  200. package/server/routes/plans.js +33 -33
  201. package/server/routes/premium-v2.js +686 -686
  202. package/server/routes/premium.js +724 -724
  203. package/server/routes/providers.js +650 -650
  204. package/server/routes/reputation.js +411 -0
  205. package/server/routes/ring4.js +885 -0
  206. package/server/routes/runtime.js +2148 -2148
  207. package/server/routes/shieldlink.js +70 -0
  208. package/server/routes/shieldqr.js +88 -88
  209. package/server/routes/sovereign.js +465 -465
  210. package/server/routes/truth-layer.js +670 -0
  211. package/server/routes/universal.js +200 -200
  212. package/server/routes/unsubscribe.js +51 -0
  213. package/server/routes/wab-api.js +850 -850
  214. package/server/routes/wab-cache.js +282 -0
  215. package/server/runtime/container-worker.js +111 -111
  216. package/server/runtime/container.js +448 -448
  217. package/server/runtime/distributed-worker.js +362 -362
  218. package/server/runtime/event-bus.js +210 -210
  219. package/server/runtime/index.js +253 -253
  220. package/server/runtime/queue.js +599 -599
  221. package/server/runtime/replay.js +666 -666
  222. package/server/runtime/sandbox.js +266 -266
  223. package/server/runtime/scheduler.js +534 -534
  224. package/server/runtime/session-engine.js +293 -293
  225. package/server/runtime/state-manager.js +188 -188
  226. package/server/secrets/wab-signing-key.pem +3 -0
  227. package/server/secrets/wab-signing-pub.pem +3 -0
  228. package/server/security/cross-site-redactor.js +196 -196
  229. package/server/security/dry-run.js +180 -180
  230. package/server/security/human-gate-rate-limit.js +147 -147
  231. package/server/security/human-gate-transports.js +178 -178
  232. package/server/security/human-gate.js +281 -281
  233. package/server/security/index.js +368 -368
  234. package/server/security/intent-engine.js +245 -245
  235. package/server/security/reward-guard.js +171 -171
  236. package/server/security/rollback-store.js +239 -239
  237. package/server/security/token-scope.js +404 -404
  238. package/server/security/url-policy.js +139 -139
  239. package/server/services/adoption-agent.js +182 -0
  240. package/server/services/agent-chat.js +506 -506
  241. package/server/services/agent-learning.js +601 -601
  242. package/server/services/agent-memory.js +625 -625
  243. package/server/services/agent-mesh.js +555 -555
  244. package/server/services/agent-symphony.js +717 -717
  245. package/server/services/agent-tasks.js +1807 -1807
  246. package/server/services/api-key-engine.js +292 -292
  247. package/server/services/cluster.js +894 -894
  248. package/server/services/commander.js +738 -738
  249. package/server/services/edge-compute.js +440 -440
  250. package/server/services/email.js +233 -233
  251. package/server/services/fairness-engine.js +409 -0
  252. package/server/services/fairness.js +420 -0
  253. package/server/services/governance.js +466 -466
  254. package/server/services/hosted-runtime.js +205 -205
  255. package/server/services/lfd.js +635 -635
  256. package/server/services/local-ai.js +389 -389
  257. package/server/services/marketplace.js +270 -270
  258. package/server/services/metering.js +182 -182
  259. package/server/services/modules/affiliate-intelligence.js +93 -93
  260. package/server/services/modules/agent-firewall.js +90 -90
  261. package/server/services/modules/bounty.js +89 -89
  262. package/server/services/modules/collective-bargaining.js +92 -92
  263. package/server/services/modules/dark-pattern.js +66 -66
  264. package/server/services/modules/gov-intelligence.js +45 -45
  265. package/server/services/modules/neural.js +55 -55
  266. package/server/services/modules/notary.js +49 -49
  267. package/server/services/modules/price-time-machine.js +86 -86
  268. package/server/services/modules/protocol.js +104 -104
  269. package/server/services/negotiation.js +439 -439
  270. package/server/services/outreach-agent.js +312 -0
  271. package/server/services/plans.js +214 -214
  272. package/server/services/plugins.js +771 -771
  273. package/server/services/price-intelligence.js +566 -566
  274. package/server/services/price-shield.js +1137 -1137
  275. package/server/services/provider-clients.js +740 -740
  276. package/server/services/reputation.js +465 -465
  277. package/server/services/search-engine.js +357 -357
  278. package/server/services/security.js +513 -513
  279. package/server/services/self-healing.js +843 -843
  280. package/server/services/shieldlink.js +492 -0
  281. package/server/services/shieldqr.js +322 -322
  282. package/server/services/sovereign-shield.js +542 -542
  283. package/server/services/ssl-ct-monitor.js +224 -0
  284. package/server/services/ssl-inspector.js +42 -42
  285. package/server/services/ssl-monitor.js +167 -167
  286. package/server/services/stripe.js +206 -205
  287. package/server/services/swarm.js +788 -788
  288. package/server/services/universal-scraper.js +662 -662
  289. package/server/services/verification.js +481 -481
  290. package/server/services/vision.js +1163 -1163
  291. package/server/services/wab-crypto.js +178 -178
  292. package/server/utils/cache.js +125 -125
  293. package/server/utils/migrate.js +81 -81
  294. package/server/utils/safe-fetch.js +228 -228
  295. package/server/utils/secureFields.js +50 -50
  296. package/server/ws.js +161 -161
  297. package/templates/artisan-marketplace.yaml +104 -104
  298. package/templates/book-price-scout.yaml +98 -98
  299. package/templates/electronics-price-tracker.yaml +108 -108
  300. package/templates/flight-deal-hunter.yaml +113 -113
  301. package/templates/freelancer-direct.yaml +116 -116
  302. package/templates/grocery-price-compare.yaml +93 -93
  303. package/templates/hotel-direct-booking.yaml +113 -113
  304. package/templates/local-services.yaml +98 -98
  305. package/templates/olive-oil-tunisia.yaml +88 -88
  306. package/templates/organic-farm-fresh.yaml +101 -101
  307. package/templates/restaurant-direct.yaml +97 -97
  308. package/templates/ring4/banking-sovereign.yaml +55 -0
  309. package/templates/ring4/ecommerce-sovereign.yaml +58 -0
  310. 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>