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