Skip to main content
​
4.0.0
2026-04-01
Breaking changes — aligns entitlement types and evaluation behavior with @stigg/node-server-sdk:
ChangeMigration
entitlementsUpdated event payload changed from Map<string, CachedEntitlement> to CustomerEntitlementsResultV2Update listeners to iterate .entitlements (an EntitlementV2[] array) instead of a Map.
EntitlementsState type removedReplace imports with CustomerEntitlementsResult from @stigg/js-client-sdk.
resetSettings on MeteredEntitlement removed (was @deprecated)Use the top-level resetPeriod and usagePeriodEnd fields directly on the entitlement.
getNumericEntitlement() called on a metered feature now returns a FeatureTypeMismatch fallback instead of granting accessUse getMeteredEntitlement() for metered features.
isGranted on credit entitlements removedUse hasAccess — same semantics, aligned with the shared decision model.
Logger interface second parameter type widened to LoggerExtra (Record<string, any> | Error | Error['stack'])Widen the second parameter of any custom Logger implementation to accept LoggerExtra. No behavior change needed — type-signature only.
Entitlement union type now includes EnumEntitlementAdd an EnumEntitlement branch to any exhaustive switch/case on Entitlement.
CreditEntitlementCurrency named export removedUse CreditEntitlement['currency'] inline type instead. Shape is unchanged.
​
3.102.1
2026-03-19
  • Added: billingCycleAnchor property when provisioning and updating subscriptions. Accepts SubscriptionBillingCycleAnchor.UNCHANGED (default) to keep the existing billing cycle anchor, or SubscriptionBillingCycleAnchor.NOW to reset it to the current timestamp.
​
3.101.0
2026-03-17
  • Deprecated: getCreditBalance() (please use getCreditEntitlement() instead). getCreditEntitlement() reads directly from the SDK’s local cache, significantly reducing latency and removing rate-limit concerns. It returns the same data: currentBalance, totalConsumed, totalGranted, and currency.
​
3.99.1
2026-03-17
  • Added: getCreditEntitlement() method for low-latency retrieval of customer credit balance.
  • Added: Support for provisioning subscriptions with variable recurring credit grant entitlements.
​
3.90.0
2026-02-26
  • Enhanced getCreditEntitlement to return currency information.
​
3.75.0
2026-01-24
  • Added: Support for configuring and managing credit auto-recharge settings, including trigger balance, target top-up amount, and monthly spend limit.
​
3.72.0
2025-12-07
  • Added support for subscriptions filter by resourceId and plan (planId/displayName).
​
3.60.2
2025-09-09
​
3.54.0
2025-09-01
  • Added: AccessDeniedReason.Revoked for determining when an entitlement has been explicitly revoked.
​
3.42.0
2025-06-26
  • Added: getSubscriptions endpoint that allows retrieving all of customers’ subscriptions
​
3.36.0
2025-02-19
  • Added: ability to determine the number of attempts that were made to collect payment for a generated invoice when Stigg is integrated with Stripe using the latestInvoice.attemptCount property of the getActiveSubscriptions() and getSubscription() endpoints
​
3.35.0
2025-01-12
​
3.34.0
2024-12-17
  • Added: GetUsageHistoryV2
  • ⚠️ Deprecated: GetUsageHistory(please use GetUsageHistoryV2 instead)
  • Changed:
    • Input Object:
      • customerRefId renamed to customerId
      • resourceRefId renamed to resourceId
      • featureRefId renamed to featureId
      • resetPeriod removed
      • yearlyResetPeriodConfiguration removed
      • monthlyResetPeriodConfiguration removed
      • weeklyResetPeriodConfiguration removed
    • Output Object
      • startDate removed
      • endDate removed
      • usageMeasurements[i].date renamed to series[0].point[i].timestamp
      • usageMeasurements[i].value renamed to series[0].point[i].value
      • usageMeasurements[i].isResetPoint renamed to series[0].point[i].isResetPoint
        • Old Value: true if and only if usage was reset due to periodic reset.
        • New Value: true if and only if usage was reset due to periodic reset or due to a plan transition.
      • groups[i].groupInfo[j].key renamed to series[i].tags[j].key
      • groups[i].groupInfo[j].value renamed to series[i].tags[j].value
      • groups[i].usageMeasurements[j].date renamed to series[i].point[j].timestamp
      • groups[i].usageMeasurements[j].value renamed to series[i].point[j].value
      • groups[i].usageMeasurements[j].isResetPoint renamed to series[i].point[j].isResetPoint
        • Old Value: true if and only if usage was reset due to periodic reset.
        • New Value: true if and only if usage was reset due to periodic reset or due to a plan transition.
​
3.33.0
2024-12-08
  • Added: ability to override prices when there’s a scheduled update in place
​
3.31.0
2024-11-21
  • Added: support for price localization in fixed fee coupons
​
3.30.0
2024-10-14
  • Added: ability to estimate the subscription cost when the payment of the subscription is delegated to a different customer using:
    • PreviewSubscription.payingCustomerId
    • EstimateSubscription.payingCustomerId
    • EstimateSubscriptionUpdate.payingCustomerId
​
3.27.0
2024-10-08
  • Added: ability to more easily determine the usage period of metered entitlements using:
    • MeteredEntitlement.usagePeriodStart
    • MeteredEntitlement.usagePeriodEnd
  • 🛑 Removed: MeteredEntitlement.nextResetDate
​
3.20.0
2024-06-20
  • Added: ability to get the list of active subscriptions from Edge using getActiveSubscriptionsList()
​
3.19.0
2024-06-20
  • Added: ability to get the details of a specific subscription using getSubscription()