@fayz-ai/plugin-courses 0.2.4 → 0.8.0

package/README.md

@@ -1,6 +1,6 @@
 # @fayz-ai/plugin-courses
 
-> **Status: experimental (incubating).** Not capability-complete — missing some or all of the capability bar (data-provider contract w/ supabase+mock pair, entity registries, settings, migrations; see `PLUGIN_PATTERNS.md`). Fine to explore in dogfoods; NOT ready for fresh installs or generated apps, and its API may change without notice.
+> **Status: experimental (incubating).** Not capability-complete — missing some or all of the capability bar (data-provider contract w/ supabase+mock pair, entity registries, settings, migrations; see `docs/PLUGIN-PATTERNS.md`). Fine to explore in dogfoods; NOT ready for fresh installs or generated apps, and its API may change without notice.
 
 > Drop a course-builder admin into any Fayz SaaS — courses, modules, lessons, enrollments.
 

package/dist/dashboardWidgets.d.ts

@@ -1,3 +1,10 @@
 import type { DashboardWidgetDef } from '@fayz-ai/core';
-export declare function createCoursesDashboardWidgets(): DashboardWidgetDef[];
+/** Commerce KPIs are contributed only for the modules the host opted into —
+ *  a host embedding courses as a lightweight members feature must not get
+ *  revenue/MRR cards broadcast onto its home dashboard (FAY-1247 rule). */
+export declare function createCoursesDashboardWidgets(modules?: {
+    sales?: boolean;
+    subscriptions?: boolean;
+    financial?: boolean;
+}): DashboardWidgetDef[];
 //# sourceMappingURL=dashboardWidgets.d.ts.map

