@solvapay/server 2.8.0 → 2.9.0-preview-465291233085dd2cc8f8ce13a3336583bc9901a0

package/dist/edge.d.ts

@@ -320,12 +320,9 @@ interface components {
                     label?: string;
                     meter: string;
                     /** @enum {string} */
-                    onExceed: 'block' | 'throttle' | 'charge' | 'notify' | 'top_up' | 'auto_upgrade';
-                    onExceedPricingId?: string;
+                    onExceed: 'block' | 'draw_credits';
                     /** @enum {string} */
                     scope: 'billing_period' | 'lifetime' | 'rolling_window';
-                    /** @enum {string} */
-                    uiHint?: 'upgrade_prompt' | 'soft_warning';
                     windowDays?: number;
                 } | {
                     feature: string;
@@ -336,12 +333,11 @@ interface components {
                     value: boolean | number | string;
                 } | {
                     days: number;
-                    downgradeToPricingId?: string;
                     /** @enum {string} */
                     kind: 'trial';
                     label?: string;
                     /** @enum {string} */
-                    onEnd: 'convert' | 'cancel' | 'downgrade';
+                    onEnd: 'convert' | 'cancel';
                 } | {
                     /** @enum {string} */
                     appliesTo?: 'recurring' | 'setup' | 'usage' | 'all';
@@ -355,17 +351,6 @@ interface components {
                     /** @enum {string} */
                     mode: 'percentage' | 'fixed';
                     value: number;
-                } | {
-                    capUnits?: number;
-                    currency?: string;
-                    /** @enum {string} */
-                    kind: 'rollover';
-                    label?: string;
-                    maxCycles?: number;
-                    meter: string;
-                    rateMinor?: number;
-                    /** @enum {string} */
-                    treatment: 'forfeit' | 'carry_forward' | 'credit_units' | 'credit_money';
                 } | {
                     /** @enum {string} */
                     kind: 'autoAssigned';
@@ -516,12 +501,9 @@ interface components {
                 label?: string;
                 meter: string;
                 /** @enum {string} */
-                onExceed: 'block' | 'throttle' | 'charge' | 'notify' | 'top_up' | 'auto_upgrade';
-                onExceedPricingId?: string;
+                onExceed: 'block' | 'draw_credits';
                 /** @enum {string} */
                 scope: 'billing_period' | 'lifetime' | 'rolling_window';
-                /** @enum {string} */
-                uiHint?: 'upgrade_prompt' | 'soft_warning';
                 windowDays?: number;
             } | {
                 feature: string;
@@ -532,12 +514,11 @@ interface components {
                 value: boolean | number | string;
             } | {
                 days: number;
-                downgradeToPricingId?: string;
                 /** @enum {string} */
                 kind: 'trial';
                 label?: string;
                 /** @enum {string} */
-                onEnd: 'convert' | 'cancel' | 'downgrade';
+                onEnd: 'convert' | 'cancel';
             } | {
                 /** @enum {string} */
                 appliesTo?: 'recurring' | 'setup' | 'usage' | 'all';
@@ -551,17 +532,6 @@ interface components {
                 /** @enum {string} */
                 mode: 'percentage' | 'fixed';
                 value: number;
-            } | {
-                capUnits?: number;
-                currency?: string;
-                /** @enum {string} */
-                kind: 'rollover';
-                label?: string;
-                maxCycles?: number;
-                meter: string;
-                rateMinor?: number;
-                /** @enum {string} */
-                treatment: 'forfeit' | 'carry_forward' | 'credit_units' | 'credit_money';
             } | {
                 /** @enum {string} */
                 kind: 'autoAssigned';
@@ -664,7 +634,7 @@ interface components {
              * @example duplicate
              * @enum {string}
              */
-            reason: 'duplicate' | 'no_product_ref' | 'customer_not_found' | 'no_active_purchase' | 'plan_not_credit_based' | 'plan_billed_at_period_end';
+            reason: 'duplicate' | 'no_product_ref' | 'customer_not_found' | 'no_active_purchase' | 'plan_not_credit_based' | 'not_credit_drawn' | 'within_included';
         };
         CreditDebitSuccessResponse: {
             /**
@@ -908,11 +878,9 @@ interface components {
              * @example requests
              */
             meterName?: string;
-            /** @description Access is blocked pending an auto-recharge top-up of the prepaid balance — `onExceed: top_up`. */
+            /** @description Access is blocked until prepaid credits cover the next unit — past an included cap with `onExceed: draw_credits`, or from the first unit on a recurring meter with no limit. */
             needsTopUp?: boolean;
-            /** @description Access is blocked pending a plan switch to the limit's target pricing — `onExceed: auto_upgrade`. */
-            needsUpgrade?: boolean;
-            /** @description Access is granted and usage beyond the included cap accrues an overage charge — `onExceed: charge`. */
+            /** @description Access is granted past the included cap and the usage is paid from prepaid credits — `onExceed: draw_credits`. */
             overage?: boolean;
             /**
              * Authoritative paywall classification shared with Managed MCP. Present on denial responses only.
@@ -934,10 +902,6 @@ interface components {
              * @example 997
              */
             remaining: number;
-            /** @description Access is granted but the caller should degrade/throttle service — the limit was exceeded with `onExceed: throttle`. */
-            throttled?: boolean;
-            /** @description The customer was auto-upgraded to the target pricing to restore access — `onExceed: auto_upgrade` succeeded. */
-            upgraded?: boolean;
             /** @description Consumed usage units this period. Present only when the backend measured a finite cap. */
             used?: number;
             /**
@@ -1005,12 +969,9 @@ interface components {
                     label?: string;
                     meter: string;
                     /** @enum {string} */
-                    onExceed: 'block' | 'throttle' | 'charge' | 'notify' | 'top_up' | 'auto_upgrade';
-                    onExceedPricingId?: string;
+                    onExceed: 'block' | 'draw_credits';
                     /** @enum {string} */
                     scope: 'billing_period' | 'lifetime' | 'rolling_window';
-                    /** @enum {string} */
-                    uiHint?: 'upgrade_prompt' | 'soft_warning';
                     windowDays?: number;
                 } | {
                     feature: string;
@@ -1021,12 +982,11 @@ interface components {
                     value: boolean | number | string;
                 } | {
                     days: number;
-                    downgradeToPricingId?: string;
                     /** @enum {string} */
                     kind: 'trial';
                     label?: string;
                     /** @enum {string} */
-                    onEnd: 'convert' | 'cancel' | 'downgrade';
+                    onEnd: 'convert' | 'cancel';
                 } | {
                     /** @enum {string} */
                     appliesTo?: 'recurring' | 'setup' | 'usage' | 'all';
@@ -1040,17 +1000,6 @@ interface components {
                     /** @enum {string} */
                     mode: 'percentage' | 'fixed';
                     value: number;
-                } | {
-                    capUnits?: number;
-                    currency?: string;
-                    /** @enum {string} */
-                    kind: 'rollover';
-                    label?: string;
-                    maxCycles?: number;
-                    meter: string;
-                    rateMinor?: number;
-                    /** @enum {string} */
-                    treatment: 'forfeit' | 'carry_forward' | 'credit_units' | 'credit_money';
                 } | {
                     /** @enum {string} */
                     kind: 'autoAssigned';
@@ -1921,12 +1870,9 @@ interface components {
                 label?: string;
                 meter: string;
                 /** @enum {string} */
-                onExceed: 'block' | 'throttle' | 'charge' | 'notify' | 'top_up' | 'auto_upgrade';
-                onExceedPricingId?: string;
+                onExceed: 'block' | 'draw_credits';
                 /** @enum {string} */
                 scope: 'billing_period' | 'lifetime' | 'rolling_window';
-                /** @enum {string} */
-                uiHint?: 'upgrade_prompt' | 'soft_warning';
                 windowDays?: number;
             } | {
                 feature: string;
@@ -1937,12 +1883,11 @@ interface components {
                 value: boolean | number | string;
             } | {
                 days: number;
-                downgradeToPricingId?: string;
                 /** @enum {string} */
                 kind: 'trial';
                 label?: string;
                 /** @enum {string} */
-                onEnd: 'convert' | 'cancel' | 'downgrade';
+                onEnd: 'convert' | 'cancel';
             } | {
                 /** @enum {string} */
                 appliesTo?: 'recurring' | 'setup' | 'usage' | 'all';
@@ -1956,17 +1901,6 @@ interface components {
                 /** @enum {string} */
                 mode: 'percentage' | 'fixed';
                 value: number;
-            } | {
-                capUnits?: number;
-                currency?: string;
-                /** @enum {string} */
-                kind: 'rollover';
-                label?: string;
-                maxCycles?: number;
-                meter: string;
-                rateMinor?: number;
-                /** @enum {string} */
-                treatment: 'forfeit' | 'carry_forward' | 'credit_units' | 'credit_money';
             } | {
                 /** @enum {string} */
                 kind: 'autoAssigned';
@@ -3941,12 +3875,11 @@ type FreeLimit = Required<Omit<GeneratedFreeAllowance, 'windowDays'>> & Pick<Gen
 /**
  * `LimitResponse` plus a deprecated SDK-only `plan` alias.
  *
- * The backend `LimitResponse` now natively carries the `onExceed` outcome flags
- * (`throttled` / `overage` / `needsTopUp` / `needsUpgrade` / `upgraded`, resolved
- * by `decideLimit`), so they flow through from `generated.ts`. `throttled` /
- * `overage` ride the allow path (`withinLimits: true`) so a protected handler
- * can read them from `decision.limits` and degrade service or note overage; the
- * others accompany a gate outcome.
+ * The backend `LimitResponse` carries the `onExceed` outcome flags
+ * (`overage` / `needsTopUp`, resolved by `decideLimit`), so they flow
+ * through from `generated.ts`. `overage` rides the allow path
+ * (`withinLimits: true`) so a protected handler can read it from
+ * `decision.limits`; `needsTopUp` accompanies a gate outcome.
  *
  * Read `planRef` for the active plan. `plan` is never populated by the
  * backend — it remains optional so older fixtures and callers still type-check.
@@ -4379,13 +4312,11 @@ type PaywallDecision<T> = {
     limits: LimitResponseWithPlan;
     customerRef: string;
     /**
-     * Set when access is granted with consequences. `throttled` is
-     * `onExceed: throttle` (legacy plans — the builder no longer
-     * offers it). `overage` is `onExceed: charge` past the included
-     * cap. Absent on a plain allow. Derived from `limits`; not new
-     * wire data.
+     * Set when access is granted past the included cap and the usage
+     * is paid from prepaid credits (`onExceed: draw_credits`). Absent on a
+     * plain allow. Derived from `limits`; not new wire data.
      */
-    consequence?: 'throttled' | 'overage';
+    consequence?: 'overage';
     /**
      * Id minted by `decide()` and reused by `runAllow()` so success /
      * fail tracking shares one idempotency key with the decision.
@@ -5110,8 +5041,7 @@ interface SolvaPay {
      * @param params.customerRef - Customer reference
      * @param params.productRef - Product reference
      * @returns Full `LimitResponseWithPlan`, including the `onExceed` outcome
-     *   flags (`throttled` / `overage` / `needsTopUp` / `needsUpgrade` /
-     *   `upgraded`) the backend already sends on `/v1/sdk/limits`
+     *   flags (`overage` / `needsTopUp`) the backend sends on `/v1/sdk/limits`
      *
      * @example
      * ```typescript
@@ -5667,7 +5597,7 @@ declare function nextActionFor(state: PaywallState): PaywallNextAction;
  *     (no purchaseRef / planRef) must not fall through to upgrade_required.
  *  3. `paywallReason === 'topup_required'` — backend stays authoritative
  *     for credit-based denials (same rule as Managed MCP).
- *  3. Authoritative `needsTopUp` / `needsUpgrade` flags from `decideLimit`.
+ *  3. Authoritative `needsTopUp` flag from `decideLimit`.
  *  4. Credit-field presence + a real shortfall (`balance < cost`).
  *  5. Active purchase / plan at included cap → `limit_reached`.
  *  6. Floor: never `upgrade_required` when credit fields or a purchase

package/dist/edge.js

@@ -732,9 +732,6 @@ function classifyPaywallState(limits) {
   if (limits.needsTopUp === true) {
     return { kind: "topup_required" };
   }
-  if (limits.needsUpgrade === true) {
-    return { kind: "upgrade_required" };
-  }
   const signals = creditSignals(limits);
   if (signals.isCreditBased) {
     if (signals.creditBalance !== void 0 && signals.creditsPerCall !== void 0 && signals.creditBalance < signals.creditsPerCall) {
@@ -862,14 +859,6 @@ function buildGateMessage(state, gate) {
       return `${lead}${topup}${auto}${switchLine}`;
     }
     case "upgrade_required": {
-      if (hasActivePlan(gate)) {
-        const planName = gate.planName ?? "This plan";
-        const lead = `${planName} is active but its included usage is exhausted, and the automatic switch to the next plan did not complete.`;
-        if (ladder) {
-          return `${lead} Switch here: ${ladder}. ${callViewer("account").replace(/^c/, "C")} for usage and recovery.`;
-        }
-        return `${lead}${recoverClause(url, "switch plan", "checkout")}`;
-      }
       if (ladder) {
         return `You don't have an active plan for this tool. Pick a plan to use this tool: ${ladder} (links expire in ${CHECKOUT_SESSION_TTL_MINUTES} minutes), or ${callViewer("checkout")}. ${callViewer("account").replace(/^c/, "C")} for usage and recovery.`;
       }
@@ -1409,7 +1398,7 @@ var SolvaPayPaywall = class {
         requestId
       };
     }
-    const consequence = lastLimitsCheck.throttled ? "throttled" : lastLimitsCheck.overage ? "overage" : void 0;
+    const consequence = lastLimitsCheck.overage ? "overage" : void 0;
     return {
       outcome: "allow",
       args,

package/dist/fetch/index.cjs

@@ -888,9 +888,6 @@ function classifyPaywallState(limits) {
   if (limits.needsTopUp === true) {
     return { kind: "topup_required" };
   }
-  if (limits.needsUpgrade === true) {
-    return { kind: "upgrade_required" };
-  }
   const signals = creditSignals(limits);
   if (signals.isCreditBased) {
     if (signals.creditBalance !== void 0 && signals.creditsPerCall !== void 0 && signals.creditBalance < signals.creditsPerCall) {
@@ -1018,14 +1015,6 @@ function buildGateMessage(state, gate) {
       return `${lead}${topup}${auto}${switchLine}`;
     }
     case "upgrade_required": {
-      if (hasActivePlan(gate)) {
-        const planName = gate.planName ?? "This plan";
-        const lead = `${planName} is active but its included usage is exhausted, and the automatic switch to the next plan did not complete.`;
-        if (ladder) {
-          return `${lead} Switch here: ${ladder}. ${callViewer("account").replace(/^c/, "C")} for usage and recovery.`;
-        }
-        return `${lead}${recoverClause(url, "switch plan", "checkout")}`;
-      }
       if (ladder) {
         return `You don't have an active plan for this tool. Pick a plan to use this tool: ${ladder} (links expire in ${CHECKOUT_SESSION_TTL_MINUTES} minutes), or ${callViewer("checkout")}. ${callViewer("account").replace(/^c/, "C")} for usage and recovery.`;
       }
@@ -1541,7 +1530,7 @@ var SolvaPayPaywall = class {
         requestId
       };
     }
-    const consequence = lastLimitsCheck.throttled ? "throttled" : lastLimitsCheck.overage ? "overage" : void 0;
+    const consequence = lastLimitsCheck.overage ? "overage" : void 0;
     return {
       outcome: "allow",
       args,

package/dist/fetch/index.d.cts

@@ -317,12 +317,9 @@ interface components {
                     label?: string;
                     meter: string;
                     /** @enum {string} */
-                    onExceed: 'block' | 'throttle' | 'charge' | 'notify' | 'top_up' | 'auto_upgrade';
-                    onExceedPricingId?: string;
+                    onExceed: 'block' | 'draw_credits';
                     /** @enum {string} */
                     scope: 'billing_period' | 'lifetime' | 'rolling_window';
-                    /** @enum {string} */
-                    uiHint?: 'upgrade_prompt' | 'soft_warning';
                     windowDays?: number;
                 } | {
                     feature: string;
@@ -333,12 +330,11 @@ interface components {
                     value: boolean | number | string;
                 } | {
                     days: number;
-                    downgradeToPricingId?: string;
                     /** @enum {string} */
                     kind: 'trial';
                     label?: string;
                     /** @enum {string} */
-                    onEnd: 'convert' | 'cancel' | 'downgrade';
+                    onEnd: 'convert' | 'cancel';
                 } | {
                     /** @enum {string} */
                     appliesTo?: 'recurring' | 'setup' | 'usage' | 'all';
@@ -352,17 +348,6 @@ interface components {
                     /** @enum {string} */
                     mode: 'percentage' | 'fixed';
                     value: number;
-                } | {
-                    capUnits?: number;
-                    currency?: string;
-                    /** @enum {string} */
-                    kind: 'rollover';
-                    label?: string;
-                    maxCycles?: number;
-                    meter: string;
-                    rateMinor?: number;
-                    /** @enum {string} */
-                    treatment: 'forfeit' | 'carry_forward' | 'credit_units' | 'credit_money';
                 } | {
                     /** @enum {string} */
                     kind: 'autoAssigned';
@@ -513,12 +498,9 @@ interface components {
                 label?: string;
                 meter: string;
                 /** @enum {string} */
-                onExceed: 'block' | 'throttle' | 'charge' | 'notify' | 'top_up' | 'auto_upgrade';
-                onExceedPricingId?: string;
+                onExceed: 'block' | 'draw_credits';
                 /** @enum {string} */
                 scope: 'billing_period' | 'lifetime' | 'rolling_window';
-                /** @enum {string} */
-                uiHint?: 'upgrade_prompt' | 'soft_warning';
                 windowDays?: number;
             } | {
                 feature: string;
@@ -529,12 +511,11 @@ interface components {
                 value: boolean | number | string;
             } | {
                 days: number;
-                downgradeToPricingId?: string;
                 /** @enum {string} */
                 kind: 'trial';
                 label?: string;
                 /** @enum {string} */
-                onEnd: 'convert' | 'cancel' | 'downgrade';
+                onEnd: 'convert' | 'cancel';
             } | {
                 /** @enum {string} */
                 appliesTo?: 'recurring' | 'setup' | 'usage' | 'all';
@@ -548,17 +529,6 @@ interface components {
                 /** @enum {string} */
                 mode: 'percentage' | 'fixed';
                 value: number;
-            } | {
-                capUnits?: number;
-                currency?: string;
-                /** @enum {string} */
-                kind: 'rollover';
-                label?: string;
-                maxCycles?: number;
-                meter: string;
-                rateMinor?: number;
-                /** @enum {string} */
-                treatment: 'forfeit' | 'carry_forward' | 'credit_units' | 'credit_money';
             } | {
                 /** @enum {string} */
                 kind: 'autoAssigned';
@@ -661,7 +631,7 @@ interface components {
              * @example duplicate
              * @enum {string}
              */
-            reason: 'duplicate' | 'no_product_ref' | 'customer_not_found' | 'no_active_purchase' | 'plan_not_credit_based' | 'plan_billed_at_period_end';
+            reason: 'duplicate' | 'no_product_ref' | 'customer_not_found' | 'no_active_purchase' | 'plan_not_credit_based' | 'not_credit_drawn' | 'within_included';
         };
         CreditDebitSuccessResponse: {
             /**
@@ -905,11 +875,9 @@ interface components {
              * @example requests
              */
             meterName?: string;
-            /** @description Access is blocked pending an auto-recharge top-up of the prepaid balance — `onExceed: top_up`. */
+            /** @description Access is blocked until prepaid credits cover the next unit — past an included cap with `onExceed: draw_credits`, or from the first unit on a recurring meter with no limit. */
             needsTopUp?: boolean;
-            /** @description Access is blocked pending a plan switch to the limit's target pricing — `onExceed: auto_upgrade`. */
-            needsUpgrade?: boolean;
-            /** @description Access is granted and usage beyond the included cap accrues an overage charge — `onExceed: charge`. */
+            /** @description Access is granted past the included cap and the usage is paid from prepaid credits — `onExceed: draw_credits`. */
             overage?: boolean;
             /**
              * Authoritative paywall classification shared with Managed MCP. Present on denial responses only.
@@ -931,10 +899,6 @@ interface components {
              * @example 997
              */
             remaining: number;
-            /** @description Access is granted but the caller should degrade/throttle service — the limit was exceeded with `onExceed: throttle`. */
-            throttled?: boolean;
-            /** @description The customer was auto-upgraded to the target pricing to restore access — `onExceed: auto_upgrade` succeeded. */
-            upgraded?: boolean;
             /** @description Consumed usage units this period. Present only when the backend measured a finite cap. */
             used?: number;
             /**
@@ -1002,12 +966,9 @@ interface components {
                     label?: string;
                     meter: string;
                     /** @enum {string} */
-                    onExceed: 'block' | 'throttle' | 'charge' | 'notify' | 'top_up' | 'auto_upgrade';
-                    onExceedPricingId?: string;
+                    onExceed: 'block' | 'draw_credits';
                     /** @enum {string} */
                     scope: 'billing_period' | 'lifetime' | 'rolling_window';
-                    /** @enum {string} */
-                    uiHint?: 'upgrade_prompt' | 'soft_warning';
                     windowDays?: number;
                 } | {
                     feature: string;
@@ -1018,12 +979,11 @@ interface components {
                     value: boolean | number | string;
                 } | {
                     days: number;
-                    downgradeToPricingId?: string;
                     /** @enum {string} */
                     kind: 'trial';
                     label?: string;
                     /** @enum {string} */
-                    onEnd: 'convert' | 'cancel' | 'downgrade';
+                    onEnd: 'convert' | 'cancel';
                 } | {
                     /** @enum {string} */
                     appliesTo?: 'recurring' | 'setup' | 'usage' | 'all';
@@ -1037,17 +997,6 @@ interface components {
                     /** @enum {string} */
                     mode: 'percentage' | 'fixed';
                     value: number;
-                } | {
-                    capUnits?: number;
-                    currency?: string;
-                    /** @enum {string} */
-                    kind: 'rollover';
-                    label?: string;
-                    maxCycles?: number;
-                    meter: string;
-                    rateMinor?: number;
-                    /** @enum {string} */
-                    treatment: 'forfeit' | 'carry_forward' | 'credit_units' | 'credit_money';
                 } | {
                     /** @enum {string} */
                     kind: 'autoAssigned';
@@ -1918,12 +1867,9 @@ interface components {
                 label?: string;
                 meter: string;
                 /** @enum {string} */
-                onExceed: 'block' | 'throttle' | 'charge' | 'notify' | 'top_up' | 'auto_upgrade';
-                onExceedPricingId?: string;
+                onExceed: 'block' | 'draw_credits';
                 /** @enum {string} */
                 scope: 'billing_period' | 'lifetime' | 'rolling_window';
-                /** @enum {string} */
-                uiHint?: 'upgrade_prompt' | 'soft_warning';
                 windowDays?: number;
             } | {
                 feature: string;
@@ -1934,12 +1880,11 @@ interface components {
                 value: boolean | number | string;
             } | {
                 days: number;
-                downgradeToPricingId?: string;
                 /** @enum {string} */
                 kind: 'trial';
                 label?: string;
                 /** @enum {string} */
-                onEnd: 'convert' | 'cancel' | 'downgrade';
+                onEnd: 'convert' | 'cancel';
             } | {
                 /** @enum {string} */
                 appliesTo?: 'recurring' | 'setup' | 'usage' | 'all';
@@ -1953,17 +1898,6 @@ interface components {
                 /** @enum {string} */
                 mode: 'percentage' | 'fixed';
                 value: number;
-            } | {
-                capUnits?: number;
-                currency?: string;
-                /** @enum {string} */
-                kind: 'rollover';
-                label?: string;
-                maxCycles?: number;
-                meter: string;
-                rateMinor?: number;
-                /** @enum {string} */
-                treatment: 'forfeit' | 'carry_forward' | 'credit_units' | 'credit_money';
             } | {
                 /** @enum {string} */
                 kind: 'autoAssigned';