JavaScript SDK

​

4.6.0

2026-06-25

Credit wallet soft limit

• Added: hasSoftLimit field on CreditEntitlement. When a credit entitlement is configured as a soft limit, getEntitlement() returns hasAccess: true and hasSoftLimit: true even after the credit balance reaches zero. Hard limit (the default) continues to return hasAccess: false when the balance is exhausted. Credit-backed features inherit the wallet’s soft-limit so dependent feature reads stay consistent.

​

4.0.0

2026-04-01

Breaking changes — aligns entitlement types and evaluation behavior with @stigg/node-server-sdk:

Change	Migration
entitlementsUpdated event payload changed from Map<string, CachedEntitlement> to CustomerEntitlementsResultV2	Update listeners to iterate .entitlements (an EntitlementV2[] array) instead of a Map.
EntitlementsState type removed	Replace 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 access	Use getMeteredEntitlement() for metered features.
isGranted on credit entitlements removed	Use 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 EnumEntitlement	Add an EnumEntitlement branch to any exhaustive switch/case on Entitlement.
CreditEntitlementCurrency named export removed	Use 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

• Updated SDK to prevent dependency on compromised NPM packages

​

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

• Added: support for offline mode

​

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()