@vritti/api-sdk 0.3.3 → 0.3.5

package/dist/catalog-resolver.cjs

@@ -22,38 +22,147 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 var catalog_resolver_exports = {};
 __export(catalog_resolver_exports, {
   PLATFORMS: () => PLATFORMS,
+  SITE_TYPES: () => SITE_TYPES,
   SNAPSHOT_SCHEMA_VERSION: () => SNAPSHOT_SCHEMA_VERSION,
-  buildBuCatalog: () => buildBuCatalog,
-  buildBuMatrix: () => buildBuMatrix,
-  buildBuRoles: () => buildBuRoles,
+  buildDependsMap: () => buildDependsMap,
+  buildPlanMatrix: () => buildPlanMatrix,
+  buildSiteCatalog: () => buildSiteCatalog,
+  buildSiteMatrix: () => buildSiteMatrix,
+  buildSiteRoles: () => buildSiteRoles,
+  cascadeLocked: () => cascadeLocked,
   composeRoleGrants: () => composeRoleGrants,
-  isBuLockedOnPlatform: () => isBuLockedOnPlatform,
+  featureAppliesAtNode: () => featureAppliesAtNode,
+  filterGrantedByDeps: () => filterGrantedByDeps,
+  findFeatureByCode: () => findFeatureByCode,
   isPlanMember: () => isPlanMember,
+  isSiteLockedOnPlatform: () => isSiteLockedOnPlatform,
   pickRouteForPlatform: () => pickRouteForPlatform,
-  resolveUserFeatures: () => resolveUserFeatures
+  prereqClosure: () => prereqClosure,
+  resolveUserFeatures: () => resolveUserFeatures,
+  snapshotFeatureKey: () => snapshotFeatureKey
 });
 module.exports = __toCommonJS(catalog_resolver_exports);
 
+// src/catalog-resolver/permission-deps.ts
+function buildDependsMap(permissions) {
+  const present = new Set(permissions.map((p) => p.code));
+  const map = /* @__PURE__ */ new Map();
+  for (const p of permissions) {
+    map.set(p.code, (p.dependsOn ?? []).filter((dep) => dep !== p.code && present.has(dep)));
+  }
+  return map;
+}
+__name(buildDependsMap, "buildDependsMap");
+function prereqClosure(code, deps) {
+  const out = /* @__PURE__ */ new Set();
+  const seen = /* @__PURE__ */ new Set([
+    code
+  ]);
+  const stack = [
+    code
+  ];
+  while (stack.length > 0) {
+    const current = stack.pop();
+    for (const dep of deps.get(current) ?? []) {
+      if (seen.has(dep)) continue;
+      seen.add(dep);
+      out.add(dep);
+      stack.push(dep);
+    }
+  }
+  return [
+    ...out
+  ];
+}
+__name(prereqClosure, "prereqClosure");
+function cascadeLocked(codes, directlyLocked, deps) {
+  const locked = /* @__PURE__ */ new Set();
+  const visiting = /* @__PURE__ */ new Set();
+  const check = /* @__PURE__ */ __name((code) => {
+    if (locked.has(code)) return true;
+    if (directlyLocked.has(code)) {
+      locked.add(code);
+      return true;
+    }
+    if (visiting.has(code)) return false;
+    visiting.add(code);
+    const viaDep = (deps.get(code) ?? []).some(check);
+    visiting.delete(code);
+    if (viaDep) locked.add(code);
+    return viaDep;
+  }, "check");
+  for (const code of codes) check(code);
+  return locked;
+}
+__name(cascadeLocked, "cascadeLocked");
+function filterGrantedByDeps(granted, deps) {
+  const ok = /* @__PURE__ */ new Set();
+  const visiting = /* @__PURE__ */ new Set();
+  const check = /* @__PURE__ */ __name((code) => {
+    if (ok.has(code)) return true;
+    if (!granted.has(code)) return false;
+    if (visiting.has(code)) return true;
+    visiting.add(code);
+    const satisfied = (deps.get(code) ?? []).every(check);
+    visiting.delete(code);
+    if (satisfied) ok.add(code);
+    return satisfied;
+  }, "check");
+  for (const code of granted) check(code);
+  return ok;
+}
+__name(filterGrantedByDeps, "filterGrantedByDeps");
+
+// src/catalog-resolver/types.ts
+var PLATFORMS = [
+  "web",
+  "mobile"
+];
+var SITE_TYPES = [
+  "OUTLET",
+  "WAREHOUSE",
+  "PRODUCTION"
+];
+function snapshotFeatureKey(code, scope) {
+  return `${scope}.${code}`;
+}
+__name(snapshotFeatureKey, "snapshotFeatureKey");
+var SNAPSHOT_SCHEMA_VERSION = 2;
+
 // src/catalog-resolver/catalog.builder.ts
