@i4e/invest4edu-access-core 0.30.0 → 0.31.0

package/package.json

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

@@ -157,7 +157,28 @@ export function createEntitlementStore({
        * The per-plan override is your "premium plans give more usage" lever: eCAS can cost 2 on
        * Discover and 1 on Grow without any per-feature matrix returning through the back door.
        */
-      if (creditsMode) {
+      /**
+       * A per-feature BUDGET opts out of credits mode.
+       *
+       * `quota` is overloaded, and the two meanings need opposite handling: on VPD it is "12
+       * sessions a year" — a budget that must decrement and refuse at zero — while on stock tips it
+       * is "5 ideas per answer", a ceiling read on every request and never spent. Credits mode
+       * counts only the wallet, so a budget expressed that way silently never moved: Grow showed
+       * 12 VPD sessions that could be used forever.
+       *
+       * So a row with a real number, on a feature that does NOT shape a response, falls through to
+       * count mode and is governed by its own counter. Credits stay for what is priced in credits.
+       * `shapes_response` is the discriminator because it is a property of the FEATURE — whether it
+       * trims an answer or counts a use — not of the plan that sells it.
+       */
+      const budgetRow = creditsMode ? resolveEntitlementRow(rows, featureCode, now) : null;
+      const isOwnBudget = !!budgetRow
+        && budgetRow.unlocked !== false
+        && feature.shapes_response !== true
+        && budgetRow.quota !== null && budgetRow.quota !== undefined && budgetRow.quota !== ""
+        && Number.isFinite(Number(budgetRow.quota));
+
+      if (creditsMode && !isOwnBudget) {
         const svcRow = resolveEntitlementRow(rows, featureCode, now);
         // Not named in a credits plan → the same fail-open NOT_IN_PLAN as count mode. A plan
         // that forgot to include a feature is a config gap, not a paywall.