@fayz-ai/plugin-inventory 0.8.0 → 0.8.3

package/dist/views/ProductCrudForm.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ProductCrudForm.d.ts","sourceRoot":"","sources":["../../src/views/ProductCrudForm.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAA;AAgBzB,wBAAgB,eAAe,CAAC,EAAE,MAAM,EAAE,OAAO,EAAE,EAAE;IAAE,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,IAAI,CAAA;CAAE,qBAkF7F"}
+{"version":3,"file":"ProductCrudForm.d.ts","sourceRoot":"","sources":["../../src/views/ProductCrudForm.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAA;AAgBzB,wBAAgB,eAAe,CAAC,EAAE,MAAM,EAAE,OAAO,EAAE,EAAE;IAAE,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,IAAI,CAAA;CAAE,qBAuF7F"}

package/dist/views/ProductListView.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ProductListView.d.ts","sourceRoot":"","sources":["../../src/views/ProductListView.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAuC,MAAM,OAAO,CAAA;AAW3D,wBAAgB,eAAe,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE;IACjD,KAAK,CAAC,EAAE,MAAM,IAAI,CAAA;IAClB,MAAM,CAAC,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,IAAI,CAAA;CAC9B,qBA0CA"}
+{"version":3,"file":"ProductListView.d.ts","sourceRoot":"","sources":["../../src/views/ProductListView.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAuC,MAAM,OAAO,CAAA;AAW3D,wBAAgB,eAAe,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE;IACjD,KAAK,CAAC,EAAE,MAAM,IAAI,CAAA;IAClB,MAAM,CAAC,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,IAAI,CAAA;CAC9B,qBA2CA"}

package/dist/views/RecipeFormView.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"RecipeFormView.d.ts","sourceRoot":"","sources":["../../src/views/RecipeFormView.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAmB,MAAM,OAAO,CAAA;AAsBvC,wBAAgB,cAAc,CAAC,EAAE,OAAO,EAAE,EAAE;IAAE,OAAO,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,MAAM,KAAK,IAAI,CAAA;CAAE,qBAoN9E"}
+{"version":3,"file":"RecipeFormView.d.ts","sourceRoot":"","sources":["../../src/views/RecipeFormView.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAmB,MAAM,OAAO,CAAA;AAuBvC,wBAAgB,cAAc,CAAC,EAAE,OAAO,EAAE,EAAE;IAAE,OAAO,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,MAAM,KAAK,IAAI,CAAA;CAAE,qBAyN9E"}

package/dist/views/RecipesView.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"RecipesView.d.ts","sourceRoot":"","sources":["../../src/views/RecipesView.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAoB,MAAM,OAAO,CAAA;AA4BxC,wBAAgB,WAAW,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE;IAAE,KAAK,CAAC,EAAE,MAAM,IAAI,CAAC;IAAC,MAAM,CAAC,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,IAAI,CAAA;CAAE,qBA0EnG"}
+{"version":3,"file":"RecipesView.d.ts","sourceRoot":"","sources":["../../src/views/RecipesView.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAoB,MAAM,OAAO,CAAA;AA6BxC,wBAAgB,WAAW,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE;IAAE,KAAK,CAAC,EAAE,MAAM,IAAI,CAAC;IAAC,MAAM,CAAC,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,IAAI,CAAA;CAAE,qBA4EnG"}

package/package.json

@@ -3,7 +3,7 @@
   "fayz": {
     "status": "beta"
   },
-  "version": "0.8.0",
+  "version": "0.8.3",
   "description": "Fayz SDK — plugin-inventory plugin",
   "type": "module",
   "main": "./dist/index.cjs",
@@ -29,9 +29,9 @@
     "lucide-react": "^0.400.0",
     "zustand": "^4.5.0",
     "@tanstack/react-table": "^8.20.0",
-    "@fayz-ai/ui": "^0.8.0",
-    "@fayz-ai/saas": "^0.8.0",
-    "@fayz-ai/core": "^0.8.0"
+    "@fayz-ai/core": "^0.8.3",
+    "@fayz-ai/ui": "^0.8.3",
+    "@fayz-ai/saas": "^0.8.3"
   },
   "devDependencies": {
     "@types/react": "^18.3.0",

package/src/InventoryContext.tsx

@@ -4,6 +4,8 @@ import type { InventoryDataProvider } from './data/types'
 import type { InventoryUIState } from './store'
 
 export interface InventoryModules {
+  /** Product catalogue screens. Off when the host registers products elsewhere. */
+  products: boolean
   recipes: boolean
   stockLocations: boolean
   batchTracking: boolean

package/src/InventoryPage.tsx

@@ -21,13 +21,13 @@ import { InventoryOnboarding } from './components/InventoryOnboarding'
 function buildNav(config: ResolvedInventoryConfig, view: string, navigate: (v: string) => void, t: (key: string) => string): ModuleNavItem[] {
   const items: ModuleNavItem[] = [
     { id: 'dashboard', label: t('inventory.nav.dashboard'), icon: 'BarChart3', active: view === 'dashboard', onClick: () => navigate('dashboard') },
-    {
+    ...(config.modules.products ? [{
       id: 'products', label: t('inventory.nav.products'), icon: 'Package', active: view.startsWith('products'),
       children: [
         { id: 'products-new', label: t('inventory.nav.new'), active: view === 'products-new', onClick: () => navigate('products-new') },
         { id: 'products-list', label: t('inventory.nav.list'), active: view === 'products-list', onClick: () => navigate('products-list') },
       ],
-    },
+    } as ModuleNavItem] : []),
     {
       id: 'stock', label: t('inventory.nav.stock'), icon: 'ArrowUpCircle',
       children: [
@@ -76,13 +76,15 @@ export function InventoryPage({ config, provider, store, registries }: {
 
   const quickActions = useMemo<PluginQuickAction[]>(() => {
     const actions: PluginQuickAction[] = [
-      {
+      // Dropped with the catalogue module: offering "new product" while the
+      // screen is gone would dead-end the user.
+      ...(config.modules.products ? [{
         id: 'new-product',
         label: t('inventory.quickActions.newProduct'),
         icon: 'Package',
         description: t('inventory.quickActions.newProductDesc'),
         action: () => navigate('products-new'),
-      },
+      } as PluginQuickAction] : []),
       {
         id: 'stock-entry',
         label: t('inventory.quickActions.stockEntry'),
@@ -128,9 +130,13 @@ export function InventoryPage({ config, provider, store, registries }: {
   }
 
   const renderView = createViewRouter([
-    { id: 'products-list', render: () => <ProductListView onNew={() => navigate('products-new')} onEdit={(id) => navigate(`products-edit:${id}`)} /> },
-    { id: 'products-new', render: () => <ProductCrudForm onSaved={() => navigate('products-list')} /> },
-    { id: 'products-edit', render: ({ id }) => <ProductCrudForm editId={id!} onSaved={() => navigate('products-list')} /> },
+    // Routes go with the module, not just the nav entry: leaving them mounted
+    // keeps a second product form reachable by URL.
+    ...(config.modules.products ? [
+      { id: 'products-list', render: () => <ProductListView onNew={() => navigate('products-new')} onEdit={(id: string) => navigate(`products-edit:${id}`)} /> },
+      { id: 'products-new', render: () => <ProductCrudForm onSaved={() => navigate('products-list')} /> },
+      { id: 'products-edit', render: ({ id }: { id?: string }) => <ProductCrudForm editId={id!} onSaved={() => navigate('products-list')} /> },
+    ] : []),
     { id: 'stock-entry', render: () => <StockMovementView defaultType="entry" onSaved={() => navigate('stock-history')} /> },
     { id: 'stock-exit', render: () => <StockMovementView defaultType="exit" onSaved={() => navigate('stock-history')} /> },
     { id: 'stock-history', render: () => <MovementHistoryView onViewDetail={(id) => navigate(`stock-detail:${id}`)} /> },

package/src/components/InventoryGeneralSettings.tsx

@@ -1,25 +1,38 @@
 import React from 'react'
-import { SettingsGroup, ToggleRow } from '@fayz-ai/saas'
+import { SettingsGroup, ToggleRow, useTenantPluginSettings } from '@fayz-ai/saas'
 import { useTranslation } from '@fayz-ai/core'
 
+// Per-tenant defaults = the values that used to be hardcoded here. Persisted +
+// re-hydrated per tenant; behavioural consumption is a follow-up.
+const INVENTORY_DEFAULTS = {
+  lowStockAlerts: true,
+  requireReason: true,
+  autoDeduct: false,
+  requireSku: false,
+  allowNegative: false,
+  lowStockEmail: false,
+  expiryWarnings: true,
+}
+
 export function InventoryGeneralSettings() {
   const t = useTranslation()
+  const s = useTenantPluginSettings('inventory', INVENTORY_DEFAULTS)
   return (
     <div className="space-y-4">
       <SettingsGroup title={t('inventory.settings.stockManagement')} description={t('inventory.settings.stockManagementDesc')}>
-        <ToggleRow label={t('inventory.settings.lowStockAlerts')} description={t('inventory.settings.lowStockAlertsDesc')} checked={true} onChange={() => {}} />
-        <ToggleRow label={t('inventory.settings.requireReason')} description={t('inventory.settings.requireReasonDesc')} checked={true} onChange={() => {}} />
-        <ToggleRow label={t('inventory.settings.autoDeduct')} description={t('inventory.settings.autoDeductDesc')} checked={false} onChange={() => {}} />
+        <ToggleRow label={t('inventory.settings.lowStockAlerts')} description={t('inventory.settings.lowStockAlertsDesc')} checked={s.get('lowStockAlerts')} onChange={(v) => s.set('lowStockAlerts', v)} />
+        <ToggleRow label={t('inventory.settings.requireReason')} description={t('inventory.settings.requireReasonDesc')} checked={s.get('requireReason')} onChange={(v) => s.set('requireReason', v)} />
+        <ToggleRow label={t('inventory.settings.autoDeduct')} description={t('inventory.settings.autoDeductDesc')} checked={s.get('autoDeduct')} onChange={(v) => s.set('autoDeduct', v)} />
       </SettingsGroup>
 
       <SettingsGroup title={t('inventory.settings.products')} description={t('inventory.settings.productsDesc')}>
-        <ToggleRow label={t('inventory.settings.requireSku')} description={t('inventory.settings.requireSkuDesc')} checked={false} onChange={() => {}} />
-        <ToggleRow label={t('inventory.settings.allowNegative')} description={t('inventory.settings.allowNegativeDesc')} checked={false} onChange={() => {}} />
+        <ToggleRow label={t('inventory.settings.requireSku')} description={t('inventory.settings.requireSkuDesc')} checked={s.get('requireSku')} onChange={(v) => s.set('requireSku', v)} />
+        <ToggleRow label={t('inventory.settings.allowNegative')} description={t('inventory.settings.allowNegativeDesc')} checked={s.get('allowNegative')} onChange={(v) => s.set('allowNegative', v)} />
       </SettingsGroup>
 
       <SettingsGroup title={t('inventory.settings.notifications')} description={t('inventory.settings.notificationsDesc')}>
-        <ToggleRow label={t('inventory.settings.lowStockEmail')} description={t('inventory.settings.lowStockEmailDesc')} checked={false} onChange={() => {}} />
-        <ToggleRow label={t('inventory.settings.expiryWarnings')} description={t('inventory.settings.expiryWarningsDesc')} checked={true} onChange={() => {}} />
+        <ToggleRow label={t('inventory.settings.lowStockEmail')} description={t('inventory.settings.lowStockEmailDesc')} checked={s.get('lowStockEmail')} onChange={(v) => s.set('lowStockEmail', v)} />
+        <ToggleRow label={t('inventory.settings.expiryWarnings')} description={t('inventory.settings.expiryWarningsDesc')} checked={s.get('expiryWarnings')} onChange={(v) => s.set('expiryWarnings', v)} />
       </SettingsGroup>
     </div>
   )

package/src/index.ts

@@ -37,6 +37,14 @@ export interface InventoryPluginOptions {
     recipes?: boolean
     stockLocations?: boolean
     batchTracking?: boolean
+    /**
+     * The product catalogue screens (list + form). Defaults on. Turn OFF when the
+     * host already owns product registration elsewhere — an e-commerce app
+     * manages products in the shop plugin, and two competing product CRUDs is
+     * how the same product ends up entered twice, differently.
+     * Stock entry/exit/history stay available either way.
+     */
+    products?: boolean
   }
   labels?: Partial<InventoryPluginLabels>
   productTypes?: Array<{ value: string; label: string }>
@@ -85,6 +93,7 @@ const DEFAULT_PRODUCT_TYPES = [
 function resolveConfig(options?: InventoryPluginOptions): ResolvedInventoryConfig {
   return {
     modules: {
+      products: options?.modules?.products !== false,
       recipes: options?.modules?.recipes !== false,
       stockLocations: options?.modules?.stockLocations !== false,
       batchTracking: options?.modules?.batchTracking ?? false,
@@ -126,6 +135,40 @@ export function createInventoryPlugin(options?: InventoryPluginOptions): PluginM
       { id: 'inventory', label: config.labels.pageTitle, group: config.labels.pageTitle },
       ...(config.modules.recipes ? [{ id: 'inventory.recipes', label: config.labels.recipes ?? 'Recipes', group: config.labels.pageTitle }] : []),
     ],
+    queryEntities: [
+      {
+        key: 'inventory:products',
+        writable: true,
+        entity: {
+          name: 'Product',
+          namePlural: 'Products',
+          icon: 'Package',
+          limitKey: 'products',
+          permission: { feature: 'inventory', action: 'read' },
+          fields: [
+            { key: 'name', label: 'Name', type: 'text', required: true, searchable: true },
+            { key: 'kind', label: 'Kind (sale/ingredient/asset)', type: 'text' },
+            { key: 'price', label: 'Price', type: 'number' },
+            { key: 'cost', label: 'Cost', type: 'number' },
+            { key: 'sku', label: 'SKU', type: 'text', searchable: true },
+            { key: 'isActive', label: 'Active', type: 'boolean' },
+            { key: 'createdAt', label: 'Created at', type: 'text' },
+          ],
+          data: {
+            table: 'products',
+            tenantScoped: true,
+            archetype: 'product',
+            archetypeKind: 'sale',
+            searchColumns: ['name', 'sku'],
+            defaults: { kind: 'sale', status: 'active', is_active: true },
+          },
+        },
+      },
+    ],
+    declaredLimits: [
+      { key: 'products', label: 'Products', table: 'products' },
+      ...(config.modules.recipes ? [{ key: 'recipes', label: config.labels.recipes ?? 'Recipes', table: 'plg_inventory_recipes' }] : []),
+    ],
     navigation: [
       {
         section: options?.navSection ?? 'main',
@@ -141,6 +184,10 @@ export function createInventoryPlugin(options?: InventoryPluginOptions): PluginM
         path: '/inventory',
         component: PageComponent,
         permission: { feature: 'inventory', action: 'read' as const },
+        // Products live on this hand-built page, not a CRUD route, so nothing
+        // would register them and a product the assistant just created would
+        // resolve to no page at all.
+        entityRoutes: ['product:sale', 'product'],
       },
     ],
     widgets: [],

package/src/views/ProductCrudForm.tsx

@@ -1,7 +1,7 @@
 import React from 'react'
 import { SubpageHeader, toast } from '@fayz-ai/ui'
 import { useTranslation } from '@fayz-ai/core'
-import { CrudFormPage } from '@fayz-ai/saas'
+import { CrudFormPage, useLimitGuard, invalidateLimit } from '@fayz-ai/saas'
 import { useInventoryConfig, useInventoryStore, useInventoryProvider } from '../InventoryContext'
 import type { ProductType } from '../types'
 import { buildProductEntity } from './productEntity'
@@ -19,6 +19,7 @@ export function ProductCrudForm({ editId, onSaved }: { editId?: string; onSaved?
   const { productTypes, currency } = useInventoryConfig()
   const provider = useInventoryProvider()
   const createProduct = useInventoryStore((s) => s.createProduct)
+  const guardProducts = useLimitGuard('products')
   const isEdit = !!editId
 
   const [initialData, setInitialData] = React.useState<Record<string, any> | null>(isEdit ? null : {})
@@ -72,7 +73,11 @@ export function ProductCrudForm({ editId, onSaved }: { editId?: string; onSaved?
     if (isEdit && editId) {
       await provider.updateProduct(editId, payload)
     } else {
+      // Plan quantity guard (client-side, before the provider call). Opens the
+      // global UpgradeModal and aborts when the plan's product cap is reached.
+      if ((await guardProducts()) === 'blocked') return
       await createProduct(payload)
+      invalidateLimit('products')
     }
     onSaved?.()
   }

package/src/views/ProductListView.tsx

@@ -52,6 +52,7 @@ export function ProductListView({ onNew, onEdit }: {
       onNew={onNew}
       addLabel={t('inventory.productList.newProduct')}
       onRowClick={(row) => onEdit?.((row as { id: string }).id)}
+      feature="inventory"
     />
   )
 }

package/src/views/RecipeFormView.tsx

@@ -5,6 +5,7 @@ import { toast } from '@fayz-ai/ui'
 import { SubpageHeader, useSaveBar } from '@fayz-ai/ui'
 import { useTranslation } from '@fayz-ai/core'
 import { SearchSelect } from '@fayz-ai/ui'
+import { useLimitGuard, invalidateLimit } from '@fayz-ai/saas'
 import type { CreateRecipeIngredientInput } from '../types'
 
 interface FormIngredient {
@@ -24,6 +25,7 @@ export function RecipeFormView({ onSaved }: { onSaved?: (id?: string) => void })
   const t = useTranslation()
   const provider = useInventoryProvider()
   const createRecipe = useInventoryStore((s) => s.createRecipe)
+  const guardRecipes = useLimitGuard('recipes')
 
   const [name, setName] = useState('')
   const [description, setDescription] = useState('')
@@ -49,6 +51,9 @@ export function RecipeFormView({ onSaved }: { onSaved?: (id?: string) => void })
 
   async function handleSave() {
     if (!name.trim() || !productId || ingredients.length === 0) { toast.error(t('common.formIncomplete')); return }
+    // Plan quantity guard (client-side, before the provider call). Opens the
+    // global UpgradeModal and aborts when the plan's recipe cap is reached.
+    if ((await guardRecipes()) === 'blocked') return
     setSaving(true)
     try {
       const recipe = await createRecipe({
@@ -66,6 +71,7 @@ export function RecipeFormView({ onSaved }: { onSaved?: (id?: string) => void })
           notes: i.notes || undefined,
         })),
       })
+      invalidateLimit('recipes')
       onSaved?.(recipe.id)
     } finally { setSaving(false) }
   }

package/src/views/RecipesView.tsx

@@ -3,6 +3,7 @@ import { BookOpen, Plus, Clock, Layers } from 'lucide-react'
 import { useInventoryStore } from '../InventoryContext'
 import { useTranslation } from '@fayz-ai/core'
 import { SubpageHeader } from '@fayz-ai/ui'
+import { PermissionGate } from '@fayz-ai/saas'
 
 function RecipeSkeleton() {
   return (
@@ -40,9 +41,11 @@ export function RecipesView({ onNew, onView }: { onNew?: () => void; onView?: (i
         title={t('inventory.recipes.title')}
         subtitle={t('inventory.recipes.productionFormulas', { count: String(recipes.length) })}
         actions={onNew && (
-          <button onClick={onNew} className="inline-flex items-center gap-1.5 rounded-lg bg-primary border border-primary px-3 py-2 text-sm font-medium text-primary-foreground hover:bg-primary/90 shadow-button-primary active:shadow-button-inset transition-colors">
-            <Plus className="h-3.5 w-3.5" /> {t('inventory.recipes.newRecipe')}
-          </button>
+          <PermissionGate feature="inventory" action="create">
+            <button onClick={onNew} className="inline-flex items-center gap-1.5 rounded-lg bg-primary border border-primary px-3 py-2 text-sm font-medium text-primary-foreground hover:bg-primary/90 shadow-button-primary active:shadow-button-inset transition-colors">
+              <Plus className="h-3.5 w-3.5" /> {t('inventory.recipes.newRecipe')}
+            </button>
+          </PermissionGate>
         )}
       />