@x402-lens/express 0.2.0 → 0.2.4

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.
package/dist/index.js CHANGED
@@ -12,6 +12,9 @@ import {
12
12
  prometheusSink,
13
13
  resolveConfig,
14
14
  sentryBreadcrumbSink,
15
+ assertLensConfig,
16
+ ConfigError,
17
+ settleResponseFromError,
15
18
  toRoutesConfig
16
19
  } from "@x402-lens/core";
17
20
  import {
@@ -19,7 +22,7 @@ import {
19
22
  x402HTTPResourceServer,
20
23
  x402ResourceServer
21
24
  } from "@x402/core/server";
22
- import { paymentMiddlewareFromHTTPServer } from "@x402/express";
25
+ import { ExpressAdapter, paymentMiddlewareFromHTTPServer } from "@x402/express";
23
26
  import { ExactEvmScheme } from "@x402/evm/exact/server";
24
27
  import { UptoEvmScheme } from "@x402/evm/upto/server";
25
28
  import { ExactSvmScheme } from "@x402/svm/exact/server";
@@ -116,26 +119,50 @@ import {
116
119
  PrometheusRegistry as PrometheusRegistry2,
117
120
  prometheusHandler
118
121
  } from "@x402-lens/core";
122
+ var FACILITATOR_UNAVAILABLE_BODY = {
123
+ error: "facilitator_unavailable",
124
+ code: "FACILITATOR_UNAVAILABLE"
125
+ };
119
126
  function paymentLens(options = {}) {
120
- const config = options.config ?? resolveConfig({
127
+ const config = options.config ? (assertLensConfig(options.config), normalisePassedConfig(options.config)) : resolveConfig({
121
128
  ...options,
122
129
  routes: normaliseRouteInput(options.routes)
123
130
  });
124
131
  return buildLens(config, options);
125
132
  }
126
133
  async function paymentLensAsync(options = {}) {
127
- const config = options.config ?? await loadConfig({
134
+ const config = options.config ? (assertLensConfig(options.config), normalisePassedConfig(options.config)) : await loadConfig({
128
135
  ...options,
129
136
  routes: normaliseRouteInput(options.routes)
130
137
  });
131
138
  return buildLens(config, options);
132
139
  }
140
+ function normalisePassedConfig(config) {
141
+ return {
142
+ ...config,
143
+ facilitatorUrl: config.facilitatorUrl.replace(/\/+$/, "")
144
+ };
145
+ }
133
146
  function normaliseRouteInput(routes) {
134
147
  if (!routes) return void 0;
135
148
  if (Array.isArray(routes)) return routes;
136
- return Object.entries(routes).map(
137
- ([route, value]) => typeof value === "string" ? { route, price: value } : { route, ...value }
138
- );
149
+ return Object.entries(routes).map(([route, value]) => {
150
+ if (typeof value === "string") return { route, price: value };
151
+ if (value && typeof value === "object" && !Array.isArray(value)) {
152
+ return { route, ...value };
153
+ }
154
+ throw new ConfigError(
155
+ "routes",
156
+ `routes["${route}"] must be a price string or an options object, got ${JSON.stringify(value)}.`
157
+ );
158
+ });
159
+ }
160
+ function decodedRoutePath(path) {
161
+ try {
162
+ return decodeURIComponent(path);
163
+ } catch {
164
+ return path;
165
+ }
139
166
  }
140
167
  function buildLens(config, options) {
141
168
  const bus = new EventBus([
@@ -147,58 +174,81 @@ function buildLens(config, options) {
147
174
  const server = new x402ResourceServer(facilitatorClient);
148
175
  const schemes = schemesInUse(config);
149
176
  for (const network of config.networks) registerScheme(server, network, schemes);
177
+ if (options.routesConfig && Object.keys(options.routesConfig).length === 0) {
178
+ throw new ConfigError(
179
+ "routesConfig",
180
+ "routesConfig is empty. Omit it to use config.routes, or pass at least one protected route \u2014 an empty map silently disables payment protection."
181
+ );
182
+ }
150
183
  const routes = options.routesConfig ?? toRoutesConfig(config);
151
184
  attachHooks(server, bus, config);
152
185
  const httpServer = new x402HTTPResourceServer(server, routes);
153
- const inner = paymentMiddlewareFromHTTPServer(httpServer);
186
+ let initFailure;
187
+ let initFailureEmitted = false;
188
+ const emitInitFailure = (error) => {
189
+ if (initFailureEmitted) return;
190
+ initFailureEmitted = true;
191
+ bus.emit(
192
+ makeEvent({
193
+ type: "facilitator.error",
194
+ ts: (/* @__PURE__ */ new Date()).toISOString(),
195
+ requestId: randomUUID(),
196
+ route: "INIT /supported",
197
+ scheme: "exact",
198
+ network: config.network,
199
+ amount: "0",
200
+ asset: "",
201
+ payTo: config.payTo,
202
+ message: error.message
203
+ })
204
+ );
205
+ };
206
+ const ready = httpServer.initialize().then(
207
+ () => void 0,
208
+ (error) => {
209
+ const asError = error instanceof Error ? error : new Error(String(error));
210
+ initFailure = asError;
211
+ emitInitFailure(asError);
212
+ throw asError;
213
+ }
214
+ );
215
+ void ready.catch(() => {
216
+ });
217
+ const inner = paymentMiddlewareFromHTTPServer(
218
+ httpServer,
219
+ void 0,
220
+ void 0,
221
+ false
222
+ );
154
223
  const corsHeaders = buildCorsHeaders(options.cors);
155
- if (options.grant) {
156
- const grant = options.grant;
157
- httpServer.onProtectedRequest(async (context, routeConfig) => {
158
- const method = safeCall(() => context.adapter.getMethod()) ?? "GET";
159
- const path = safeCall(() => context.adapter.getPath()) ?? context.path ?? "/";
160
- const decision = await grant({
161
- method,
162
- path,
163
- route: `${method} ${path}`,
164
- header: (name) => safeCall(() => context.adapter.getHeader(name)),
165
- query: safeCall(() => context.adapter.getQueryParams?.() ?? {}) ?? {},
166
- config: routeConfig
167
- });
168
- if (decision === true) {
169
- bus.emit(
170
- makeEvent({
171
- type: "access.granted",
172
- requestId: currentRequestContext()?.requestId ?? randomUUID(),
173
- route: `${method} ${path}`,
174
- scheme: "exact",
175
- network: config.network,
176
- amount: "0",
177
- asset: "",
178
- payTo: config.payTo
179
- })
180
- );
181
- return { grantAccess: true };
182
- }
183
- if (typeof decision === "string") {
184
- bus.emit(
185
- makeEvent({
186
- type: "access.denied",
187
- requestId: currentRequestContext()?.requestId ?? randomUUID(),
188
- route: `${method} ${path}`,
189
- scheme: "exact",
190
- network: config.network,
191
- amount: "0",
192
- asset: "",
193
- payTo: config.payTo,
194
- reason: decision
195
- })
196
- );
197
- return { abort: true, reason: decision };
198
- }
199
- return void 0;
200
- });
224
+ if (options.cors === true) {
225
+ process.emitWarning(
226
+ '[x402-lens] cors: true does not set Access-Control-Allow-Origin. Pass cors: { origin: "\u2026" } for browser buyers.',
227
+ "X402LensCors"
228
+ );
201
229
  }
230
+ const grant = options.grant;
231
+ const respondFacilitatorUnavailable = (res, requestId, route, error) => {
232
+ bus.emit(
233
+ makeEvent({
234
+ type: "facilitator.error",
235
+ ts: (/* @__PURE__ */ new Date()).toISOString(),
236
+ requestId,
237
+ route,
238
+ scheme: "exact",
239
+ network: config.network,
240
+ amount: "0",
241
+ asset: "",
242
+ payTo: config.payTo,
243
+ message: error.message
244
+ })
245
+ );
246
+ if (!res.headersSent) {
247
+ res.status(502).json(FACILITATOR_UNAVAILABLE_BODY);
248
+ } else if (!res.writableEnded) {
249
+ res.end();
250
+ }
251
+ };
202
252
  const middleware = (req, res, next) => {
203
253
  const context = {
204
254
  requestId: randomUUID(),
@@ -207,6 +257,14 @@ function buildLens(config, options) {
207
257
  path: req.path
208
258
  };
209
259
  if (corsHeaders) applyCorsHeaders(res, corsHeaders);
260
+ if (req.method === "OPTIONS") {
261
+ if (corsHeaders) {
262
+ if (!res.headersSent) res.sendStatus(204);
263
+ return;
264
+ }
265
+ next();
266
+ return;
267
+ }
210
268
  const emitRequired = (paymentRequired) => {
211
269
  const entries = paymentRequired.accepts ?? [];
212
270
  const entry = entries[0];
@@ -227,13 +285,135 @@ function buildLens(config, options) {
227
285
  );
228
286
  };
229
287
  observePaymentRequired(res, emitRequired, { mirrorBody: readableBody });
230
- runWithRequestContext(context, () => inner(req, res, next));
288
+ runWithRequestContext(context, () => {
289
+ void (async () => {
290
+ const adapter = new ExpressAdapter(req);
291
+ const httpContext = {
292
+ adapter,
293
+ path: req.path,
294
+ decodedPath: decodedRoutePath(req.path),
295
+ method: req.method,
296
+ paymentHeader: adapter.getHeader("payment-signature") || adapter.getHeader("x-payment")
297
+ };
298
+ if (!httpServer.requiresPayment(httpContext)) {
299
+ next();
300
+ return;
301
+ }
302
+ if (grant) {
303
+ try {
304
+ const decision = await grant({
305
+ method: context.method,
306
+ path: context.path,
307
+ route: `${context.method} ${context.path}`,
308
+ header: (name) => safeCall(() => adapter.getHeader(name)),
309
+ query: safeCall(() => adapter.getQueryParams?.() ?? {}) ?? {},
310
+ config: matchRouteConfig(config, context.method, context.path)
311
+ });
312
+ if (decision === true) {
313
+ bus.emit(
314
+ makeEvent({
315
+ type: "access.granted",
316
+ requestId: context.requestId,
317
+ route: `${context.method} ${context.path}`,
318
+ scheme: "exact",
319
+ network: config.network,
320
+ amount: "0",
321
+ asset: "",
322
+ payTo: config.payTo
323
+ })
324
+ );
325
+ next();
326
+ return;
327
+ }
328
+ if (typeof decision === "string") {
329
+ bus.emit(
330
+ makeEvent({
331
+ type: "access.denied",
332
+ requestId: context.requestId,
333
+ route: `${context.method} ${context.path}`,
334
+ scheme: "exact",
335
+ network: config.network,
336
+ amount: "0",
337
+ asset: "",
338
+ payTo: config.payTo,
339
+ reason: decision
340
+ })
341
+ );
342
+ if (!res.headersSent) res.status(403).json({ error: "access_denied" });
343
+ return;
344
+ }
345
+ } catch (error) {
346
+ const reason = error instanceof Error ? error.message.slice(0, 200) : "grant_error";
347
+ bus.emit(
348
+ makeEvent({
349
+ type: "access.denied",
350
+ requestId: context.requestId,
351
+ route: `${context.method} ${context.path}`,
352
+ scheme: "exact",
353
+ network: config.network,
354
+ amount: "0",
355
+ asset: "",
356
+ payTo: config.payTo,
357
+ reason
358
+ })
359
+ );
360
+ if (!res.headersSent) {
361
+ res.status(403).json({ error: "access_denied" });
362
+ }
363
+ return;
364
+ }
365
+ }
366
+ try {
367
+ await ready;
368
+ } catch (error) {
369
+ const asError = initFailure ?? (error instanceof Error ? error : new Error(String(error)));
370
+ emitInitFailure(asError);
371
+ if (!res.headersSent) {
372
+ res.status(502).json(FACILITATOR_UNAVAILABLE_BODY);
373
+ } else if (!res.writableEnded) {
374
+ res.end();
375
+ }
376
+ return;
377
+ }
378
+ void Promise.resolve(inner(req, res, next)).catch((error) => {
379
+ const asError = error instanceof Error ? error : new Error(String(error));
380
+ respondFacilitatorUnavailable(
381
+ res,
382
+ context.requestId,
383
+ `${context.method} ${context.path}`,
384
+ asError
385
+ );
386
+ });
387
+ })().catch((error) => {
388
+ const asError = error instanceof Error ? error : new Error(String(error));
389
+ bus.emit(
390
+ makeEvent({
391
+ type: "facilitator.error",
392
+ ts: (/* @__PURE__ */ new Date()).toISOString(),
393
+ requestId: context.requestId,
394
+ route: `${context.method} ${context.path}`,
395
+ scheme: "exact",
396
+ network: config.network,
397
+ amount: "0",
398
+ asset: "",
399
+ payTo: config.payTo,
400
+ message: `middleware: ${asError.message}`
401
+ })
402
+ );
403
+ if (!res.headersSent) {
404
+ res.status(500).json({ error: "internal_error", code: "MIDDLEWARE_ERROR" });
405
+ } else if (!res.writableEnded) {
406
+ res.end();
407
+ }
408
+ });
409
+ });
231
410
  };
232
411
  return {
233
412
  middleware,
234
413
  server,
235
414
  httpServer,
236
415
  config,
416
+ ready,
237
417
  on(listener) {
238
418
  const sink = callbackSink(listener);
239
419
  bus.add(sink);
@@ -246,6 +426,27 @@ function buildLens(config, options) {
246
426
  }
247
427
  };
248
428
  }
429
+ function matchRouteConfig(config, method, path) {
430
+ const candidates = config.routes.filter(
431
+ (route) => route.method === method || route.method === "*"
432
+ );
433
+ const exact = candidates.find((route) => route.path === path);
434
+ if (exact) return exact;
435
+ return candidates.find((route) => pathMatchesPattern(route.path, path));
436
+ }
437
+ function pathMatchesPattern(pattern, path) {
438
+ if (pattern === path) return true;
439
+ const patternParts = pattern.split("/");
440
+ const pathParts = path.split("/");
441
+ if (patternParts.length !== pathParts.length) return false;
442
+ for (let index = 0; index < patternParts.length; index += 1) {
443
+ const expected = patternParts[index] ?? "";
444
+ const actual = pathParts[index] ?? "";
445
+ if (expected.startsWith(":") || expected === "*") continue;
446
+ if (expected !== actual) return false;
447
+ }
448
+ return true;
449
+ }
249
450
  function safeCall(read) {
250
451
  try {
251
452
  return read();
@@ -292,9 +493,10 @@ function buildCorsHeaders(cors) {
292
493
  return headers;
293
494
  }
294
495
  function applyCorsHeaders(res, headers) {
496
+ const replaceHeaders = /* @__PURE__ */ new Set(["access-control-allow-origin", "vary"]);
295
497
  for (const [name, value] of Object.entries(headers)) {
296
498
  const existing = res.getHeader(name);
297
- if (existing === void 0) {
499
+ if (existing === void 0 || replaceHeaders.has(name.toLowerCase())) {
298
500
  res.setHeader(name, value);
299
501
  continue;
300
502
  }
@@ -380,7 +582,7 @@ function attachHooks(server, bus, config) {
380
582
  });
381
583
  server.onSettleFailure(async (context) => {
382
584
  const requirements = context.requirements;
383
- const settle = settleFromError(context.error);
585
+ const settle = settleResponseFromError(context.error);
384
586
  bus.emit(
385
587
  makeEvent({
386
588
  ...baseEvent(requirements, config, settle?.payer),
@@ -425,11 +627,6 @@ function syntheticChallenge(requirements) {
425
627
  accepts: [requirements]
426
628
  };
427
629
  }
428
- function settleFromError(error) {
429
- if (!error || typeof error !== "object") return void 0;
430
- const candidate = error;
431
- return candidate.settleResponse ?? candidate.result ?? candidate.body;
432
- }
433
630
  export {
434
631
  PrometheusRegistry2 as PrometheusRegistry,
435
632
  paymentLens,
package/dist/index.js.map CHANGED
@@ -1 +1 @@
1
- {"version":3,"sources":["../src/index.ts","../src/context.ts","../src/observe.ts"],"sourcesContent":["/**\r\n * `paymentLens()` — x402 v2 payments for Express, with observability that\r\n * explains itself.\r\n *\r\n * This is a thin layer over `@x402/express`, not a reimplementation. The\r\n * official middleware owns the protocol: it builds `PaymentRequired`, sets\r\n * `PAYMENT-REQUIRED`, calls the facilitator's `/verify` and `/settle`, and\r\n * settles only after a successful handler. Everything here attaches to it.\r\n *\r\n * What we add:\r\n *\r\n * - An event per payment lifecycle step, with the fields needed to answer\r\n * \"why did this fail\": route, amount, network, buyer, tx hash, plus findings.\r\n * - A readable 402 body next to the canonical header, so `curl | jq` works.\r\n * - Config loading that refuses to guess a facilitator, network, or address.\r\n */\r\n\r\nimport { randomUUID } from \"node:crypto\";\r\nimport type { NextFunction, Request, RequestHandler, Response } from \"express\";\r\nimport {\r\n EventBus,\r\n PrometheusRegistry,\r\n callbackSink,\r\n consoleSink,\r\n diagnose,\r\n jsonlFileSink,\r\n loadConfig,\r\n makeEvent,\r\n openTelemetrySink,\r\n prometheusSink,\r\n resolveConfig,\r\n sentryBreadcrumbSink,\r\n toRoutesConfig,\r\n type Finding,\r\n type LensConfig,\r\n type LensConfigInput,\r\n type LensEvent,\r\n type LensSink,\r\n type OtelTracerLike,\r\n type PaymentScheme,\r\n type RouteInput,\r\n type SentryLike,\r\n type WirePaymentPayload,\r\n type WirePaymentRequired,\r\n type WireSettleResponse,\r\n type WireVerifyResponse,\r\n} from \"@x402-lens/core\";\r\nimport {\r\n HTTPFacilitatorClient,\r\n x402HTTPResourceServer,\r\n x402ResourceServer,\r\n type FacilitatorClient,\r\n type HTTPRequestContext,\r\n type RoutesConfig,\r\n} from \"@x402/core/server\";\r\nimport { paymentMiddlewareFromHTTPServer } from \"@x402/express\";\r\nimport { ExactEvmScheme } from \"@x402/evm/exact/server\";\r\nimport { UptoEvmScheme } from \"@x402/evm/upto/server\";\r\nimport { ExactSvmScheme } from \"@x402/svm/exact/server\";\r\nimport { UptoSvmScheme } from \"@x402/svm/upto/server\";\r\nimport { currentRequestContext, runWithRequestContext } from \"./context.js\";\r\nimport { observePaymentRequired } from \"./observe.js\";\r\n\r\n/** Where the lens should send events. */\r\nexport interface LensSinkOptions {\r\n /** Print a compact line per event. Defaults to `true`. */\r\n console?: boolean;\r\n /** Append newline-delimited JSON to this path. */\r\n jsonlPath?: string;\r\n /** Called for every event. Exceptions are caught and never reach the caller. */\r\n onEvent?: (event: LensEvent) => void;\r\n /**\r\n * Record counters for Prometheus. Pass `true` for the shared registry, or a\r\n * `PrometheusRegistry` you will serve from `/metrics` via `prometheusHandler`.\r\n */\r\n prometheus?: boolean | PrometheusRegistry;\r\n /**\r\n * OpenTelemetry tracer (`trace.getTracer(\"x402-lens\")`). Opens a short span\r\n * per event. `@opentelemetry/api` is not a dependency of this package.\r\n */\r\n otel?: OtelTracerLike;\r\n /**\r\n * Sentry-compatible handle (`import * as Sentry from \"@sentry/node\"`).\r\n * Records each event as a breadcrumb. Sentry is not a dependency.\r\n */\r\n sentry?: SentryLike;\r\n}\r\n\r\n/** Short route form: a bare price, or the full per-route options. */\r\nexport type RouteMap = Record<string, string | Omit<RouteInput, \"route\">>;\r\n\r\nexport interface PaymentLensOptions extends Omit<LensConfigInput, \"routes\"> {\r\n /**\r\n * Route prices, in either the short map form\r\n * (`{ \"GET /weather\": \"$0.001\" }`) or the `RouteInput[]` form. Overrides the\r\n * config file and `X402_PRICE__*`.\r\n */\r\n routes?: RouteMap | RouteInput[];\r\n /** Pre-resolved config. Skips loading entirely, including validation. */\r\n config?: LensConfig;\r\n /** Where events go. Defaults to console. */\r\n sinks?: LensSinkOptions;\r\n /** Extra sinks, appended after the ones built from `sinks`. */\r\n extraSinks?: LensSink[];\r\n /** Override the `RoutesConfig` handed to `@x402/express`, for advanced setups. */\r\n routesConfig?: RoutesConfig;\r\n /**\r\n * Mirror the decoded challenge into the 402 JSON body. On by default: the v2\r\n * spec leaves the body to the server, and a readable body is the difference\r\n * between a debuggable endpoint and a base64 scavenger hunt.\r\n */\r\n readableBody?: boolean;\r\n /**\r\n * Expose the payment headers for browser buyers. Off by default so an app\r\n * with its own CORS layer is never surprised.\r\n *\r\n * Without this, a cross-origin `fetch()` cannot read `PAYMENT-REQUIRED` or\r\n * `PAYMENT-RESPONSE`, and the browser strips `PAYMENT-SIGNATURE` from the\r\n * retry — the payment silently never happens. `x402-lens inspect` reports it.\r\n *\r\n * Pass `true` to let x402-lens set the headers, or `{ origin }` to also emit\r\n * `Access-Control-Allow-Origin`. If your app already has a CORS middleware,\r\n * leave this off and add the three headers there instead.\r\n */\r\n cors?: boolean | { origin?: string };\r\n /**\r\n * Replace the facilitator client entirely.\r\n *\r\n * For a facilitator that is not plain HTTP (an in-process one, a queue-backed\r\n * one, a proxy that signs requests), or to wrap the SDK client with retries,\r\n * caching, or metrics. When supplied, `facilitatorUrl` is still validated but\r\n * only used for event metadata and doctor output.\r\n */\r\n facilitatorClient?: FacilitatorClient;\r\n /**\r\n * Grant access without payment for a request.\r\n *\r\n * Runs before verification on every request to a protected route. Return\r\n * `true` to let the handler run unpaid (health checks, internal traffic, a\r\n * free tier), or a reason string to deny with a 403. Every decision is\r\n * emitted as `access.granted` / `access.denied`, so a bypass is never silent.\r\n *\r\n * Returning `false`/`undefined` continues to the normal payment flow.\r\n */\r\n grant?: (request: GrantContext) => boolean | string | undefined | Promise<boolean | string | undefined>;\r\n}\r\n\r\nexport interface PaymentLens {\r\n /** Mount in Express before your routes. */\r\n middleware: RequestHandler;\r\n /** The underlying resource server, for custom hooks or extensions. */\r\n server: x402ResourceServer;\r\n /** The underlying HTTP resource server. */\r\n httpServer: x402HTTPResourceServer;\r\n /** Resolved and validated configuration. */\r\n config: LensConfig;\r\n /** Subscribe to events programmatically. */\r\n on(listener: (event: LensEvent) => void): () => void;\r\n /** Flush sinks and stop emitting. */\r\n close(): Promise<void>;\r\n}\r\n\r\n/** What a `grant` callback is given about the request it may let through. */\r\nexport interface GrantContext {\r\n /** HTTP method, e.g. `GET`. */\r\n method: string;\r\n /** Request path, e.g. `/weather`. */\r\n path: string;\r\n /** `\"<METHOD> <path>\"`, the same key the route map uses. */\r\n route: string;\r\n /**\r\n * Read a request header, case-insensitively-ish (exactly as the adapter\r\n * reports it). The SDK gives hooks an accessor rather than a header map, so\r\n * this is a function — use it to check an API key or an internal marker.\r\n */\r\n header(name: string): string | undefined;\r\n /** Query parameters, when the adapter can provide them. */\r\n query: Record<string, string | string[]>;\r\n /** The route's own configuration, including its prices and metadata. */\r\n config: unknown;\r\n}\r\n\r\n/**\r\n * Build x402 payment middleware for Express.\r\n *\r\n * Configuration precedence is explicit options → `X402_*` environment variables.\r\n * Use {@link paymentLensAsync} when it should also read `x402.config.json`.\r\n *\r\n * @param options - Routes, configuration, and sinks\r\n * @returns Middleware plus handles for events and the underlying servers\r\n * @throws {ConfigError} When a required setting is missing or malformed\r\n */\r\nexport function paymentLens(options: PaymentLensOptions = {}): PaymentLens {\r\n const config = options.config ?? resolveConfig({\r\n ...options,\r\n routes: normaliseRouteInput(options.routes),\r\n });\r\n return buildLens(config, options);\r\n}\r\n\r\n/**\r\n * Async variant that also reads `x402.config.json` from the working directory.\r\n *\r\n * @param options - Routes, configuration, and sinks\r\n * @returns Middleware plus handles for events and the underlying servers\r\n * @throws {ConfigError} When a required setting is missing or malformed\r\n */\r\nexport async function paymentLensAsync(\r\n options: PaymentLensOptions = {},\r\n): Promise<PaymentLens> {\r\n const config = options.config ?? await loadConfig({\r\n ...options,\r\n routes: normaliseRouteInput(options.routes),\r\n });\r\n return buildLens(config, options);\r\n}\r\n\r\nfunction normaliseRouteInput(routes: PaymentLensOptions[\"routes\"]): RouteInput[] | undefined {\r\n if (!routes) return undefined;\r\n if (Array.isArray(routes)) return routes;\r\n // A bare string is the common case; an object allows per-route options such as\r\n // `paymentFlow` without dropping to the array form.\r\n return Object.entries(routes).map(([route, value]) =>\r\n typeof value === \"string\" ? { route, price: value } : { route, ...value },\r\n );\r\n}\r\n\r\nfunction buildLens(config: LensConfig, options: PaymentLensOptions): PaymentLens {\r\n const bus = new EventBus([\r\n ...buildSinks(options.sinks),\r\n ...(options.extraSinks ?? []),\r\n ]);\r\n const readableBody = options.readableBody ?? true;\r\n\r\n const facilitatorClient =\r\n options.facilitatorClient ?? buildFacilitatorClient(config);\r\n const server = new x402ResourceServer(facilitatorClient);\r\n const schemes = schemesInUse(config);\r\n for (const network of config.networks) registerScheme(server, network, schemes);\r\n\r\n const routes = options.routesConfig ?? (toRoutesConfig(config) as unknown as RoutesConfig);\r\n\r\n attachHooks(server, bus, config);\r\n\r\n const httpServer = new x402HTTPResourceServer(server, routes);\r\n const inner = paymentMiddlewareFromHTTPServer(httpServer);\r\n const corsHeaders = buildCorsHeaders(options.cors);\r\n\r\n if (options.grant) {\r\n const grant = options.grant;\r\n httpServer.onProtectedRequest(async (context, routeConfig) => {\r\n const method = safeCall(() => context.adapter.getMethod()) ?? \"GET\";\r\n const path = safeCall(() => context.adapter.getPath()) ?? context.path ?? \"/\";\r\n const decision = await grant({\r\n method,\r\n path,\r\n route: `${method} ${path}`,\r\n header: (name: string) => safeCall(() => context.adapter.getHeader(name)),\r\n query: safeCall(() => context.adapter.getQueryParams?.() ?? {}) ?? {},\r\n config: routeConfig,\r\n });\r\n\r\n if (decision === true) {\r\n bus.emit(\r\n makeEvent<LensEvent>({\r\n type: \"access.granted\",\r\n requestId: currentRequestContext()?.requestId ?? randomUUID(),\r\n route: `${method} ${path}`,\r\n scheme: \"exact\",\r\n network: config.network,\r\n amount: \"0\",\r\n asset: \"\",\r\n payTo: config.payTo,\r\n } as LensEvent),\r\n );\r\n return { grantAccess: true };\r\n }\r\n\r\n if (typeof decision === \"string\") {\r\n bus.emit(\r\n makeEvent<LensEvent>({\r\n type: \"access.denied\",\r\n requestId: currentRequestContext()?.requestId ?? randomUUID(),\r\n route: `${method} ${path}`,\r\n scheme: \"exact\",\r\n network: config.network,\r\n amount: \"0\",\r\n asset: \"\",\r\n payTo: config.payTo,\r\n reason: decision,\r\n } as LensEvent),\r\n );\r\n return { abort: true, reason: decision };\r\n }\r\n\r\n return undefined;\r\n });\r\n }\r\n\r\n const middleware: RequestHandler = (req: Request, res: Response, next: NextFunction) => {\r\n const context = {\r\n requestId: randomUUID(),\r\n startedAt: Date.now(),\r\n method: req.method,\r\n path: req.path,\r\n };\r\n\r\n if (corsHeaders) applyCorsHeaders(res, corsHeaders);\r\n\r\n const emitRequired = (paymentRequired: WirePaymentRequired): void => {\r\n const entries = paymentRequired.accepts ?? [];\r\n const entry = entries[0];\r\n bus.emit(\r\n makeEvent<LensEvent>({\r\n type: \"payment.required\",\r\n requestId: context.requestId,\r\n route: `${context.method} ${context.path}`,\r\n scheme: entry?.scheme ?? \"exact\",\r\n network: entry?.network ?? config.network,\r\n amount: entry?.amount ?? \"0\",\r\n asset: entry?.asset ?? \"\",\r\n payTo: entry?.payTo ?? config.payTo,\r\n offers: entries.length,\r\n durationMs: Date.now() - context.startedAt,\r\n findings: diagnose({ paymentRequired, now: context.startedAt }),\r\n } as LensEvent),\r\n );\r\n };\r\n\r\n observePaymentRequired(res, emitRequired, { mirrorBody: readableBody });\r\n\r\n runWithRequestContext(context, () => inner(req, res, next));\r\n };\r\n\r\n return {\r\n middleware,\r\n server,\r\n httpServer,\r\n config,\r\n on(listener) {\r\n const sink = callbackSink(listener);\r\n bus.add(sink);\r\n return () => {\r\n bus.remove(sink);\r\n };\r\n },\r\n close() {\r\n return bus.close();\r\n },\r\n };\r\n}\r\n\r\n/**\r\n * Call an adapter accessor, treating a throw as \"not available\".\r\n *\r\n * Adapters are third-party code; a missing or throwing accessor must not turn\r\n * an access decision into a 500.\r\n */\r\nfunction safeCall<T>(read: () => T): T | undefined {\r\n try {\r\n return read();\r\n } catch {\r\n return undefined;\r\n }\r\n}\r\n\r\n/**\r\n * Build the SDK facilitator client, carrying auth headers and a request\r\n * timeout when configured.\r\n *\r\n * The SDK requires auth headers keyed by endpoint; passing a flat object throws\r\n * at request time, so the shape is validated once here rather than surfacing as\r\n * a failed payment later.\r\n */\r\nfunction buildFacilitatorClient(config: LensConfig): HTTPFacilitatorClient {\r\n const authHeaders = config.facilitatorHeaders;\r\n const timeoutMs = config.facilitatorTimeoutMs;\r\n\r\n return new HTTPFacilitatorClient({\r\n url: config.facilitatorUrl,\r\n ...(timeoutMs !== undefined ? { timeoutMs } : {}),\r\n ...(authHeaders ? { createAuthHeaders: async () => authHeaders } : {}),\r\n });\r\n}\r\n\r\nfunction buildSinks(sinkOptions: LensSinkOptions | undefined): LensSink[] {\r\n const sinks: LensSink[] = [];\r\n if (sinkOptions?.console ?? true) sinks.push(consoleSink());\r\n if (sinkOptions?.jsonlPath) sinks.push(jsonlFileSink(sinkOptions.jsonlPath));\r\n if (sinkOptions?.onEvent) sinks.push(callbackSink(sinkOptions.onEvent));\r\n if (sinkOptions?.prometheus) {\r\n sinks.push(\r\n prometheusSink(\r\n sinkOptions.prometheus === true\r\n ? undefined\r\n : sinkOptions.prometheus,\r\n ),\r\n );\r\n }\r\n if (sinkOptions?.otel) sinks.push(openTelemetrySink(sinkOptions.otel));\r\n if (sinkOptions?.sentry) sinks.push(sentryBreadcrumbSink(sinkOptions.sentry));\r\n return sinks;\r\n}\r\n\r\n/**\r\n * The three headers a browser buyer needs, and nothing else.\r\n *\r\n * A literal `*` does not cover any of them on a credentialed request, so they\r\n * have to be named. `Access-Control-Allow-Headers` also needs `Content-Type`\r\n * whenever the retry carries a JSON body, because that alone triggers a\r\n * preflight before the payment header is even considered.\r\n */\r\nfunction buildCorsHeaders(\r\n cors: PaymentLensOptions[\"cors\"],\r\n): Record<string, string> | undefined {\r\n if (!cors) return undefined;\r\n const headers: Record<string, string> = {\r\n \"Access-Control-Expose-Headers\": \"PAYMENT-REQUIRED, PAYMENT-RESPONSE\",\r\n \"Access-Control-Allow-Headers\": \"Content-Type, PAYMENT-SIGNATURE\",\r\n \"Access-Control-Allow-Methods\": \"GET, POST, PUT, PATCH, DELETE, OPTIONS\",\r\n };\r\n if (typeof cors === \"object\" && cors.origin) {\r\n headers[\"Access-Control-Allow-Origin\"] = cors.origin;\r\n if (cors.origin !== \"*\") headers.Vary = \"Origin\";\r\n }\r\n return headers;\r\n}\r\n\r\n/**\r\n * Merge our headers into whatever the response already has, so an app's own\r\n * CORS layer keeps working.\r\n */\r\nfunction applyCorsHeaders(res: Response, headers: Record<string, string>): void {\r\n for (const [name, value] of Object.entries(headers)) {\r\n const existing = res.getHeader(name);\r\n if (existing === undefined) {\r\n res.setHeader(name, value);\r\n continue;\r\n }\r\n const merged = new Set(\r\n String(existing)\r\n .split(\",\")\r\n .map(part => part.trim())\r\n .filter(Boolean),\r\n );\r\n for (const item of value.split(\",\").map(part => part.trim())) merged.add(item);\r\n res.setHeader(name, Array.from(merged).join(\", \"));\r\n }\r\n}\r\n\r\n/**\r\n * Register the schemes this package supports on one network.\r\n *\r\n * `exact` is always registered; `upto` only when a route asks for it, so the\r\n * challenge for an all-`exact` deployment stays byte-identical to before.\r\n *\r\n * @param server - Resource server to register on\r\n * @param network - CAIP-2 network, already validated\r\n * @param schemes - Schemes any route on this network needs\r\n */\r\nfunction registerScheme(\r\n server: x402ResourceServer,\r\n network: string,\r\n schemes: ReadonlySet<PaymentScheme>,\r\n): void {\r\n const separator = network.indexOf(\":\");\r\n const namespace = separator === -1 ? network : network.slice(0, separator);\r\n // `Network` is a template-literal type; the value was validated as CAIP-2 by\r\n // `resolveConfig` before reaching here.\r\n const caip2 = network as `${string}:${string}`;\r\n\r\n switch (namespace) {\r\n case \"eip155\": {\r\n server.register(caip2, new ExactEvmScheme());\r\n if (schemes.has(\"upto\")) server.register(caip2, new UptoEvmScheme());\r\n return;\r\n }\r\n case \"solana\": {\r\n server.register(caip2, new ExactSvmScheme());\r\n if (schemes.has(\"upto\")) server.register(caip2, new UptoSvmScheme({}));\r\n return;\r\n }\r\n default:\r\n throw new Error(\r\n `[x402-lens] No scheme for namespace \"${namespace}\". This package registers exact (and upto) schemes for eip155 and solana. For any other network, keep the returned server instance and call server.register(network, scheme) yourself.`,\r\n );\r\n }\r\n}\r\n\r\n/** Which schemes the configured routes actually need. */\r\nfunction schemesInUse(config: LensConfig): Set<PaymentScheme> {\r\n const used = new Set<PaymentScheme>();\r\n for (const route of config.routes) used.add(route.scheme ?? \"exact\");\r\n return used;\r\n}\r\n\r\n/** The three fields every event needs from a `PaymentRequirements`. */\r\ninterface RequirementsShape {\r\n scheme: string;\r\n network: string;\r\n amount: string;\r\n asset: string;\r\n payTo: string;\r\n}\r\n\r\nfunction attachHooks(server: x402ResourceServer, bus: EventBus, config: LensConfig): void {\r\n server.onAfterVerify(async context => {\r\n const requirements = context.requirements as unknown as RequirementsShape;\r\n const result = context.result as unknown as WireVerifyResponse;\r\n const payload = context.paymentPayload as unknown as WirePaymentPayload;\r\n const base = baseEvent(requirements, config, result.isValid ? result.payer : undefined);\r\n const findings: Finding[] = diagnose({\r\n verifyResponse: result,\r\n paymentPayload: payload,\r\n paymentRequired: syntheticChallenge(requirements),\r\n });\r\n\r\n if (!result.isValid) {\r\n bus.emit(\r\n makeEvent<LensEvent>({\r\n ...base,\r\n type: \"payment.failed\",\r\n reason: result.invalidReason ?? \"unknown\",\r\n findings,\r\n } as LensEvent),\r\n );\r\n return;\r\n }\r\n\r\n bus.emit(makeEvent<LensEvent>({ ...base, type: \"payment.verified\" } as LensEvent));\r\n });\r\n\r\n server.onVerifyFailure(async context => {\r\n const requirements = context.requirements as unknown as RequirementsShape;\r\n bus.emit(\r\n makeEvent<LensEvent>({\r\n ...baseEvent(requirements, config),\r\n type: \"facilitator.error\",\r\n message: context.error.message,\r\n } as LensEvent),\r\n );\r\n });\r\n\r\n server.onAfterSettle(async context => {\r\n const requirements = context.requirements as unknown as RequirementsShape;\r\n const result = context.result as unknown as WireSettleResponse;\r\n bus.emit(\r\n makeEvent<LensEvent>({\r\n ...baseEvent(requirements, config, result.payer),\r\n type: \"payment.settled\",\r\n txHash: result.transaction ?? \"\",\r\n phase: context.phase,\r\n findings: diagnose({ settleResponse: result }),\r\n } as LensEvent),\r\n );\r\n });\r\n\r\n server.onSettleFailure(async context => {\r\n const requirements = context.requirements as unknown as RequirementsShape;\r\n const settle = settleFromError(context.error);\r\n bus.emit(\r\n makeEvent<LensEvent>({\r\n ...baseEvent(requirements, config, settle?.payer),\r\n type: \"payment.settle_failed\",\r\n reason: settle?.errorReason ?? context.error.message,\r\n ...(settle?.transaction ? { txHash: settle.transaction } : {}),\r\n phase: context.phase,\r\n findings: diagnose({ settleResponse: settle }),\r\n } as LensEvent),\r\n );\r\n });\r\n\r\n server.onVerifiedPaymentCanceled(async context => {\r\n const requirements = context.requirements as unknown as RequirementsShape;\r\n bus.emit(\r\n makeEvent<LensEvent>({\r\n ...baseEvent(requirements, config),\r\n type: \"payment.canceled\",\r\n cancelReason: context.reason,\r\n phase: context.phase,\r\n } as LensEvent),\r\n );\r\n });\r\n}\r\n\r\nfunction baseEvent(\r\n requirements: RequirementsShape,\r\n config: LensConfig,\r\n buyer?: string,\r\n): Omit<LensEvent, \"type\"> {\r\n const context = currentRequestContext();\r\n return {\r\n ts: new Date().toISOString(),\r\n requestId: context?.requestId ?? randomUUID(),\r\n route: `${context?.method ?? \"GET\"} ${context?.path ?? \"/\"}`,\r\n scheme: requirements.scheme ?? \"exact\",\r\n network: requirements.network ?? config.network,\r\n amount: requirements.amount ?? \"0\",\r\n asset: requirements.asset ?? \"\",\r\n payTo: requirements.payTo ?? config.payTo,\r\n ...(buyer ? { buyer } : {}),\r\n ...(context ? { durationMs: Date.now() - context.startedAt } : {}),\r\n } as Omit<LensEvent, \"type\">;\r\n}\r\n\r\n/**\r\n * Hooks receive the matched requirement, not the whole challenge. Rebuilding a\r\n * one-entry challenge lets the same findings rules run on both paths.\r\n */\r\nfunction syntheticChallenge(requirements: RequirementsShape): WirePaymentRequired {\r\n return {\r\n x402Version: 2,\r\n accepts: [requirements as unknown as NonNullable<WirePaymentRequired[\"accepts\"]>[number]],\r\n };\r\n}\r\n\r\n/** Settlement failures arrive as a thrown error carrying the settle response. */\r\nfunction settleFromError(error: unknown): WireSettleResponse | undefined {\r\n if (!error || typeof error !== \"object\") return undefined;\r\n const candidate = error as {\r\n settleResponse?: WireSettleResponse;\r\n result?: WireSettleResponse;\r\n body?: WireSettleResponse;\r\n };\r\n return candidate.settleResponse ?? candidate.result ?? candidate.body;\r\n}\r\n\r\nexport type { HTTPRequestContext };\r\nexport {\r\n PrometheusRegistry,\r\n prometheusHandler,\r\n} from \"@x402-lens/core\";","/**\r\n * Per-request context carried through the async call chain.\r\n *\r\n * The official middleware builds its own `HTTPTransportContext`, so hooks only\r\n * receive a path and method — not the request id or the start time. An\r\n * AsyncLocalStorage store gives hooks the full picture without reaching into\r\n * private fields of the SDK's adapter, and without keying state on a route that\r\n * may have many concurrent requests.\r\n */\r\n\r\nimport { AsyncLocalStorage } from \"node:async_hooks\";\r\n\r\n/** What we know at the moment a request enters our middleware. */\r\nexport interface RequestContext {\r\n requestId: string;\r\n startedAt: number;\r\n method: string;\r\n path: string;\r\n}\r\n\r\nconst storage = new AsyncLocalStorage<RequestContext>();\r\n\r\n/** Run `fn` with `context` bound to the current async chain. */\r\nexport function runWithRequestContext<T>(context: RequestContext, fn: () => T): T {\r\n return storage.run(context, fn);\r\n}\r\n\r\n/** The context for the request currently being handled, if any. */\r\nexport function currentRequestContext(): RequestContext | undefined {\r\n return storage.getStore();\r\n}\r\n","/**\r\n * Observing the 402 without changing it.\r\n *\r\n * The official Express middleware builds `PaymentRequired`, puts it in the\r\n * base64 `PAYMENT-REQUIRED` header, and sends a small JSON body. There is no\r\n * hook for \"a challenge was issued\", so we watch the response instead: wrap the\r\n * few methods that can commit headers or a body, decode the header, and emit.\r\n *\r\n * Everything is restored on `finish`, and nothing we do alters the wire form of\r\n * the header. The one deliberate addition is to the JSON body: v2 treats the\r\n * response body as server-defined, and mirroring the challenge there is what\r\n * makes `curl | jq` usable without base64 in the loop.\r\n */\r\n\r\nimport type { Response } from \"express\";\r\nimport { decodePaymentRequiredHeader } from \"@x402/core/http\";\r\nimport type { WirePaymentRequired } from \"@x402-lens/core\";\r\n\r\n/** Fields a client needs to see without base64-decoding the header. */\r\nexport function bodyFieldsFromChallenge(\r\n paymentRequired: WirePaymentRequired,\r\n): Record<string, unknown> {\r\n return {\r\n x402Version: paymentRequired.x402Version,\r\n ...(paymentRequired.error ? { error: paymentRequired.error } : {}),\r\n ...(paymentRequired.resource ? { resource: paymentRequired.resource } : {}),\r\n ...(paymentRequired.accepts ? { accepts: paymentRequired.accepts } : {}),\r\n };\r\n}\r\n\r\nexport interface ObserveOptions {\r\n /**\r\n * Mirror the decoded challenge into the 402 JSON body. The v2 spec leaves the\r\n * body to the server; a readable body is what makes `curl | jq` usable\r\n * without base64 in the loop. Set false to leave the body untouched.\r\n */\r\n mirrorBody?: boolean;\r\n}\r\n\r\ntype AnyFunction = (...args: unknown[]) => unknown;\r\n\r\ninterface Patchable {\r\n setHeader: AnyFunction;\r\n writeHead: AnyFunction;\r\n json: AnyFunction;\r\n}\r\n\r\n/**\r\n * Attach an observer to one response.\r\n *\r\n * @param res - The Express response to watch\r\n * @param onChallenge - Called once per 402 that carries a decodable challenge\r\n * @param options - Whether to mirror the challenge into the body\r\n * @returns A function that removes the observer early\r\n */\r\nexport function observePaymentRequired(\r\n res: Response,\r\n onChallenge: (paymentRequired: WirePaymentRequired) => void,\r\n options: ObserveOptions = {},\r\n): () => void {\r\n const mirrorBody = options.mirrorBody ?? true;\r\n const target = res as unknown as Patchable;\r\n const originalSetHeader = target.setHeader;\r\n const originalWriteHead = target.writeHead;\r\n const originalJson = target.json;\r\n\r\n let captured: WirePaymentRequired | undefined;\r\n let capturedRaw: string | undefined;\r\n let emitted = false;\r\n let restored = false;\r\n\r\n const capture = (value: unknown): void => {\r\n if (typeof value !== \"string\" || value.length === 0) return;\r\n if (value === capturedRaw) return;\r\n try {\r\n captured = decodePaymentRequiredHeader(value) as unknown as WirePaymentRequired;\r\n capturedRaw = value;\r\n } catch {\r\n // A malformed header is the SDK's problem to surface, not ours.\r\n }\r\n };\r\n\r\n const emitIfChallenge = (): void => {\r\n if (emitted || !captured) return;\r\n emitted = true;\r\n onChallenge(captured);\r\n };\r\n\r\n target.setHeader = function patchedSetHeader(\r\n this: unknown,\r\n name: unknown,\r\n value: unknown,\r\n ) {\r\n if (typeof name === \"string\" && name.toLowerCase() === \"payment-required\") {\r\n capture(value);\r\n }\r\n return originalSetHeader.call(this, name, value);\r\n } as AnyFunction;\r\n\r\n target.writeHead = function patchedWriteHead(\r\n this: unknown,\r\n statusCode: unknown,\r\n ...rest: unknown[]\r\n ) {\r\n if (statusCode === 402) {\r\n // Some setups pass the header bag to writeHead instead of setHeader.\r\n for (const candidate of rest) {\r\n if (candidate && typeof candidate === \"object\") {\r\n for (const [key, value] of Object.entries(candidate as Record<string, unknown>)) {\r\n if (key.toLowerCase() === \"payment-required\") capture(value);\r\n }\r\n }\r\n }\r\n emitIfChallenge();\r\n }\r\n return originalWriteHead.call(this, statusCode, ...rest);\r\n } as AnyFunction;\r\n\r\n target.json = function patchedJson(this: unknown, body: unknown, ...rest: unknown[]) {\r\n if (res.statusCode === 402 && captured) {\r\n emitIfChallenge();\r\n if (!mirrorBody) return originalJson.call(this, body, ...rest);\r\n const base =\r\n body && typeof body === \"object\" && !Array.isArray(body)\r\n ? (body as Record<string, unknown>)\r\n : {};\r\n return originalJson.call(this, { ...base, ...bodyFieldsFromChallenge(captured) }, ...rest);\r\n }\r\n return originalJson.call(this, body, ...rest);\r\n } as AnyFunction;\r\n\r\n const restore = (): void => {\r\n if (restored) return;\r\n restored = true;\r\n target.setHeader = originalSetHeader;\r\n target.writeHead = originalWriteHead;\r\n target.json = originalJson;\r\n res.off(\"finish\", restore);\r\n res.off(\"close\", restore);\r\n };\r\n\r\n res.on(\"finish\", restore);\r\n res.on(\"close\", restore);\r\n\r\n return restore;\r\n}\r\n"],"mappings":"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","names":["PrometheusRegistry"]}
1
+ {"version":3,"sources":["../src/index.ts","../src/context.ts","../src/observe.ts"],"sourcesContent":["/**\r\n * `paymentLens()` — x402 v2 payments for Express, with observability that\r\n * explains itself.\r\n *\r\n * This is a thin layer over `@x402/express`, not a reimplementation. The\r\n * official middleware owns the protocol: it builds `PaymentRequired`, sets\r\n * `PAYMENT-REQUIRED`, calls the facilitator's `/verify` and `/settle`, and\r\n * settles only after a successful handler. Everything here attaches to it.\r\n *\r\n * What we add:\r\n *\r\n * - An event per payment lifecycle step, with the fields needed to answer\r\n * \"why did this fail\": route, amount, network, buyer, tx hash, plus findings.\r\n * - A readable 402 body next to the canonical header, so `curl | jq` works.\r\n * - Config loading that refuses to guess a facilitator, network, or address.\r\n */\r\n\r\nimport { randomUUID } from \"node:crypto\";\r\nimport type { NextFunction, Request, RequestHandler, Response } from \"express\";\r\nimport {\r\n EventBus,\r\n PrometheusRegistry,\r\n callbackSink,\r\n consoleSink,\r\n diagnose,\r\n jsonlFileSink,\r\n loadConfig,\r\n makeEvent,\r\n openTelemetrySink,\r\n prometheusSink,\r\n resolveConfig,\r\n sentryBreadcrumbSink,\r\n assertLensConfig,\r\n ConfigError,\r\n settleResponseFromError,\r\n toRoutesConfig,\r\n type Finding,\r\n type LensConfig,\r\n type LensConfigInput,\r\n type LensEvent,\r\n type LensSink,\r\n type OtelTracerLike,\r\n type PaymentScheme,\r\n type RouteInput,\r\n type RoutePrice,\r\n type SentryLike,\r\n type WirePaymentPayload,\r\n type WirePaymentRequired,\r\n type WireSettleResponse,\r\n type WireVerifyResponse,\r\n} from \"@x402-lens/core\";\r\nimport {\r\n HTTPFacilitatorClient,\r\n x402HTTPResourceServer,\r\n x402ResourceServer,\r\n type FacilitatorClient,\r\n type HTTPRequestContext,\r\n type RoutesConfig,\r\n} from \"@x402/core/server\";\r\nimport { ExpressAdapter, paymentMiddlewareFromHTTPServer } from \"@x402/express\";\r\nimport { ExactEvmScheme } from \"@x402/evm/exact/server\";\r\nimport { UptoEvmScheme } from \"@x402/evm/upto/server\";\r\nimport { ExactSvmScheme } from \"@x402/svm/exact/server\";\r\nimport { UptoSvmScheme } from \"@x402/svm/upto/server\";\r\nimport { currentRequestContext, runWithRequestContext } from \"./context.js\";\r\nimport { observePaymentRequired } from \"./observe.js\";\r\n\r\n/**\r\n * Buyer-facing body when the facilitator cannot be reached at init (or the\r\n * inner middleware rejects for the same reason). Full SDK detail stays on the\r\n * `facilitator.error` event — never in this JSON.\r\n */\r\nconst FACILITATOR_UNAVAILABLE_BODY = {\r\n error: \"facilitator_unavailable\",\r\n code: \"FACILITATOR_UNAVAILABLE\",\r\n} as const;\r\n\r\n/** Where the lens should send events. */\r\nexport interface LensSinkOptions {\r\n /** Print a compact line per event. Defaults to `true`. */\r\n console?: boolean;\r\n /** Append newline-delimited JSON to this path. */\r\n jsonlPath?: string;\r\n /** Called for every event. Exceptions are caught and never reach the caller. */\r\n onEvent?: (event: LensEvent) => void;\r\n /**\r\n * Record counters for Prometheus. Pass `true` for the shared registry, or a\r\n * `PrometheusRegistry` you will serve from `/metrics` via `prometheusHandler`.\r\n */\r\n prometheus?: boolean | PrometheusRegistry;\r\n /**\r\n * OpenTelemetry tracer (`trace.getTracer(\"x402-lens\")`). Opens a short span\r\n * per event. `@opentelemetry/api` is not a dependency of this package.\r\n */\r\n otel?: OtelTracerLike;\r\n /**\r\n * Sentry-compatible handle (`import * as Sentry from \"@sentry/node\"`).\r\n * Records each event as a breadcrumb. Sentry is not a dependency.\r\n */\r\n sentry?: SentryLike;\r\n}\r\n\r\n/** Short route form: a bare price, or the full per-route options. */\r\nexport type RouteMap = Record<string, string | Omit<RouteInput, \"route\">>;\r\n\r\nexport interface PaymentLensOptions extends Omit<LensConfigInput, \"routes\"> {\r\n /**\r\n * Route prices, in either the short map form\r\n * (`{ \"GET /weather\": \"$0.001\" }`) or the `RouteInput[]` form. Overrides the\r\n * config file and `X402_PRICE__*`.\r\n */\r\n routes?: RouteMap | RouteInput[];\r\n /**\r\n * Pre-resolved config. Skips file/env loading, but still runs\r\n * {@link assertLensConfig} (URL, payTo, paths, schemes, headers).\r\n */\r\n config?: LensConfig;\r\n /** Where events go. Defaults to console. */\r\n sinks?: LensSinkOptions;\r\n /** Extra sinks, appended after the ones built from `sinks`. */\r\n extraSinks?: LensSink[];\r\n /** Override the `RoutesConfig` handed to `@x402/express`, for advanced setups. */\r\n routesConfig?: RoutesConfig;\r\n /**\r\n * Mirror the decoded challenge into the 402 JSON body. On by default: the v2\r\n * spec leaves the body to the server, and a readable body is the difference\r\n * between a debuggable endpoint and a base64 scavenger hunt.\r\n */\r\n readableBody?: boolean;\r\n /**\r\n * Expose the payment headers for browser buyers. Off by default so an app\r\n * with its own CORS layer is never surprised.\r\n *\r\n * Without this, a cross-origin `fetch()` cannot read `PAYMENT-REQUIRED` or\r\n * `PAYMENT-RESPONSE`, and the browser strips `PAYMENT-SIGNATURE` from the\r\n * retry — the payment silently never happens. `x402-lens inspect` reports it.\r\n *\r\n * Pass `true` to let x402-lens set the headers, or `{ origin }` to also emit\r\n * `Access-Control-Allow-Origin`. If your app already has a CORS middleware,\r\n * leave this off and add the three headers there instead.\r\n */\r\n cors?: boolean | { origin?: string };\r\n /**\r\n * Replace the facilitator client entirely.\r\n *\r\n * For a facilitator that is not plain HTTP (an in-process one, a queue-backed\r\n * one, a proxy that signs requests), or to wrap the SDK client with retries,\r\n * caching, or metrics. When supplied, `facilitatorUrl` is still validated but\r\n * only used for event metadata and doctor output.\r\n */\r\n facilitatorClient?: FacilitatorClient;\r\n /**\r\n * Grant access without payment for a request.\r\n *\r\n * Runs before verification on every request to a protected route. Return\r\n * `true` to let the handler run unpaid (health checks, internal traffic, a\r\n * free tier), or a reason string to deny with a 403. The buyer always sees\r\n * `{ error: \"access_denied\" }`; the reason is only on the event. Every\r\n * decision emits `access.granted` / `access.denied`.\r\n *\r\n * Returning `false`/`undefined` continues to the normal payment flow.\r\n */\r\n grant?: (request: GrantContext) => boolean | string | undefined | Promise<boolean | string | undefined>;\r\n}\r\n\r\nexport interface PaymentLens {\r\n /** Mount in Express before your routes. */\r\n middleware: RequestHandler;\r\n /** The underlying resource server, for custom hooks or extensions. */\r\n server: x402ResourceServer;\r\n /** The underlying HTTP resource server. */\r\n httpServer: x402HTTPResourceServer;\r\n /** Resolved and validated configuration. */\r\n config: LensConfig;\r\n /**\r\n * Settles when the facilitator `/supported` probe succeeds.\r\n *\r\n * Rejects when the facilitator cannot be reached or advertises no usable\r\n * kinds. Await this before accepting traffic so a dead facilitator fails\r\n * the deploy instead of the first buyer's request.\r\n */\r\n ready: Promise<void>;\r\n /** Subscribe to events programmatically. */\r\n on(listener: (event: LensEvent) => void): () => void;\r\n /** Flush sinks and stop emitting. */\r\n close(): Promise<void>;\r\n}\r\n\r\n/** What a `grant` callback is given about the request it may let through. */\r\nexport interface GrantContext {\r\n /** HTTP method, e.g. `GET`. */\r\n method: string;\r\n /** Request path, e.g. `/weather`. */\r\n path: string;\r\n /** `\"<METHOD> <path>\"`, the same key the route map uses. */\r\n route: string;\r\n /**\r\n * Read a request header, case-insensitively-ish (exactly as the adapter\r\n * reports it). The SDK gives hooks an accessor rather than a header map, so\r\n * this is a function — use it to check an API key or an internal marker.\r\n */\r\n header(name: string): string | undefined;\r\n /** Query parameters, when the adapter can provide them. */\r\n query: Record<string, string | string[]>;\r\n /** The matched route's configuration (price, scheme, metadata), when known. */\r\n config: RouteInput | RoutePrice | undefined;\r\n}\r\n\r\n/**\r\n * Build x402 payment middleware for Express.\r\n *\r\n * Configuration precedence is explicit options → `X402_*` environment variables.\r\n * Use {@link paymentLensAsync} when it should also read `x402.config.json`.\r\n *\r\n * @param options - Routes, configuration, and sinks\r\n * @returns Middleware plus handles for events and the underlying servers\r\n * @throws {ConfigError} When a required setting is missing or malformed\r\n */\r\nexport function paymentLens(options: PaymentLensOptions = {}): PaymentLens {\r\n const config = options.config\r\n ? (assertLensConfig(options.config), normalisePassedConfig(options.config))\r\n : resolveConfig({\r\n ...options,\r\n routes: normaliseRouteInput(options.routes),\r\n });\r\n return buildLens(config, options);\r\n}\r\n\r\n/**\r\n * Async variant that also reads `x402.config.json` from the working directory.\r\n *\r\n * @param options - Routes, configuration, and sinks\r\n * @returns Middleware plus handles for events and the underlying servers\r\n * @throws {ConfigError} When a required setting is missing or malformed\r\n */\r\nexport async function paymentLensAsync(\r\n options: PaymentLensOptions = {},\r\n): Promise<PaymentLens> {\r\n const config = options.config\r\n ? (assertLensConfig(options.config), normalisePassedConfig(options.config))\r\n : await loadConfig({\r\n ...options,\r\n routes: normaliseRouteInput(options.routes),\r\n });\r\n return buildLens(config, options);\r\n}\r\n\r\n/** Match `resolveConfig` trailing-slash stripping for pre-built configs. */\r\nfunction normalisePassedConfig(config: LensConfig): LensConfig {\r\n return {\r\n ...config,\r\n facilitatorUrl: config.facilitatorUrl.replace(/\\/+$/, \"\"),\r\n };\r\n}\r\n\r\nfunction normaliseRouteInput(routes: PaymentLensOptions[\"routes\"]): RouteInput[] | undefined {\r\n if (!routes) return undefined;\r\n if (Array.isArray(routes)) return routes;\r\n // A bare string is the common case; an object allows per-route options such as\r\n // `paymentFlow` without dropping to the array form.\r\n return Object.entries(routes).map(([route, value]) => {\r\n if (typeof value === \"string\") return { route, price: value };\r\n if (value && typeof value === \"object\" && !Array.isArray(value)) {\r\n return { route, ...value };\r\n }\r\n throw new ConfigError(\r\n \"routes\",\r\n `routes[\"${route}\"] must be a price string or an options object, got ${JSON.stringify(value)}.`,\r\n );\r\n });\r\n}\r\n\r\nfunction decodedRoutePath(path: string): string {\r\n try {\r\n return decodeURIComponent(path);\r\n } catch {\r\n return path;\r\n }\r\n}\r\n\r\nfunction buildLens(config: LensConfig, options: PaymentLensOptions): PaymentLens {\r\n const bus = new EventBus([\r\n ...buildSinks(options.sinks),\r\n ...(options.extraSinks ?? []),\r\n ]);\r\n const readableBody = options.readableBody ?? true;\r\n\r\n const facilitatorClient =\r\n options.facilitatorClient ?? buildFacilitatorClient(config);\r\n const server = new x402ResourceServer(facilitatorClient);\r\n const schemes = schemesInUse(config);\r\n for (const network of config.networks) registerScheme(server, network, schemes);\r\n\r\n if (options.routesConfig && Object.keys(options.routesConfig).length === 0) {\r\n throw new ConfigError(\r\n \"routesConfig\",\r\n \"routesConfig is empty. Omit it to use config.routes, or pass at least one protected route — an empty map silently disables payment protection.\",\r\n );\r\n }\r\n const routes = options.routesConfig ?? (toRoutesConfig(config) as unknown as RoutesConfig);\r\n\r\n attachHooks(server, bus, config);\r\n\r\n const httpServer = new x402HTTPResourceServer(server, routes);\r\n let initFailure: Error | undefined;\r\n let initFailureEmitted = false;\r\n\r\n const emitInitFailure = (error: Error): void => {\r\n if (initFailureEmitted) return;\r\n initFailureEmitted = true;\r\n bus.emit(\r\n makeEvent<LensEvent>({\r\n type: \"facilitator.error\",\r\n ts: new Date().toISOString(),\r\n requestId: randomUUID(),\r\n route: \"INIT /supported\",\r\n scheme: \"exact\",\r\n network: config.network,\r\n amount: \"0\",\r\n asset: \"\",\r\n payTo: config.payTo,\r\n message: error.message,\r\n } as LensEvent),\r\n );\r\n };\r\n\r\n // Own the facilitator probe so a failure is observable (`ready` + events)\r\n // instead of an opaque HTTP 500 from the SDK's lazy init path.\r\n const ready = httpServer.initialize().then(\r\n () => undefined,\r\n error => {\r\n const asError = error instanceof Error ? error : new Error(String(error));\r\n initFailure = asError;\r\n emitInitFailure(asError);\r\n throw asError;\r\n },\r\n );\r\n // Keep `ready` rejectable for awaiters, but do not crash the process when\r\n // nobody has attached yet (apps may mount middleware before awaiting ready).\r\n void ready.catch(() => {});\r\n\r\n // Disable the SDK's parallel syncFacilitatorOnStart probe — `ready` above is\r\n // the single source of truth for initialization.\r\n const inner = paymentMiddlewareFromHTTPServer(\r\n httpServer,\r\n undefined,\r\n undefined,\r\n false,\r\n );\r\n const corsHeaders = buildCorsHeaders(options.cors);\r\n if (options.cors === true) {\r\n // #region agent note — surface at build time without throwing\r\n process.emitWarning(\r\n \"[x402-lens] cors: true does not set Access-Control-Allow-Origin. Pass cors: { origin: \\\"…\\\" } for browser buyers.\",\r\n \"X402LensCors\",\r\n );\r\n // #endregion\r\n }\r\n\r\n const grant = options.grant;\r\n\r\n const respondFacilitatorUnavailable = (res: Response, requestId: string, route: string, error: Error): void => {\r\n bus.emit(\r\n makeEvent<LensEvent>({\r\n type: \"facilitator.error\",\r\n ts: new Date().toISOString(),\r\n requestId,\r\n route,\r\n scheme: \"exact\",\r\n network: config.network,\r\n amount: \"0\",\r\n asset: \"\",\r\n payTo: config.payTo,\r\n message: error.message,\r\n } as LensEvent),\r\n );\r\n if (!res.headersSent) {\r\n res.status(502).json(FACILITATOR_UNAVAILABLE_BODY);\r\n } else if (!res.writableEnded) {\r\n res.end();\r\n }\r\n };\r\n\r\n const middleware: RequestHandler = (req: Request, res: Response, next: NextFunction) => {\r\n const context = {\r\n requestId: randomUUID(),\r\n startedAt: Date.now(),\r\n method: req.method,\r\n path: req.path,\r\n };\r\n\r\n if (corsHeaders) applyCorsHeaders(res, corsHeaders);\r\n\r\n // Browser preflight must never hit the payment path (wildcard routes included).\r\n if (req.method === \"OPTIONS\") {\r\n // When lens owns CORS, complete preflight here — otherwise Express 404s\r\n // and browsers never send PAYMENT-SIGNATURE. When cors is off, the app's\r\n // own CORS middleware must answer.\r\n if (corsHeaders) {\r\n if (!res.headersSent) res.sendStatus(204);\r\n return;\r\n }\r\n next();\r\n return;\r\n }\r\n\r\n const emitRequired = (paymentRequired: WirePaymentRequired): void => {\r\n const entries = paymentRequired.accepts ?? [];\r\n const entry = entries[0];\r\n bus.emit(\r\n makeEvent<LensEvent>({\r\n type: \"payment.required\",\r\n requestId: context.requestId,\r\n route: `${context.method} ${context.path}`,\r\n scheme: entry?.scheme ?? \"exact\",\r\n network: entry?.network ?? config.network,\r\n amount: entry?.amount ?? \"0\",\r\n asset: entry?.asset ?? \"\",\r\n payTo: entry?.payTo ?? config.payTo,\r\n offers: entries.length,\r\n durationMs: Date.now() - context.startedAt,\r\n findings: diagnose({ paymentRequired, now: context.startedAt }),\r\n } as LensEvent),\r\n );\r\n };\r\n\r\n observePaymentRequired(res, emitRequired, { mirrorBody: readableBody });\r\n\r\n // Enter ALS before grant/ready so hooks share the same requestId.\r\n runWithRequestContext(context, () => {\r\n void (async () => {\r\n const adapter = new ExpressAdapter(req);\r\n const httpContext = {\r\n adapter,\r\n path: req.path,\r\n decodedPath: decodedRoutePath(req.path),\r\n method: req.method,\r\n paymentHeader:\r\n adapter.getHeader(\"payment-signature\") || adapter.getHeader(\"x-payment\"),\r\n };\r\n\r\n // Unprotected routes must not depend on facilitator readiness (health checks).\r\n if (!httpServer.requiresPayment(httpContext)) {\r\n next();\r\n return;\r\n }\r\n\r\n // Grant runs before ready so internal bypass still works when the\r\n // facilitator is down.\r\n if (grant) {\r\n try {\r\n const decision = await grant({\r\n method: context.method,\r\n path: context.path,\r\n route: `${context.method} ${context.path}`,\r\n header: (name: string) => safeCall(() => adapter.getHeader(name)),\r\n query: safeCall(() => adapter.getQueryParams?.() ?? {}) ?? {},\r\n config: matchRouteConfig(config, context.method, context.path),\r\n });\r\n\r\n if (decision === true) {\r\n bus.emit(\r\n makeEvent<LensEvent>({\r\n type: \"access.granted\",\r\n requestId: context.requestId,\r\n route: `${context.method} ${context.path}`,\r\n scheme: \"exact\",\r\n network: config.network,\r\n amount: \"0\",\r\n asset: \"\",\r\n payTo: config.payTo,\r\n } as LensEvent),\r\n );\r\n next();\r\n return;\r\n }\r\n\r\n if (typeof decision === \"string\") {\r\n bus.emit(\r\n makeEvent<LensEvent>({\r\n type: \"access.denied\",\r\n requestId: context.requestId,\r\n route: `${context.method} ${context.path}`,\r\n scheme: \"exact\",\r\n network: config.network,\r\n amount: \"0\",\r\n asset: \"\",\r\n payTo: config.payTo,\r\n reason: decision,\r\n } as LensEvent),\r\n );\r\n if (!res.headersSent) res.status(403).json({ error: \"access_denied\" });\r\n return;\r\n }\r\n } catch (error) {\r\n const reason =\r\n error instanceof Error ? error.message.slice(0, 200) : \"grant_error\";\r\n bus.emit(\r\n makeEvent<LensEvent>({\r\n type: \"access.denied\",\r\n requestId: context.requestId,\r\n route: `${context.method} ${context.path}`,\r\n scheme: \"exact\",\r\n network: config.network,\r\n amount: \"0\",\r\n asset: \"\",\r\n payTo: config.payTo,\r\n reason,\r\n } as LensEvent),\r\n );\r\n if (!res.headersSent) {\r\n res.status(403).json({ error: \"access_denied\" });\r\n }\r\n return;\r\n }\r\n }\r\n\r\n try {\r\n await ready;\r\n } catch (error) {\r\n const asError =\r\n initFailure ??\r\n (error instanceof Error ? error : new Error(String(error)));\r\n emitInitFailure(asError);\r\n if (!res.headersSent) {\r\n res.status(502).json(FACILITATOR_UNAVAILABLE_BODY);\r\n } else if (!res.writableEnded) {\r\n res.end();\r\n }\r\n return;\r\n }\r\n\r\n void Promise.resolve(inner(req, res, next)).catch((error: unknown) => {\r\n const asError = error instanceof Error ? error : new Error(String(error));\r\n respondFacilitatorUnavailable(\r\n res,\r\n context.requestId,\r\n `${context.method} ${context.path}`,\r\n asError,\r\n );\r\n });\r\n })().catch((error: unknown) => {\r\n const asError = error instanceof Error ? error : new Error(String(error));\r\n bus.emit(\r\n makeEvent<LensEvent>({\r\n type: \"facilitator.error\",\r\n ts: new Date().toISOString(),\r\n requestId: context.requestId,\r\n route: `${context.method} ${context.path}`,\r\n scheme: \"exact\",\r\n network: config.network,\r\n amount: \"0\",\r\n asset: \"\",\r\n payTo: config.payTo,\r\n message: `middleware: ${asError.message}`,\r\n } as LensEvent),\r\n );\r\n if (!res.headersSent) {\r\n res.status(500).json({ error: \"internal_error\", code: \"MIDDLEWARE_ERROR\" });\r\n } else if (!res.writableEnded) {\r\n res.end();\r\n }\r\n });\r\n });\r\n };\r\n\r\n return {\r\n middleware,\r\n server,\r\n httpServer,\r\n config,\r\n ready,\r\n on(listener) {\r\n const sink = callbackSink(listener);\r\n bus.add(sink);\r\n return () => {\r\n bus.remove(sink);\r\n };\r\n },\r\n close() {\r\n return bus.close();\r\n },\r\n };\r\n}\r\n\r\n/**\r\n * Find the configured route that covers this method/path for grant callbacks.\r\n * Exact matches win; then Express-style `:param` / `*` segments; then method `*`.\r\n */\r\nfunction matchRouteConfig(\r\n config: LensConfig,\r\n method: string,\r\n path: string,\r\n): RoutePrice | undefined {\r\n const candidates = config.routes.filter(\r\n route => route.method === method || route.method === \"*\",\r\n );\r\n const exact = candidates.find(route => route.path === path);\r\n if (exact) return exact;\r\n return candidates.find(route => pathMatchesPattern(route.path, path));\r\n}\r\n\r\n/** Match `/users/:id` and `/files/*` style patterns against a request path. */\r\nfunction pathMatchesPattern(pattern: string, path: string): boolean {\r\n if (pattern === path) return true;\r\n const patternParts = pattern.split(\"/\");\r\n const pathParts = path.split(\"/\");\r\n if (patternParts.length !== pathParts.length) return false;\r\n for (let index = 0; index < patternParts.length; index += 1) {\r\n const expected = patternParts[index] ?? \"\";\r\n const actual = pathParts[index] ?? \"\";\r\n if (expected.startsWith(\":\") || expected === \"*\") continue;\r\n if (expected !== actual) return false;\r\n }\r\n return true;\r\n}\r\n\r\n/**\r\n * Call an adapter accessor, treating a throw as \"not available\".\r\n *\r\n * Adapters are third-party code; a missing or throwing accessor must not turn\r\n * an access decision into a 500.\r\n */\r\nfunction safeCall<T>(read: () => T): T | undefined {\r\n try {\r\n return read();\r\n } catch {\r\n return undefined;\r\n }\r\n}\r\n\r\n/**\r\n * Build the SDK facilitator client, carrying auth headers and a request\r\n * timeout when configured.\r\n *\r\n * Auth headers must be keyed by facilitator path (`verify` / `settle` /\r\n * `supported`). Flat objects are rejected by `resolveConfig` before this runs,\r\n * so a misconfigured client never reaches the first payment request as HTTP 500.\r\n */\r\nfunction buildFacilitatorClient(config: LensConfig): HTTPFacilitatorClient {\r\n const authHeaders = config.facilitatorHeaders;\r\n const timeoutMs = config.facilitatorTimeoutMs;\r\n\r\n return new HTTPFacilitatorClient({\r\n url: config.facilitatorUrl,\r\n ...(timeoutMs !== undefined ? { timeoutMs } : {}),\r\n ...(authHeaders ? { createAuthHeaders: async () => authHeaders } : {}),\r\n });\r\n}\r\n\r\nfunction buildSinks(sinkOptions: LensSinkOptions | undefined): LensSink[] {\r\n const sinks: LensSink[] = [];\r\n if (sinkOptions?.console ?? true) sinks.push(consoleSink());\r\n if (sinkOptions?.jsonlPath) sinks.push(jsonlFileSink(sinkOptions.jsonlPath));\r\n if (sinkOptions?.onEvent) sinks.push(callbackSink(sinkOptions.onEvent));\r\n if (sinkOptions?.prometheus) {\r\n sinks.push(\r\n prometheusSink(\r\n sinkOptions.prometheus === true\r\n ? undefined\r\n : sinkOptions.prometheus,\r\n ),\r\n );\r\n }\r\n if (sinkOptions?.otel) sinks.push(openTelemetrySink(sinkOptions.otel));\r\n if (sinkOptions?.sentry) sinks.push(sentryBreadcrumbSink(sinkOptions.sentry));\r\n return sinks;\r\n}\r\n\r\n/**\r\n * The three headers a browser buyer needs, and nothing else.\r\n *\r\n * A literal `*` does not cover any of them on a credentialed request, so they\r\n * have to be named. `Access-Control-Allow-Headers` also needs `Content-Type`\r\n * whenever the retry carries a JSON body, because that alone triggers a\r\n * preflight before the payment header is even considered.\r\n */\r\nfunction buildCorsHeaders(\r\n cors: PaymentLensOptions[\"cors\"],\r\n): Record<string, string> | undefined {\r\n if (!cors) return undefined;\r\n const headers: Record<string, string> = {\r\n \"Access-Control-Expose-Headers\": \"PAYMENT-REQUIRED, PAYMENT-RESPONSE\",\r\n \"Access-Control-Allow-Headers\": \"Content-Type, PAYMENT-SIGNATURE\",\r\n \"Access-Control-Allow-Methods\": \"GET, POST, PUT, PATCH, DELETE, OPTIONS\",\r\n };\r\n if (typeof cors === \"object\" && cors.origin) {\r\n headers[\"Access-Control-Allow-Origin\"] = cors.origin;\r\n if (cors.origin !== \"*\") headers.Vary = \"Origin\";\r\n }\r\n return headers;\r\n}\r\n\r\n/**\r\n * Merge our headers into whatever the response already has, so an app's own\r\n * CORS layer keeps working.\r\n *\r\n * List headers (Expose/Allow-Headers/Methods) are unioned. Singleton CORS\r\n * headers (`Access-Control-Allow-Origin`, `Vary`) replace — comma-joining ACAO\r\n * produces a value browsers reject.\r\n */\r\nfunction applyCorsHeaders(res: Response, headers: Record<string, string>): void {\r\n const replaceHeaders = new Set([\"access-control-allow-origin\", \"vary\"]);\r\n for (const [name, value] of Object.entries(headers)) {\r\n const existing = res.getHeader(name);\r\n if (existing === undefined || replaceHeaders.has(name.toLowerCase())) {\r\n res.setHeader(name, value);\r\n continue;\r\n }\r\n const merged = new Set(\r\n String(existing)\r\n .split(\",\")\r\n .map(part => part.trim())\r\n .filter(Boolean),\r\n );\r\n for (const item of value.split(\",\").map(part => part.trim())) merged.add(item);\r\n res.setHeader(name, Array.from(merged).join(\", \"));\r\n }\r\n}\r\n\r\n/**\r\n * Register the schemes this package supports on one network.\r\n *\r\n * `exact` is always registered; `upto` only when a route asks for it, so the\r\n * challenge for an all-`exact` deployment stays byte-identical to before.\r\n *\r\n * @param server - Resource server to register on\r\n * @param network - CAIP-2 network, already validated\r\n * @param schemes - Schemes any route on this network needs\r\n */\r\nfunction registerScheme(\r\n server: x402ResourceServer,\r\n network: string,\r\n schemes: ReadonlySet<PaymentScheme>,\r\n): void {\r\n const separator = network.indexOf(\":\");\r\n const namespace = separator === -1 ? network : network.slice(0, separator);\r\n // `Network` is a template-literal type; the value was validated as CAIP-2 by\r\n // `resolveConfig` before reaching here.\r\n const caip2 = network as `${string}:${string}`;\r\n\r\n switch (namespace) {\r\n case \"eip155\": {\r\n server.register(caip2, new ExactEvmScheme());\r\n if (schemes.has(\"upto\")) server.register(caip2, new UptoEvmScheme());\r\n return;\r\n }\r\n case \"solana\": {\r\n server.register(caip2, new ExactSvmScheme());\r\n if (schemes.has(\"upto\")) server.register(caip2, new UptoSvmScheme({}));\r\n return;\r\n }\r\n default:\r\n throw new Error(\r\n `[x402-lens] No scheme for namespace \"${namespace}\". This package registers exact (and upto) schemes for eip155 and solana. For any other network, keep the returned server instance and call server.register(network, scheme) yourself.`,\r\n );\r\n }\r\n}\r\n\r\n/** Which schemes the configured routes actually need. */\r\nfunction schemesInUse(config: LensConfig): Set<PaymentScheme> {\r\n const used = new Set<PaymentScheme>();\r\n for (const route of config.routes) used.add(route.scheme ?? \"exact\");\r\n return used;\r\n}\r\n\r\n/** The three fields every event needs from a `PaymentRequirements`. */\r\ninterface RequirementsShape {\r\n scheme: string;\r\n network: string;\r\n amount: string;\r\n asset: string;\r\n payTo: string;\r\n}\r\n\r\nfunction attachHooks(server: x402ResourceServer, bus: EventBus, config: LensConfig): void {\r\n server.onAfterVerify(async context => {\r\n const requirements = context.requirements as unknown as RequirementsShape;\r\n const result = context.result as unknown as WireVerifyResponse;\r\n const payload = context.paymentPayload as unknown as WirePaymentPayload;\r\n const base = baseEvent(requirements, config, result.isValid ? result.payer : undefined);\r\n const findings: Finding[] = diagnose({\r\n verifyResponse: result,\r\n paymentPayload: payload,\r\n paymentRequired: syntheticChallenge(requirements),\r\n });\r\n\r\n if (!result.isValid) {\r\n bus.emit(\r\n makeEvent<LensEvent>({\r\n ...base,\r\n type: \"payment.failed\",\r\n reason: result.invalidReason ?? \"unknown\",\r\n findings,\r\n } as LensEvent),\r\n );\r\n return;\r\n }\r\n\r\n bus.emit(makeEvent<LensEvent>({ ...base, type: \"payment.verified\" } as LensEvent));\r\n });\r\n\r\n server.onVerifyFailure(async context => {\r\n const requirements = context.requirements as unknown as RequirementsShape;\r\n bus.emit(\r\n makeEvent<LensEvent>({\r\n ...baseEvent(requirements, config),\r\n type: \"facilitator.error\",\r\n message: context.error.message,\r\n } as LensEvent),\r\n );\r\n });\r\n\r\n server.onAfterSettle(async context => {\r\n const requirements = context.requirements as unknown as RequirementsShape;\r\n const result = context.result as unknown as WireSettleResponse;\r\n bus.emit(\r\n makeEvent<LensEvent>({\r\n ...baseEvent(requirements, config, result.payer),\r\n type: \"payment.settled\",\r\n txHash: result.transaction ?? \"\",\r\n phase: context.phase,\r\n findings: diagnose({ settleResponse: result }),\r\n } as LensEvent),\r\n );\r\n });\r\n\r\n server.onSettleFailure(async context => {\r\n const requirements = context.requirements as unknown as RequirementsShape;\r\n const settle = settleResponseFromError(context.error);\r\n bus.emit(\r\n makeEvent<LensEvent>({\r\n ...baseEvent(requirements, config, settle?.payer),\r\n type: \"payment.settle_failed\",\r\n reason: settle?.errorReason ?? context.error.message,\r\n ...(settle?.transaction ? { txHash: settle.transaction } : {}),\r\n phase: context.phase,\r\n findings: diagnose({ settleResponse: settle }),\r\n } as LensEvent),\r\n );\r\n });\r\n\r\n server.onVerifiedPaymentCanceled(async context => {\r\n const requirements = context.requirements as unknown as RequirementsShape;\r\n bus.emit(\r\n makeEvent<LensEvent>({\r\n ...baseEvent(requirements, config),\r\n type: \"payment.canceled\",\r\n cancelReason: context.reason,\r\n phase: context.phase,\r\n } as LensEvent),\r\n );\r\n });\r\n}\r\n\r\nfunction baseEvent(\r\n requirements: RequirementsShape,\r\n config: LensConfig,\r\n buyer?: string,\r\n): Omit<LensEvent, \"type\"> {\r\n const context = currentRequestContext();\r\n return {\r\n ts: new Date().toISOString(),\r\n requestId: context?.requestId ?? randomUUID(),\r\n route: `${context?.method ?? \"GET\"} ${context?.path ?? \"/\"}`,\r\n scheme: requirements.scheme ?? \"exact\",\r\n network: requirements.network ?? config.network,\r\n amount: requirements.amount ?? \"0\",\r\n asset: requirements.asset ?? \"\",\r\n payTo: requirements.payTo ?? config.payTo,\r\n ...(buyer ? { buyer } : {}),\r\n ...(context ? { durationMs: Date.now() - context.startedAt } : {}),\r\n } as Omit<LensEvent, \"type\">;\r\n}\r\n\r\n/**\r\n * Hooks receive the matched requirement, not the whole challenge. Rebuilding a\r\n * one-entry challenge lets the same findings rules run on both paths.\r\n */\r\nfunction syntheticChallenge(requirements: RequirementsShape): WirePaymentRequired {\r\n return {\r\n x402Version: 2,\r\n accepts: [requirements as unknown as NonNullable<WirePaymentRequired[\"accepts\"]>[number]],\r\n };\r\n}\r\n\r\nexport type { HTTPRequestContext };\r\nexport {\r\n PrometheusRegistry,\r\n prometheusHandler,\r\n} from \"@x402-lens/core\";","/**\r\n * Per-request context carried through the async call chain.\r\n *\r\n * The official middleware builds its own `HTTPTransportContext`, so hooks only\r\n * receive a path and method — not the request id or the start time. An\r\n * AsyncLocalStorage store gives hooks the full picture without reaching into\r\n * private fields of the SDK's adapter, and without keying state on a route that\r\n * may have many concurrent requests.\r\n */\r\n\r\nimport { AsyncLocalStorage } from \"node:async_hooks\";\r\n\r\n/** What we know at the moment a request enters our middleware. */\r\nexport interface RequestContext {\r\n requestId: string;\r\n startedAt: number;\r\n method: string;\r\n path: string;\r\n}\r\n\r\nconst storage = new AsyncLocalStorage<RequestContext>();\r\n\r\n/** Run `fn` with `context` bound to the current async chain. */\r\nexport function runWithRequestContext<T>(context: RequestContext, fn: () => T): T {\r\n return storage.run(context, fn);\r\n}\r\n\r\n/** The context for the request currently being handled, if any. */\r\nexport function currentRequestContext(): RequestContext | undefined {\r\n return storage.getStore();\r\n}\r\n","/**\r\n * Observing the 402 without changing it.\r\n *\r\n * The official Express middleware builds `PaymentRequired`, puts it in the\r\n * base64 `PAYMENT-REQUIRED` header, and sends a small JSON body. There is no\r\n * hook for \"a challenge was issued\", so we watch the response instead: wrap the\r\n * few methods that can commit headers or a body, decode the header, and emit.\r\n *\r\n * Everything is restored on `finish`, and nothing we do alters the wire form of\r\n * the header. The one deliberate addition is to the JSON body: v2 treats the\r\n * response body as server-defined, and mirroring the challenge there is what\r\n * makes `curl | jq` usable without base64 in the loop.\r\n */\r\n\r\nimport type { Response } from \"express\";\r\nimport { decodePaymentRequiredHeader } from \"@x402/core/http\";\r\nimport type { WirePaymentRequired } from \"@x402-lens/core\";\r\n\r\n/** Fields a client needs to see without base64-decoding the header. */\r\nexport function bodyFieldsFromChallenge(\r\n paymentRequired: WirePaymentRequired,\r\n): Record<string, unknown> {\r\n return {\r\n x402Version: paymentRequired.x402Version,\r\n ...(paymentRequired.error ? { error: paymentRequired.error } : {}),\r\n ...(paymentRequired.resource ? { resource: paymentRequired.resource } : {}),\r\n ...(paymentRequired.accepts ? { accepts: paymentRequired.accepts } : {}),\r\n };\r\n}\r\n\r\nexport interface ObserveOptions {\r\n /**\r\n * Mirror the decoded challenge into the 402 JSON body. The v2 spec leaves the\r\n * body to the server; a readable body is what makes `curl | jq` usable\r\n * without base64 in the loop. Set false to leave the body untouched.\r\n */\r\n mirrorBody?: boolean;\r\n}\r\n\r\ntype AnyFunction = (...args: unknown[]) => unknown;\r\n\r\ninterface Patchable {\r\n setHeader: AnyFunction;\r\n writeHead: AnyFunction;\r\n json: AnyFunction;\r\n}\r\n\r\n/**\r\n * Attach an observer to one response.\r\n *\r\n * @param res - The Express response to watch\r\n * @param onChallenge - Called once per 402 that carries a decodable challenge\r\n * @param options - Whether to mirror the challenge into the body\r\n * @returns A function that removes the observer early\r\n */\r\nexport function observePaymentRequired(\r\n res: Response,\r\n onChallenge: (paymentRequired: WirePaymentRequired) => void,\r\n options: ObserveOptions = {},\r\n): () => void {\r\n const mirrorBody = options.mirrorBody ?? true;\r\n const target = res as unknown as Patchable;\r\n const originalSetHeader = target.setHeader;\r\n const originalWriteHead = target.writeHead;\r\n const originalJson = target.json;\r\n\r\n let captured: WirePaymentRequired | undefined;\r\n let capturedRaw: string | undefined;\r\n let emitted = false;\r\n let restored = false;\r\n\r\n const capture = (value: unknown): void => {\r\n if (typeof value !== \"string\" || value.length === 0) return;\r\n if (value === capturedRaw) return;\r\n try {\r\n captured = decodePaymentRequiredHeader(value) as unknown as WirePaymentRequired;\r\n capturedRaw = value;\r\n } catch {\r\n // A malformed header is the SDK's problem to surface, not ours.\r\n }\r\n };\r\n\r\n const emitIfChallenge = (): void => {\r\n if (emitted || !captured) return;\r\n emitted = true;\r\n onChallenge(captured);\r\n };\r\n\r\n target.setHeader = function patchedSetHeader(\r\n this: unknown,\r\n name: unknown,\r\n value: unknown,\r\n ) {\r\n if (typeof name === \"string\" && name.toLowerCase() === \"payment-required\") {\r\n capture(value);\r\n }\r\n return originalSetHeader.call(this, name, value);\r\n } as AnyFunction;\r\n\r\n target.writeHead = function patchedWriteHead(\r\n this: unknown,\r\n statusCode: unknown,\r\n ...rest: unknown[]\r\n ) {\r\n if (statusCode === 402) {\r\n // Some setups pass the header bag to writeHead instead of setHeader.\r\n for (const candidate of rest) {\r\n if (candidate && typeof candidate === \"object\") {\r\n for (const [key, value] of Object.entries(candidate as Record<string, unknown>)) {\r\n if (key.toLowerCase() === \"payment-required\") capture(value);\r\n }\r\n }\r\n }\r\n emitIfChallenge();\r\n }\r\n return originalWriteHead.call(this, statusCode, ...rest);\r\n } as AnyFunction;\r\n\r\n target.json = function patchedJson(this: unknown, body: unknown, ...rest: unknown[]) {\r\n if (res.statusCode === 402 && captured) {\r\n emitIfChallenge();\r\n if (!mirrorBody) return originalJson.call(this, body, ...rest);\r\n const base =\r\n body && typeof body === \"object\" && !Array.isArray(body)\r\n ? (body as Record<string, unknown>)\r\n : {};\r\n return originalJson.call(this, { ...base, ...bodyFieldsFromChallenge(captured) }, ...rest);\r\n }\r\n return originalJson.call(this, body, ...rest);\r\n } as AnyFunction;\r\n\r\n const restore = (): void => {\r\n if (restored) return;\r\n restored = true;\r\n target.setHeader = originalSetHeader;\r\n target.writeHead = originalWriteHead;\r\n target.json = originalJson;\r\n res.off(\"finish\", restore);\r\n res.off(\"close\", restore);\r\n };\r\n\r\n res.on(\"finish\", restore);\r\n res.on(\"close\", restore);\r\n\r\n return restore;\r\n}\r\n"],"mappings":"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","names":["PrometheusRegistry"]}