@agentcash/router 1.2.5 → 1.3.0

package/dist/index.cjs

@@ -1913,6 +1913,8 @@ var RouteBuilder = class {
   _providerConfig;
   /** @internal */
   _validateFn;
+  /** @internal */
+  _mppInfo;
   constructor(key, registry, deps) {
     this._key = key;
     this._registry = registry;
@@ -1936,6 +1938,7 @@ var RouteBuilder = class {
     if (options?.maxPrice) next._maxPrice = options.maxPrice;
     if (options?.minPrice) next._minPrice = options.minPrice;
     if (options?.payTo) next._payTo = options.payTo;
+    if (options?.mpp) next._mppInfo = options.mpp;
     if (typeof pricing === "object" && "tiers" in pricing) {
       for (const [tierKey, tierConfig] of Object.entries(pricing.tiers)) {
         if (!tierKey) {
@@ -2094,7 +2097,8 @@ var RouteBuilder = class {
       apiKeyResolver: this._apiKeyResolver,
       providerName: this._providerName,
       providerConfig: this._providerConfig,
-      validateFn: this._validateFn
+      validateFn: this._validateFn,
+      mppInfo: this._mppInfo
     };
     this._registry.register(entry);
     return createRequestHandler(entry, fn, this._deps);
@@ -2301,7 +2305,7 @@ function deriveTag(routeKey) {
   return routeKey.split("/")[0].split("-").map((w) => w[0].toUpperCase() + w.slice(1)).join(" ");
 }
 function buildOperation(routeKey, entry, tag) {
-  const protocols = entry.protocols.length > 0 ? entry.protocols : void 0;
+  const protocols = entry.protocols.length > 0 ? entry.protocols.map((p) => toProtocolObject(p, entry.mppInfo)) : void 0;
   const paymentRequired = Boolean(entry.pricing) || entry.authMode === "paid";
   const requiresSiwxScheme = entry.authMode === "siwx" || Boolean(entry.siwxEnabled);
   const requiresApiKeyScheme = Boolean(entry.apiKeyResolver) && entry.authMode !== "siwx";
@@ -2361,19 +2365,33 @@ function buildOperation(routeKey, entry, tag) {
     requiresApiKeyScheme
   };
 }
+function toProtocolObject(protocol, mppInfo) {
+  if (protocol === "mpp") {
+    return {
+      mpp: {
+        method: mppInfo?.method ?? "tempo",
+        intent: mppInfo?.intent ?? "charge",
+        currency: mppInfo?.currency ?? "0x20c0000000000000000000000000000000000001"
+      }
+    };
+  }
+  return { [protocol]: {} };
+}
 function buildPricingInfo(entry) {
   if (!entry.pricing) return void 0;
   if (typeof entry.pricing === "string") {
     return {
-      pricingMode: "fixed",
-      price: entry.pricing
+      price: { mode: "fixed", currency: "USD", amount: entry.pricing }
     };
   }
   if (typeof entry.pricing === "function") {
     return {
-      pricingMode: "quote",
-      ...entry.minPrice ? { minPrice: entry.minPrice } : {},
-      ...entry.maxPrice ? { maxPrice: entry.maxPrice } : {}
+      price: {
+        mode: "dynamic",
+        currency: "USD",
+        min: entry.minPrice ?? "0",
+        max: entry.maxPrice ?? "0"
+      }
     };
   }
   if ("tiers" in entry.pricing) {
@@ -2383,19 +2401,20 @@ function buildPricingInfo(entry) {
     if (Number.isFinite(min) && Number.isFinite(max)) {
       if (min === max) {
         return {
-          pricingMode: "fixed",
-          price: String(min)
+          price: { mode: "fixed", currency: "USD", amount: String(min) }
         };
       }
       return {
-        pricingMode: "range",
-        minPrice: String(min),
-        maxPrice: String(max)
+        price: { mode: "dynamic", currency: "USD", min: String(min), max: String(max) }
       };
     }
     return {
-      pricingMode: "quote",
-      ...entry.maxPrice ? { maxPrice: entry.maxPrice } : {}
+      price: {
+        mode: "dynamic",
+        currency: "USD",
+        min: "0",
+        max: entry.maxPrice ?? "0"
+      }
     };
   }
   return void 0;

package/dist/index.d.cts

@@ -241,12 +241,19 @@ interface X402FacilitatorsConfig {
     evm?: X402FacilitatorTarget;
     solana?: X402FacilitatorTarget;
 }
+interface MppProtocolInfo {
+    method?: string;
+    intent?: string;
+    currency?: string;
+}
 interface PaidOptions {
     protocols?: ProtocolType[];
     maxPrice?: string;
     minPrice?: string;
     /** Override the payment recipient. String for static, function for dynamic (receives the Request). */
     payTo?: PayToConfig;
+    /** Override MPP protocol metadata in x-payment-info discovery. */
+    mpp?: MppProtocolInfo;
 }
 interface HandlerContext<TBody = undefined, TQuery = undefined> {
     body: TBody;
@@ -306,6 +313,7 @@ interface RouteEntry {
     providerName?: string;
     providerConfig?: ProviderConfig;
     validateFn?: (body: unknown) => void | Promise<void>;
+    mppInfo?: MppProtocolInfo;
 }
 interface DiscoveryConfig {
     title: string;
@@ -481,6 +489,7 @@ declare class RouteBuilder<TBody = undefined, TQuery = undefined, HasAuth extend
     /** @internal */ _providerName: string | undefined;
     /** @internal */ _providerConfig: ProviderConfig | undefined;
     /** @internal */ _validateFn: ((body: TBody) => void | Promise<void>) | undefined;
+    /** @internal */ _mppInfo: MppProtocolInfo | undefined;
     constructor(key: string, registry: RouteRegistry, deps: OrchestrateDeps);
     private fork;
     paid(pricing: string, options?: PaidOptions): RouteBuilder<TBody, TQuery, True, False, HasBody>;
@@ -553,4 +562,4 @@ declare function createRouter<const P extends Record<string, string> = Record<ne
     prices?: P;
 }): ServiceRouter<Extract<keyof P, string>>;
 
-export { type AlertEvent, type AlertFn, type AlertLevel, type AuthEvent, type AuthMode, type DiscoveryConfig, type EntitlementStore, type ErrorEvent, type HandlerContext, HttpError, MemoryEntitlementStore, MemoryNonceStore, type MonitorEntry, type NonceStore, type OveragePolicy, type PaidOptions, type PayToConfig, type PaymentEvent, type PluginContext, type PricingConfig, type ProtocolType, type ProviderConfig, type ProviderQuotaEvent, type QuotaInfo, type QuotaLevel, type RedisEntitlementStoreOptions, type RedisNonceStoreOptions, type RequestMeta, type ResponseMeta, RouteBuilder, type RouteEntry, RouteRegistry, type RouterConfig, type RouterPlugin, SIWX_CHALLENGE_EXPIRY_MS, type ServiceRouter, type SettlementEvent, type TierConfig, type X402AcceptConfig, type X402FacilitatorTarget, type X402FacilitatorsConfig, type X402ResolvedAccept, type X402RouterFacilitatorConfig, type X402Server, consolePlugin, createRedisEntitlementStore, createRedisNonceStore, createRouter };
+export { type AlertEvent, type AlertFn, type AlertLevel, type AuthEvent, type AuthMode, type DiscoveryConfig, type EntitlementStore, type ErrorEvent, type HandlerContext, HttpError, MemoryEntitlementStore, MemoryNonceStore, type MonitorEntry, type MppProtocolInfo, type NonceStore, type OveragePolicy, type PaidOptions, type PayToConfig, type PaymentEvent, type PluginContext, type PricingConfig, type ProtocolType, type ProviderConfig, type ProviderQuotaEvent, type QuotaInfo, type QuotaLevel, type RedisEntitlementStoreOptions, type RedisNonceStoreOptions, type RequestMeta, type ResponseMeta, RouteBuilder, type RouteEntry, RouteRegistry, type RouterConfig, type RouterPlugin, SIWX_CHALLENGE_EXPIRY_MS, type ServiceRouter, type SettlementEvent, type TierConfig, type X402AcceptConfig, type X402FacilitatorTarget, type X402FacilitatorsConfig, type X402ResolvedAccept, type X402RouterFacilitatorConfig, type X402Server, consolePlugin, createRedisEntitlementStore, createRedisNonceStore, createRouter };

package/dist/index.d.ts

@@ -241,12 +241,19 @@ interface X402FacilitatorsConfig {
     evm?: X402FacilitatorTarget;
     solana?: X402FacilitatorTarget;
 }
+interface MppProtocolInfo {
+    method?: string;
+    intent?: string;
+    currency?: string;
+}
 interface PaidOptions {
     protocols?: ProtocolType[];
     maxPrice?: string;
     minPrice?: string;
     /** Override the payment recipient. String for static, function for dynamic (receives the Request). */
     payTo?: PayToConfig;
+    /** Override MPP protocol metadata in x-payment-info discovery. */
+    mpp?: MppProtocolInfo;
 }
 interface HandlerContext<TBody = undefined, TQuery = undefined> {
     body: TBody;
@@ -306,6 +313,7 @@ interface RouteEntry {
     providerName?: string;
     providerConfig?: ProviderConfig;
     validateFn?: (body: unknown) => void | Promise<void>;
+    mppInfo?: MppProtocolInfo;
 }
 interface DiscoveryConfig {
     title: string;
@@ -481,6 +489,7 @@ declare class RouteBuilder<TBody = undefined, TQuery = undefined, HasAuth extend
     /** @internal */ _providerName: string | undefined;
     /** @internal */ _providerConfig: ProviderConfig | undefined;
     /** @internal */ _validateFn: ((body: TBody) => void | Promise<void>) | undefined;
+    /** @internal */ _mppInfo: MppProtocolInfo | undefined;
     constructor(key: string, registry: RouteRegistry, deps: OrchestrateDeps);
     private fork;
     paid(pricing: string, options?: PaidOptions): RouteBuilder<TBody, TQuery, True, False, HasBody>;
@@ -553,4 +562,4 @@ declare function createRouter<const P extends Record<string, string> = Record<ne
     prices?: P;
 }): ServiceRouter<Extract<keyof P, string>>;
 
-export { type AlertEvent, type AlertFn, type AlertLevel, type AuthEvent, type AuthMode, type DiscoveryConfig, type EntitlementStore, type ErrorEvent, type HandlerContext, HttpError, MemoryEntitlementStore, MemoryNonceStore, type MonitorEntry, type NonceStore, type OveragePolicy, type PaidOptions, type PayToConfig, type PaymentEvent, type PluginContext, type PricingConfig, type ProtocolType, type ProviderConfig, type ProviderQuotaEvent, type QuotaInfo, type QuotaLevel, type RedisEntitlementStoreOptions, type RedisNonceStoreOptions, type RequestMeta, type ResponseMeta, RouteBuilder, type RouteEntry, RouteRegistry, type RouterConfig, type RouterPlugin, SIWX_CHALLENGE_EXPIRY_MS, type ServiceRouter, type SettlementEvent, type TierConfig, type X402AcceptConfig, type X402FacilitatorTarget, type X402FacilitatorsConfig, type X402ResolvedAccept, type X402RouterFacilitatorConfig, type X402Server, consolePlugin, createRedisEntitlementStore, createRedisNonceStore, createRouter };
+export { type AlertEvent, type AlertFn, type AlertLevel, type AuthEvent, type AuthMode, type DiscoveryConfig, type EntitlementStore, type ErrorEvent, type HandlerContext, HttpError, MemoryEntitlementStore, MemoryNonceStore, type MonitorEntry, type MppProtocolInfo, type NonceStore, type OveragePolicy, type PaidOptions, type PayToConfig, type PaymentEvent, type PluginContext, type PricingConfig, type ProtocolType, type ProviderConfig, type ProviderQuotaEvent, type QuotaInfo, type QuotaLevel, type RedisEntitlementStoreOptions, type RedisNonceStoreOptions, type RequestMeta, type ResponseMeta, RouteBuilder, type RouteEntry, RouteRegistry, type RouterConfig, type RouterPlugin, SIWX_CHALLENGE_EXPIRY_MS, type ServiceRouter, type SettlementEvent, type TierConfig, type X402AcceptConfig, type X402FacilitatorTarget, type X402FacilitatorsConfig, type X402ResolvedAccept, type X402RouterFacilitatorConfig, type X402Server, consolePlugin, createRedisEntitlementStore, createRedisNonceStore, createRouter };

package/dist/index.js

@@ -1874,6 +1874,8 @@ var RouteBuilder = class {
   _providerConfig;
   /** @internal */
   _validateFn;
+  /** @internal */
+  _mppInfo;
   constructor(key, registry, deps) {
     this._key = key;
     this._registry = registry;
@@ -1897,6 +1899,7 @@ var RouteBuilder = class {
     if (options?.maxPrice) next._maxPrice = options.maxPrice;
     if (options?.minPrice) next._minPrice = options.minPrice;
     if (options?.payTo) next._payTo = options.payTo;
+    if (options?.mpp) next._mppInfo = options.mpp;
     if (typeof pricing === "object" && "tiers" in pricing) {
       for (const [tierKey, tierConfig] of Object.entries(pricing.tiers)) {
         if (!tierKey) {
@@ -2055,7 +2058,8 @@ var RouteBuilder = class {
       apiKeyResolver: this._apiKeyResolver,
       providerName: this._providerName,
       providerConfig: this._providerConfig,
-      validateFn: this._validateFn
+      validateFn: this._validateFn,
+      mppInfo: this._mppInfo
     };
     this._registry.register(entry);
     return createRequestHandler(entry, fn, this._deps);
@@ -2262,7 +2266,7 @@ function deriveTag(routeKey) {
   return routeKey.split("/")[0].split("-").map((w) => w[0].toUpperCase() + w.slice(1)).join(" ");
 }
 function buildOperation(routeKey, entry, tag) {
-  const protocols = entry.protocols.length > 0 ? entry.protocols : void 0;
+  const protocols = entry.protocols.length > 0 ? entry.protocols.map((p) => toProtocolObject(p, entry.mppInfo)) : void 0;
   const paymentRequired = Boolean(entry.pricing) || entry.authMode === "paid";
   const requiresSiwxScheme = entry.authMode === "siwx" || Boolean(entry.siwxEnabled);
   const requiresApiKeyScheme = Boolean(entry.apiKeyResolver) && entry.authMode !== "siwx";
@@ -2322,19 +2326,33 @@ function buildOperation(routeKey, entry, tag) {
     requiresApiKeyScheme
   };
 }
+function toProtocolObject(protocol, mppInfo) {
+  if (protocol === "mpp") {
+    return {
+      mpp: {
+        method: mppInfo?.method ?? "tempo",
+        intent: mppInfo?.intent ?? "charge",
+        currency: mppInfo?.currency ?? "0x20c0000000000000000000000000000000000001"
+      }
+    };
+  }
+  return { [protocol]: {} };
+}
 function buildPricingInfo(entry) {
   if (!entry.pricing) return void 0;
   if (typeof entry.pricing === "string") {
     return {
-      pricingMode: "fixed",
-      price: entry.pricing
+      price: { mode: "fixed", currency: "USD", amount: entry.pricing }
     };
   }
   if (typeof entry.pricing === "function") {
     return {
-      pricingMode: "quote",
-      ...entry.minPrice ? { minPrice: entry.minPrice } : {},
-      ...entry.maxPrice ? { maxPrice: entry.maxPrice } : {}
+      price: {
+        mode: "dynamic",
+        currency: "USD",
+        min: entry.minPrice ?? "0",
+        max: entry.maxPrice ?? "0"
+      }
     };
   }
   if ("tiers" in entry.pricing) {
@@ -2344,19 +2362,20 @@ function buildPricingInfo(entry) {
     if (Number.isFinite(min) && Number.isFinite(max)) {
       if (min === max) {
         return {
-          pricingMode: "fixed",
-          price: String(min)
+          price: { mode: "fixed", currency: "USD", amount: String(min) }
         };
       }
       return {
-        pricingMode: "range",
-        minPrice: String(min),
-        maxPrice: String(max)
+        price: { mode: "dynamic", currency: "USD", min: String(min), max: String(max) }
       };
     }
     return {
-      pricingMode: "quote",
-      ...entry.maxPrice ? { maxPrice: entry.maxPrice } : {}
+      price: {
+        mode: "dynamic",
+        currency: "USD",
+        min: "0",
+        max: entry.maxPrice ?? "0"
+      }
     };
   }
   return void 0;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agentcash/router",
-  "version": "1.2.5",
+  "version": "1.3.0",
   "description": "Unified route builder for Next.js App Router APIs with x402, MPP, SIWX, and API key auth",
   "type": "module",
   "exports": {