package/dist/dashboardWidgets.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"dashboardWidgets.d.ts","sourceRoot":"","sources":["../src/dashboardWidgets.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAA;AA0CvD,wBAAgB,6BAA6B,IAAI,kBAAkB,EAAE,CAOpE"}
+{"version":3,"file":"dashboardWidgets.d.ts","sourceRoot":"","sources":["../src/dashboardWidgets.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAA;AA0CvD;;2EAE2E;AAC3E,wBAAgB,6BAA6B,CAC3C,OAAO,GAAE;IAAE,KAAK,CAAC,EAAE,OAAO,CAAC;IAAC,aAAa,CAAC,EAAE,OAAO,CAAC;IAAC,SAAS,CAAC,EAAE,OAAO,CAAA;CAAO,GAC9E,kBAAkB,EAAE,CAetB"}

package/dist/index.cjs

@@ -974,12 +974,14 @@ function FeesKpi() {
   const s = useSummary();
   return /* @__PURE__ */ jsxRuntime.jsx(ui.KpiCard, { label: t("courses.kpi.fees") || "Platform fees", icon: "Percent", loading: !s, value: s ? formatMoney(s.platformFeeTotal, s.currency) : void 0 });
 }
-function createCoursesDashboardWidgets() {
+function createCoursesDashboardWidgets(modules = {}) {
   return [
-    ui.defineKpiWidget({ id: "courses.kpi.revenue", title: "courses.kpi.revenue", domain: "courses", defaultOrder: 0, component: RevenueKpi }),
-    ui.defineKpiWidget({ id: "courses.kpi.sales", title: "courses.kpi.sales", domain: "courses", defaultOrder: 1, component: SalesKpi }),
-    ui.defineKpiWidget({ id: "courses.kpi.mrr", title: "courses.kpi.mrr", domain: "courses", defaultOrder: 2, component: MrrKpi }),
-    ui.defineKpiWidget({ id: "courses.kpi.fees", title: "courses.kpi.fees", domain: "courses", defaultOrder: 3, component: FeesKpi })
+    ...modules.sales ? [
+      ui.defineKpiWidget({ id: "courses.kpi.revenue", title: "courses.kpi.revenue", domain: "courses", defaultOrder: 0, component: RevenueKpi }),
+      ui.defineKpiWidget({ id: "courses.kpi.sales", title: "courses.kpi.sales", domain: "courses", defaultOrder: 1, component: SalesKpi })
+    ] : [],
+    ...modules.subscriptions ? [ui.defineKpiWidget({ id: "courses.kpi.mrr", title: "courses.kpi.mrr", domain: "courses", defaultOrder: 2, component: MrrKpi })] : [],
+    ...modules.financial ? [ui.defineKpiWidget({ id: "courses.kpi.fees", title: "courses.kpi.fees", domain: "courses", defaultOrder: 3, component: FeesKpi })] : []
   ];
 }
 function createStripeConnector() {
@@ -1019,6 +1021,26 @@ function createCoursesPlugin(options) {
   }
   const base = options?.navPosition ?? 1;
   const section = options?.navSection ?? "main";
+  const modules = options?.modules ?? {};
+  const navigation = [
+    { section, position: base, label: options?.navLabel ?? "Courses", route: "/courses", icon: "BookOpen", permission: read("courses") },
+    ...modules.membersArea ? [{ section, position: base + 1, label: "Members area", route: "/courses/members", icon: "GraduationCap", permission: read("courses") }] : [],
+    ...modules.sales ? [{ section, position: base + 2, label: "Sales", route: "/courses/sales", icon: "TrendingUp", permission: read("courses.sales") }] : [],
+    ...modules.subscriptions ? [{ section, position: base + 3, label: "Subscriptions", route: "/courses/subscriptions", icon: "Repeat", permission: read("courses.sales") }] : [],
+    ...modules.financial ? [{ section, position: base + 4, label: "Financial", route: "/courses/financial", icon: "CreditCard", permission: read("courses.finance") }] : [],
+    ...modules.reports ? [{ section, position: base + 5, label: "Reports", route: "/courses/reports", icon: "BarChart3", permission: read("courses.sales") }] : []
+  ];
+  const routes = [
+    // Static segments outscore the `:id` param in the saas router, so these
+    // resolve before the editor route (AdminShell sorts by routeScore).
+    { path: "/courses", component: asComp(CoursesListPage), permission: read("courses") },
+    ...modules.membersArea ? [{ path: "/courses/members", component: asComp(MembersAreaPage), permission: read("courses") }] : [],
+    ...modules.sales ? [{ path: "/courses/sales", component: asComp(SalesPage), permission: read("courses.sales") }] : [],
+    ...modules.subscriptions ? [{ path: "/courses/subscriptions", component: asComp(SubscriptionsPage), permission: read("courses.sales") }] : [],
+    ...modules.financial ? [{ path: "/courses/financial", component: asComp(FinancialPage), permission: read("courses.finance") }] : [],
+    ...modules.reports ? [{ path: "/courses/reports", component: asComp(ReportsPage), permission: read("courses.sales") }] : [],
+    { path: "/courses/:id", component: asComp(CourseEditorPage) }
+  ];
   return {
     id: "courses",
     name: options?.navLabel ?? "Courses",
@@ -1026,6 +1048,10 @@ function createCoursesPlugin(options) {
     version: "1.0.0",
     scope: options?.scope ?? "vertical",
     verticalId: options?.verticalId,
+    // LMS is its own business model with opt-in commerce modules
+    // (members/sales/subscriptions — see modules.* below) — targets the
+    // saas/admin Panel world rather than the ecommerce storefront.
+    scaffolds: ["saas"],
     defaultEnabled: true,
     dependencies: [],
     declaredFeatures: [
@@ -1033,27 +1059,12 @@ function createCoursesPlugin(options) {
       { id: "courses.sales", label: "Sales", group: "Courses" },
       { id: "courses.finance", label: "Financial", group: "Courses" }
     ],
-    navigation: [
-      { section, position: base, label: options?.navLabel ?? "Courses", route: "/courses", icon: "BookOpen", permission: read("courses") },
-      { section, position: base + 1, label: "Members area", route: "/courses/members", icon: "GraduationCap", permission: read("courses") },
-      { section, position: base + 2, label: "Sales", route: "/courses/sales", icon: "TrendingUp", permission: read("courses.sales") },
-      { section, position: base + 3, label: "Subscriptions", route: "/courses/subscriptions", icon: "Repeat", permission: read("courses.sales") },
-      { section, position: base + 4, label: "Financial", route: "/courses/financial", icon: "CreditCard", permission: read("courses.finance") },
-      { section, position: base + 5, label: "Reports", route: "/courses/reports", icon: "BarChart3", permission: read("courses.sales") }
-    ],
-    routes: [
-      // Static segments outscore the `:id` param in the saas router, so these
-      // resolve before the editor route (AdminShell sorts by routeScore).
-      { path: "/courses", component: asComp(CoursesListPage), permission: read("courses") },
-      { path: "/courses/members", component: asComp(MembersAreaPage), permission: read("courses") },
-      { path: "/courses/sales", component: asComp(SalesPage), permission: read("courses.sales") },
-      { path: "/courses/subscriptions", component: asComp(SubscriptionsPage), permission: read("courses.sales") },
-      { path: "/courses/financial", component: asComp(FinancialPage), permission: read("courses.finance") },
-      { path: "/courses/reports", component: asComp(ReportsPage), permission: read("courses.sales") },
-      { path: "/courses/:id", component: asComp(CourseEditorPage) }
-    ],
+    navigation,
+    routes,
     widgets: [],
-    dashboardWidgets: createCoursesDashboardWidgets(),
+    // Commerce KPIs on the shared 'home' surface follow the same opt-in rule:
+    // no module enabled → no widgets broadcast into a host's dashboard.
+    dashboardWidgets: createCoursesDashboardWidgets(modules),
     connectors: [createStripeConnector()],
     settings: [
       { id: "courses", label: "Courses", icon: "BookOpen", component: asComp(CoursesSettingsTab), order: 20, permission: read("courses") }