@solvapay/server 2.9.0 → 2.10.0-preview-01847ff5f57eafaa4bca393519caeaf6856d968c

package/dist/edge.d.ts

@@ -1782,8 +1782,20 @@ interface components {
              * @example active
              */
             status: string;
-            /** @description Usage billing state for usage-based plans */
-            usage?: components['schemas']['UsageBillingDto'];
+            /** @description Billing period of the active usage window; counts come from `/v1/sdk/limits` */
+            usage?: components['schemas']['SdkUsagePeriodDto'];
+        };
+        SdkUsagePeriodDto: {
+            /**
+             * Billing period of the active usage window; counts come from `/v1/sdk/limits`
+             * @example 2025-11-01T00:00:00Z
+             */
+            periodEnd?: string;
+            /**
+             * Billing period of the active usage window; counts come from `/v1/sdk/limits`
+             * @example 2025-10-01T00:00:00Z
+             */
+            periodStart?: string;
         };
         TaxBreakdownDto: {
             /** @description ISO 4217 currency code */
@@ -1931,33 +1943,6 @@ interface components {
             /** @enum {string} */
             taxBehavior?: 'auto' | 'inclusive' | 'exclusive';
         };
-        UsageBillingDto: {
-            /**
-             * Overage cost in cents
-             * @example 0
-             */
-            overageCost: number;
-            /**
-             * Units exceeding the plan included amount
-             * @example 0
-             */
-            overageUnits: number;
-            /**
-             * Period end date
-             * @example 2025-11-01T00:00:00Z
-             */
-            periodEnd?: string;
-            /**
-             * Period start date
-             * @example 2025-10-01T00:00:00Z
-             */
-            periodStart?: string;
-            /**
-             * Units consumed in current period
-             * @example 150
-             */
-            used: number;
-        };
         UsageRecordResponse: {
             creditDebit?: components['schemas']['CreditDebitSuccessResponse'] | components['schemas']['CreditDebitSkippedResponse'];
             /** @example usage_A1B2C3D4 */
@@ -6316,7 +6301,13 @@ declare function checkPurchaseCore(request: Request, options?: {
 interface GetUsageResult {
     meterRef: string | null;
     total: number | null;
-    used: number;
+    /**
+     * Consumed units this period. `limits.used` when the backend measured a
+     * finite cap, otherwise `total - remaining` when both are finite.
+     * `null` means this response did not measure consumption (`limits` null,
+     * unlimited, or credit-based).
+     */
+    used: number | null;
     remaining: number | null;
     /** 0–100, rounded to 2dp. `null` when `total` is unknown. */
     percentUsed: number | null;
@@ -6344,7 +6335,6 @@ interface UsageLimitsInput {
  * `remaining === -1` on a real limits object.
  */
 declare function deriveUsageSnapshot(input: {
-    used: number;
     periodStart?: string;
     periodEnd?: string;
     purchaseRef?: string;
@@ -6353,10 +6343,9 @@ declare function deriveUsageSnapshot(input: {
 /**
  * Fetch the authenticated customer's usage snapshot for the active purchase.
  *
- * Consumption (`used`, period window) comes from `checkPurchaseCore`. The cap
- * (`total`, `remaining`, `meterRef`) comes from `checkLimits` — the plan
- * snapshot no longer carries `limit` or `meterRef` on the wire, so a metered
- * plan costs one extra backend call unless the caller already has a
+ * The period window and `purchaseRef` come from the active purchase. Consumption
+ * and the cap (`used`, `total`, `remaining`, `meterRef`) come from `checkLimits`.
+ * A metered plan costs one extra backend call unless the caller already has a
  * `LimitResponse` (`options.limits`).
  *
  * Pass `limits` (including `null` for a failed fetch) to skip the

package/dist/edge.js

@@ -3600,7 +3600,7 @@ function deriveUsageSnapshot(input) {
     return {
       meterRef: null,
       total: null,
-      used: input.used,
+      used: null,
       remaining: null,
       percentUsed: null,
       ...period,
@@ -3610,8 +3610,8 @@ function deriveUsageSnapshot(input) {
   const hasFiniteCap = input.limits.remaining >= 0;
   const remaining = hasFiniteCap ? input.limits.remaining : null;
   const total = typeof input.limits.limit === "number" && input.limits.limit > 0 ? input.limits.limit : null;
-  const used = typeof input.limits.used === "number" ? input.limits.used : total !== null && remaining !== null ? Math.max(0, total - remaining) : input.used;
-  const percentUsed = total !== null && total > 0 ? Math.min(100, Math.round(used / total * 1e4) / 100) : null;
+  const used = typeof input.limits.used === "number" ? input.limits.used : total !== null && remaining !== null ? Math.max(0, total - remaining) : null;
+  const percentUsed = total !== null && total > 0 && used !== null ? Math.min(100, Math.round(used / total * 1e4) / 100) : null;
   return {
     meterRef: input.limits.meterName ?? null,
     total,
@@ -3627,28 +3627,27 @@ async function getUsageCore(request, options = {}) {
   if (isErrorResult(purchaseResult)) return purchaseResult;
   const activePurchase = (purchaseResult.purchases ?? []).find((p) => p.status === "active");
   if (!activePurchase) {
-    return deriveUsageSnapshot({ used: 0, limits: options.limits ?? null });
+    return deriveUsageSnapshot({ limits: options.limits ?? null });
   }
   const usage = activePurchase.usage;
-  const used = typeof usage?.used === "number" ? usage.used : 0;
   const period = {
     periodStart: usage?.periodStart,
     periodEnd: usage?.periodEnd,
     purchaseRef: activePurchase.reference
   };
   if ("limits" in options) {
-    return deriveUsageSnapshot({ used, ...period, limits: options.limits ?? null });
+    return deriveUsageSnapshot({ ...period, limits: options.limits ?? null });
   }
   const usageCounted = countsUsage(activePurchase.planSnapshot) || activePurchase.planSnapshot?.isMetered === true;
   if (!usageCounted || !activePurchase.productRef) {
-    return deriveUsageSnapshot({ used, ...period, limits: null });
+    return deriveUsageSnapshot({ ...period, limits: null });
   }
   const solvaPay = options.solvaPay || createSolvaPay();
   const limits = await solvaPay.apiClient.checkLimits({
     customerRef: purchaseResult.customerRef,
     productRef: activePurchase.productRef
   });
-  return deriveUsageSnapshot({ used, ...period, limits });
+  return deriveUsageSnapshot({ ...period, limits });
 }
 async function trackUsageCore(request, body, options = {}) {
   try {

package/dist/fetch/index.d.cts

@@ -1779,8 +1779,20 @@ interface components {
              * @example active
              */
             status: string;
-            /** @description Usage billing state for usage-based plans */
-            usage?: components['schemas']['UsageBillingDto'];
+            /** @description Billing period of the active usage window; counts come from `/v1/sdk/limits` */
+            usage?: components['schemas']['SdkUsagePeriodDto'];
+        };
+        SdkUsagePeriodDto: {
+            /**
+             * Billing period of the active usage window; counts come from `/v1/sdk/limits`
+             * @example 2025-11-01T00:00:00Z
+             */
+            periodEnd?: string;
+            /**
+             * Billing period of the active usage window; counts come from `/v1/sdk/limits`
+             * @example 2025-10-01T00:00:00Z
+             */
+            periodStart?: string;
         };
         TaxBreakdownDto: {
             /** @description ISO 4217 currency code */
@@ -1928,33 +1940,6 @@ interface components {
             /** @enum {string} */
             taxBehavior?: 'auto' | 'inclusive' | 'exclusive';
         };
-        UsageBillingDto: {
-            /**
-             * Overage cost in cents
-             * @example 0
-             */
-            overageCost: number;
-            /**
-             * Units exceeding the plan included amount
-             * @example 0
-             */
-            overageUnits: number;
-            /**
-             * Period end date
-             * @example 2025-11-01T00:00:00Z
-             */
-            periodEnd?: string;
-            /**
-             * Period start date
-             * @example 2025-10-01T00:00:00Z
-             */
-            periodStart?: string;
-            /**
-             * Units consumed in current period
-             * @example 150
-             */
-            used: number;
-        };
         UsageRecordResponse: {
             creditDebit?: components['schemas']['CreditDebitSuccessResponse'] | components['schemas']['CreditDebitSkippedResponse'];
             /** @example usage_A1B2C3D4 */

package/dist/fetch/index.d.ts

@@ -1779,8 +1779,20 @@ interface components {
              * @example active
              */
             status: string;
-            /** @description Usage billing state for usage-based plans */
-            usage?: components['schemas']['UsageBillingDto'];
+            /** @description Billing period of the active usage window; counts come from `/v1/sdk/limits` */
+            usage?: components['schemas']['SdkUsagePeriodDto'];
+        };
+        SdkUsagePeriodDto: {
+            /**
+             * Billing period of the active usage window; counts come from `/v1/sdk/limits`
+             * @example 2025-11-01T00:00:00Z
+             */
+            periodEnd?: string;
+            /**
+             * Billing period of the active usage window; counts come from `/v1/sdk/limits`
+             * @example 2025-10-01T00:00:00Z
+             */
+            periodStart?: string;
         };
         TaxBreakdownDto: {
             /** @description ISO 4217 currency code */
@@ -1928,33 +1940,6 @@ interface components {
             /** @enum {string} */
             taxBehavior?: 'auto' | 'inclusive' | 'exclusive';
         };
-        UsageBillingDto: {
-            /**
-             * Overage cost in cents
-             * @example 0
-             */
-            overageCost: number;
-            /**
-             * Units exceeding the plan included amount
-             * @example 0
-             */
-            overageUnits: number;
-            /**
-             * Period end date
-             * @example 2025-11-01T00:00:00Z
-             */
-            periodEnd?: string;
-            /**
-             * Period start date
-             * @example 2025-10-01T00:00:00Z
-             */
-            periodStart?: string;
-            /**
-             * Units consumed in current period
-             * @example 150
-             */
-            used: number;
-        };
         UsageRecordResponse: {
             creditDebit?: components['schemas']['CreditDebitSuccessResponse'] | components['schemas']['CreditDebitSkippedResponse'];
             /** @example usage_A1B2C3D4 */

package/dist/index.cjs

@@ -3685,7 +3685,7 @@ function deriveUsageSnapshot(input) {
     return {
       meterRef: null,
       total: null,
-      used: input.used,
+      used: null,
       remaining: null,
       percentUsed: null,
       ...period,
@@ -3695,8 +3695,8 @@ function deriveUsageSnapshot(input) {
   const hasFiniteCap = input.limits.remaining >= 0;
   const remaining = hasFiniteCap ? input.limits.remaining : null;
   const total = typeof input.limits.limit === "number" && input.limits.limit > 0 ? input.limits.limit : null;
-  const used = typeof input.limits.used === "number" ? input.limits.used : total !== null && remaining !== null ? Math.max(0, total - remaining) : input.used;
-  const percentUsed = total !== null && total > 0 ? Math.min(100, Math.round(used / total * 1e4) / 100) : null;
+  const used = typeof input.limits.used === "number" ? input.limits.used : total !== null && remaining !== null ? Math.max(0, total - remaining) : null;
+  const percentUsed = total !== null && total > 0 && used !== null ? Math.min(100, Math.round(used / total * 1e4) / 100) : null;
   return {
     meterRef: input.limits.meterName ?? null,
     total,
@@ -3712,28 +3712,27 @@ async function getUsageCore(request, options = {}) {
   if (isErrorResult(purchaseResult)) return purchaseResult;
   const activePurchase = (purchaseResult.purchases ?? []).find((p) => p.status === "active");
   if (!activePurchase) {
-    return deriveUsageSnapshot({ used: 0, limits: options.limits ?? null });
+    return deriveUsageSnapshot({ limits: options.limits ?? null });
   }
   const usage = activePurchase.usage;
-  const used = typeof usage?.used === "number" ? usage.used : 0;
   const period = {
     periodStart: usage?.periodStart,
     periodEnd: usage?.periodEnd,
     purchaseRef: activePurchase.reference
   };
   if ("limits" in options) {
-    return deriveUsageSnapshot({ used, ...period, limits: options.limits ?? null });
+    return deriveUsageSnapshot({ ...period, limits: options.limits ?? null });
   }
   const usageCounted = (0, import_core13.countsUsage)(activePurchase.planSnapshot) || activePurchase.planSnapshot?.isMetered === true;
   if (!usageCounted || !activePurchase.productRef) {
-    return deriveUsageSnapshot({ used, ...period, limits: null });
+    return deriveUsageSnapshot({ ...period, limits: null });
   }
   const solvaPay = options.solvaPay || createSolvaPay();
   const limits = await solvaPay.apiClient.checkLimits({
     customerRef: purchaseResult.customerRef,
     productRef: activePurchase.productRef
   });
-  return deriveUsageSnapshot({ used, ...period, limits });
+  return deriveUsageSnapshot({ ...period, limits });
 }
 async function trackUsageCore(request, body, options = {}) {
   try {

package/dist/index.d.cts

@@ -1782,8 +1782,20 @@ interface components {
              * @example active
              */
             status: string;
-            /** @description Usage billing state for usage-based plans */
-            usage?: components['schemas']['UsageBillingDto'];
+            /** @description Billing period of the active usage window; counts come from `/v1/sdk/limits` */
+            usage?: components['schemas']['SdkUsagePeriodDto'];
+        };
+        SdkUsagePeriodDto: {
+            /**
+             * Billing period of the active usage window; counts come from `/v1/sdk/limits`
+             * @example 2025-11-01T00:00:00Z
+             */
+            periodEnd?: string;
+            /**
+             * Billing period of the active usage window; counts come from `/v1/sdk/limits`
+             * @example 2025-10-01T00:00:00Z
+             */
+            periodStart?: string;
         };
         TaxBreakdownDto: {
             /** @description ISO 4217 currency code */
@@ -1931,33 +1943,6 @@ interface components {
             /** @enum {string} */
             taxBehavior?: 'auto' | 'inclusive' | 'exclusive';
         };
-        UsageBillingDto: {
-            /**
-             * Overage cost in cents
-             * @example 0
-             */
-            overageCost: number;
-            /**
-             * Units exceeding the plan included amount
-             * @example 0
-             */
-            overageUnits: number;
-            /**
-             * Period end date
-             * @example 2025-11-01T00:00:00Z
-             */
-            periodEnd?: string;
-            /**
-             * Period start date
-             * @example 2025-10-01T00:00:00Z
-             */
-            periodStart?: string;
-            /**
-             * Units consumed in current period
-             * @example 150
-             */
-            used: number;
-        };
         UsageRecordResponse: {
             creditDebit?: components['schemas']['CreditDebitSuccessResponse'] | components['schemas']['CreditDebitSkippedResponse'];
             /** @example usage_A1B2C3D4 */
@@ -6381,7 +6366,13 @@ declare function checkPurchaseCore(request: Request, options?: {
 interface GetUsageResult {
     meterRef: string | null;
     total: number | null;
-    used: number;
+    /**
+     * Consumed units this period. `limits.used` when the backend measured a
+     * finite cap, otherwise `total - remaining` when both are finite.
+     * `null` means this response did not measure consumption (`limits` null,
+     * unlimited, or credit-based).
+     */
+    used: number | null;
     remaining: number | null;
     /** 0–100, rounded to 2dp. `null` when `total` is unknown. */
     percentUsed: number | null;
@@ -6409,7 +6400,6 @@ interface UsageLimitsInput {
  * `remaining === -1` on a real limits object.
  */
 declare function deriveUsageSnapshot(input: {
-    used: number;
     periodStart?: string;
     periodEnd?: string;
     purchaseRef?: string;
@@ -6418,10 +6408,9 @@ declare function deriveUsageSnapshot(input: {
 /**
  * Fetch the authenticated customer's usage snapshot for the active purchase.
  *
- * Consumption (`used`, period window) comes from `checkPurchaseCore`. The cap
- * (`total`, `remaining`, `meterRef`) comes from `checkLimits` — the plan
- * snapshot no longer carries `limit` or `meterRef` on the wire, so a metered
- * plan costs one extra backend call unless the caller already has a
+ * The period window and `purchaseRef` come from the active purchase. Consumption
+ * and the cap (`used`, `total`, `remaining`, `meterRef`) come from `checkLimits`.
+ * A metered plan costs one extra backend call unless the caller already has a
  * `LimitResponse` (`options.limits`).
  *
  * Pass `limits` (including `null` for a failed fetch) to skip the

package/dist/index.d.ts

@@ -1782,8 +1782,20 @@ interface components {
              * @example active
              */
             status: string;
-            /** @description Usage billing state for usage-based plans */
-            usage?: components['schemas']['UsageBillingDto'];
+            /** @description Billing period of the active usage window; counts come from `/v1/sdk/limits` */
+            usage?: components['schemas']['SdkUsagePeriodDto'];
+        };
+        SdkUsagePeriodDto: {
+            /**
+             * Billing period of the active usage window; counts come from `/v1/sdk/limits`
+             * @example 2025-11-01T00:00:00Z
+             */
+            periodEnd?: string;
+            /**
+             * Billing period of the active usage window; counts come from `/v1/sdk/limits`
+             * @example 2025-10-01T00:00:00Z
+             */
+            periodStart?: string;
         };
         TaxBreakdownDto: {
             /** @description ISO 4217 currency code */
@@ -1931,33 +1943,6 @@ interface components {
             /** @enum {string} */
             taxBehavior?: 'auto' | 'inclusive' | 'exclusive';
         };
-        UsageBillingDto: {
-            /**
-             * Overage cost in cents
-             * @example 0
-             */
-            overageCost: number;
-            /**
-             * Units exceeding the plan included amount
-             * @example 0
-             */
-            overageUnits: number;
-            /**
-             * Period end date
-             * @example 2025-11-01T00:00:00Z
-             */
-            periodEnd?: string;
-            /**
-             * Period start date
-             * @example 2025-10-01T00:00:00Z
-             */
-            periodStart?: string;
-            /**
-             * Units consumed in current period
-             * @example 150
-             */
-            used: number;
-        };
         UsageRecordResponse: {
             creditDebit?: components['schemas']['CreditDebitSuccessResponse'] | components['schemas']['CreditDebitSkippedResponse'];
             /** @example usage_A1B2C3D4 */
@@ -6381,7 +6366,13 @@ declare function checkPurchaseCore(request: Request, options?: {
 interface GetUsageResult {
     meterRef: string | null;
     total: number | null;
-    used: number;
+    /**
+     * Consumed units this period. `limits.used` when the backend measured a
+     * finite cap, otherwise `total - remaining` when both are finite.
+     * `null` means this response did not measure consumption (`limits` null,
+     * unlimited, or credit-based).
+     */
+    used: number | null;
     remaining: number | null;
     /** 0–100, rounded to 2dp. `null` when `total` is unknown. */
     percentUsed: number | null;
@@ -6409,7 +6400,6 @@ interface UsageLimitsInput {
  * `remaining === -1` on a real limits object.
  */
 declare function deriveUsageSnapshot(input: {
-    used: number;
     periodStart?: string;
     periodEnd?: string;
     purchaseRef?: string;
@@ -6418,10 +6408,9 @@ declare function deriveUsageSnapshot(input: {
 /**
  * Fetch the authenticated customer's usage snapshot for the active purchase.
  *
- * Consumption (`used`, period window) comes from `checkPurchaseCore`. The cap
- * (`total`, `remaining`, `meterRef`) comes from `checkLimits` — the plan
- * snapshot no longer carries `limit` or `meterRef` on the wire, so a metered
- * plan costs one extra backend call unless the caller already has a
+ * The period window and `purchaseRef` come from the active purchase. Consumption
+ * and the cap (`used`, `total`, `remaining`, `meterRef`) come from `checkLimits`.
+ * A metered plan costs one extra backend call unless the caller already has a
  * `LimitResponse` (`options.limits`).
  *
  * Pass `limits` (including `null` for a failed fetch) to skip the

package/dist/index.js

@@ -3602,7 +3602,7 @@ function deriveUsageSnapshot(input) {
     return {
       meterRef: null,
       total: null,
-      used: input.used,
+      used: null,
       remaining: null,
       percentUsed: null,
       ...period,
@@ -3612,8 +3612,8 @@ function deriveUsageSnapshot(input) {
   const hasFiniteCap = input.limits.remaining >= 0;
   const remaining = hasFiniteCap ? input.limits.remaining : null;
   const total = typeof input.limits.limit === "number" && input.limits.limit > 0 ? input.limits.limit : null;
-  const used = typeof input.limits.used === "number" ? input.limits.used : total !== null && remaining !== null ? Math.max(0, total - remaining) : input.used;
-  const percentUsed = total !== null && total > 0 ? Math.min(100, Math.round(used / total * 1e4) / 100) : null;
+  const used = typeof input.limits.used === "number" ? input.limits.used : total !== null && remaining !== null ? Math.max(0, total - remaining) : null;
+  const percentUsed = total !== null && total > 0 && used !== null ? Math.min(100, Math.round(used / total * 1e4) / 100) : null;
   return {
     meterRef: input.limits.meterName ?? null,
     total,
@@ -3629,28 +3629,27 @@ async function getUsageCore(request, options = {}) {
   if (isErrorResult(purchaseResult)) return purchaseResult;
   const activePurchase = (purchaseResult.purchases ?? []).find((p) => p.status === "active");
   if (!activePurchase) {
-    return deriveUsageSnapshot({ used: 0, limits: options.limits ?? null });
+    return deriveUsageSnapshot({ limits: options.limits ?? null });
   }
   const usage = activePurchase.usage;
-  const used = typeof usage?.used === "number" ? usage.used : 0;
   const period = {
     periodStart: usage?.periodStart,
     periodEnd: usage?.periodEnd,
     purchaseRef: activePurchase.reference
   };
   if ("limits" in options) {
-    return deriveUsageSnapshot({ used, ...period, limits: options.limits ?? null });
+    return deriveUsageSnapshot({ ...period, limits: options.limits ?? null });
   }
   const usageCounted = countsUsage(activePurchase.planSnapshot) || activePurchase.planSnapshot?.isMetered === true;
   if (!usageCounted || !activePurchase.productRef) {
-    return deriveUsageSnapshot({ used, ...period, limits: null });
+    return deriveUsageSnapshot({ ...period, limits: null });
   }
   const solvaPay = options.solvaPay || createSolvaPay();
   const limits = await solvaPay.apiClient.checkLimits({
     customerRef: purchaseResult.customerRef,
     productRef: activePurchase.productRef
   });
-  return deriveUsageSnapshot({ used, ...period, limits });
+  return deriveUsageSnapshot({ ...period, limits });
 }
 async function trackUsageCore(request, body, options = {}) {
   try {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@solvapay/server",
-  "version": "2.9.0",
+  "version": "2.10.0-preview-01847ff5f57eafaa4bca393519caeaf6856d968c",
   "type": "module",
   "main": "./dist/index.cjs",
   "module": "./dist/index.js",