@fayz-ai/plugin-courses 0.2.4 → 0.8.1

package/dist/index.d.ts

@@ -3,8 +3,30 @@ export interface CoursesPluginOptions {
     navPosition?: number;
     navSection?: 'main' | 'secondary' | 'settings';
     navLabel?: string;
+    /** Nav labels for the module entries (default English). */
+    labels?: {
+        membersArea?: string;
+        sales?: string;
+        subscriptions?: string;
+        financial?: string;
+        reports?: 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,2DAA2D;IAC3D,MAAM,CAAC,EAAE;QACP,WAAW,CAAC,EAAE,MAAM,CAAA;QACpB,KAAK,CAAC,EAAE,MAAM,CAAA;QACd,aAAa,CAAC,EAAE,MAAM,CAAA;QACtB,SAAS,CAAC,EAAE,MAAM,CAAA;QAClB,OAAO,CAAC,EAAE,MAAM,CAAA;KACjB,CAAA;IACD,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,CA2ElF;AAOD,OAAO,EAAE,cAAc,EAAE,MAAM,WAAW,CAAA"}

package/dist/index.js

@@ -1,9 +1,9 @@
 import { hashRouterAdapter, registerPluginFactory, registerTranslations, useTranslation } from '@fayz-ai/core';
 import { setCoursesTenantResolver, getCoursesProviderOptional, setCoursesProvider, createMockCoursesProvider, getCoursesProvider } from '@fayz-ai/courses';
-import { useOrganizationStore, PluginSettingsPanel, SettingsGroup, SelectRow, ToggleRow } from '@fayz-ai/saas';
+import { useOrganizationStore, useLimitGuard, usePermissionOptional, PermissionGate, invalidateLimit, 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
 
@@ -314,6 +314,8 @@ function CoursesListPage() {
   const shellOwnsHeader = useModuleLayout() === "tabs";
   const [courses, setCourses] = React2.useState(null);
   const [creating, setCreating] = React2.useState(false);
+  const guardCourses = useLimitGuard("courses");
+  const can = usePermissionOptional();
   const load = React2.useCallback(async () => {
     setCourses(await getCoursesProvider().listCourses());
   }, []);
@@ -321,24 +323,27 @@ function CoursesListPage() {
     void load();
   }, [load]);
   async function onCreate() {
+    if (!can("courses", "create")) return;
+    if (await guardCourses() === "blocked") return;
     setCreating(true);
     try {
       const course = await getCoursesProvider().createCourse({
         title: t("courses.editor.untitledCourse") || "Untitled course",
         status: "draft"
       });
+      invalidateLimit("courses");
       navigateTo(`/courses/${course.id}`);
     } finally {
       setCreating(false);
     }
   }
   return /* @__PURE__ */ jsxs("div", { className: "mx-auto max-w-6xl p-6 md:p-8", children: [
-    shellOwnsHeader ? /* @__PURE__ */ jsx(PageHeaderActions, { children: /* @__PURE__ */ jsx(Button, { onClick: onCreate, disabled: creating, children: t("courses.new") || "New course" }) }) : /* @__PURE__ */ jsxs("div", { className: "mb-6 flex items-center justify-between", children: [
+    shellOwnsHeader ? /* @__PURE__ */ jsx(PageHeaderActions, { children: /* @__PURE__ */ jsx(PermissionGate, { feature: "courses", action: "create", children: /* @__PURE__ */ jsx(Button, { onClick: onCreate, disabled: creating, children: t("courses.new") || "New course" }) }) }) : /* @__PURE__ */ jsxs("div", { className: "mb-6 flex items-center justify-between", children: [
       /* @__PURE__ */ jsxs("div", { children: [
         /* @__PURE__ */ jsx("h1", { className: "text-2xl font-bold text-foreground", children: t("courses.title") || "Courses" }),
         courses && /* @__PURE__ */ jsx("p", { className: "mt-1 text-sm text-muted-foreground", children: (t("courses.count") || "{count} courses").replace("{count}", String(courses.length)) })
       ] }),
-      /* @__PURE__ */ jsx(Button, { onClick: onCreate, disabled: creating, children: t("courses.new") || "New course" })
+      /* @__PURE__ */ jsx(PermissionGate, { feature: "courses", action: "create", children: /* @__PURE__ */ jsx(Button, { onClick: onCreate, disabled: creating, children: t("courses.new") || "New course" }) })
     ] }),
     courses && courses.length === 0 && /* @__PURE__ */ jsx("div", { className: "rounded-xl border border-dashed border-border p-12 text-center text-muted-foreground", children: t("courses.empty") || "No courses yet. Create your first one." }),
     /* @__PURE__ */ jsx("div", { className: "grid grid-cols-1 gap-4 sm:grid-cols-2 lg:grid-cols-3", children: courses?.map((course) => /* @__PURE__ */ jsxs(
@@ -952,12 +957,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 +1004,27 @@ function createCoursesPlugin(options) {
   }
   const base = options?.navPosition ?? 1;
   const section = options?.navSection ?? "main";
+  const modules = options?.modules ?? {};
+  const labels = options?.labels ?? {};
+  const navigation = [
+    { section, position: base, label: options?.navLabel ?? "Courses", route: "/courses", icon: "BookOpen", permission: read("courses") },
+    ...modules.membersArea ? [{ section, position: base + 1, label: labels.membersArea ?? "Members area", route: "/courses/members", icon: "GraduationCap", permission: read("courses") }] : [],
+    ...modules.sales ? [{ section, position: base + 2, label: labels.sales ?? "Sales", route: "/courses/sales", icon: "TrendingUp", permission: read("courses.sales") }] : [],
+    ...modules.subscriptions ? [{ section, position: base + 3, label: labels.subscriptions ?? "Subscriptions", route: "/courses/subscriptions", icon: "Repeat", permission: read("courses.sales") }] : [],
+    ...modules.financial ? [{ section, position: base + 4, label: labels.financial ?? "Financial", route: "/courses/financial", icon: "CreditCard", permission: read("courses.finance") }] : [],
+    ...modules.reports ? [{ section, position: base + 5, label: labels.reports ?? "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 +1032,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 +1043,15 @@ 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) }
+    declaredLimits: [
+      { key: "courses", label: "Courses", table: "plg_courses_courses" }
     ],
+    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") }