@vritti/api-sdk 0.3.3 → 0.3.6

package/dist/catalog-resolver.js

@@ -1,26 +1,130 @@
 var __defProp = Object.defineProperty;
 var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
 
+// 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"
+];
+var SERVICE_CODES = [
+  "GITEA"
+];
+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, availableServices = []) {
   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 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 missingServices = unmetServices(feature, availableServices);
+      const permissions = buildPermissions(feature, businessCode, membership, siteLocks, plans, bucket, missingServices);
+      const lockReason = resolveLockReason(!memberOnBucket, sitePlatformLocked, missingServices);
+      const locked = lockReason !== null;
       const unlockPlans = lockReason === "PLAN" ? plansIncludingFeature(plans, feature.code, bucket) : [];
       catalog.push({
         code: feature.code,
@@ -46,48 +150,81 @@ function buildBuCatalog(snapshot, businessCode, planCode, buLocks, bucket) {
         locked,
         lockReason,
         unlockPlans,
+        missingServices,
         permissions
       });
     }
   }
   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 resolveLockReason(planLocked, siteLocked, missingServices) {
+  if (planLocked) return "PLAN";
+  if (siteLocked) return "SITE";
+  if (missingServices.length > 0) return "SERVICE";
+  return null;
+}
+__name(resolveLockReason, "resolveLockReason");
+function unmetServices(feature, availableServices) {
+  return (feature.requiredServices ?? []).filter((service) => !availableServices.includes(service));
+}
+__name(unmetServices, "unmetServices");
+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, missingServices = []) {
   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 closure = [
+      p.code,
+      ...prereqClosure(p.code, deps)
+    ];
+    const cascaded = lockedSet.has(p.code);
+    const planReason = cascaded && closure.some((c) => directlyPlanLocked.has(c));
+    const siteReason = cascaded && closure.some((c) => directlySiteLocked.has(c));
+    const lockReason = resolveLockReason(planReason, siteReason, missingServices);
+    const locked = lockReason !== null;
+    const unlockPlans = lockReason === "PLAN" ? plansUnlockingClosure(plans, feature.code, closure, bucket) : [];
     return {
       code: p.code,
       locked,
       lockReason,
-      unlockPlans
+      unlockPlans,
+      missingServices
     };
   });
 }
 __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)) {
@@ -96,115 +233,13 @@ 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");
-
-// 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) {
-  const business = businessCode ? snapshot.businesses?.[businessCode] : void 0;
-  const plans = business?.plans ?? {};
-  const plan = planCode ? plans[planCode] : void 0;
-  const planMeta = {
-    code: planCode ?? "",
-    name: plan?.name ?? planCode ?? ""
-  };
-  const locks = buLocks ?? {};
-  if (!business || !plan) return {
-    plan: planMeta,
-    apps: [],
-    locks
-  };
-  const apps = [];
-  for (const app of business.apps) {
-    let unlockedCount = 0;
-    let totalCount = 0;
-    const features = [];
-    for (const code of app.features) {
-      const feature = snapshot.features?.[code];
-      if (!feature) 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 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 availableIn = inPlan ? [] : plansUnlockingPerm(plans, code, p.code, plat, planCode);
-          totalCount += 1;
-          if (inPlan) unlockedCount += 1;
-          return {
-            inPlan,
-            selected,
-            availableIn
-          };
-        }, "cell");
-        return {
-          code: p.code,
-          label: p.label,
-          web: cell("web"),
-          mobile: cell("mobile")
-        };
-      });
-      features.push({
-        code: feature.code,
-        name: feature.name,
-        icon: feature.lucideIcon ?? null,
-        platforms,
-        inPlan: featureInPlan,
-        availableIn: featureInPlan ? [] : plansIncludingFeature2(plans, code, planCode),
-        permissions
-      });
-    }
-    apps.push({
-      code: app.code,
-      name: app.name,
-      icon: app.icon ?? null,
-      unlockedCount,
-      totalCount,
-      features
-    });
-  }
-  return {
-    plan: planMeta,
-    apps,
-    locks
-  };
-}
-__name(buildBuMatrix, "buildBuMatrix");
-function plansUnlockingPerm(plans, featureCode, permCode, platform, excludeCode) {
-  const names = [];
-  for (const [code, p] of Object.entries(plans)) {
-    if (code === excludeCode) continue;
-    if ((p.unlockedPermissions?.[featureCode]?.[platform] ?? []).includes(permCode)) names.push(p.name);
-  }
-  return names;
-}
-__name(plansUnlockingPerm, "plansUnlockingPerm");
-function plansIncludingFeature2(plans, featureCode, excludeCode) {
-  const names = [];
-  for (const [code, p] of Object.entries(plans)) {
-    if (code === excludeCode) continue;
-    if (isPlanMember(p.unlockedPermissions?.[featureCode])) names.push(p.name);
-  }
-  return names;
-}
-__name(plansIncludingFeature2, "plansIncludingFeature");
+__name(buildSiteRoles, "buildSiteRoles");
 
 // src/catalog-resolver/compose-role-grants.ts
 function unionBucket(base, add) {
@@ -245,13 +280,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, availableServices } = 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, availableServices);
   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];