-function buildBuCatalog(snapshot, businessCode, planCode, buLocks, bucket) {
+function featureAppliesAtNode(applicableSiteTypes, siteType) {
+  return applicableSiteTypes.includes(siteType);
+}
+__name(featureAppliesAtNode, "featureAppliesAtNode");
+function findFeatureByCode(snapshot, code) {
+  for (const feature of Object.values(snapshot.features ?? {})) {
+    if (feature?.code === code) return feature;
+  }
+  return void 0;
+}
+__name(findFeatureByCode, "findFeatureByCode");
+function buildSiteCatalog(snapshot, businessCode, planCode, siteLocks, bucket, siteType, scope) {
   if (!businessCode) return [];
   const business = snapshot.businesses?.[businessCode];
   if (!business) return [];
   const plan = planCode ? business.plans?.[planCode] : void 0;
   const plans = business.plans ?? {};
   const catalog = [];
-  for (const app of business.apps) {
-    const businessAppFeatures = app.features.map((code) => snapshot.features?.[code]).filter((f) => !!f && !!(f.microfrontends?.web || f.microfrontends?.mobile));
+  const sortedApps = [
+    ...business.apps
+  ].sort((a, b) => a.name.localeCompare(b.name));
+  for (const app of sortedApps) {
+    const businessAppFeatures = app.features.filter((ref) => scope === void 0 || ref.scope === scope).map((ref) => snapshot.features?.[snapshotFeatureKey(ref.code, ref.scope)]).filter((f) => !!f && !!(f.microfrontends?.web || f.microfrontends?.mobile) && (siteType === void 0 || featureAppliesAtNode(f.applicableSiteTypes, siteType)));
     if (businessAppFeatures.length === 0) continue;
     for (const feature of businessAppFeatures) {
       const membership = plan?.unlockedPermissions?.[feature.code];
       const web = feature.microfrontends?.web;
       const mobile = feature.microfrontends?.mobile;
-      const permissions = buildPermissions(feature, businessCode, membership, buLocks, plans, bucket);
+      const permissions = buildPermissions(feature, businessCode, membership, siteLocks, plans, bucket);
       const memberOnBucket = membership?.[bucket] !== void 0;
-      const buPlatformLocked = buLocks?.[feature.code]?.[bucket] === null;
-      const locked = !memberOnBucket || buPlatformLocked;
-      const lockReason = !memberOnBucket ? "PLAN" : buPlatformLocked ? "BU" : null;
+      const sitePlatformLocked = siteLocks?.[feature.code]?.[bucket] === null;
+      const locked = !memberOnBucket || sitePlatformLocked;
+      const lockReason = !memberOnBucket ? "PLAN" : sitePlatformLocked ? "SITE" : null;
       const unlockPlans = lockReason === "PLAN" ? plansIncludingFeature(plans, feature.code, bucket) : [];
       catalog.push({
         code: feature.code,
@@ -85,25 +194,43 @@ function buildBuCatalog(snapshot, businessCode, planCode, buLocks, bucket) {
   }
   return catalog;
 }
-__name(buildBuCatalog, "buildBuCatalog");
+__name(buildSiteCatalog, "buildSiteCatalog");
 function isPlanMember(entry) {
   return !!entry && (entry.web !== void 0 || entry.mobile !== void 0);
 }
 __name(isPlanMember, "isPlanMember");
-function isBuLockedOnPlatform(entry, platform, code) {
+function isSiteLockedOnPlatform(entry, platform, code) {
   const locks = entry?.[platform];
   return locks === null || (locks?.includes(code) ?? false);
 }
-__name(isBuLockedOnPlatform, "isBuLockedOnPlatform");
-function buildPermissions(feature, businessCode, planMembership, buLocks, plans, bucket) {
+__name(isSiteLockedOnPlatform, "isSiteLockedOnPlatform");
+function buildPermissions(feature, businessCode, planMembership, siteLocks, plans, bucket) {
   const planUnlocked = new Set(planMembership?.[bucket] ?? []);
-  const lockEntry = buLocks?.[feature.code];
-  return (feature.permissions ?? []).filter((p) => p.isGlobal || p.businesses.includes(businessCode)).map((p) => {
-    const planAllows = planUnlocked.has(p.code);
-    const buAllows = !isBuLockedOnPlatform(lockEntry, bucket, p.code);
-    const locked = !planAllows || !buAllows;
-    const lockReason = !planAllows ? "PLAN" : !buAllows ? "BU" : null;
-    const unlockPlans = lockReason === "PLAN" ? plansUnlockingPermission(plans, feature.code, p.code, bucket) : [];
+  const lockEntry = siteLocks?.[feature.code];
+  const perms = (feature.permissions ?? []).filter((p) => p.isGlobal || p.businesses.includes(businessCode));
+  const deps = buildDependsMap(perms);
+  const codes = perms.map((p) => p.code);
+  const directlyPlanLocked = /* @__PURE__ */ new Set();
+  const directlySiteLocked = /* @__PURE__ */ new Set();
+  for (const p of perms) {
+    if (!planUnlocked.has(p.code)) directlyPlanLocked.add(p.code);
+    if (isSiteLockedOnPlatform(lockEntry, bucket, p.code)) directlySiteLocked.add(p.code);
+  }
+  const directlyLocked = /* @__PURE__ */ new Set([
+    ...directlyPlanLocked,
+    ...directlySiteLocked
+  ]);
+  const lockedSet = cascadeLocked(codes, directlyLocked, deps);
+  return perms.map((p) => {
+    const locked = lockedSet.has(p.code);
+    const closure = [
+      p.code,
+      ...prereqClosure(p.code, deps)
+    ];
+    const planReason = closure.some((c) => directlyPlanLocked.has(c));
+    const siteReason = closure.some((c) => directlySiteLocked.has(c));
+    const lockReason = !locked ? null : planReason ? "PLAN" : siteReason ? "SITE" : null;
+    const unlockPlans = locked && lockReason === "PLAN" ? plansUnlockingClosure(plans, feature.code, closure, bucket) : [];
     return {
       code: p.code,
       locked,
@@ -113,14 +240,15 @@ function buildPermissions(feature, businessCode, planMembership, buLocks, plans,
   });
 }
 __name(buildPermissions, "buildPermissions");
-function plansUnlockingPermission(plans, featureCode, permCode, bucket) {
+function plansUnlockingClosure(plans, featureCode, closure, bucket) {
   const result = [];
   for (const [code, plan] of Object.entries(plans)) {
-    if (plan.unlockedPermissions?.[featureCode]?.[bucket]?.includes(permCode)) result.push(code);
+    const unlocked = plan.unlockedPermissions?.[featureCode]?.[bucket];
+    if (unlocked && closure.every((c) => unlocked.includes(c))) result.push(code);
   }
   return result;
 }
-__name(plansUnlockingPermission, "plansUnlockingPermission");
+__name(plansUnlockingClosure, "plansUnlockingClosure");
 function plansIncludingFeature(plans, featureCode, bucket) {
   const result = [];
   for (const [code, plan] of Object.entries(plans)) {
@@ -129,23 +257,24 @@ function plansIncludingFeature(plans, featureCode, bucket) {
   return result;
 }
 __name(plansIncludingFeature, "plansIncludingFeature");
-function buildBuRoles(snapshot, businessCode) {
+function buildSiteRoles(snapshot, businessCode) {
   if (!businessCode) return [];
   const business = snapshot.businesses?.[businessCode];
   if (!business) return [];
   return Object.values(business.roleTemplates ?? {});
 }
-__name(buildBuRoles, "buildBuRoles");
+__name(buildSiteRoles, "buildSiteRoles");
 
-// src/catalog-resolver/types.ts
-var PLATFORMS = [
-  "web",
-  "mobile"
-];
-var SNAPSHOT_SCHEMA_VERSION = 1;
-
-// src/catalog-resolver/bu-matrix.builder.ts
-function buildBuMatrix(snapshot, businessCode, planCode, buLocks) {
+// src/catalog-resolver/site-matrix.builder.ts
+function buildSiteMatrix(snapshot, businessCode, planCode, siteLocks, siteType) {
+  return buildMatrix(snapshot, businessCode, planCode, siteLocks, false, siteType);
+}
+__name(buildSiteMatrix, "buildSiteMatrix");
+function buildPlanMatrix(snapshot, businessCode, planCode, siteLocks) {
+  return buildMatrix(snapshot, businessCode, planCode, siteLocks, true);
+}
+__name(buildPlanMatrix, "buildPlanMatrix");
+function buildMatrix(snapshot, businessCode, planCode, siteLocks, allScopes, siteType) {
   const business = businessCode ? snapshot.businesses?.[businessCode] : void 0;
   const plans = business?.plans ?? {};
   const plan = planCode ? plans[planCode] : void 0;
@@ -153,7 +282,7 @@ function buildBuMatrix(snapshot, businessCode, planCode, buLocks) {
     code: planCode ?? "",
     name: plan?.name ?? planCode ?? ""
   };
-  const locks = buLocks ?? {};
+  const locks = siteLocks ?? {};
   if (!business || !plan) return {
     plan: planMeta,
     apps: [],
@@ -164,20 +293,23 @@ function buildBuMatrix(snapshot, businessCode, planCode, buLocks) {
     let unlockedCount = 0;
     let totalCount = 0;
     const features = [];
-    for (const code of app.features) {
-      const feature = snapshot.features?.[code];
+    for (const ref of app.features) {
+      if (!allScopes && ref.scope !== "SITE") continue;
+      const code = ref.code;
+      const feature = snapshot.features?.[snapshotFeatureKey(code, ref.scope)];
       if (!feature) continue;
+      if (siteType !== void 0 && !featureAppliesAtNode(feature.applicableSiteTypes, siteType)) continue;
       const platforms = PLATFORMS.filter((p) => !!feature.microfrontends?.[p]);
       if (platforms.length === 0) continue;
       const membership = plan.unlockedPermissions?.[code];
       const featureInPlan = isPlanMember(membership);
-      const buEntry = buLocks?.[code];
+      const siteEntry = siteLocks?.[code];
       const permissions = (feature.permissions ?? []).filter((p) => p.isGlobal || p.businesses.includes(businessCode ?? "")).map((p) => {
         const cell = /* @__PURE__ */ __name((plat) => {
           if (!platforms.includes(plat)) return null;
           const planCodes = membership?.[plat];
           const inPlan = featureInPlan && planCodes !== void 0 && planCodes.includes(p.code);
-          const selected = inPlan && !isBuLockedOnPlatform(buEntry, plat, p.code);
+          const selected = inPlan && !isSiteLockedOnPlatform(siteEntry, plat, p.code);
           const availableIn = inPlan ? [] : plansUnlockingPerm(plans, code, p.code, plat, planCode);
           totalCount += 1;
           if (inPlan) unlockedCount += 1;
@@ -190,6 +322,7 @@ function buildBuMatrix(snapshot, businessCode, planCode, buLocks) {
         return {
           code: p.code,
           label: p.label,
+          dependsOn: p.dependsOn ?? [],
           web: cell("web"),
           mobile: cell("mobile")
         };
@@ -198,12 +331,15 @@ function buildBuMatrix(snapshot, businessCode, planCode, buLocks) {
         code: feature.code,
         name: feature.name,
         icon: feature.lucideIcon ?? null,
+        scope: feature.scope,
+        applicableSiteTypes: feature.applicableSiteTypes,
         platforms,
         inPlan: featureInPlan,
         availableIn: featureInPlan ? [] : plansIncludingFeature2(plans, code, planCode),
         permissions
       });
     }
+    if (features.length === 0) continue;
     apps.push({
       code: app.code,
       name: app.name,
@@ -213,13 +349,14 @@ function buildBuMatrix(snapshot, businessCode, planCode, buLocks) {
       features
     });
   }
+  apps.sort((a, b) => a.name.localeCompare(b.name));
   return {
     plan: planMeta,
     apps,
     locks
   };
 }
-__name(buildBuMatrix, "buildBuMatrix");
+__name(buildMatrix, "buildMatrix");
 function plansUnlockingPerm(plans, featureCode, permCode, platform, excludeCode) {
   const names = [];
   for (const [code, p] of Object.entries(plans)) {
@@ -278,13 +415,35 @@ __name(composeRoleGrants, "composeRoleGrants");
 
 // src/catalog-resolver/resolve-user-features.ts
 function resolveUserFeatures(params) {
-  const { snapshot, businessCode, planCode, buLocks, roleFeatures, platform } = params;
+  const { snapshot, businessCode, planCode, siteLocks, roleFeatures, platform, siteType, scope } = params;
   const bucket = platform === "web" ? "web" : "mobile";
-  const catalog = buildBuCatalog(snapshot, businessCode, planCode, buLocks, bucket);
+  const featureByCode = /* @__PURE__ */ __name((code) => scope ? snapshot.features?.[snapshotFeatureKey(code, scope)] : findFeatureByCode(snapshot, code), "featureByCode");
+  const catalog = buildSiteCatalog(snapshot, businessCode, planCode, siteLocks, bucket, siteType, scope);
   const catalogMap = new Map(catalog.map((f) => [
     f.code,
     f
   ]));
+  const businessPlans = snapshot.businesses[businessCode]?.plans ?? {};
+  const currentUnlockedCodes = /* @__PURE__ */ new Set();
+  if (planCode && businessPlans[planCode]) {
+    for (const [featureCode, platforms] of Object.entries(businessPlans[planCode].unlockedPermissions ?? {})) {
+      if (platforms?.[bucket] !== void 0) currentUnlockedCodes.add(featureCode);
+    }
+  }
+  const planAdds = /* @__PURE__ */ new Map();
+  for (const [planKey, plan] of Object.entries(businessPlans)) {
+    if (planKey === planCode) continue;
+    const adds = [];
+    for (const [featureCode, platforms] of Object.entries(plan.unlockedPermissions ?? {})) {
+      if (platforms?.[bucket] === void 0 || currentUnlockedCodes.has(featureCode)) continue;
+      const name = featureByCode(featureCode)?.name;
+      if (name) adds.push({
+        code: featureCode,
+        name
+      });
+    }
+    planAdds.set(planKey, adds);
+  }
   const grantedFeatures = /* @__PURE__ */ new Map();
   for (const [code, grant] of Object.entries(roleFeatures ?? {})) {
     const granted = grant?.[bucket];
@@ -298,18 +457,23 @@ function resolveUserFeatures(params) {
     if (!catalogEntry) continue;
     const route = pickRouteForPlatform(catalogEntry, platform);
     if (!route) continue;
+    const featureDeps = buildDependsMap(featureByCode(code)?.permissions ?? []);
     const permByCode = new Map((catalogEntry.permissions ?? []).map((p) => [
       p.code,
       p
     ]));
     const grantedPerms = [
-      ...permsSet
+      ...filterGrantedByDeps(permsSet, featureDeps)
     ];
     const lockedPermissions = grantedPerms.map((c) => permByCode.get(c)).filter((p) => !!p?.locked).map((p) => ({
       code: p.code,
       reason: p.lockReason ?? null,
       unlockPlans: p.unlockPlans ?? []
     }));
+    const upsell = catalogEntry.locked && catalogEntry.lockReason === "PLAN" ? (catalogEntry.unlockPlans ?? []).map((plan) => ({
+      plan,
+      features: (planAdds.get(plan) ?? []).filter((f) => f.code !== code).map((f) => f.name)
+    })).filter((group) => group.features.length > 0) : [];
     features.push({
       code,
       name: catalogEntry.name,
@@ -321,6 +485,7 @@ function resolveUserFeatures(params) {
       lockReason: catalogEntry.lockReason ?? null,
       unlockPlans: catalogEntry.unlockPlans ?? [],
       lockedPermissions,
+      upsell,
       route,
       appCode: catalogEntry.appCode,
       appName: catalogEntry.appName,
@@ -328,6 +493,7 @@ function resolveUserFeatures(params) {
       appSortOrder: catalogEntry.appSortOrder
     });
   }
+  features.sort((a, b) => a.appName.localeCompare(b.appName));
   return features;
 }
 __name(resolveUserFeatures, "resolveUserFeatures");
@@ -351,14 +517,23 @@ __name(pickRouteForPlatform, "pickRouteForPlatform");
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   PLATFORMS,
+  SITE_TYPES,
   SNAPSHOT_SCHEMA_VERSION,
-  buildBuCatalog,
-  buildBuMatrix,
-  buildBuRoles,
+  buildDependsMap,
+  buildPlanMatrix,
+  buildSiteCatalog,
+  buildSiteMatrix,
+  buildSiteRoles,
+  cascadeLocked,
   composeRoleGrants,
-  isBuLockedOnPlatform,
+  featureAppliesAtNode,
+  filterGrantedByDeps,
+  findFeatureByCode,
   isPlanMember,
+  isSiteLockedOnPlatform,
   pickRouteForPlatform,
-  resolveUserFeatures
+  prereqClosure,
+  resolveUserFeatures,
+  snapshotFeatureKey
 });
 //# sourceMappingURL=catalog-resolver.cjs.map