@solvapay/mcp-core 0.4.3 → 0.4.4

package/dist/index.cjs

@@ -2047,7 +2047,7 @@ function snapshotFromLimits(params) {
   };
 }
 function buildResponseContext(params) {
-  const { customerRef, limits, product, bootstrapProduct, solvaPay } = params;
+  const { customerRef, limits, product, bootstrapProduct, solvaPay, freeLimit } = params;
   const bootstrapPlan = params.bootstrapPlan ?? synthesizePlanStub(limits);
   const emittedBlocks = [];
   const abortController = new AbortController();
@@ -2055,7 +2055,8 @@ function buildResponseContext(params) {
     const freshLimits = await solvaPay.checkLimits({
       customerRef,
       productRef: product,
-      meterName: "requests"
+      meterName: freeLimit?.meter ?? "requests",
+      ...freeLimit ? { freeAllowance: freeLimit } : {}
     });
     return snapshotFromLimits({
       customerRef,
@@ -2109,7 +2110,7 @@ function buildResponseContext(params) {
 
 // src/payable-handler.ts
 function buildPayableHandler(solvaPay, ctx, handler) {
-  const { product, getCustomerRef, toolName } = ctx;
+  const { product, getCustomerRef, toolName, freeLimit } = ctx;
   const wrappedBusinessLogic = async (args, handlerContext) => {
     const limits = handlerContext?.limits ?? null;
     const customerRef = handlerContext?.customerRef ?? "";
@@ -2117,11 +2118,17 @@ function buildPayableHandler(solvaPay, ctx, handler) {
       customerRef,
       limits,
       product,
-      solvaPay
+      solvaPay,
+      ...freeLimit ? { freeLimit } : {}
     });
     return handler(args, responseCtx);
   };
-  const protectedHandler = solvaPay.payable({ product, getCustomerRef, ...toolName ? { toolName } : {} }).mcp(wrappedBusinessLogic);
+  const protectedHandler = solvaPay.payable({
+    product,
+    getCustomerRef,
+    ...toolName ? { toolName } : {},
+    ...freeLimit ? { freeLimit } : {}
+  }).mcp(wrappedBusinessLogic);
   return async (args, extra) => {
     const result = await protectedHandler(args, extra);
     if ((0, import_server6.isPaywallStructuredContent)(result.structuredContent)) {

package/dist/index.d.cts

@@ -1,5 +1,5 @@
 import { ZodTypeAny, z } from 'zod';
-import { PurchaseCheckResult, PaymentMethodInfo, CustomerBalanceResult, GetUsageResult, LimitResponseWithPlan, LimitAutoRechargeDto, PaywallNextAction, SdkMerchantResponse, SdkProductResponse, components, SolvaPay, PaywallError, PaywallStructuredContent } from '@solvapay/server';
+import { PurchaseCheckResult, PaymentMethodInfo, CustomerBalanceResult, GetUsageResult, LimitResponseWithPlan, LimitAutoRechargeDto, PaywallNextAction, SdkMerchantResponse, SdkProductResponse, components, SolvaPay, PaywallError, PaywallStructuredContent, FreeLimit } from '@solvapay/server';
 import { PricingOptionLike } from '@solvapay/core';
 export { ProductReadinessInput, ProductReadinessResult, SOLVAPAY_PRODUCT_REF_PLACEHOLDER, assertValidProductRef, creditsToDisplayMinorUnits, evaluateProductReadiness, isZeroDecimalCurrency, minorUnitsPerMajor } from '@solvapay/core';
 
@@ -1500,6 +1500,11 @@ interface BuildPayableHandlerContext {
      * events are attributable to a tool.
      */
     toolName?: string;
+    /**
+     * SDK-only free-tool allowance. When set, the paywall kernel counts
+     * against this free meter instead of the plan meter.
+     */
+    freeLimit?: FreeLimit;
 }
 /**
  * Merchant handler contract: `(args, ctx) => ctx.respond(data, options?)`.

package/dist/index.d.ts

@@ -1,5 +1,5 @@
 import { ZodTypeAny, z } from 'zod';
-import { PurchaseCheckResult, PaymentMethodInfo, CustomerBalanceResult, GetUsageResult, LimitResponseWithPlan, LimitAutoRechargeDto, PaywallNextAction, SdkMerchantResponse, SdkProductResponse, components, SolvaPay, PaywallError, PaywallStructuredContent } from '@solvapay/server';
+import { PurchaseCheckResult, PaymentMethodInfo, CustomerBalanceResult, GetUsageResult, LimitResponseWithPlan, LimitAutoRechargeDto, PaywallNextAction, SdkMerchantResponse, SdkProductResponse, components, SolvaPay, PaywallError, PaywallStructuredContent, FreeLimit } from '@solvapay/server';
 import { PricingOptionLike } from '@solvapay/core';
 export { ProductReadinessInput, ProductReadinessResult, SOLVAPAY_PRODUCT_REF_PLACEHOLDER, assertValidProductRef, creditsToDisplayMinorUnits, evaluateProductReadiness, isZeroDecimalCurrency, minorUnitsPerMajor } from '@solvapay/core';
 
@@ -1500,6 +1500,11 @@ interface BuildPayableHandlerContext {
      * events are attributable to a tool.
      */
     toolName?: string;
+    /**
+     * SDK-only free-tool allowance. When set, the paywall kernel counts
+     * against this free meter instead of the plan meter.
+     */
+    freeLimit?: FreeLimit;
 }
 /**
  * Merchant handler contract: `(args, ctx) => ctx.respond(data, options?)`.

package/dist/index.js

@@ -1991,7 +1991,7 @@ function snapshotFromLimits(params) {
   };
 }
 function buildResponseContext(params) {
-  const { customerRef, limits, product, bootstrapProduct, solvaPay } = params;
+  const { customerRef, limits, product, bootstrapProduct, solvaPay, freeLimit } = params;
   const bootstrapPlan = params.bootstrapPlan ?? synthesizePlanStub(limits);
   const emittedBlocks = [];
   const abortController = new AbortController();
@@ -1999,7 +1999,8 @@ function buildResponseContext(params) {
     const freshLimits = await solvaPay.checkLimits({
       customerRef,
       productRef: product,
-      meterName: "requests"
+      meterName: freeLimit?.meter ?? "requests",
+      ...freeLimit ? { freeAllowance: freeLimit } : {}
     });
     return snapshotFromLimits({
       customerRef,
@@ -2053,7 +2054,7 @@ function buildResponseContext(params) {
 
 // src/payable-handler.ts
 function buildPayableHandler(solvaPay, ctx, handler) {
-  const { product, getCustomerRef, toolName } = ctx;
+  const { product, getCustomerRef, toolName, freeLimit } = ctx;
   const wrappedBusinessLogic = async (args, handlerContext) => {
     const limits = handlerContext?.limits ?? null;
     const customerRef = handlerContext?.customerRef ?? "";
@@ -2061,11 +2062,17 @@ function buildPayableHandler(solvaPay, ctx, handler) {
       customerRef,
       limits,
       product,
-      solvaPay
+      solvaPay,
+      ...freeLimit ? { freeLimit } : {}
     });
     return handler(args, responseCtx);
   };
-  const protectedHandler = solvaPay.payable({ product, getCustomerRef, ...toolName ? { toolName } : {} }).mcp(wrappedBusinessLogic);
+  const protectedHandler = solvaPay.payable({
+    product,
+    getCustomerRef,
+    ...toolName ? { toolName } : {},
+    ...freeLimit ? { freeLimit } : {}
+  }).mcp(wrappedBusinessLogic);
   return async (args, extra) => {
     const result = await protectedHandler(args, extra);
     if (isPaywallStructuredContent(result.structuredContent)) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@solvapay/mcp-core",
-  "version": "0.4.3",
+  "version": "0.4.4",
   "description": "Framework-neutral MCP contracts for the SolvaPay SDK (tool names, descriptors, payable handler, paywall meta, CSP, bootstrap payload, OAuth discovery JSON builders, bearer/JWT helpers).",
   "type": "module",
   "main": "./dist/index.cjs",
@@ -41,7 +41,7 @@
     "typescript": "^5.9.3",
     "vitest": "^4.1.2",
     "zod": "^4.3.6",
-    "@solvapay/server": "2.7.0",
+    "@solvapay/server": "2.8.0",
     "@solvapay/test-utils": "^0.0.0"
   },
   "scripts": {