@solvapay/server 2.4.0 → 2.4.1

package/dist/edge.d.ts

@@ -1,3 +1,4 @@
+import { z } from 'zod';
 import { BusinessDetailsInput, TaxBreakdown } from '@solvapay/core';
 
 interface components {
@@ -5421,6 +5422,52 @@ declare class PaywallError extends Error {
 /** JSON body shape for HTTP adapters and MCP text content (stable fields for clients). */
 declare function paywallErrorToClientPayload(error: PaywallError): Record<string, unknown>;
 
+/**
+ * Zod schemas for `PaywallStructuredContent`. Declared so MCP hosts can
+ * hydrate `structuredContent` and so we fail loud when a required field
+ * the narrator claims to print is missing. Every recovery field is
+ * optional — a default here would invent data the backend did not send.
+ */
+
+declare const PaywallStructuredContentSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    planRef: z.ZodOptional<z.ZodString>;
+    plans: z.ZodOptional<z.ZodArray<z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
+    meterName: z.ZodOptional<z.ZodString>;
+    unitPriceMinor: z.ZodOptional<z.ZodNumber>;
+    currency: z.ZodOptional<z.ZodString>;
+    included: z.ZodOptional<z.ZodObject<{
+        total: z.ZodNumber;
+        used: z.ZodNumber;
+        remaining: z.ZodNumber;
+    }, z.core.$strip>>;
+    creditBalance: z.ZodOptional<z.ZodNumber>;
+    balance: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    productDetails: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    kind: z.ZodLiteral<"payment_required">;
+    product: z.ZodString;
+    checkoutUrl: z.ZodString;
+    message: z.ZodString;
+}, z.core.$strip>, z.ZodObject<{
+    planRef: z.ZodOptional<z.ZodString>;
+    plans: z.ZodOptional<z.ZodArray<z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
+    meterName: z.ZodOptional<z.ZodString>;
+    unitPriceMinor: z.ZodOptional<z.ZodNumber>;
+    currency: z.ZodOptional<z.ZodString>;
+    included: z.ZodOptional<z.ZodObject<{
+        total: z.ZodNumber;
+        used: z.ZodNumber;
+        remaining: z.ZodNumber;
+    }, z.core.$strip>>;
+    creditBalance: z.ZodOptional<z.ZodNumber>;
+    balance: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    productDetails: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    kind: z.ZodLiteral<"activation_required">;
+    product: z.ZodString;
+    checkoutUrl: z.ZodString;
+    message: z.ZodString;
+    confirmationUrl: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>], "kind">;
+
 /**
  * Pure state engine that classifies a `LimitResponseWithPlan` into a
  * recovery-tool-specific `PaywallState`, and produces the human-readable
@@ -6262,4 +6309,4 @@ declare function verifyWebhook({ body, signature, secret, }: {
     secret: string;
 }): Promise<WebhookEvent>;
 
-export { type ActivatePlanResult, type AuthenticatedUser, type ConfigureMcpPlansRequest, type ConfigureMcpPlansResponse, type CreateSolvaPayConfig, type CustomerBalanceResult, type CustomerResponseMapped, type CustomerWebhookObject, type ErrorResult, type GetUsageResult, type HttpAdapterOptions, type LimitActivationBalance, type LimitActivationProduct, type LimitPlanSummary, type LimitResponseWithPlan, type McpBootstrapPlanInput, type McpBootstrapRequest, type McpBootstrapResponse, type McpToolPlanMappingInput, type NextAdapterOptions, type OneTimePurchaseInfo, type PayableAllowResult, type PayableFunction, type PayableGateOptions, type PayableGateResult, type PayableOptions, type PayablePaywallResult, type PaymentMethodInfo, type PaywallArgs, type PaywallDecision, PaywallError, type PaywallMetadata, type PaywallState, type PaywallStructuredContent, type ProcessPaymentResult, type ProductConfigurationStatus, type PurchaseCheckResult, type RetryOptions, type SdkMerchantResponse, type SdkProductResponse, type ServerClientOptions, type SolvaPay, type SolvaPayClient, type ToolPlanMappingInput, type TopupProcessResult, type VerifyProductConfigurationOptions, type WebhookEvent, type WebhookEventForType, type WebhookEventObjectMap, type WebhookEventType, type WebhookProduct, activatePlanCore, attachBusinessDetailsCore, buildGateMessage, buildNudgeMessage, buildPaywallGate, cancelPurchaseCore, checkLimitsCore, checkPurchaseCore, classifyPaywallState, type components, createCheckoutSessionCore, createCustomerSessionCore, createPaymentIntentCore, createSolvaPay, createSolvaPayClient, createTopupPaymentIntentCore, deriveUsageSnapshot, disableAutoRechargeCore, getAuthenticatedUserCore, getAutoRechargeCore, getCustomerBalanceCore, getHistoryCore, getMerchantCore, getPaymentMethodCore, getProductCore, getUsageCore, handleRouteError, isErrorResult, isPaywallStructuredContent, listPlansCore, paywallErrorToClientPayload, processPaymentIntentCore, processTopupPaymentIntentCore, reactivatePurchaseCore, saveAutoRechargeCore, syncCustomerCore, trackUsageCore, verifyProductConfiguration, verifyWebhook, withRetry };
+export { type ActivatePlanResult, type AuthenticatedUser, type ConfigureMcpPlansRequest, type ConfigureMcpPlansResponse, type CreateSolvaPayConfig, type CustomerBalanceResult, type CustomerResponseMapped, type CustomerWebhookObject, type ErrorResult, type GetUsageResult, type HttpAdapterOptions, type LimitActivationBalance, type LimitActivationProduct, type LimitPlanSummary, type LimitResponseWithPlan, type McpBootstrapPlanInput, type McpBootstrapRequest, type McpBootstrapResponse, type McpToolPlanMappingInput, type NextAdapterOptions, type OneTimePurchaseInfo, type PayableAllowResult, type PayableFunction, type PayableGateOptions, type PayableGateResult, type PayableOptions, type PayablePaywallResult, type PaymentMethodInfo, type PaywallArgs, type PaywallDecision, PaywallError, type PaywallMetadata, type PaywallState, type PaywallStructuredContent, PaywallStructuredContentSchema, type ProcessPaymentResult, type ProductConfigurationStatus, type PurchaseCheckResult, type RetryOptions, type SdkMerchantResponse, type SdkProductResponse, type ServerClientOptions, type SolvaPay, type SolvaPayClient, type ToolPlanMappingInput, type TopupProcessResult, type VerifyProductConfigurationOptions, type WebhookEvent, type WebhookEventForType, type WebhookEventObjectMap, type WebhookEventType, type WebhookProduct, activatePlanCore, attachBusinessDetailsCore, buildGateMessage, buildNudgeMessage, buildPaywallGate, cancelPurchaseCore, checkLimitsCore, checkPurchaseCore, classifyPaywallState, type components, createCheckoutSessionCore, createCustomerSessionCore, createPaymentIntentCore, createSolvaPay, createSolvaPayClient, createTopupPaymentIntentCore, deriveUsageSnapshot, disableAutoRechargeCore, getAuthenticatedUserCore, getAutoRechargeCore, getCustomerBalanceCore, getHistoryCore, getMerchantCore, getPaymentMethodCore, getProductCore, getUsageCore, handleRouteError, isErrorResult, isPaywallStructuredContent, listPlansCore, paywallErrorToClientPayload, processPaymentIntentCore, processTopupPaymentIntentCore, reactivatePurchaseCore, saveAutoRechargeCore, syncCustomerCore, trackUsageCore, verifyProductConfiguration, verifyWebhook, withRetry };

package/dist/edge.js

@@ -2129,34 +2129,34 @@ function isJsonSchemaObject(value) {
   return Boolean(value && typeof value === "object");
 }
 function toZodSchema(property) {
-  const z = getZod();
+  const z2 = getZod();
   if (Array.isArray(property.enum) && property.enum.length > 0) {
     if (property.enum.every((value) => typeof value === "string")) {
       const [first, ...rest] = property.enum;
-      return z.enum([first, ...rest]);
+      return z2.enum([first, ...rest]);
     }
     if (property.enum.length === 1) {
-      return z.literal(property.enum[0]);
+      return z2.literal(property.enum[0]);
     }
-    return z.union(property.enum.map((value) => z.literal(value)));
+    return z2.union(property.enum.map((value) => z2.literal(value)));
   }
   switch (property.type) {
     case "string":
-      return z.string();
+      return z2.string();
     case "number":
-      return z.number();
+      return z2.number();
     case "integer":
-      return z.number().int();
+      return z2.number().int();
     case "boolean":
-      return z.boolean();
+      return z2.boolean();
     case "array":
-      return z.array(
-        isJsonSchemaObject(property.items) ? toZodSchema(property.items) : z.any()
+      return z2.array(
+        isJsonSchemaObject(property.items) ? toZodSchema(property.items) : z2.any()
       );
     case "object":
-      return z.object(jsonSchemaToZodRawShape(property.properties || {}));
+      return z2.object(jsonSchemaToZodRawShape(property.properties || {}));
     default:
-      return z.any();
+      return z2.any();
   }
 }
 function jsonSchemaToZodRawShape(properties, required = []) {
@@ -2191,12 +2191,12 @@ function registerVirtualToolsMcpImpl(server, apiClient, options) {
     if (filter && !filter(toolDefinition)) continue;
     const mappedDefinition = mapDefinition ? mapDefinition(toolDefinition) : toolDefinition;
     const wrappedHandler = wrapHandler ? wrapHandler(mappedDefinition.handler, mappedDefinition) : mappedDefinition.handler;
-    const z = getZod();
+    const z2 = getZod();
     server.registerTool(
       mappedDefinition.name,
       {
         description: mappedDefinition.description,
-        inputSchema: z.object(
+        inputSchema: z2.object(
           jsonSchemaToZodRawShape(
             mappedDefinition.inputSchema.properties,
             mappedDefinition.inputSchema.required || []
@@ -2483,6 +2483,42 @@ function isPaywallStructuredContent(value) {
   return kind === "payment_required" || kind === "activation_required";
 }
 
+// src/types/paywall-schema.ts
+import { z } from "zod";
+var includedSchema = z.object({
+  total: z.number(),
+  used: z.number(),
+  remaining: z.number()
+});
+var recoveryFields2 = {
+  planRef: z.string().optional(),
+  plans: z.array(z.record(z.string(), z.unknown())).optional(),
+  meterName: z.string().optional(),
+  unitPriceMinor: z.number().optional(),
+  currency: z.string().optional(),
+  included: includedSchema.optional(),
+  creditBalance: z.number().optional(),
+  balance: z.record(z.string(), z.unknown()).optional(),
+  productDetails: z.record(z.string(), z.unknown()).optional()
+};
+var PaywallStructuredContentSchema = z.discriminatedUnion("kind", [
+  z.object({
+    kind: z.literal("payment_required"),
+    product: z.string(),
+    checkoutUrl: z.string(),
+    message: z.string(),
+    ...recoveryFields2
+  }),
+  z.object({
+    kind: z.literal("activation_required"),
+    product: z.string(),
+    checkoutUrl: z.string(),
+    message: z.string(),
+    confirmationUrl: z.string().optional(),
+    ...recoveryFields2
+  })
+]);
+
 // src/helpers/error.ts
 import { SolvaPayError as SolvaPayError5 } from "@solvapay/core";
 function isErrorResult(result) {
@@ -3612,6 +3648,7 @@ async function verifyWebhook({
 }
 export {
   PaywallError,
+  PaywallStructuredContentSchema,
   activatePlanCore,
   attachBusinessDetailsCore,
   buildGateMessage,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@solvapay/server",
-  "version": "2.4.0",
+  "version": "2.4.1",
   "type": "module",
   "main": "./dist/index.cjs",
   "module": "./dist/index.js",