@i4e/invest4edu-access-core 0.17.1 → 0.17.3

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@i4e/invest4edu-access-core",
-  "version": "0.17.1",
+  "version": "0.17.3",
   "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.js

@@ -155,8 +155,20 @@ export function createEntitlementStore({ getDb, toObjectId = (v) => v, logger =
         subscription, entitlementRows: rows, featureCode, feature, used, credits, identity, bypass, now,
       });
 
-      // Carry what consume() needs, so it cannot recompute the period key and count against a
-      // different bucket than the one that was just checked.
+      /**
+       * Carry what consume() needs, so it cannot recompute the period key and count against a
+       * different bucket than the one that was just checked.
+       *
+       * The carried row takes its ceiling from the RESOLVED result, not from the raw plan row —
+       * because a per-subject override changes the decision without changing the row it came
+       * from. Carrying the raw row meant consume guarded on the plan's quota while the check had
+       * already passed on the overridden one: a subject granted 5 was refused at 2, and it
+       * surfaced as a counter that had simply stopped moving.
+       */
+      const effectiveRow = row
+        ? { ...row, quota: result.quota, overage_policy: result.overage_policy || row.overage_policy }
+        : null;
+
       return {
         ...result,
         carriedSubjectType: subjectType,
@@ -164,7 +176,7 @@ export function createEntitlementStore({ getDb, toObjectId = (v) => v, logger =
         carriedSubscriptionId: subscription._id,
         carriedPeriodStart: subscription.period_start || null,
         carriedIdentity: identity,
-        carriedRow: row,
+        carriedRow: effectiveRow,
       };
     } catch (e) {
       logger.warn(`[entitlement] resolve failed for ${featureCode}, allowing through: ${e.message}`);

package/src/subscription-lifecycle.js

@@ -67,6 +67,9 @@ export const SUBSCRIPTION_EVENT_TYPES = Object.freeze([
   "status_changed", "cancelled", "blocked", "expired",
   "payment_captured", "payment_failed",
   "quota_exceeded",
+  // 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",
 ]);
 
 export default { SUBSCRIPTION_STATUSES, LIVE_STATUSES, TRANSITIONS, canTransition, SUBSCRIPTION_EVENT_TYPES };