@@ -265,18 +322,24 @@ 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 ?? []
+      unlockPlans: p.unlockPlans ?? [],
+      missingServices: p.missingServices ?? []
     }));
+    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,
@@ -287,7 +350,9 @@ function resolveUserFeatures(params) {
       locked: catalogEntry.locked ?? false,
       lockReason: catalogEntry.lockReason ?? null,
       unlockPlans: catalogEntry.unlockPlans ?? [],
+      missingServices: catalogEntry.missingServices ?? [],
       lockedPermissions,
+      upsell,
       route,
       appCode: catalogEntry.appCode,
       appName: catalogEntry.appName,
@@ -295,6 +360,7 @@ function resolveUserFeatures(params) {
       appSortOrder: catalogEntry.appSortOrder
     });
   }
+  features.sort((a, b) => a.appName.localeCompare(b.appName));
   return features;
 }
 __name(resolveUserFeatures, "resolveUserFeatures");
@@ -315,16 +381,137 @@ function pickRouteForPlatform(entry, platform) {
   };
 }
 __name(pickRouteForPlatform, "pickRouteForPlatform");
+
+// 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;
+  const planMeta = {
+    code: planCode ?? "",
+    name: plan?.name ?? planCode ?? ""
+  };
+  const locks = siteLocks ?? {};
+  if (!business || !plan) return {
+    plan: planMeta,
+    apps: [],
+    locks
+  };
+  const apps = [];
+  for (const app of business.apps) {
+    let unlockedCount = 0;
+    let totalCount = 0;
+    const features = [];
+    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 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 && !isSiteLockedOnPlatform(siteEntry, plat, p.code);
+          const availableIn = inPlan ? [] : plansUnlockingPerm(plans, code, p.code, plat, planCode);
+          totalCount += 1;
+          if (inPlan) unlockedCount += 1;
+          return {
+            inPlan,
+            selected,
+            availableIn
+          };
+        }, "cell");
+        return {
+          code: p.code,
+          label: p.label,
+          dependsOn: p.dependsOn ?? [],
+          web: cell("web"),
+          mobile: cell("mobile")
+        };
+      });
+      features.push({
+        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,
+      icon: app.icon ?? null,
+      unlockedCount,
+      totalCount,
+      features
+    });
+  }
+  apps.sort((a, b) => a.name.localeCompare(b.name));
+  return {
+    plan: planMeta,
+    apps,
+    locks
+  };
+}
+__name(buildMatrix, "buildMatrix");
+function plansUnlockingPerm(plans, featureCode, permCode, platform, excludeCode) {
+  const names = [];
+  for (const [code, p] of Object.entries(plans)) {
+    if (code === excludeCode) continue;
+    if ((p.unlockedPermissions?.[featureCode]?.[platform] ?? []).includes(permCode)) names.push(p.name);
+  }
+  return names;
+}
+__name(plansUnlockingPerm, "plansUnlockingPerm");
+function plansIncludingFeature2(plans, featureCode, excludeCode) {
+  const names = [];
+  for (const [code, p] of Object.entries(plans)) {
+    if (code === excludeCode) continue;
+    if (isPlanMember(p.unlockedPermissions?.[featureCode])) names.push(p.name);
+  }
+  return names;
+}
+__name(plansIncludingFeature2, "plansIncludingFeature");
 export {
   PLATFORMS,
+  SERVICE_CODES,
+  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.js.map