@fayz-ai/plugin-courses 0.2.4 → 0.8.0

package/dist/index.d.ts

@@ -5,6 +5,20 @@ export interface CoursesPluginOptions {
     navLabel?: string;
     scope?: PluginScope;
     verticalId?: VerticalId;
+    /**
+     * Commerce-vertical modules — ALL OFF by default (the one architectural
+     * rule: shared-surface contributions are opt-in, never broadcast — FAY-1247).
+     * course-admin (the vertical owner) enables everything via its PluginRef
+     * config; a host embedding courses as a lightweight members feature (e.g.
+     * agency-os's "Memberships") gets only the base nav entry + editor.
+     */
+    modules?: {
+        membersArea?: boolean;
+        sales?: boolean;
+        subscriptions?: boolean;
+        financial?: boolean;
+        reports?: boolean;
+    };
 }
 export declare function createCoursesPlugin(options?: CoursesPluginOptions): PluginManifest;
 export { coursesLocales } from './locales';

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,eAAe,CAAA;AA8B5E,MAAM,WAAW,oBAAoB;IACnC,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,UAAU,CAAC,EAAE,MAAM,GAAG,WAAW,GAAG,UAAU,CAAA;IAC9C,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,KAAK,CAAC,EAAE,WAAW,CAAA;IACnB,UAAU,CAAC,EAAE,UAAU,CAAA;CACxB;AAKD,wBAAgB,mBAAmB,CAAC,OAAO,CAAC,EAAE,oBAAoB,GAAG,cAAc,CA0DlF;AAOD,OAAO,EAAE,cAAc,EAAE,MAAM,WAAW,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,eAAe,CAAA;AA8B5E,MAAM,WAAW,oBAAoB;IACnC,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,UAAU,CAAC,EAAE,MAAM,GAAG,WAAW,GAAG,UAAU,CAAA;IAC9C,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,KAAK,CAAC,EAAE,WAAW,CAAA;IACnB,UAAU,CAAC,EAAE,UAAU,CAAA;IACvB;;;;;;OAMG;IACH,OAAO,CAAC,EAAE;QACR,WAAW,CAAC,EAAE,OAAO,CAAA;QACrB,KAAK,CAAC,EAAE,OAAO,CAAA;QACf,aAAa,CAAC,EAAE,OAAO,CAAA;QACvB,SAAS,CAAC,EAAE,OAAO,CAAA;QACnB,OAAO,CAAC,EAAE,OAAO,CAAA;KAClB,CAAA;CACF;AAKD,wBAAgB,mBAAmB,CAAC,OAAO,CAAC,EAAE,oBAAoB,GAAG,cAAc,CAuElF;AAOD,OAAO,EAAE,cAAc,EAAE,MAAM,WAAW,CAAA"}

package/dist/index.js

@@ -2,8 +2,8 @@ import { hashRouterAdapter, registerPluginFactory, registerTranslations, useTran
 import { setCoursesTenantResolver, getCoursesProviderOptional, setCoursesProvider, createMockCoursesProvider, getCoursesProvider } from '@fayz-ai/courses';
 import { useOrganizationStore, PluginSettingsPanel, SettingsGroup, SelectRow, ToggleRow } from '@fayz-ai/saas';
 import * as React2 from 'react';
-import { defineKpiWidget, KpiCard, useModuleLayout, PageHeaderActions, Button, Badge, Input, toast, Card, DataTable } from '@fayz-ai/ui';
-import { jsx, jsxs } from 'react/jsx-runtime';
+import { defineKpiWidget, useModuleLayout, PageHeaderActions, Button, Badge, Input, KpiCard, DataTable, Card, toast } from '@fayz-ai/ui';
+import { jsxs, jsx } from 'react/jsx-runtime';
 
 // src/index.ts
 
@@ -952,12 +952,14 @@ function FeesKpi() {
   const s = useSummary();
   return /* @__PURE__ */ jsx(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 [
-    defineKpiWidget({ id: "courses.kpi.revenue", title: "courses.kpi.revenue", domain: "courses", defaultOrder: 0, component: RevenueKpi }),
-    defineKpiWidget({ id: "courses.kpi.sales", title: "courses.kpi.sales", domain: "courses", defaultOrder: 1, component: SalesKpi }),
-    defineKpiWidget({ id: "courses.kpi.mrr", title: "courses.kpi.mrr", domain: "courses", defaultOrder: 2, component: MrrKpi }),
-    defineKpiWidget({ id: "courses.kpi.fees", title: "courses.kpi.fees", domain: "courses", defaultOrder: 3, component: FeesKpi })
+    ...modules.sales ? [
+      defineKpiWidget({ id: "courses.kpi.revenue", title: "courses.kpi.revenue", domain: "courses", defaultOrder: 0, component: RevenueKpi }),
+      defineKpiWidget({ id: "courses.kpi.sales", title: "courses.kpi.sales", domain: "courses", defaultOrder: 1, component: SalesKpi })
+    ] : [],
+    ...modules.subscriptions ? [defineKpiWidget({ id: "courses.kpi.mrr", title: "courses.kpi.mrr", domain: "courses", defaultOrder: 2, component: MrrKpi })] : [],
+    ...modules.financial ? [defineKpiWidget({ id: "courses.kpi.fees", title: "courses.kpi.fees", domain: "courses", defaultOrder: 3, component: FeesKpi })] : []
   ];
 }
 function createStripeConnector() {
@@ -997,6 +999,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",
@@ -1004,6 +1026,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: [
@@ -1011,27 +1037,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") }