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
@@ -1,251 +1,251 @@
1
- const express = require('express');
2
- const crypto = require('crypto');
3
- const router = express.Router();
4
- const {
5
- verifyLicense,
6
- recordAnalytic,
7
- findSiteByLicense,
8
- findSiteById,
9
- db
10
- } = require('../models/db');
11
- const { broadcastAnalytic } = require('../ws');
12
- const { cache, AnalyticsQueue } = require('../utils/cache');
13
- const { licenseTokenLimiter, licenseTrackLimiter } = require('../middleware/rateLimits');
14
- const tokenScope = require('../security/token-scope');
15
-
16
- const analyticsQueue = new AnalyticsQueue(db, { maxSize: 50, maxBufferTotal: 5000 });
17
-
18
- // ─── Session Token Store (in-memory, TTL 1 hour) ────────────────────
19
- const sessionTokens = new Map();
20
- const SESSION_TTL = 60 * 60 * 1000;
21
-
22
- setInterval(() => {
23
- const now = Date.now();
24
- for (const [token, data] of sessionTokens) {
25
- if (now > data.expiresAt) sessionTokens.delete(token);
26
- }
27
- }, 5 * 60 * 1000);
28
-
29
- function normalizeHost(host) {
30
- if (!host) return '';
31
- let h = String(host).toLowerCase().trim();
32
- if (h.startsWith('www.')) h = h.slice(4);
33
- return h;
34
- }
35
-
36
- function getRequestHostname(req) {
37
- const origin = req.get('origin') || req.get('referer');
38
- try {
39
- return origin ? new URL(origin).hostname : req.hostname;
40
- } catch {
41
- return req.hostname;
42
- }
43
- }
44
-
45
- function allowDevInsecureOrigin(hostname) {
46
- if (process.env.NODE_ENV === 'production') return false;
47
- if (process.env.ALLOW_INSECURE_LICENSE_ORIGIN !== 'true') return false;
48
- const n = normalizeHost(hostname);
49
- return n === 'localhost' || n === '127.0.0.1' || n === '[::1]';
50
- }
51
-
52
- // ─── Verify (domain + license OR session + siteId) ─────────────────
53
- router.post('/verify', (req, res) => {
54
- const { domain, licenseKey, siteId, sessionToken } = req.body;
55
-
56
- if (sessionToken && siteId) {
57
- const session = sessionTokens.get(sessionToken);
58
- if (!session || Date.now() > session.expiresAt) {
59
- sessionTokens.delete(sessionToken);
60
- return res.json({ valid: false, error: 'Session expired or invalid', tier: 'free' });
61
- }
62
- const requestDomain = getRequestHostname(req);
63
- if (normalizeHost(requestDomain) !== normalizeHost(session.domain)) {
64
- return res.json({ valid: false, error: 'Domain mismatch', tier: 'free' });
65
- }
66
- if (session.siteId !== siteId) {
67
- return res.json({ valid: false, error: 'Invalid site', tier: 'free' });
68
- }
69
- return res.json({
70
- valid: true,
71
- tier: session.tier,
72
- domain: session.domain,
73
- allowedPermissions: session.permissions
74
- });
75
- }
76
-
77
- if (!domain || !licenseKey) {
78
- return res.status(400).json({ valid: false, error: 'Domain and licenseKey are required (or sessionToken + siteId)', tier: 'free' });
79
- }
80
-
81
- const cacheKey = `license:${domain}:${licenseKey}`;
82
- const cached = cache.get(cacheKey);
83
- if (cached) return res.json(cached);
84
-
85
- const result = verifyLicense(domain, licenseKey);
86
- cache.set(cacheKey, result, 60000);
87
- res.json(result);
88
- });
89
-
90
- // ─── Token exchange: siteId (preferred) or licenseKey (legacy) ─────
91
- router.post('/token', licenseTokenLimiter, (req, res) => {
92
- const { licenseKey, siteId, scope: requestedScope } = req.body;
93
- const domain = getRequestHostname(req);
94
- const normReq = normalizeHost(domain);
95
-
96
- // SPEC §8.7 — parse caller-requested scope. Absent = legacy unscoped.
97
- let scope;
98
- try {
99
- scope = tokenScope.parseScope(requestedScope);
100
- } catch (e) {
101
- return res.status(400).json({ error: 'invalid_scope', message: e.message });
102
- }
103
-
104
- const finishSession = (site, result) => {
105
- const sessionToken = crypto.randomBytes(32).toString('hex');
106
- const expiresAt = Date.now() + SESSION_TTL;
107
- sessionTokens.set(sessionToken, {
108
- siteId: site.id,
109
- domain: site.domain,
110
- tier: result.tier,
111
- permissions: result.allowedPermissions,
112
- scope,
113
- expiresAt
114
- });
115
- res.json({
116
- sessionToken,
117
- siteId: site.id,
118
- tier: result.tier,
119
- permissions: result.allowedPermissions,
120
- scope: tokenScope.formatScope(scope),
121
- expiresIn: SESSION_TTL / 1000
122
- });
123
- };
124
-
125
- if (siteId && !licenseKey) {
126
- const site = findSiteById.get(siteId);
127
- if (!site || !site.active) {
128
- return res.status(404).json({ error: 'Site not found' });
129
- }
130
- const originOk =
131
- normReq === normalizeHost(site.domain) ||
132
- allowDevInsecureOrigin(domain);
133
- if (!originOk) {
134
- return res.status(403).json({ error: 'Origin does not match registered site domain' });
135
- }
136
- const cacheKey = `license:${site.domain}:${site.license_key}`;
137
- let result = cache.get(cacheKey);
138
- if (!result) {
139
- result = verifyLicense(site.domain, site.license_key);
140
- cache.set(cacheKey, result, 60000);
141
- }
142
- if (!result.valid) {
143
- return res.status(403).json({ error: result.error || 'Invalid license', tier: 'free' });
144
- }
145
- return finishSession(site, result);
146
- }
147
-
148
- if (!licenseKey) {
149
- return res.status(400).json({ error: 'siteId or licenseKey is required' });
150
- }
151
-
152
- const cacheKey = `license:${domain}:${licenseKey}`;
153
- let result = cache.get(cacheKey);
154
- if (!result) {
155
- result = verifyLicense(domain, licenseKey);
156
- cache.set(cacheKey, result, 60000);
157
- }
158
- if (!result.valid) {
159
- return res.status(403).json({ error: result.error || 'Invalid license', tier: 'free' });
160
- }
161
-
162
- const site = findSiteByLicense.get(licenseKey);
163
- if (!site) {
164
- return res.status(404).json({ error: 'Site not found' });
165
- }
166
-
167
- finishSession(site, result);
168
- });
169
-
170
- // ─── Validate Session Token ─────────────────────────────────────────
171
- router.post('/session', (req, res) => {
172
- const { sessionToken } = req.body;
173
- if (!sessionToken) {
174
- return res.status(400).json({ valid: false, error: 'sessionToken required' });
175
- }
176
-
177
- const session = sessionTokens.get(sessionToken);
178
- if (!session || Date.now() > session.expiresAt) {
179
- sessionTokens.delete(sessionToken);
180
- return res.status(401).json({ valid: false, error: 'Session expired or invalid' });
181
- }
182
-
183
- const requestDomain = getRequestHostname(req);
184
- if (normalizeHost(requestDomain) !== normalizeHost(session.domain)) {
185
- return res.status(403).json({ valid: false, error: 'Domain mismatch' });
186
- }
187
-
188
- res.json({
189
- valid: true,
190
- siteId: session.siteId,
191
- tier: session.tier,
192
- permissions: session.permissions
193
- });
194
- });
195
-
196
- // ─── Analytics track (session-bound; licenseKey deprecated) ──────
197
- router.post('/track', licenseTrackLimiter, (req, res) => {
198
- const { sessionToken, actionName, agentId, triggerType, success, metadata, licenseKey } = req.body;
199
-
200
- if (!actionName) {
201
- return res.status(400).json({ error: 'actionName is required' });
202
- }
203
-
204
- let site;
205
- if (sessionToken) {
206
- const session = sessionTokens.get(sessionToken);
207
- if (!session || Date.now() > session.expiresAt) {
208
- sessionTokens.delete(sessionToken);
209
- return res.status(401).json({ error: 'Session expired or invalid' });
210
- }
211
- const requestDomain = getRequestHostname(req);
212
- if (normalizeHost(requestDomain) !== normalizeHost(session.domain)) {
213
- return res.status(403).json({ error: 'Origin does not match session domain' });
214
- }
215
- site = findSiteById.get(session.siteId);
216
- if (!site || !site.active) {
217
- return res.status(404).json({ error: 'Site not found' });
218
- }
219
- } else if (licenseKey && process.env.ALLOW_LEGACY_LICENSE_TRACK === 'true') {
220
- site = findSiteByLicense.get(licenseKey);
221
- if (!site) return res.status(404).json({ error: 'Site not found' });
222
- } else {
223
- return res.status(400).json({
224
- error: 'sessionToken is required. Obtain via POST /api/license/token (see installation snippet).'
225
- });
226
- }
227
-
228
- try {
229
- analyticsQueue.push({
230
- siteId: site.id,
231
- actionName,
232
- agentId,
233
- triggerType,
234
- success: success !== false,
235
- metadata
236
- });
237
-
238
- broadcastAnalytic(site.id, {
239
- actionName,
240
- agentId,
241
- triggerType,
242
- success: success !== false
243
- });
244
-
245
- res.json({ recorded: true });
246
- } catch (err) {
247
- res.status(500).json({ error: 'Failed to record analytics' });
248
- }
249
- });
250
-
251
- module.exports = router;
1
+ const express = require('express');
2
+ const crypto = require('crypto');
3
+ const router = express.Router();
4
+ const {
5
+ verifyLicense,
6
+ recordAnalytic,
7
+ findSiteByLicense,
8
+ findSiteById,
9
+ db
10
+ } = require('../models/db');
11
+ const { broadcastAnalytic } = require('../ws');
12
+ const { cache, AnalyticsQueue } = require('../utils/cache');
13
+ const { licenseTokenLimiter, licenseTrackLimiter } = require('../middleware/rateLimits');
14
+ const tokenScope = require('../security/token-scope');
15
+
16
+ const analyticsQueue = new AnalyticsQueue(db, { maxSize: 50, maxBufferTotal: 5000 });
17
+
18
+ // ─── Session Token Store (in-memory, TTL 1 hour) ────────────────────
19
+ const sessionTokens = new Map();
20
+ const SESSION_TTL = 60 * 60 * 1000;
21
+
22
+ setInterval(() => {
23
+ const now = Date.now();
24
+ for (const [token, data] of sessionTokens) {
25
+ if (now > data.expiresAt) sessionTokens.delete(token);
26
+ }
27
+ }, 5 * 60 * 1000);
28
+
29
+ function normalizeHost(host) {
30
+ if (!host) return '';
31
+ let h = String(host).toLowerCase().trim();
32
+ if (h.startsWith('www.')) h = h.slice(4);
33
+ return h;
34
+ }
35
+
36
+ function getRequestHostname(req) {
37
+ const origin = req.get('origin') || req.get('referer');
38
+ try {
39
+ return origin ? new URL(origin).hostname : req.hostname;
40
+ } catch {
41
+ return req.hostname;
42
+ }
43
+ }
44
+
45
+ function allowDevInsecureOrigin(hostname) {
46
+ if (process.env.NODE_ENV === 'production') return false;
47
+ if (process.env.ALLOW_INSECURE_LICENSE_ORIGIN !== 'true') return false;
48
+ const n = normalizeHost(hostname);
49
+ return n === 'localhost' || n === '127.0.0.1' || n === '[::1]';
50
+ }
51
+
52
+ // ─── Verify (domain + license OR session + siteId) ─────────────────
53
+ router.post('/verify', (req, res) => {
54
+ const { domain, licenseKey, siteId, sessionToken } = req.body;
55
+
56
+ if (sessionToken && siteId) {
57
+ const session = sessionTokens.get(sessionToken);
58
+ if (!session || Date.now() > session.expiresAt) {
59
+ sessionTokens.delete(sessionToken);
60
+ return res.json({ valid: false, error: 'Session expired or invalid', tier: 'free' });
61
+ }
62
+ const requestDomain = getRequestHostname(req);
63
+ if (normalizeHost(requestDomain) !== normalizeHost(session.domain)) {
64
+ return res.json({ valid: false, error: 'Domain mismatch', tier: 'free' });
65
+ }
66
+ if (session.siteId !== siteId) {
67
+ return res.json({ valid: false, error: 'Invalid site', tier: 'free' });
68
+ }
69
+ return res.json({
70
+ valid: true,
71
+ tier: session.tier,
72
+ domain: session.domain,
73
+ allowedPermissions: session.permissions
74
+ });
75
+ }
76
+
77
+ if (!domain || !licenseKey) {
78
+ return res.status(400).json({ valid: false, error: 'Domain and licenseKey are required (or sessionToken + siteId)', tier: 'free' });
79
+ }
80
+
81
+ const cacheKey = `license:${domain}:${licenseKey}`;
82
+ const cached = cache.get(cacheKey);
83
+ if (cached) return res.json(cached);
84
+
85
+ const result = verifyLicense(domain, licenseKey);
86
+ cache.set(cacheKey, result, 60000);
87
+ res.json(result);
88
+ });
89
+
90
+ // ─── Token exchange: siteId (preferred) or licenseKey (legacy) ─────
91
+ router.post('/token', licenseTokenLimiter, (req, res) => {
92
+ const { licenseKey, siteId, scope: requestedScope } = req.body;
93
+ const domain = getRequestHostname(req);
94
+ const normReq = normalizeHost(domain);
95
+
96
+ // SPEC §8.7 — parse caller-requested scope. Absent = legacy unscoped.
97
+ let scope;
98
+ try {
99
+ scope = tokenScope.parseScope(requestedScope);
100
+ } catch (e) {
101
+ return res.status(400).json({ error: 'invalid_scope', message: e.message });
102
+ }
103
+
104
+ const finishSession = (site, result) => {
105
+ const sessionToken = crypto.randomBytes(32).toString('hex');
106
+ const expiresAt = Date.now() + SESSION_TTL;
107
+ sessionTokens.set(sessionToken, {
108
+ siteId: site.id,
109
+ domain: site.domain,
110
+ tier: result.tier,
111
+ permissions: result.allowedPermissions,
112
+ scope,
113
+ expiresAt
114
+ });
115
+ res.json({
116
+ sessionToken,
117
+ siteId: site.id,
118
+ tier: result.tier,
119
+ permissions: result.allowedPermissions,
120
+ scope: tokenScope.formatScope(scope),
121
+ expiresIn: SESSION_TTL / 1000
122
+ });
123
+ };
124
+
125
+ if (siteId && !licenseKey) {
126
+ const site = findSiteById.get(siteId);
127
+ if (!site || !site.active) {
128
+ return res.status(404).json({ error: 'Site not found' });
129
+ }
130
+ const originOk =
131
+ normReq === normalizeHost(site.domain) ||
132
+ allowDevInsecureOrigin(domain);
133
+ if (!originOk) {
134
+ return res.status(403).json({ error: 'Origin does not match registered site domain' });
135
+ }
136
+ const cacheKey = `license:${site.domain}:${site.license_key}`;
137
+ let result = cache.get(cacheKey);
138
+ if (!result) {
139
+ result = verifyLicense(site.domain, site.license_key);
140
+ cache.set(cacheKey, result, 60000);
141
+ }
142
+ if (!result.valid) {
143
+ return res.status(403).json({ error: result.error || 'Invalid license', tier: 'free' });
144
+ }
145
+ return finishSession(site, result);
146
+ }
147
+
148
+ if (!licenseKey) {
149
+ return res.status(400).json({ error: 'siteId or licenseKey is required' });
150
+ }
151
+
152
+ const cacheKey = `license:${domain}:${licenseKey}`;
153
+ let result = cache.get(cacheKey);
154
+ if (!result) {
155
+ result = verifyLicense(domain, licenseKey);
156
+ cache.set(cacheKey, result, 60000);
157
+ }
158
+ if (!result.valid) {
159
+ return res.status(403).json({ error: result.error || 'Invalid license', tier: 'free' });
160
+ }
161
+
162
+ const site = findSiteByLicense.get(licenseKey);
163
+ if (!site) {
164
+ return res.status(404).json({ error: 'Site not found' });
165
+ }
166
+
167
+ finishSession(site, result);
168
+ });
169
+
170
+ // ─── Validate Session Token ─────────────────────────────────────────
171
+ router.post('/session', (req, res) => {
172
+ const { sessionToken } = req.body;
173
+ if (!sessionToken) {
174
+ return res.status(400).json({ valid: false, error: 'sessionToken required' });
175
+ }
176
+
177
+ const session = sessionTokens.get(sessionToken);
178
+ if (!session || Date.now() > session.expiresAt) {
179
+ sessionTokens.delete(sessionToken);
180
+ return res.status(401).json({ valid: false, error: 'Session expired or invalid' });
181
+ }
182
+
183
+ const requestDomain = getRequestHostname(req);
184
+ if (normalizeHost(requestDomain) !== normalizeHost(session.domain)) {
185
+ return res.status(403).json({ valid: false, error: 'Domain mismatch' });
186
+ }
187
+
188
+ res.json({
189
+ valid: true,
190
+ siteId: session.siteId,
191
+ tier: session.tier,
192
+ permissions: session.permissions
193
+ });
194
+ });
195
+
196
+ // ─── Analytics track (session-bound; licenseKey deprecated) ──────
197
+ router.post('/track', licenseTrackLimiter, (req, res) => {
198
+ const { sessionToken, actionName, agentId, triggerType, success, metadata, licenseKey } = req.body;
199
+
200
+ if (!actionName) {
201
+ return res.status(400).json({ error: 'actionName is required' });
202
+ }
203
+
204
+ let site;
205
+ if (sessionToken) {
206
+ const session = sessionTokens.get(sessionToken);
207
+ if (!session || Date.now() > session.expiresAt) {
208
+ sessionTokens.delete(sessionToken);
209
+ return res.status(401).json({ error: 'Session expired or invalid' });
210
+ }
211
+ const requestDomain = getRequestHostname(req);
212
+ if (normalizeHost(requestDomain) !== normalizeHost(session.domain)) {
213
+ return res.status(403).json({ error: 'Origin does not match session domain' });
214
+ }
215
+ site = findSiteById.get(session.siteId);
216
+ if (!site || !site.active) {
217
+ return res.status(404).json({ error: 'Site not found' });
218
+ }
219
+ } else if (licenseKey && process.env.ALLOW_LEGACY_LICENSE_TRACK === 'true') {
220
+ site = findSiteByLicense.get(licenseKey);
221
+ if (!site) return res.status(404).json({ error: 'Site not found' });
222
+ } else {
223
+ return res.status(400).json({
224
+ error: 'sessionToken is required. Obtain via POST /api/license/token (see installation snippet).'
225
+ });
226
+ }
227
+
228
+ try {
229
+ analyticsQueue.push({
230
+ siteId: site.id,
231
+ actionName,
232
+ agentId,
233
+ triggerType,
234
+ success: success !== false,
235
+ metadata
236
+ });
237
+
238
+ broadcastAnalytic(site.id, {
239
+ actionName,
240
+ agentId,
241
+ triggerType,
242
+ success: success !== false
243
+ });
244
+
245
+ res.json({ recorded: true });
246
+ } catch (err) {
247
+ res.status(500).json({ error: 'Failed to record analytics' });
248
+ }
249
+ });
250
+
251
+ module.exports = router;