@vibecheckai/cli 3.0.10 → 3.1.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 (162) hide show
  1. package/bin/.generated +25 -0
  2. package/bin/dev/run-v2-torture.js +30 -30
  3. package/bin/registry.js +105 -0
  4. package/bin/runners/lib/__tests__/entitlements-v2.test.js +295 -295
  5. package/bin/runners/lib/analysis-core.js +271 -271
  6. package/bin/runners/lib/analyzers.js +579 -579
  7. package/bin/runners/lib/auth-truth.js +193 -193
  8. package/bin/runners/lib/backup.js +62 -62
  9. package/bin/runners/lib/billing.js +107 -107
  10. package/bin/runners/lib/claims.js +118 -118
  11. package/bin/runners/lib/cli-output.js +368 -0
  12. package/bin/runners/lib/cli-ui.js +540 -540
  13. package/bin/runners/lib/contracts/auth-contract.js +202 -202
  14. package/bin/runners/lib/contracts/env-contract.js +181 -181
  15. package/bin/runners/lib/contracts/external-contract.js +206 -206
  16. package/bin/runners/lib/contracts/guard.js +168 -168
  17. package/bin/runners/lib/contracts/index.js +89 -89
  18. package/bin/runners/lib/contracts/plan-validator.js +311 -311
  19. package/bin/runners/lib/contracts/route-contract.js +199 -199
  20. package/bin/runners/lib/contracts.js +804 -804
  21. package/bin/runners/lib/detect.js +89 -89
  22. package/bin/runners/lib/detectors-v2.js +703 -703
  23. package/bin/runners/lib/doctor/autofix.js +254 -254
  24. package/bin/runners/lib/doctor/index.js +37 -37
  25. package/bin/runners/lib/doctor/modules/dependencies.js +325 -325
  26. package/bin/runners/lib/doctor/modules/index.js +46 -46
  27. package/bin/runners/lib/doctor/modules/network.js +250 -250
  28. package/bin/runners/lib/doctor/modules/project.js +312 -312
  29. package/bin/runners/lib/doctor/modules/runtime.js +224 -224
  30. package/bin/runners/lib/doctor/modules/security.js +348 -348
  31. package/bin/runners/lib/doctor/modules/system.js +213 -213
  32. package/bin/runners/lib/doctor/modules/vibecheck.js +394 -394
  33. package/bin/runners/lib/doctor/reporter.js +262 -262
  34. package/bin/runners/lib/doctor/service.js +262 -262
  35. package/bin/runners/lib/doctor/types.js +113 -113
  36. package/bin/runners/lib/doctor/ui.js +263 -263
  37. package/bin/runners/lib/doctor-v2.js +608 -608
  38. package/bin/runners/lib/drift.js +425 -425
  39. package/bin/runners/lib/enforcement.js +72 -72
  40. package/bin/runners/lib/enterprise-detect.js +603 -603
  41. package/bin/runners/lib/enterprise-init.js +942 -942
  42. package/bin/runners/lib/entitlements-v2.js +490 -493
  43. package/bin/runners/lib/env-resolver.js +417 -417
  44. package/bin/runners/lib/env-template.js +66 -66
  45. package/bin/runners/lib/env.js +189 -189
  46. package/bin/runners/lib/extractors/client-calls.js +990 -990
  47. package/bin/runners/lib/extractors/fastify-route-dump.js +573 -573
  48. package/bin/runners/lib/extractors/fastify-routes.js +426 -426
  49. package/bin/runners/lib/extractors/index.js +363 -363
  50. package/bin/runners/lib/extractors/next-routes.js +524 -524
  51. package/bin/runners/lib/extractors/proof-graph.js +431 -431
  52. package/bin/runners/lib/extractors/route-matcher.js +451 -451
  53. package/bin/runners/lib/extractors/truthpack-v2.js +377 -377
  54. package/bin/runners/lib/extractors/ui-bindings.js +547 -547
  55. package/bin/runners/lib/findings-schema.js +281 -281
  56. package/bin/runners/lib/firewall-prompt.js +50 -50
  57. package/bin/runners/lib/graph/graph-builder.js +265 -265
  58. package/bin/runners/lib/graph/html-renderer.js +413 -413
  59. package/bin/runners/lib/graph/index.js +32 -32
  60. package/bin/runners/lib/graph/runtime-collector.js +215 -215
  61. package/bin/runners/lib/graph/static-extractor.js +518 -518
  62. package/bin/runners/lib/html-report.js +650 -650
  63. package/bin/runners/lib/init-wizard.js +308 -308
  64. package/bin/runners/lib/llm.js +75 -75
  65. package/bin/runners/lib/meter.js +61 -61
  66. package/bin/runners/lib/missions/evidence.js +126 -126
  67. package/bin/runners/lib/missions/plan.js +69 -69
  68. package/bin/runners/lib/missions/templates.js +192 -192
  69. package/bin/runners/lib/patch.js +40 -40
  70. package/bin/runners/lib/permissions/auth-model.js +213 -213
  71. package/bin/runners/lib/permissions/idor-prover.js +205 -205
  72. package/bin/runners/lib/permissions/index.js +45 -45
  73. package/bin/runners/lib/permissions/matrix-builder.js +198 -198
  74. package/bin/runners/lib/pkgjson.js +28 -28
  75. package/bin/runners/lib/policy.js +295 -295
  76. package/bin/runners/lib/preflight.js +142 -142
  77. package/bin/runners/lib/reality/correlation-detectors.js +359 -359
  78. package/bin/runners/lib/reality/index.js +318 -318
  79. package/bin/runners/lib/reality/request-hashing.js +416 -416
  80. package/bin/runners/lib/reality/request-mapper.js +453 -453
  81. package/bin/runners/lib/reality/safety-rails.js +463 -463
  82. package/bin/runners/lib/reality/semantic-snapshot.js +408 -408
  83. package/bin/runners/lib/reality/toast-detector.js +393 -393
  84. package/bin/runners/lib/reality-findings.js +84 -84
  85. package/bin/runners/lib/receipts.js +179 -0
  86. package/bin/runners/lib/redact.js +29 -29
  87. package/bin/runners/lib/replay/capsule-manager.js +154 -154
  88. package/bin/runners/lib/replay/index.js +263 -263
  89. package/bin/runners/lib/replay/player.js +348 -348
  90. package/bin/runners/lib/replay/recorder.js +331 -331
  91. package/bin/runners/lib/report-engine.js +447 -447
  92. package/bin/runners/lib/report-html.js +1499 -1499
  93. package/bin/runners/lib/report-templates.js +969 -969
  94. package/bin/runners/lib/report.js +135 -135
  95. package/bin/runners/lib/route-detection.js +1140 -1140
  96. package/bin/runners/lib/route-truth.js +477 -477
  97. package/bin/runners/lib/sandbox/index.js +59 -59
  98. package/bin/runners/lib/sandbox/proof-chain.js +399 -399
  99. package/bin/runners/lib/sandbox/sandbox-runner.js +205 -205
  100. package/bin/runners/lib/sandbox/worktree.js +174 -174
  101. package/bin/runners/lib/schema-validator.js +350 -350
  102. package/bin/runners/lib/schemas/contracts.schema.json +160 -160
  103. package/bin/runners/lib/schemas/finding.schema.json +100 -100
  104. package/bin/runners/lib/schemas/mission-pack.schema.json +206 -206
  105. package/bin/runners/lib/schemas/proof-graph.schema.json +176 -176
  106. package/bin/runners/lib/schemas/reality-report.schema.json +162 -162
  107. package/bin/runners/lib/schemas/share-pack.schema.json +180 -180
  108. package/bin/runners/lib/schemas/ship-report.schema.json +117 -117
  109. package/bin/runners/lib/schemas/truthpack-v2.schema.json +303 -303
  110. package/bin/runners/lib/schemas/validator.js +438 -438
  111. package/bin/runners/lib/score-history.js +282 -282
  112. package/bin/runners/lib/share-pack.js +239 -239
  113. package/bin/runners/lib/snippets.js +67 -67
  114. package/bin/runners/lib/truth.js +667 -667
  115. package/bin/runners/lib/upsell.js +510 -0
  116. package/bin/runners/lib/usage.js +153 -0
  117. package/bin/runners/lib/validate-patch.js +156 -156
  118. package/bin/runners/lib/verdict-engine.js +628 -628
  119. package/bin/runners/reality/engine.js +917 -917
  120. package/bin/runners/reality/flows.js +122 -122
  121. package/bin/runners/reality/report.js +378 -378
  122. package/bin/runners/reality/session.js +193 -193
  123. package/bin/runners/runAuth.js +51 -0
  124. package/bin/runners/runBadge.js +31 -4
  125. package/bin/runners/runClaimVerifier.js +483 -483
  126. package/bin/runners/runContext.js +56 -56
  127. package/bin/runners/runContextCompiler.js +385 -385
  128. package/bin/runners/runCtx.js +674 -674
  129. package/bin/runners/runCtxDiff.js +301 -301
  130. package/bin/runners/runCtxGuard.js +176 -176
  131. package/bin/runners/runCtxSync.js +116 -116
  132. package/bin/runners/runDoctor.js +72 -3
  133. package/bin/runners/runFix.js +13 -0
  134. package/bin/runners/runGate.js +17 -17
  135. package/bin/runners/runGraph.js +454 -440
  136. package/bin/runners/runGuard.js +168 -168
  137. package/bin/runners/runInitGha.js +164 -164
  138. package/bin/runners/runInstall.js +277 -277
  139. package/bin/runners/runInteractive.js +388 -388
  140. package/bin/runners/runLabs.js +340 -340
  141. package/bin/runners/runMcp.js +865 -42
  142. package/bin/runners/runMissionGenerator.js +282 -282
  143. package/bin/runners/runPR.js +255 -255
  144. package/bin/runners/runPermissions.js +304 -290
  145. package/bin/runners/runPreflight.js +580 -0
  146. package/bin/runners/runProve.js +1252 -1193
  147. package/bin/runners/runReality.js +1328 -1328
  148. package/bin/runners/runReplay.js +499 -499
  149. package/bin/runners/runReport.js +584 -584
  150. package/bin/runners/runShare.js +212 -212
  151. package/bin/runners/runShip.js +98 -19
  152. package/bin/runners/runStatus.js +138 -138
  153. package/bin/runners/runTruthpack.js +636 -636
  154. package/bin/runners/runVerify.js +272 -0
  155. package/bin/runners/runWatch.js +407 -407
  156. package/bin/vibecheck.js +110 -95
  157. package/mcp-server/consolidated-tools.js +804 -804
  158. package/mcp-server/tools/index.js +72 -72
  159. package/mcp-server/truth-context.js +581 -581
  160. package/mcp-server/truth-firewall-tools.js +1500 -1500
  161. package/package.json +1 -1
  162. package/bin/runners/runProof.zip +0 -0
