@relai-fi/x402 0.5.31 → 0.5.33

package/dist/index.d.cts

@@ -1,4 +1,4 @@
-export { DynamicPrice, PaymentInfo, ProtectOptions, default as Relai, RelaiIntegritasFlow, RelaiIntegritasOptions, RelaiServerConfig, SettleResult, StripePayTo, default, stripePayTo } from './server.cjs';
+export { D as DynamicPrice, F as FreeTierPluginConfig, b as PaymentInfo, g as PluginContext, h as PluginResult, P as ProtectOptions, R as Relai, d as RelaiIntegritasFlow, e as RelaiIntegritasOptions, f as RelaiPlugin, a as RelaiServerConfig, S as SettleResult, c as StripePayTo, R as default, s as stripePayTo } from './server-BAPqyEka.cjs';
 export { RelayWebSocketFactory, RelayWebSocketLike, X402Client, X402ClientConfig, X402FetchInit, X402IntegritasConfig, X402IntegritasFlow, X402NetworkSelectionMode, X402RelayWsConfig, X402RelayWsError, X402RelayWsResponse, X402RequestOptions, default as createX402Client } from './client.cjs';
 export { A as AcceptsExtra, B as BASE_MAINNET_NETWORK, C as CAIP2_TO_NETWORK, b as CHAIN_IDS, E as EXPLORER_TX_URL, l as EvmWallet, N as NETWORK_CAIP2, e as NETWORK_LABELS, d as NETWORK_TOKENS, c as NetworkToken, P as PaymentAccept, o as PaymentRequired, R as RELAI_FACILITATOR_URL, h as RELAI_NETWORKS, a as RelaiNetwork, m as ResourceInfo, S as SOLANA_MAINNET_NETWORK, k as SolanaWallet, U as USDC_ADDRESSES, g as USDC_BASE, f as USDC_SOLANA, W as WalletSet, j as isEvm, i as isSolana, n as normalizeNetwork, r as resolveToken } from './types-Y9ni5XwY.cjs';
 export { BridgeBalances, BridgeQuoteResult, BridgeResult } from './management.cjs';

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-export { DynamicPrice, PaymentInfo, ProtectOptions, default as Relai, RelaiIntegritasFlow, RelaiIntegritasOptions, RelaiServerConfig, SettleResult, StripePayTo, default, stripePayTo } from './server.js';
+export { D as DynamicPrice, F as FreeTierPluginConfig, b as PaymentInfo, g as PluginContext, h as PluginResult, P as ProtectOptions, R as Relai, d as RelaiIntegritasFlow, e as RelaiIntegritasOptions, f as RelaiPlugin, a as RelaiServerConfig, S as SettleResult, c as StripePayTo, R as default, s as stripePayTo } from './server-BRSLRU_Y.js';
 export { RelayWebSocketFactory, RelayWebSocketLike, X402Client, X402ClientConfig, X402FetchInit, X402IntegritasConfig, X402IntegritasFlow, X402NetworkSelectionMode, X402RelayWsConfig, X402RelayWsError, X402RelayWsResponse, X402RequestOptions, default as createX402Client } from './client.js';
 export { A as AcceptsExtra, B as BASE_MAINNET_NETWORK, C as CAIP2_TO_NETWORK, b as CHAIN_IDS, E as EXPLORER_TX_URL, l as EvmWallet, N as NETWORK_CAIP2, e as NETWORK_LABELS, d as NETWORK_TOKENS, c as NetworkToken, P as PaymentAccept, o as PaymentRequired, R as RELAI_FACILITATOR_URL, h as RELAI_NETWORKS, a as RelaiNetwork, m as ResourceInfo, S as SOLANA_MAINNET_NETWORK, k as SolanaWallet, U as USDC_ADDRESSES, g as USDC_BASE, f as USDC_SOLANA, W as WalletSet, j as isEvm, i as isSolana, n as normalizeNetwork, r as resolveToken } from './types-Y9ni5XwY.js';
 export { BridgeBalances, BridgeQuoteResult, BridgeResult } from './management.js';

package/dist/index.js

@@ -448,11 +448,23 @@ async function createStripeDepositAddress(secretKey, amountUsdCents, network = "
   return address;
 }
 var Relai = class {
-  // Cache feePayer per network
   constructor(config) {
     this.feePayerCache = /* @__PURE__ */ new Map();
+    this.pluginInitPromise = null;
     this.network = config.network;
     this.facilitatorUrl = config.facilitatorUrl || RELAI_FACILITATOR_URL;
+    this.plugins = config.plugins ?? [];
+  }
+  async runPluginInit() {
+    for (const plugin of this.plugins) {
+      if (plugin.onInit) {
+        try {
+          await plugin.onInit();
+        } catch (err) {
+          console.warn(`[Relai] Plugin '${plugin.name}' init failed:`, err);
+        }
+      }
+    }
   }
   /**
    * Get feePayer address for a network (cached)
@@ -543,6 +555,38 @@ var Relai = class {
         const integritasFlow = headerIntegritasFlow || configuredIntegritas.flow;
         const integritasMode = integritasFlow === "single" ? "single_signature_fee_included" : integritasFlow === "dual" ? "dual_signature_split" : void 0;
         const paymentHeader = req.headers["x-payment"] || req.headers["payment-signature"] || req.headers["x-payment-signature"];
+        if (!paymentHeader && self.plugins.length > 0) {
+          if (!self.pluginInitPromise) {
+            self.pluginInitPromise = self.runPluginInit();
+          }
+          await self.pluginInitPromise;
+          const pluginCtx = {
+            network,
+            price: resolvedPrice,
+            path: req.path || req.originalUrl || "/",
+            method: (req.method || "GET").toUpperCase()
+          };
+          for (const plugin of self.plugins) {
+            if (!plugin.beforePaymentCheck) continue;
+            try {
+              const pluginResult = await plugin.beforePaymentCheck(req, pluginCtx);
+              if (pluginResult?.skip) {
+                if (pluginResult.headers) {
+                  for (const [k, v] of Object.entries(pluginResult.headers)) {
+                    res.setHeader(k, v);
+                  }
+                }
+                req.pluginMeta = { ...req.pluginMeta || {}, ...pluginResult.meta || {} };
+                req.x402Paid = false;
+                req.x402Free = true;
+                req.x402Plugin = plugin.name;
+                return next();
+              }
+            } catch (pluginErr) {
+              console.warn(`[Relai] Plugin '${plugin.name}' beforePaymentCheck error (non-blocking):`, pluginErr);
+            }
+          }
+        }
         if (!paymentHeader) {
           options.onPaymentRequired?.(req, { price: resolvedPrice, network });
           let resolvedPayTo;
@@ -681,6 +725,22 @@ var Relai = class {
           Buffer.from(JSON.stringify(paymentResponse)).toString("base64")
         );
         options.onPaymentSettled?.(req, result);
+        if (self.plugins.length > 0) {
+          const settleCtx = {
+            network,
+            price: resolvedPrice,
+            path: req.path || req.originalUrl || "/",
+            method: (req.method || "GET").toUpperCase()
+          };
+          for (const plugin of self.plugins) {
+            if (!plugin.afterSettled) continue;
+            try {
+              await plugin.afterSettled(req, result, settleCtx);
+            } catch (pluginErr) {
+              console.warn(`[Relai] Plugin '${plugin.name}' afterSettled error (non-blocking):`, pluginErr);
+            }
+          }
+        }
         if (options.customRules) {
           const valid = await options.customRules(req);
           if (!valid) {