web-agent-bridge 3.2.0 → 3.4.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 (256) hide show
  1. package/LICENSE +84 -72
  2. package/README.ar.md +1304 -1152
  3. package/README.md +298 -1635
  4. package/bin/agent-runner.js +474 -474
  5. package/bin/cli.js +237 -138
  6. package/bin/wab-init.js +223 -0
  7. package/bin/wab.js +80 -80
  8. package/examples/azure-dns-wab.js +83 -0
  9. package/examples/bidi-agent.js +119 -119
  10. package/examples/cloudflare-wab-dns.js +121 -0
  11. package/examples/cpanel-wab-dns.js +114 -0
  12. package/examples/cross-site-agent.js +91 -91
  13. package/examples/dns-discovery-agent.js +166 -0
  14. package/examples/gcp-dns-wab.js +76 -0
  15. package/examples/governance-agent.js +169 -0
  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 -0
  19. package/examples/puppeteer-agent.js +108 -108
  20. package/examples/route53-wab-dns.js +144 -0
  21. package/examples/saas-dashboard/README.md +55 -55
  22. package/examples/safe-mode-agent.js +96 -0
  23. package/examples/shopify-hydrogen/README.md +74 -74
  24. package/examples/vision-agent.js +171 -171
  25. package/examples/wab-sign.js +74 -0
  26. package/examples/wab-verify.js +60 -0
  27. package/examples/wordpress-elementor/README.md +77 -77
  28. package/package.json +19 -6
  29. package/public/.well-known/agent-tools.json +180 -180
  30. package/public/.well-known/ai-assets.json +59 -59
  31. package/public/.well-known/security.txt +8 -0
  32. package/public/.well-known/wab.json +28 -0
  33. package/public/activate.html +368 -0
  34. package/public/adoption-metrics.html +188 -0
  35. package/public/agent-workspace.html +349 -349
  36. package/public/ai.html +198 -198
  37. package/public/api.html +413 -412
  38. package/public/azure-dns-integration.html +289 -0
  39. package/public/browser.html +486 -486
  40. package/public/cloudflare-integration.html +380 -0
  41. package/public/commander-dashboard.html +243 -243
  42. package/public/cookies.html +210 -210
  43. package/public/cpanel-integration.html +398 -0
  44. package/public/css/agent-workspace.css +1713 -1713
  45. package/public/css/premium.css +317 -317
  46. package/public/css/styles.css +1263 -1235
  47. package/public/dashboard.html +707 -706
  48. package/public/dns.html +436 -0
  49. package/public/docs.html +588 -587
  50. package/public/feed.xml +89 -89
  51. package/public/gcp-dns-integration.html +318 -0
  52. package/public/growth.html +465 -463
  53. package/public/index.html +1266 -982
  54. package/public/integrations.html +556 -0
  55. package/public/js/activate.js +145 -0
  56. package/public/js/agent-workspace.js +1740 -1740
  57. package/public/js/auth-nav.js +65 -31
  58. package/public/js/auth-redirect.js +12 -12
  59. package/public/js/cookie-consent.js +56 -56
  60. package/public/js/dns.js +438 -0
  61. package/public/js/wab-demo-page.js +721 -721
  62. package/public/js/ws-client.js +74 -74
  63. package/public/llms-full.txt +360 -360
  64. package/public/llms.txt +125 -125
  65. package/public/login.html +85 -85
  66. package/public/mesh-dashboard.html +328 -328
  67. package/public/openapi.json +669 -580
  68. package/public/phone-shield.html +281 -0
  69. package/public/plesk-integration.html +375 -0
  70. package/public/premium-dashboard.html +2489 -2489
  71. package/public/premium.html +793 -793
  72. package/public/privacy.html +297 -297
  73. package/public/provider-onboarding.html +172 -0
  74. package/public/provider-sandbox.html +134 -0
  75. package/public/providers.html +359 -0
  76. package/public/register.html +105 -105
  77. package/public/registrar-integrations.html +141 -0
  78. package/public/robots.txt +99 -87
  79. package/public/route53-integration.html +531 -0
  80. package/public/script/wab-consent.d.ts +36 -36
  81. package/public/script/wab-consent.js +104 -104
  82. package/public/script/wab-schema.js +131 -131
  83. package/public/script/wab.d.ts +108 -108
  84. package/public/script/wab.min.js +580 -580
  85. package/public/security.txt +8 -0
  86. package/public/shieldqr.html +231 -0
  87. package/public/sitemap.xml +6 -0
  88. package/public/terms.html +256 -256
  89. package/public/wab-trust.html +200 -0
  90. package/public/wab-vs-protocols.html +210 -0
  91. package/public/whitepaper.html +449 -0
  92. package/script/ai-agent-bridge.js +1754 -1754
  93. package/sdk/README.md +99 -99
  94. package/sdk/agent-mesh.js +449 -449
  95. package/sdk/auto-discovery.js +288 -0
  96. package/sdk/commander.js +262 -262
  97. package/sdk/governance.js +262 -0
  98. package/sdk/index.d.ts +464 -464
  99. package/sdk/index.js +25 -1
  100. package/sdk/multi-agent.js +318 -318
  101. package/sdk/package.json +2 -2
  102. package/sdk/safe-mode.js +221 -0
  103. package/sdk/safety-shield.js +219 -0
  104. package/sdk/schema-discovery.js +83 -83
  105. package/server/adapters/index.js +520 -520
  106. package/server/config/plans.js +367 -367
  107. package/server/config/secrets.js +102 -102
  108. package/server/control-plane/index.js +301 -301
  109. package/server/data-plane/index.js +354 -354
  110. package/server/index.js +670 -427
  111. package/server/llm/index.js +404 -404
  112. package/server/middleware/adminAuth.js +35 -35
  113. package/server/middleware/auth.js +50 -50
  114. package/server/middleware/featureGate.js +88 -88
  115. package/server/middleware/rateLimits.js +100 -100
  116. package/server/middleware/sensitiveAction.js +157 -0
  117. package/server/migrations/001_add_analytics_indexes.sql +7 -7
  118. package/server/migrations/002_premium_features.sql +418 -418
  119. package/server/migrations/003_ads_integer_cents.sql +33 -33
  120. package/server/migrations/004_agent_os.sql +158 -158
  121. package/server/migrations/005_marketplace_metering.sql +126 -126
  122. package/server/migrations/007_governance.sql +106 -0
  123. package/server/migrations/008_plans.sql +144 -0
  124. package/server/migrations/009_shieldqr.sql +30 -0
  125. package/server/migrations/010_extended_trust.sql +33 -0
  126. package/server/models/adapters/index.js +33 -33
  127. package/server/models/adapters/mysql.js +183 -183
  128. package/server/models/adapters/postgresql.js +172 -172
  129. package/server/models/adapters/sqlite.js +7 -7
  130. package/server/models/db.js +740 -681
  131. package/server/observability/failure-analysis.js +337 -337
  132. package/server/observability/index.js +394 -394
  133. package/server/protocol/capabilities.js +223 -223
  134. package/server/protocol/index.js +243 -243
  135. package/server/protocol/schema.js +584 -584
  136. package/server/registry/certification.js +271 -271
  137. package/server/registry/index.js +326 -326
  138. package/server/routes/admin-plans.js +76 -0
  139. package/server/routes/admin-premium.js +673 -671
  140. package/server/routes/admin-shieldqr.js +90 -0
  141. package/server/routes/admin-trust-monitor.js +83 -0
  142. package/server/routes/admin.js +549 -261
  143. package/server/routes/ads.js +130 -130
  144. package/server/routes/agent-workspace.js +540 -540
  145. package/server/routes/api.js +150 -150
  146. package/server/routes/auth.js +71 -71
  147. package/server/routes/billing.js +57 -45
  148. package/server/routes/commander.js +316 -316
  149. package/server/routes/demo-showcase.js +332 -332
  150. package/server/routes/demo-store.js +154 -0
  151. package/server/routes/discovery.js +2348 -417
  152. package/server/routes/gateway.js +173 -157
  153. package/server/routes/governance.js +208 -0
  154. package/server/routes/license.js +251 -240
  155. package/server/routes/mesh.js +469 -469
  156. package/server/routes/noscript.js +543 -543
  157. package/server/routes/plans.js +33 -0
  158. package/server/routes/premium-v2.js +686 -686
  159. package/server/routes/premium.js +724 -724
  160. package/server/routes/providers.js +650 -0
  161. package/server/routes/runtime.js +2148 -2147
  162. package/server/routes/shieldqr.js +88 -0
  163. package/server/routes/sovereign.js +465 -385
  164. package/server/routes/universal.js +200 -185
  165. package/server/routes/wab-api.js +850 -501
  166. package/server/runtime/container-worker.js +111 -111
  167. package/server/runtime/container.js +448 -448
  168. package/server/runtime/distributed-worker.js +362 -362
  169. package/server/runtime/event-bus.js +210 -210
  170. package/server/runtime/index.js +253 -253
  171. package/server/runtime/queue.js +599 -599
  172. package/server/runtime/replay.js +666 -666
  173. package/server/runtime/sandbox.js +266 -266
  174. package/server/runtime/scheduler.js +534 -534
  175. package/server/runtime/session-engine.js +293 -293
  176. package/server/runtime/state-manager.js +188 -188
  177. package/server/security/cross-site-redactor.js +196 -0
  178. package/server/security/dry-run.js +180 -0
  179. package/server/security/human-gate-rate-limit.js +147 -0
  180. package/server/security/human-gate-transports.js +178 -0
  181. package/server/security/human-gate.js +281 -0
  182. package/server/security/index.js +368 -368
  183. package/server/security/intent-engine.js +245 -0
  184. package/server/security/reward-guard.js +171 -0
  185. package/server/security/rollback-store.js +239 -0
  186. package/server/security/token-scope.js +404 -0
  187. package/server/security/url-policy.js +139 -0
  188. package/server/services/agent-chat.js +506 -506
  189. package/server/services/agent-learning.js +601 -575
  190. package/server/services/agent-memory.js +625 -625
  191. package/server/services/agent-mesh.js +555 -539
  192. package/server/services/agent-symphony.js +717 -717
  193. package/server/services/agent-tasks.js +1807 -1807
  194. package/server/services/api-key-engine.js +292 -261
  195. package/server/services/cluster.js +894 -894
  196. package/server/services/commander.js +738 -738
  197. package/server/services/edge-compute.js +440 -440
  198. package/server/services/email.js +233 -204
  199. package/server/services/governance.js +466 -0
  200. package/server/services/hosted-runtime.js +205 -205
  201. package/server/services/lfd.js +635 -635
  202. package/server/services/local-ai.js +389 -389
  203. package/server/services/marketplace.js +270 -270
  204. package/server/services/metering.js +182 -182
  205. package/server/services/modules/affiliate-intelligence.js +93 -93
  206. package/server/services/modules/agent-firewall.js +90 -90
  207. package/server/services/modules/bounty.js +89 -89
  208. package/server/services/modules/collective-bargaining.js +92 -92
  209. package/server/services/modules/dark-pattern.js +66 -66
  210. package/server/services/modules/gov-intelligence.js +45 -45
  211. package/server/services/modules/neural.js +55 -55
  212. package/server/services/modules/notary.js +49 -49
  213. package/server/services/modules/price-time-machine.js +86 -86
  214. package/server/services/modules/protocol.js +104 -104
  215. package/server/services/negotiation.js +439 -439
  216. package/server/services/plans.js +214 -0
  217. package/server/services/plugins.js +771 -771
  218. package/server/services/premium.js +1 -1
  219. package/server/services/price-intelligence.js +566 -566
  220. package/server/services/price-shield.js +1137 -1137
  221. package/server/services/provider-clients.js +740 -0
  222. package/server/services/reputation.js +465 -465
  223. package/server/services/search-engine.js +357 -357
  224. package/server/services/security.js +513 -513
  225. package/server/services/self-healing.js +843 -843
  226. package/server/services/shieldqr.js +322 -0
  227. package/server/services/sovereign-shield.js +542 -0
  228. package/server/services/ssl-inspector.js +42 -0
  229. package/server/services/ssl-monitor.js +167 -0
  230. package/server/services/stripe.js +205 -192
  231. package/server/services/swarm.js +788 -788
  232. package/server/services/universal-scraper.js +662 -661
  233. package/server/services/verification.js +481 -481
  234. package/server/services/vision.js +1163 -1163
  235. package/server/services/wab-crypto.js +178 -0
  236. package/server/utils/cache.js +125 -125
  237. package/server/utils/migrate.js +81 -81
  238. package/server/utils/safe-fetch.js +228 -0
  239. package/server/utils/secureFields.js +50 -50
  240. package/server/ws.js +161 -161
  241. package/templates/artisan-marketplace.yaml +104 -104
  242. package/templates/book-price-scout.yaml +98 -98
  243. package/templates/electronics-price-tracker.yaml +108 -108
  244. package/templates/flight-deal-hunter.yaml +113 -113
  245. package/templates/freelancer-direct.yaml +116 -116
  246. package/templates/grocery-price-compare.yaml +93 -93
  247. package/templates/hotel-direct-booking.yaml +113 -113
  248. package/templates/local-services.yaml +98 -98
  249. package/templates/olive-oil-tunisia.yaml +88 -88
  250. package/templates/organic-farm-fresh.yaml +101 -101
  251. package/templates/restaurant-direct.yaml +97 -97
  252. package/public/score.html +0 -263
  253. package/server/migrations/006_growth_suite.sql +0 -138
  254. package/server/routes/growth.js +0 -962
  255. package/server/services/fairness-engine.js +0 -409
  256. package/server/services/fairness.js +0 -420
package/public/cpanel-integration.html ADDED
@@ -0,0 +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>