@@ -1,453 +1,453 @@
1
- /**
2
- * Request Mapper v2
3
- *
4
- * Maps runtime requests to client calls with specificity scoring.
5
- * Handles URL normalization, basePath, proxies, tRPC/GraphQL operations.
6
- */
7
-
8
- "use strict";
9
-
10
- const crypto = require("crypto");
11
-
12
- // =============================================================================
13
- // IGNORE PATTERNS
14
- // =============================================================================
15
-
16
- const IGNORE_PATTERNS = {
17
- // Asset extensions
18
- assets: /\.(js|css|png|jpg|jpeg|gif|svg|ico|woff2?|ttf|eot|map|webp|avif)(\?.*)?$/i,
19
-
20
- // Dev/HMR patterns
21
- hmr: /(_next\/static|__webpack_hmr|hot-update|\.hot-update\.|webpack|turbopack)/i,
22
-
23
- // Analytics/tracking
24
- analytics: /(analytics|gtag|ga\.js|gtm\.js|pixel|clarity|hotjar|segment|mixpanel|amplitude)/i,
25
-
26
- // Third party
27
- thirdParty: /^https?:\/\/(fonts\.googleapis|cdn\.|unpkg\.com|cdnjs\.|jsdelivr)/i,
28
-
29
- // Browser internals
30
- browser: /^(chrome-extension|moz-extension|safari-extension|about:|data:|blob:)/i,
31
-
32
- // Favicon
33
- favicon: /favicon\.ico/i,
34
-
35
- // Source maps
36
- sourceMaps: /\.map$/i,
37
-
38
- // WebSocket
39
- websocket: /^wss?:/i,
40
- };
41
-
42
- /**
43
- * Check if request should be ignored
44
- */
45
- function shouldIgnoreRequest(url, method = "GET") {
46
- if (!url) return true;
47
-
48
- // Always include mutations
49
- if (["POST", "PUT", "PATCH", "DELETE"].includes(method?.toUpperCase())) {
50
- // But still ignore analytics POST
51
- if (IGNORE_PATTERNS.analytics.test(url)) return true;
52
- return false;
53
- }
54
-
55
- for (const pattern of Object.values(IGNORE_PATTERNS)) {
56
- if (pattern.test(url)) return true;
57
- }
58
-
59
- return false;
60
- }
61
-
62
- // =============================================================================
63
- // URL NORMALIZATION
64
- // =============================================================================
65
-
66
- /**
67
- * Normalize URL for matching
68
- */
69
- function normalizeRequestUrl(url, options = {}) {
70
- const { basePath = "", stripHost = true, stripQuery = true } = options;
71
-
72
- if (!url) return null;
73
-
74
- let normalized = url;
75
-
76
- // Strip host if absolute URL
77
- if (stripHost && /^https?:\/\//.test(normalized)) {
78
- try {
79
- const parsed = new URL(normalized);
80
- normalized = parsed.pathname + (stripQuery ? "" : parsed.search);
81
- } catch {
82
- // Invalid URL, try to extract path
83
- normalized = normalized.replace(/^https?:\/\/[^/]+/, "");
84
- }
85
- }
86
-
87
- // Strip query string
88
- if (stripQuery) {
89
- normalized = normalized.split("?")[0].split("#")[0];
90
- }
91
-
92
- // Strip basePath prefix
93
- if (basePath && normalized.startsWith(basePath)) {
94
- normalized = normalized.slice(basePath.length) || "/";
95
- }
96
-
97
- // Ensure leading slash
98
- if (!normalized.startsWith("/")) {
99
- normalized = "/" + normalized;
100
- }
101
-
102
- // Remove trailing slash except for root
103
- if (normalized.length > 1 && normalized.endsWith("/")) {
104
- normalized = normalized.slice(0, -1);
105
- }
106
-
107
- // Normalize multiple slashes
108
- normalized = normalized.replace(/\/+/g, "/");
109
-
110
- return normalized;
111
- }
112
-
113
- /**
114
- * Extract tRPC operation from URL
115
- */
116
- function extractTrpcOperation(url) {
117
- // /api/trpc/user.get?batch=1&input=...
118
- const match = url.match(/\/trpc\/([^?]+)/);
119
- if (!match) return null;
120
-
121
- const procedure = match[1];
122
- // Handle batch queries
123
- const procedures = procedure.split(",").map(p => p.trim());
124
-
125
- return {
126
- type: "trpc",
127
- procedures,
128
- isBatch: procedures.length > 1,
129
- };
130
- }
131
-
132
- /**
133
- * Extract GraphQL operation from request
134
- */
135
- function extractGraphqlOperation(url, body) {
136
- // Check if it's a GraphQL endpoint
137
- if (!url.includes("graphql")) return null;
138
-
139
- if (!body) return { type: "graphql", operationName: null };
140
-
141
- try {
142
- const parsed = typeof body === "string" ? JSON.parse(body) : body;
143
- return {
144
- type: "graphql",
145
- operationName: parsed.operationName || null,
146
- operationType: parsed.query?.trim().startsWith("mutation") ? "mutation" : "query",
147
- };
148
- } catch {
149
- return { type: "graphql", operationName: null };
150
- }
151
- }
152
-
153
- // =============================================================================
154
- // REQUEST → CLIENT CALL MATCHING
155
- // =============================================================================
156
-
157
- /**
158
- * Match a runtime request to client calls
159
- */
160
- function matchRequestToClientCalls(request, clientCalls, options = {}) {
161
- const { basePath = "", rewrites = [] } = options;
162
-
163
- const normalizedPath = normalizeRequestUrl(request.url, { basePath });
164
- if (!normalizedPath) return null;
165
-
166
- const method = (request.method || "GET").toUpperCase();
167
-
168
- // Check for tRPC
169
- const trpcOp = extractTrpcOperation(request.url);
170
- if (trpcOp) {
171
- return matchTrpcRequest(trpcOp, clientCalls, request);
172
- }
173
-
174
- // Check for GraphQL
175
- const gqlOp = extractGraphqlOperation(request.url, request.body);
176
- if (gqlOp) {
177
- return matchGraphqlRequest(gqlOp, clientCalls, request);
178
- }
179
-
180
- // Standard HTTP matching
181
- const candidates = [];
182
-
183
- for (const call of clientCalls) {
184
- if (call.kind !== "http") continue;
185
-
186
- const score = calculateMatchScore(normalizedPath, method, call, { basePath, rewrites });
187
- if (score > 0) {
188
- candidates.push({ call, score });
189
- }
190
- }
191
-
192
- // Sort by score descending
193
- candidates.sort((a, b) => b.score - a.score);
194
-
195
- if (candidates.length === 0) {
196
- return {
197
- matched: false,
198
- request,
199
- normalizedPath,
200
- method,
201
- candidates: [],
202
- };
203
- }
204
-
205
- return {
206
- matched: true,
207
- request,
208
- normalizedPath,
209
- method,
210
- bestMatch: candidates[0].call,
211
- score: candidates[0].score,
212
- candidates: candidates.slice(0, 3),
213
- };
214
- }
215
-
216
- /**
217
- * Match tRPC request to client calls
218
- */
219
- function matchTrpcRequest(trpcOp, clientCalls, request) {
220
- const trpcCalls = clientCalls.filter(c => c.kind === "trpc");
221
-
222
- for (const call of trpcCalls) {
223
- const callProcedure = call.meta?.procedure;
224
- if (!callProcedure) continue;
225
-
226
- // Check if any procedure matches
227
- for (const proc of trpcOp.procedures) {
228
- if (proc === callProcedure || proc.endsWith(callProcedure)) {
229
- return {
230
- matched: true,
231
- request,
232
- matchType: "trpc",
233
- procedure: proc,
234
- bestMatch: call,
235
- score: 1.0,
236
- };
237
- }
238
- }
239
- }
240
-
241
- return {
242
- matched: false,
243
- request,
244
- matchType: "trpc",
245
- procedures: trpcOp.procedures,
246
- };
247
- }
248
-
249
- /**
250
- * Match GraphQL request to client calls
251
- */
252
- function matchGraphqlRequest(gqlOp, clientCalls, request) {
253
- const gqlCalls = clientCalls.filter(c => c.kind === "graphql");
254
-
255
- if (gqlOp.operationName) {
256
- for (const call of gqlCalls) {
257
- if (call.meta?.operationName === gqlOp.operationName) {
258
- return {
259
- matched: true,
260
- request,
261
- matchType: "graphql",
262
- operationName: gqlOp.operationName,
263
- bestMatch: call,
264
- score: 1.0,
265
- };
266
- }
267
- }
268
- }
269
-
270
- // Fallback: match any GraphQL call
271
- if (gqlCalls.length > 0) {
272
- return {
273
- matched: true,
274
- request,
275
- matchType: "graphql",
276
- operationName: gqlOp.operationName,
277
- bestMatch: gqlCalls[0],
278
- score: 0.5,
279
- };
280
- }
281
-
282
- return {
283
- matched: false,
284
- request,
285
- matchType: "graphql",
286
- operationName: gqlOp.operationName,
287
- };
288
- }
289
-
290
- /**
291
- * Calculate match score between request and client call
292
- */
293
- function calculateMatchScore(requestPath, requestMethod, call, options = {}) {
294
- const { basePath = "", rewrites = [] } = options;
295
-
296
- let callPath = call.canonicalPath;
297
- if (!callPath) return 0;
298
-
299
- // Apply rewrites
300
- for (const rewrite of rewrites) {
301
- if (rewrite.source && rewrite.destination) {
302
- const sourceRegex = new RegExp("^" + rewrite.source.replace(/:(\w+)/g, "([^/]+)") + "$");
303
- if (sourceRegex.test(requestPath)) {
304
- // Rewrite matches, adjust call path expectation
305
- callPath = requestPath.replace(sourceRegex, rewrite.destination);
306
- break;
307
- }
308
- }
309
- }
310
-
311
- let score = 0;
312
-
313
- // Exact path match
314
- if (requestPath === callPath) {
315
- score += 1.0;
316
- }
317
- // Parameterized match
318
- else if (callPath.includes("{") || callPath.includes(":")) {
319
- const pattern = "^" + callPath
320
- .replace(/\{[^}]+\}/g, "[^/]+")
321
- .replace(/:(\w+)/g, "[^/]+") + "$";
322
- const regex = new RegExp(pattern);
323
- if (regex.test(requestPath)) {
324
- score += 0.9;
325
- }
326
- }
327
- // Prefix match (less confident)
328
- else if (requestPath.startsWith(callPath) || callPath.startsWith(requestPath)) {
329
- score += 0.5;
330
- }
331
-
332
- if (score === 0) return 0;
333
-
334
- // Method match bonus
335
- const callMethod = (call.method || "UNKNOWN").toUpperCase();
336
- if (callMethod === requestMethod) {
337
- score += 0.1;
338
- } else if (callMethod === "UNKNOWN" || callMethod === "*") {
339
- // No penalty for unknown
340
- } else {
341
- score -= 0.2; // Method mismatch penalty
342
- }
343
-
344
- // Confidence bonus
345
- if (call.confidence === "high") {
346
- score += 0.05;
347
- } else if (call.confidence === "low") {
348
- score -= 0.05;
349
- }
350
-
351
- return Math.max(0, Math.min(1, score));
352
- }
353
-
354
- // =============================================================================
355
- // BATCH MAPPING
356
- // =============================================================================
357
-
358
- /**
359
- * Map all runtime requests to client calls
360
- */
361
- function mapAllRequests(requests, clientCalls, options = {}) {
362
- const { basePath = "", rewrites = [], includeIgnored = false } = options;
363
-
364
- const results = {
365
- mapped: [],
366
- unmapped: [],
367
- ignored: [],
368
- stats: {
369
- total: requests.length,
370
- mapped: 0,
371
- unmapped: 0,
372
- ignored: 0,
373
- byMatchType: {},
374
- },
375
- };
376
-
377
- for (const request of requests) {
378
- // Check if should ignore
379
- if (shouldIgnoreRequest(request.url, request.method)) {
380
- if (includeIgnored) {
381
- results.ignored.push(request);
382
- }
383
- results.stats.ignored++;
384
- continue;
385
- }
386
-
387
- const match = matchRequestToClientCalls(request, clientCalls, { basePath, rewrites });
388
-
389
- if (match.matched) {
390
- results.mapped.push(match);
391
- results.stats.mapped++;
392
-
393
- const matchType = match.matchType || "http";
394
- results.stats.byMatchType[matchType] = (results.stats.byMatchType[matchType] || 0) + 1;
395
- } else {
396
- results.unmapped.push(match);
397
- results.stats.unmapped++;
398
- }
399
- }
400
-
401
- return results;
402
- }
403
-
404
- /**
405
- * Group mapped requests by client call
406
- */
407
- function groupRequestsByClientCall(mappedResults) {
408
- const groups = new Map();
409
-
410
- for (const match of mappedResults) {
411
- if (!match.bestMatch) continue;
412
-
413
- const callId = match.bestMatch.id;
414
- if (!groups.has(callId)) {
415
- groups.set(callId, {
416
- clientCall: match.bestMatch,
417
- requests: [],
418
- statuses: [],
419
- });
420
- }
421
-
422
- const group = groups.get(callId);
423
- group.requests.push(match.request);
424
- if (match.request.status) {
425
- group.statuses.push(match.request.status);
426
- }
427
- }
428
-
429
- return groups;
430
- }
431
-
432
- // =============================================================================
433
- // EXPORTS
434
- // =============================================================================
435
-
436
- module.exports = {
437
- // Ignore patterns
438
- IGNORE_PATTERNS,
439
- shouldIgnoreRequest,
440
-
441
- // URL normalization
442
- normalizeRequestUrl,
443
- extractTrpcOperation,
444
- extractGraphqlOperation,
445
-
446
- // Matching
447
- matchRequestToClientCalls,
448
- calculateMatchScore,
449
-
450
- // Batch operations
451
- mapAllRequests,
452
- groupRequestsByClientCall,
453
- };
1
+ /**
2
+ * Request Mapper v2
3
+ *
4
+ * Maps runtime requests to client calls with specificity scoring.
5
+ * Handles URL normalization, basePath, proxies, tRPC/GraphQL operations.
6
+ */
7
+
8
+ "use strict";
9
+
10
+ const crypto = require("crypto");
11
+
12
+ // =============================================================================
13
+ // IGNORE PATTERNS
14
+ // =============================================================================
15
+
16
+ const IGNORE_PATTERNS = {
17
+ // Asset extensions
18
+ assets: /\.(js|css|png|jpg|jpeg|gif|svg|ico|woff2?|ttf|eot|map|webp|avif)(\?.*)?$/i,
19
+
20
+ // Dev/HMR patterns
21
+ hmr: /(_next\/static|__webpack_hmr|hot-update|\.hot-update\.|webpack|turbopack)/i,
22
+
23
+ // Analytics/tracking
24
+ analytics: /(analytics|gtag|ga\.js|gtm\.js|pixel|clarity|hotjar|segment|mixpanel|amplitude)/i,
25
+
26
+ // Third party
27
+ thirdParty: /^https?:\/\/(fonts\.googleapis|cdn\.|unpkg\.com|cdnjs\.|jsdelivr)/i,
28
+
29
+ // Browser internals
30
+ browser: /^(chrome-extension|moz-extension|safari-extension|about:|data:|blob:)/i,
31
+
32
+ // Favicon
33
+ favicon: /favicon\.ico/i,
34
+
35
+ // Source maps
36
+ sourceMaps: /\.map$/i,
37
+
38
+ // WebSocket
39
+ websocket: /^wss?:/i,
40
+ };
41
+
42
+ /**
43
+ * Check if request should be ignored
44
+ */
45
+ function shouldIgnoreRequest(url, method = "GET") {
46
+ if (!url) return true;
47
+
48
+ // Always include mutations
49
+ if (["POST", "PUT", "PATCH", "DELETE"].includes(method?.toUpperCase())) {
50
+ // But still ignore analytics POST
51
+ if (IGNORE_PATTERNS.analytics.test(url)) return true;
52
+ return false;
53
+ }
54
+
55
+ for (const pattern of Object.values(IGNORE_PATTERNS)) {
56
+ if (pattern.test(url)) return true;
57
+ }
58
+
59
+ return false;
60
+ }
61
+
62
+ // =============================================================================
63
+ // URL NORMALIZATION
64
+ // =============================================================================
65
+
66
+ /**
67
+ * Normalize URL for matching
68
+ */
69
+ function normalizeRequestUrl(url, options = {}) {
70
+ const { basePath = "", stripHost = true, stripQuery = true } = options;
71
+
72
+ if (!url) return null;
73
+
74
+ let normalized = url;
75
+
76
+ // Strip host if absolute URL
77
+ if (stripHost && /^https?:\/\//.test(normalized)) {
78
+ try {
79
+ const parsed = new URL(normalized);
80
+ normalized = parsed.pathname + (stripQuery ? "" : parsed.search);
81
+ } catch {
82
+ // Invalid URL, try to extract path
83
+ normalized = normalized.replace(/^https?:\/\/[^/]+/, "");
84
+ }
85
+ }
86
+
87
+ // Strip query string
88
+ if (stripQuery) {
89
+ normalized = normalized.split("?")[0].split("#")[0];
90
+ }
91
+
92
+ // Strip basePath prefix
93
+ if (basePath && normalized.startsWith(basePath)) {
94
+ normalized = normalized.slice(basePath.length) || "/";
95
+ }
96
+
97
+ // Ensure leading slash
98
+ if (!normalized.startsWith("/")) {
99
+ normalized = "/" + normalized;
100
+ }
101
+
102
+ // Remove trailing slash except for root
103
+ if (normalized.length > 1 && normalized.endsWith("/")) {
104
+ normalized = normalized.slice(0, -1);
105
+ }
106
+
107
+ // Normalize multiple slashes
108
+ normalized = normalized.replace(/\/+/g, "/");
109
+
110
+ return normalized;
111
+ }
112
+
113
+ /**
114
+ * Extract tRPC operation from URL
115
+ */
116
+ function extractTrpcOperation(url) {
117
+ // /api/trpc/user.get?batch=1&input=...
118
+ const match = url.match(/\/trpc\/([^?]+)/);
119
+ if (!match) return null;
120
+
121
+ const procedure = match[1];
122
+ // Handle batch queries
123
+ const procedures = procedure.split(",").map(p => p.trim());
124
+
125
+ return {
126
+ type: "trpc",
127
+ procedures,
128
+ isBatch: procedures.length > 1,
129
+ };
130
+ }
131
+
132
+ /**
133
+ * Extract GraphQL operation from request
134
+ */
135
+ function extractGraphqlOperation(url, body) {
136
+ // Check if it's a GraphQL endpoint
137
+ if (!url.includes("graphql")) return null;
138
+
139
+ if (!body) return { type: "graphql", operationName: null };
140
+
141
+ try {
142
+ const parsed = typeof body === "string" ? JSON.parse(body) : body;
143
+ return {
144
+ type: "graphql",
145
+ operationName: parsed.operationName || null,
146
+ operationType: parsed.query?.trim().startsWith("mutation") ? "mutation" : "query",
147
+ };
148
+ } catch {
149
+ return { type: "graphql", operationName: null };
150
+ }
151
+ }
152
+
153
+ // =============================================================================
154
+ // REQUEST → CLIENT CALL MATCHING
155
+ // =============================================================================
156
+
157
+ /**
158
+ * Match a runtime request to client calls
159
+ */
160
+ function matchRequestToClientCalls(request, clientCalls, options = {}) {
161
+ const { basePath = "", rewrites = [] } = options;
162
+
163
+ const normalizedPath = normalizeRequestUrl(request.url, { basePath });
164
+ if (!normalizedPath) return null;
165
+
166
+ const method = (request.method || "GET").toUpperCase();
167
+
168
+ // Check for tRPC
169
+ const trpcOp = extractTrpcOperation(request.url);
170
+ if (trpcOp) {
171
+ return matchTrpcRequest(trpcOp, clientCalls, request);
172
+ }
173
+
174
+ // Check for GraphQL
175
+ const gqlOp = extractGraphqlOperation(request.url, request.body);
176
+ if (gqlOp) {
177
+ return matchGraphqlRequest(gqlOp, clientCalls, request);
178
+ }
179
+
180
+ // Standard HTTP matching
181
+ const candidates = [];
182
+
183
+ for (const call of clientCalls) {
184
+ if (call.kind !== "http") continue;
185
+
186
+ const score = calculateMatchScore(normalizedPath, method, call, { basePath, rewrites });
187
+ if (score > 0) {
188
+ candidates.push({ call, score });
189
+ }
190
+ }
191
+
192
+ // Sort by score descending
193
+ candidates.sort((a, b) => b.score - a.score);
194
+
195
+ if (candidates.length === 0) {
196
+ return {
197
+ matched: false,
198
+ request,
199
+ normalizedPath,
200
+ method,
201
+ candidates: [],
202
+ };
203
+ }
204
+
205
+ return {
206
+ matched: true,
207
+ request,
208
+ normalizedPath,
209
+ method,
210
+ bestMatch: candidates[0].call,
211
+ score: candidates[0].score,
212
+ candidates: candidates.slice(0, 3),
213
+ };
214
+ }
215
+
216
+ /**
217
+ * Match tRPC request to client calls
218
+ */
219
+ function matchTrpcRequest(trpcOp, clientCalls, request) {
220
+ const trpcCalls = clientCalls.filter(c => c.kind === "trpc");
221
+
222
+ for (const call of trpcCalls) {
223
+ const callProcedure = call.meta?.procedure;
224
+ if (!callProcedure) continue;
225
+
226
+ // Check if any procedure matches
227
+ for (const proc of trpcOp.procedures) {
228
+ if (proc === callProcedure || proc.endsWith(callProcedure)) {
229
+ return {
230
+ matched: true,
231
+ request,
232
+ matchType: "trpc",
233
+ procedure: proc,
234
+ bestMatch: call,
235
+ score: 1.0,
236
+ };
237
+ }
238
+ }
239
+ }
240
+
241
+ return {
242
+ matched: false,
243
+ request,
244
+ matchType: "trpc",
245
+ procedures: trpcOp.procedures,
246
+ };
247
+ }
248
+
249
+ /**
250
+ * Match GraphQL request to client calls
251
+ */
252
+ function matchGraphqlRequest(gqlOp, clientCalls, request) {
253
+ const gqlCalls = clientCalls.filter(c => c.kind === "graphql");
254
+
255
+ if (gqlOp.operationName) {
256
+ for (const call of gqlCalls) {
257
+ if (call.meta?.operationName === gqlOp.operationName) {
258
+ return {
259
+ matched: true,
260
+ request,
261
+ matchType: "graphql",
262
+ operationName: gqlOp.operationName,
263
+ bestMatch: call,
264
+ score: 1.0,
265
+ };
266
+ }
267
+ }
268
+ }
269
+
270
+ // Fallback: match any GraphQL call
271
+ if (gqlCalls.length > 0) {
272
+ return {
273
+ matched: true,
274
+ request,
275
+ matchType: "graphql",
276
+ operationName: gqlOp.operationName,
277
+ bestMatch: gqlCalls[0],
278
+ score: 0.5,
279
+ };
280
+ }
281
+
282
+ return {
283
+ matched: false,
284
+ request,
285
+ matchType: "graphql",
286
+ operationName: gqlOp.operationName,
287
+ };
288
+ }
289
+
290
+ /**
291
+ * Calculate match score between request and client call
292
+ */
293
+ function calculateMatchScore(requestPath, requestMethod, call, options = {}) {
294
+ const { basePath = "", rewrites = [] } = options;
295
+
296
+ let callPath = call.canonicalPath;
297
+ if (!callPath) return 0;
298
+
299
+ // Apply rewrites
300
+ for (const rewrite of rewrites) {
301
+ if (rewrite.source && rewrite.destination) {
302
+ const sourceRegex = new RegExp("^" + rewrite.source.replace(/:(\w+)/g, "([^/]+)") + "$");
303
+ if (sourceRegex.test(requestPath)) {
304
+ // Rewrite matches, adjust call path expectation
305
+ callPath = requestPath.replace(sourceRegex, rewrite.destination);
306
+ break;
307
+ }
308
+ }
309
+ }
310
+
311
+ let score = 0;
312
+
313
+ // Exact path match
314
+ if (requestPath === callPath) {
315
+ score += 1.0;
316
+ }
317
+ // Parameterized match
318
+ else if (callPath.includes("{") || callPath.includes(":")) {
319
+ const pattern = "^" + callPath
320
+ .replace(/\{[^}]+\}/g, "[^/]+")
321
+ .replace(/:(\w+)/g, "[^/]+") + "$";
322
+ const regex = new RegExp(pattern);
323
+ if (regex.test(requestPath)) {
324
+ score += 0.9;
325
+ }
326
+ }
327
+ // Prefix match (less confident)
328
+ else if (requestPath.startsWith(callPath) || callPath.startsWith(requestPath)) {
329
+ score += 0.5;
330
+ }
331
+
332
+ if (score === 0) return 0;
333
+
334
+ // Method match bonus
335
+ const callMethod = (call.method || "UNKNOWN").toUpperCase();
336
+ if (callMethod === requestMethod) {
337
+ score += 0.1;
338
+ } else if (callMethod === "UNKNOWN" || callMethod === "*") {
339
+ // No penalty for unknown
340
+ } else {
341
+ score -= 0.2; // Method mismatch penalty
342
+ }
343
+
344
+ // Confidence bonus
345
+ if (call.confidence === "high") {
346
+ score += 0.05;
347
+ } else if (call.confidence === "low") {
348
+ score -= 0.05;
349
+ }
350
+
351
+ return Math.max(0, Math.min(1, score));
352
+ }
353
+
354
+ // =============================================================================
355
+ // BATCH MAPPING
356
+ // =============================================================================
357
+
358
+ /**
359
+ * Map all runtime requests to client calls
360
+ */
361
+ function mapAllRequests(requests, clientCalls, options = {}) {
362
+ const { basePath = "", rewrites = [], includeIgnored = false } = options;
363
+
364
+ const results = {
365
+ mapped: [],
366
+ unmapped: [],
367
+ ignored: [],
368
+ stats: {
369
+ total: requests.length,
370
+ mapped: 0,
371
+ unmapped: 0,
372
+ ignored: 0,
373
+ byMatchType: {},
374
+ },
375
+ };
376
+
377
+ for (const request of requests) {
378
+ // Check if should ignore
379
+ if (shouldIgnoreRequest(request.url, request.method)) {
380
+ if (includeIgnored) {
381
+ results.ignored.push(request);
382
+ }
383
+ results.stats.ignored++;
384
+ continue;
385
+ }
386
+
387
+ const match = matchRequestToClientCalls(request, clientCalls, { basePath, rewrites });
388
+
389
+ if (match.matched) {
390
+ results.mapped.push(match);
391
+ results.stats.mapped++;
392
+
393
+ const matchType = match.matchType || "http";
394
+ results.stats.byMatchType[matchType] = (results.stats.byMatchType[matchType] || 0) + 1;
395
+ } else {
396
+ results.unmapped.push(match);
397
+ results.stats.unmapped++;
398
+ }
399
+ }
400
+
401
+ return results;
402
+ }
403
+
404
+ /**
405
+ * Group mapped requests by client call
406
+ */
407
+ function groupRequestsByClientCall(mappedResults) {
408
+ const groups = new Map();
409
+
410
+ for (const match of mappedResults) {
411
+ if (!match.bestMatch) continue;
412
+
413
+ const callId = match.bestMatch.id;
414
+ if (!groups.has(callId)) {
415
+ groups.set(callId, {
416
+ clientCall: match.bestMatch,
417
+ requests: [],
418
+ statuses: [],
419
+ });
420
+ }
421
+
422
+ const group = groups.get(callId);
423
+ group.requests.push(match.request);
424
+ if (match.request.status) {
425
+ group.statuses.push(match.request.status);
426
+ }
427
+ }
428
+
429
+ return groups;
430
+ }
431
+
432
+ // =============================================================================
433
+ // EXPORTS
434
+ // =============================================================================
435
+
436
+ module.exports = {
437
+ // Ignore patterns
438
+ IGNORE_PATTERNS,
439
+ shouldIgnoreRequest,
440
+
441
+ // URL normalization
442
+ normalizeRequestUrl,
443
+ extractTrpcOperation,
444
+ extractGraphqlOperation,
445
+
446
+ // Matching
447
+ matchRequestToClientCalls,
448
+ calculateMatchScore,
449
+
450
+ // Batch operations
451
+ mapAllRequests,
452
+ groupRequestsByClientCall,
453
+ };