@fayz-ai/plugin-courses 0.8.0 → 0.8.1

package/dist/pages/CoursesListPage.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"CoursesListPage.d.ts","sourceRoot":"","sources":["../../src/pages/CoursesListPage.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAA;AAY9B,wBAAgB,eAAe,sBA2F9B;yBA3Fe,eAAe"}
+{"version":3,"file":"CoursesListPage.d.ts","sourceRoot":"","sources":["../../src/pages/CoursesListPage.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAA;AAa9B,wBAAgB,eAAe,sBAuG9B;yBAvGe,eAAe"}

package/dist/pages/FinancialPage.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"FinancialPage.d.ts","sourceRoot":"","sources":["../../src/pages/FinancialPage.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAA;AAO9B,wBAAgB,aAAa,sBAmE5B;yBAnEe,aAAa"}
+{"version":3,"file":"FinancialPage.d.ts","sourceRoot":"","sources":["../../src/pages/FinancialPage.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAA;AAY9B,wBAAgB,aAAa,sBAmE5B;yBAnEe,aAAa"}

package/package.json

@@ -3,7 +3,7 @@
   "fayz": {
     "status": "preview"
   },
-  "version": "0.8.0",
+  "version": "0.8.1",
   "description": "[experimental] Fayz SDK — courses admin management plugin",
   "type": "module",
   "main": "./dist/index.cjs",
@@ -28,10 +28,10 @@
   "dependencies": {
     "lucide-react": "^0.400.0",
     "@tanstack/react-table": "^8.20.0",
-    "@fayz-ai/core": "^0.8.0",
-    "@fayz-ai/ui": "^0.8.0",
-    "@fayz-ai/courses": "^0.8.0",
-    "@fayz-ai/saas": "^0.8.0"
+    "@fayz-ai/saas": "^0.8.2",
+    "@fayz-ai/core": "^0.8.2",
+    "@fayz-ai/ui": "^0.8.1",
+    "@fayz-ai/courses": "^0.8.0"
   },
   "devDependencies": {
     "@types/react": "^18.3.0",

package/src/index.ts

@@ -33,6 +33,14 @@ 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
   /**
@@ -74,13 +82,14 @@ export function createCoursesPlugin(options?: CoursesPluginOptions): PluginManif
 
   // Opt-in nav/routes per module. Position offsets stay stable relative to the
   // enabled set so hosts control exactly where the block sits.
+  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: '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') }] : []),
+    ...(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 = [
@@ -113,6 +122,9 @@ export function createCoursesPlugin(options?: CoursesPluginOptions): PluginManif
       { id: 'courses.sales', label: 'Sales', group: 'Courses' },
       { id: 'courses.finance', label: 'Financial', group: 'Courses' },
     ],
+    declaredLimits: [
+      { key: 'courses', label: 'Courses', table: 'plg_courses_courses' },
+    ],
     navigation,
     routes,
     widgets: [],

package/src/pages/CoursesListPage.tsx

@@ -2,6 +2,7 @@ import * as React from 'react'
 import { Button, Badge, PageHeaderActions, useModuleLayout } from '@fayz-ai/ui'
 import { useTranslation } from '@fayz-ai/core'
 import { getCoursesProvider, type Course } from '@fayz-ai/courses'
+import { useLimitGuard, invalidateLimit, PermissionGate, usePermissionOptional } from '@fayz-ai/saas'
 import { navigateTo } from '../nav'
 
 function statusVariant(status: Course['status']): 'success' | 'secondary' | 'outline' {
@@ -17,6 +18,8 @@ export function CoursesListPage() {
   const shellOwnsHeader = useModuleLayout() === 'tabs'
   const [courses, setCourses] = React.useState<Course[] | null>(null)
   const [creating, setCreating] = React.useState(false)
+  const guardCourses = useLimitGuard('courses')
+  const can = usePermissionOptional()
 
   const load = React.useCallback(async () => {
     setCourses(await getCoursesProvider().listCourses())
@@ -27,12 +30,18 @@ export function CoursesListPage() {
   }, [load])
 
   async function onCreate() {
+    // Defense in depth: never create without the role's `create` action.
+    if (!can('courses', 'create')) return
+    // Plan quantity guard (client-side, before the provider call). Opens the
+    // global UpgradeModal and aborts when the plan's course cap is reached.
+    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)
@@ -43,9 +52,11 @@ export function CoursesListPage() {
     <div className="mx-auto max-w-6xl p-6 md:p-8">
       {shellOwnsHeader ? (
         <PageHeaderActions>
-          <Button onClick={onCreate} disabled={creating}>
-            {t('courses.new') || 'New course'}
-          </Button>
+          <PermissionGate feature="courses" action="create">
+            <Button onClick={onCreate} disabled={creating}>
+              {t('courses.new') || 'New course'}
+            </Button>
+          </PermissionGate>
         </PageHeaderActions>
       ) : (
         <div className="mb-6 flex items-center justify-between">
@@ -57,9 +68,11 @@ export function CoursesListPage() {
               </p>
             )}
           </div>
-          <Button onClick={onCreate} disabled={creating}>
-            {t('courses.new') || 'New course'}
-          </Button>
+          <PermissionGate feature="courses" action="create">
+            <Button onClick={onCreate} disabled={creating}>
+              {t('courses.new') || 'New course'}
+            </Button>
+          </PermissionGate>
         </div>
       )}
 

package/src/pages/FinancialPage.tsx

@@ -5,6 +5,11 @@ import { getCoursesProvider, type Payout, type FinancialSummary, type CreatorAcc
 import { PageContainer, StatCard, StatGrid, SimpleTable, type SimpleColumn } from '../components/CommerceUI'
 import { formatMoney, formatDate, formatPercent } from '../lib/format'
 
+// No plan gate here on purpose. The page is registered as a shell ROUTE with
+// `permission: read('courses.finance')`, so the route guard already resolves
+// role AND plan for it — and whether `courses.finance` is a paid feature is the
+// APP's call (its billing.ts), never the plugin's. Hardcoding a gate here would
+// bake one product's packaging into the SDK.
 export function FinancialPage() {
   const t = useTranslation()
   const [summary, setSummary] = React.useState<FinancialSummary | null>(null)