@i4e/invest4edu-access-core 0.26.0 → 0.27.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@i4e/invest4edu-access-core",
-  "version": "0.26.0",
+  "version": "0.27.0",
   "description": "Shared access-control primitives for NeoFindesk: tenant keystone, role capabilities, reportee tree, feature flags, and the unified access engine (registry schema, snapshot resolver, visibleWhen).",
   "type": "module",
   "exports": {

package/src/entitlement-store.d.ts

@@ -81,6 +81,13 @@ export interface EntitlementStore {
 }
 
 export function createEntitlementStore(opts: {
+  /**
+   * The subscription master switch. Returning false makes the whole store inert — every
+   * entitlement answers OPEN, nothing is counted and no subject is auto-provisioned — so the code
+   * can ship to production long before the product does. Defaults to the `SUBSCRIPTION_ENABLED`
+   * environment variable, and therefore to OFF.
+   */
+  isEnabled?: () => boolean | Promise<boolean>;
   /** Returns a raw MongoDB `Db`, or null/undefined when the connection is not ready. */
   getDb: () => unknown;
   /** Cast an id the way the caller's driver expects. Defaults to pass-through. */

package/src/subscription-lifecycle.js

@@ -70,6 +70,15 @@ export const SUBSCRIPTION_EVENT_TYPES = Object.freeze([
   // Consumption that happened outside the software — a webinar attended, a VPD session held.
   // There is no request behind it, so this event is the only record of who said it happened.
   "usage_recorded",
+  /**
+   * Credits handed out by an admin, rather than bought or rolled over.
+   *
+   * It used to be recorded as `override_set`, which made the history unreadable at exactly the
+   * moment it mattered: a one-off top-up and a permanent change to somebody's per-period allowance
+   * are different promises, and "who gave this partner 500 credits" cannot be answered by a stream
+   * where both look identical.
+   */
+  "credits_granted",
   /**
    * A term closed with credits unspent and the plan's policy carried them forward. Worth its own
    * type because a customer WILL ask why their balance is bigger than their allowance, and the