Skip to main content
​
3.0.0
2026-02-04
Breaking change: This version introduces a new Redis data structure for storing entitlement data. This change enables support for credit entitlements at high scale.
Once persistent-cache-service v3.0.0 writes data to Redis, older versions of @stigg/node-server-sdk and sidecar-service will not be able to read it correctly and will return incorrect entitlement data.

​
What changed

  • The Redis data structure now stores entitlements in a polymorphic format that supports both boolean and credit-based entitlements
  • Credit features are now properly linked to their credit entitlements

​
Why this matters

If you deploy persistent-cache-service v3.0.0 before upgrading all SDK/sidecar instances:
  • Older versions will misinterpret the new data structure
  • Entitlement checks may return incorrect results
  • This could affect your customers’ access to features

​
Migration steps

You must follow this upgrade sequence:
  1. Upgrade your SDK or Sidecar to the minimum required versions (upgrade whichever you use):
    • @stigg/node-server-sdk → v4.12.1 or later
    • sidecar-service → v5.194.5 or later
  2. Deploy all updated services — ensure all SDK and/or sidecar instances are running the new version
  3. Deploy persistent-cache-service v3.0.0 — only after step 2 is complete
​
2.41.0
2025-11-23
  • Added in-memory and persistent credit balance cache support to the SDK.
  • Credit balances now automatically update on grant and consumption events.
  • Entitlement evaluation uses the cached credit balance for faster checks.