@fayz-ai/saas 0.1.6 → 0.2.0

package/dist/shell/components/plugins/ConnectorsHub.d.ts

@@ -0,0 +1,6 @@
+import React from 'react';
+import type { ConnectorDefinition } from '@fayz-ai/core';
+export declare function ConnectorsHub({ connectors }: {
+    connectors: ConnectorDefinition[];
+}): React.JSX.Element;
+//# sourceMappingURL=ConnectorsHub.d.ts.map

package/dist/shell/components/plugins/ConnectorsHub.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ConnectorsHub.d.ts","sourceRoot":"","sources":["../../../../src/shell/components/plugins/ConnectorsHub.tsx"],"names":[],"mappings":"AAAA,OAAO,KAA2C,MAAM,OAAO,CAAA;AAG/D,OAAO,KAAK,EAAE,mBAAmB,EAAmB,MAAM,eAAe,CAAA;AAqJzE,wBAAgB,aAAa,CAAC,EAAE,UAAU,EAAE,EAAE;IAAE,UAAU,EAAE,mBAAmB,EAAE,CAAA;CAAE,qBAUlF"}

package/dist/shell/components/plugins/PluginSettingsPanel.d.ts

@@ -6,17 +6,19 @@ export interface SettingsPanelTab {
     icon?: string;
     content: React.ReactNode;
 }
-export declare function PluginSettingsPanel({ title, subtitle, generalSettings, registries, customTabs, routeBase, onClose }: {
+export declare function PluginSettingsPanel({ title, subtitle, generalSettings, registries, customTabs, routeBase, hostPluginId, onClose }: {
     title: string;
     subtitle?: string;
     /** General preferences component */
     generalSettings?: React.ReactNode;
-    /** CRUD registries — each becomes its own tab */
+    /** CRUD registries — grouped under a "Properties" tab */
     registries?: PluginRegistryDef[];
     /** Additional custom tabs (e.g., Pipeline config for CRM) */
     customTabs?: SettingsPanelTab[];
     /** Hash route base for CRUD sub-routing */
     routeBase: string;
+    /** This plugin's id — used to surface connectors addons registered for it in an Integrations tab. */
+    hostPluginId?: string;
     /** Called when back button is clicked. If not provided, back button is hidden. */
     onClose?: () => void;
 }): React.JSX.Element;

package/dist/shell/components/plugins/PluginSettingsPanel.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"PluginSettingsPanel.d.ts","sourceRoot":"","sources":["../../../../src/shell/components/plugins/PluginSettingsPanel.tsx"],"names":[],"mappings":"AAAA,OAAO,KAA4B,MAAM,OAAO,CAAA;AAKhD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAA;AAU5D,MAAM,WAAW,gBAAgB;IAC/B,EAAE,EAAE,MAAM,CAAA;IACV,KAAK,EAAE,MAAM,CAAA;IACb,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,OAAO,EAAE,KAAK,CAAC,SAAS,CAAA;CACzB;AA4BD,wBAAgB,mBAAmB,CAAC,EAAE,KAAK,EAAE,QAAQ,EAAE,eAAe,EAAE,UAAU,EAAE,UAAU,EAAE,SAAS,EAAE,OAAO,EAAE,EAAE;IACpH,KAAK,EAAE,MAAM,CAAA;IACb,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,oCAAoC;IACpC,eAAe,CAAC,EAAE,KAAK,CAAC,SAAS,CAAA;IACjC,iDAAiD;IACjD,UAAU,CAAC,EAAE,iBAAiB,EAAE,CAAA;IAChC,6DAA6D;IAC7D,UAAU,CAAC,EAAE,gBAAgB,EAAE,CAAA;IAC/B,2CAA2C;IAC3C,SAAS,EAAE,MAAM,CAAA;IACjB,kFAAkF;IAClF,OAAO,CAAC,EAAE,MAAM,IAAI,CAAA;CACrB,qBA+HA"}
+{"version":3,"file":"PluginSettingsPanel.d.ts","sourceRoot":"","sources":["../../../../src/shell/components/plugins/PluginSettingsPanel.tsx"],"names":[],"mappings":"AAAA,OAAO,KAA4B,MAAM,OAAO,CAAA;AAKhD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAA;AAW5D,MAAM,WAAW,gBAAgB;IAC/B,EAAE,EAAE,MAAM,CAAA;IACV,KAAK,EAAE,MAAM,CAAA;IACb,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,OAAO,EAAE,KAAK,CAAC,SAAS,CAAA;CACzB;AAmGD,wBAAgB,mBAAmB,CAAC,EAAE,KAAK,EAAE,QAAQ,EAAE,eAAe,EAAE,UAAU,EAAE,UAAU,EAAE,SAAS,EAAE,YAAY,EAAE,OAAO,EAAE,EAAE;IAClI,KAAK,EAAE,MAAM,CAAA;IACb,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,oCAAoC;IACpC,eAAe,CAAC,EAAE,KAAK,CAAC,SAAS,CAAA;IACjC,yDAAyD;IACzD,UAAU,CAAC,EAAE,iBAAiB,EAAE,CAAA;IAChC,6DAA6D;IAC7D,UAAU,CAAC,EAAE,gBAAgB,EAAE,CAAA;IAC/B,2CAA2C;IAC3C,SAAS,EAAE,MAAM,CAAA;IACjB,qGAAqG;IACrG,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,kFAAkF;IAClF,OAAO,CAAC,EAAE,MAAM,IAAI,CAAA;CACrB,qBAoIA"}

package/dist/shell/createSaasApp.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"createSaasApp.d.ts","sourceRoot":"","sources":["../../src/shell/createSaasApp.tsx"],"names":[],"mappings":"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"}
+{"version":3,"file":"createSaasApp.d.ts","sourceRoot":"","sources":["../../src/shell/createSaasApp.tsx"],"names":[],"mappings":"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"}

package/dist/shell/hooks/useModuleNavigation.d.ts

@@ -21,5 +21,7 @@ export declare function useModuleNavigation(hashBase: string, depthMap?: DepthMa
     direction: NavDirection;
     animationClass: string;
     navigate: (nextView: string, hash?: string) => void;
+    previousView: string | null;
+    back: (fallbackView?: string) => void;
 };
 //# sourceMappingURL=useModuleNavigation.d.ts.map

package/dist/shell/hooks/useModuleNavigation.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useModuleNavigation.d.ts","sourceRoot":"","sources":["../../../src/shell/hooks/useModuleNavigation.ts"],"names":[],"mappings":"AAEA;;;;GAIG;AACH,MAAM,MAAM,YAAY,GAAG,SAAS,GAAG,MAAM,CAAA;AAE7C;;;GAGG;AACH,MAAM,MAAM,QAAQ,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;AAW7C;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,QAAQ,EAAE,QAAQ,SAAY;;;;yBA8DrD,MAAM,SAAS,MAAM;EA8B9D"}
+{"version":3,"file":"useModuleNavigation.d.ts","sourceRoot":"","sources":["../../../src/shell/hooks/useModuleNavigation.ts"],"names":[],"mappings":"AAEA;;;;GAIG;AACH,MAAM,MAAM,YAAY,GAAG,SAAS,GAAG,MAAM,CAAA;AAE7C;;;GAGG;AACH,MAAM,MAAM,QAAQ,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;AAW7C;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,QAAQ,EAAE,QAAQ,SAAY;;;;yBA6ErD,MAAM,SAAS,MAAM;;0BA8BpB,MAAM;EAWhD"}

package/dist/shell/types/crud.d.ts

@@ -1,6 +1,15 @@
 import type React from 'react';
 import type { EntityArchetype } from './entities';
-export type FieldType = 'text' | 'email' | 'phone' | 'url' | 'image' | 'number' | 'currency' | 'select' | 'multiselect' | 'segmented' | 'date' | 'datetime' | 'time' | 'boolean' | 'textarea' | 'color' | 'computed';
+export type FieldType = 'text' | 'email' | 'phone' | 'url' | 'image' | 'number' | 'currency' | 'select' | 'multiselect' | 'segmented' | 'relation' | 'date' | 'datetime' | 'time' | 'boolean' | 'textarea' | 'color' | 'computed';
+/** Foreign-key source for a `relation` field (options loaded from a table). */
+export interface FieldRelation {
+    table: string;
+    valueField?: string;
+    labelField?: string;
+    tenantScoped?: boolean;
+    schema?: string;
+    filter?: Record<string, unknown>;
+}
 /** Read-only display produced by a `computed` field's `compute()`. */
 export interface ComputedFieldValue {
     display: string;
@@ -19,6 +28,8 @@ export interface FieldDef {
         value: string;
         description?: string;
     }[];
+    /** Required for `relation` fields — where to load the option list from. */
+    relation?: FieldRelation;
     min?: number;
     max?: number;
     currency?: string;

package/dist/shell/types/crud.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"crud.d.ts","sourceRoot":"","sources":["../../../src/shell/types/crud.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAA;AAC9B,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAA;AAEjD,MAAM,MAAM,SAAS,GACjB,MAAM,GAAG,OAAO,GAAG,OAAO,GAAG,KAAK,GAAG,OAAO,GAC5C,QAAQ,GAAG,UAAU,GACrB,QAAQ,GAAG,aAAa,GAAG,WAAW,GACtC,MAAM,GAAG,UAAU,GAAG,MAAM,GAC5B,SAAS,GAAG,UAAU,GACtB,OAAO,GAAG,UAAU,CAAA;AAExB,sEAAsE;AACtE,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,MAAM,CAAA;IACf,IAAI,CAAC,EAAE,UAAU,GAAG,UAAU,GAAG,SAAS,CAAA;CAC3C;AAED,MAAM,WAAW,QAAQ;IACvB,GAAG,EAAE,MAAM,CAAA;IACX,KAAK,EAAE,MAAM,CAAA;IACb,IAAI,EAAE,SAAS,CAAA;IACf,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,qDAAqD;IACrD,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,OAAO,CAAC,EAAE,MAAM,EAAE,GAAG;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,WAAW,CAAC,EAAE,MAAM,CAAA;KAAE,EAAE,CAAA;IAC7E,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,sFAAsF;IACtF,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB,WAAW,CAAC,EAAE,OAAO,CAAA;IACrB,UAAU,CAAC,EAAE,OAAO,CAAA;IACpB,kEAAkE;IAClE,YAAY,CAAC,EAAE,OAAO,CAAA;IACtB,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,UAAU,CAAC,EAAE,OAAO,CAAA;IACpB,UAAU,CAAC,EAAE,CAAC,KAAK,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,KAAK,KAAK,CAAC,SAAS,CAAA;IACtD,oFAAoF;IACpF,OAAO,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,KAAK,kBAAkB,GAAG,IAAI,CAAA;IACpE,YAAY,CAAC,EAAE,GAAG,CAAA;IAClB,+EAA+E;IAC/E,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,+EAA+E;IAC/E,IAAI,CAAC,EAAE,CAAC,GAAG,CAAC,CAAA;IACZ,yGAAyG;IACzG,YAAY,CAAC,EAAE,OAAO,CAAA;CACvB;AAED,MAAM,WAAW,UAAU;IACzB,EAAE,EAAE,MAAM,CAAA;IACV,KAAK,EAAE,MAAM,CAAA;IACb,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,oDAAoD;IACpD,OAAO,CAAC,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,CAAA;IACnB,yEAAyE;IACzE,SAAS,CAAC,EAAE,OAAO,CAAA;CACpB;AAED,MAAM,WAAW,SAAS;IACxB,EAAE,EAAE,MAAM,CAAA;IACV,KAAK,EAAE,MAAM,CAAA;IACb,IAAI,CAAC,EAAE,MAAM,CAAA;IACb;2EACuE;IACvE,SAAS,CAAC,EAAE,KAAK,CAAC,aAAa,CAAC,GAAG,CAAC,CAAA;IACpC,+FAA+F;IAC/F,UAAU,CAAC,EAAE,MAAM,EAAE,CAAA;IACrB,sDAAsD;IACtD,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAChC;AAED,MAAM,MAAM,UAAU,GAAG,QAAQ,GAAG,SAAS,GAAG,SAAS,GAAG,UAAU,GAAG,OAAO,GAAG,SAAS,GAAG,SAAS,CAAA;AAExG,MAAM,WAAW,SAAS,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC;IAChD,IAAI,EAAE,MAAM,CAAA;IACZ,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,IAAI,EAAE,MAAM,CAAA;IACZ,gFAAgF;IAChF,MAAM,CAAC,EAAE,UAAU,CAAA;IACnB,MAAM,EAAE,QAAQ,EAAE,CAAA;IAClB,mEAAmE;IACnE,WAAW,CAAC,EAAE,UAAU,EAAE,CAAA;IAC1B,+DAA+D;IAC/D,UAAU,CAAC,EAAE,SAAS,EAAE,CAAA;IACxB,IAAI,CAAC,EAAE;QACL,KAAK,EAAE,MAAM,CAAA;QACb,MAAM,CAAC,EAAE,MAAM,CAAA;QACf,YAAY,CAAC,EAAE,OAAO,CAAA;QACtB,cAAc,CAAC,EAAE,MAAM,CAAA;QACvB,aAAa,CAAC,EAAE,MAAM,EAAE,CAAA;QACxB,aAAa,CAAC,EAAE,MAAM,CAAA;QACtB,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;QAClC,yFAAyF;QACzF,SAAS,CAAC,EAAE,eAAe,CAAA;QAC3B,6DAA6D;QAC7D,aAAa,CAAC,EAAE,MAAM,CAAA;QACtB,wEAAwE;QACxE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;QAChC,sDAAsD;QACtD,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;QAClC,oEAAoE;QACpE,QAAQ,CAAC,EAAE,MAAM,CAAA;KAClB,CAAA;IACD,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,cAAc,CAAC,EAAE,KAAK,GAAG,MAAM,CAAA;IAC/B,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,iFAAiF;IACjF,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,+FAA+F;IAC/F,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB;mFAC+E;IAC/E,MAAM,CAAC,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;KAAE,EAAE,CAAA;CAChD;AAMD,oDAAoD;AACpD,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,UAAU,CAAC,EAAE,OAAO,CAAA;IACpB,WAAW,CAAC,EAAE,OAAO,CAAA;IACrB,YAAY,CAAC,EAAE,OAAO,CAAA;CACvB;AAED,qEAAqE;AACrE,MAAM,MAAM,gBAAgB,GAAG,MAAM,CAAC,MAAM,EAAE,iBAAiB,CAAC,CAAA;AAEhE,yFAAyF;AACzF,MAAM,MAAM,gBAAgB,GAAG,MAAM,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAA"}
+{"version":3,"file":"crud.d.ts","sourceRoot":"","sources":["../../../src/shell/types/crud.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fayz-ai/saas",
-  "version": "0.1.6",
+  "version": "0.2.0",
   "description": "Fayz SDK SaaS layer — multi-tenancy, billing, permissions, org management",
   "type": "module",
   "main": "./dist/index.cjs",
@@ -47,9 +47,9 @@
     "@tanstack/react-table": "^8.20.0",
     "cmdk": "^1.0.0",
     "@radix-ui/react-dialog": "^1.1.0",
-    "@fayz-ai/auth": "^0.1.6",
-    "@fayz-ai/ui": "^0.1.6",
-    "@fayz-ai/core": "^0.1.6"
+    "@fayz-ai/core": "^0.2.0",
+    "@fayz-ai/auth": "^0.2.0",
+    "@fayz-ai/ui": "^0.2.0"
   },
   "devDependencies": {
     "@types/react": "^18.3.0",

package/src/crud/CrudDetailPage.tsx

@@ -15,6 +15,7 @@ import { SERVICE_DETAIL_TABS } from './archetypes/ServiceDetailTabs'
 import { LOCATION_DETAIL_TABS } from './archetypes/LocationDetailTabs'
 import { SUBJECT_DETAIL_TABS } from './archetypes/SubjectDetailTabs'
 import { useTranslation } from '@fayz-ai/core'
+import { usePluginRuntimeOptional, getWidgetsForZone } from '@fayz-ai/core'
 import type { EntityDef, FieldDef, FieldGroup, FormLayout, DetailTab } from '@fayz-ai/core'
 
 interface CrudDetailPageProps {
@@ -246,8 +247,12 @@ export function CrudDetailPage({
   const initial = typeof displayValue === 'string' ? displayValue.charAt(0).toUpperCase() : '?'
 
   // Merge archetype tabs + custom entity tabs
+  const runtime = usePluginRuntimeOptional()
   const archetypeTabs = getArchetypeTabs(entityDef.layout, entityDef.data?.archetypeKind)
   const customTabs = [...archetypeTabs, ...(entityDef.detailTabs ?? [])]
+    // Drop tabs that require a plugin-contributed widget when none is registered
+    // (e.g. the financial statement tab only appears when the financial plugin is active).
+    .filter((tab) => !tab.requiresWidgetZone || (runtime ? getWidgetsForZone(runtime, tab.requiresWidgetZone).length > 0 : false))
   const entityId = entityDef.name.toLowerCase().replace(/\s+/g, '-')
   const widgetZone = `${entityId}.detail.tabs`
 

package/src/crud/CrudFormPage.tsx

@@ -15,6 +15,7 @@ import { SubjectFormLayout } from './archetypes/SubjectFormLayout'
 import { useTranslation } from '@fayz-ai/core'
 import type { FieldDef, FieldGroup, EntityDef } from '@fayz-ai/core'
 import type { FormLayout } from '@fayz-ai/core'
+import { RelationSelect } from './relation-field'
 
 interface CrudFormPageProps {
   entityDef: EntityDef
@@ -133,6 +134,17 @@ function renderField(field: FieldDef, value: any, onChange: (val: any) => void,
           className={`${baseClass} min-h-[60px] py-1.5`}
         />
       )
+    case 'relation':
+      return (
+        <RelationSelect
+          relation={field.relation}
+          value={value}
+          onChange={onChange}
+          className={baseClass}
+          required={field.required}
+          placeholder={field.placeholder ?? `Select ${field.label.toLowerCase()}...`}
+        />
+      )
     case 'select': {
       const options = (field.options ?? []).map((o) =>
         typeof o === 'string' ? { label: o, value: o } : o,

package/src/crud/archetypes/PersonDetailTabs.tsx

@@ -66,6 +66,25 @@ export function DocumentsTab({ item }: { item?: any }) {
   )
 }
 
+export function FinancialTab({ item }: { item?: any }) {
+  const runtime = usePluginsOptional()
+  const widgets = runtime ? getWidgetsForZone(runtime, 'person.detail.financial') : []
+  if (widgets.length > 0 && item) {
+    const w = widgets[0]
+    const Widget = w.component as React.ComponentType<any>
+    return (
+      <Widget
+        item={item}
+        config={w.config}
+        runtime={runtime?.context}
+        plugin={w.plugin}
+        widget={w}
+      />
+    )
+  }
+  return null
+}
+
 export function ScheduleTab({ item }: { item: any }) {
   const t = useTranslation()
   if (!item?.id) {
@@ -83,5 +102,8 @@ export function ScheduleTab({ item }: { item: any }) {
 export const PERSON_DETAIL_TABS = [
   { id: 'schedule', label: 'Schedule', icon: 'CalendarDays', component: ScheduleTab, visibleFor: ['staff'] },
   { id: 'documents', label: 'Documents', icon: 'FileText', component: DocumentsTab },
+  // Per-person financial statement — only shown when the financial plugin contributes
+  // its widget (see requiresWidgetZone). Clients = paid invoices; staff = commissions.
+  { id: 'financial', label: 'Statement', icon: 'DollarSign', component: FinancialTab, requiresWidgetZone: 'person.detail.financial' },
   { id: 'activity', label: 'Activity', icon: 'Clock', component: ActivityTab },
 ]

package/src/crud/fieldToColumn.tsx

@@ -1,6 +1,7 @@
 import React from 'react'
 import type { FieldDef } from '@fayz-ai/core'
 import { Badge } from '@fayz-ai/ui'
+import { RelationCell } from './relation-field'
 import {
   formatCurrency as formatCurrencyLocale,
   formatDate as formatDateLocale,
@@ -95,6 +96,8 @@ export function fieldToColumns(fields: FieldDef[], options?: FieldToColumnsOptio
                 <span className="text-xs text-muted-foreground">{String(value)}</span>
               </span>
             )
+          case 'relation':
+            return <RelationCell relation={field.relation} value={value} />
           case 'select':
             return <Badge variant="secondary">{String(value)}</Badge>
           case 'number':

package/src/crud/index.ts

@@ -9,3 +9,4 @@ export { DeleteConfirmDialog } from './DeleteConfirmDialog'
 export { ImportWizard } from './ImportWizard'
 export type { ImportRowError } from './ImportWizard'
 export { exportToCSV } from './csv-export'
+export { RelationSelect, RelationCell, useRelationOptions, loadRelationOptions, invalidateRelationOptions } from './relation-field'

package/src/crud/relation-field.tsx

@@ -0,0 +1,115 @@
+import React, { useEffect, useState } from 'react'
+import { Badge } from '@fayz-ai/ui'
+import { getSupabaseClientOptional, getActiveTenantId } from '@fayz-ai/core'
+import type { FieldRelation } from '@fayz-ai/core'
+
+// Relation field support for the CRUD engine: load a select's options from a
+// table at runtime so a foreign-key column stores a real id (e.g. uuid) instead
+// of a static string. Shared by the form input (RelationSelect) and the table
+// cell (RelationCell). Options are cached per (schema, table, fields, tenant,
+// filter) so the list + every cell reuse one query.
+
+type Option = { value: string; label: string }
+
+const cache = new Map<string, Promise<Option[]>>()
+
+function keyOf(r: FieldRelation): string {
+  const tenant = r.tenantScoped !== false ? (getActiveTenantId() ?? '') : ''
+  return JSON.stringify([
+    r.schema ?? 'public', r.table, r.valueField ?? 'id', r.labelField ?? 'name',
+    tenant, r.filter ?? null,
+  ])
+}
+
+async function fetchOptions(r: FieldRelation): Promise<Option[]> {
+  const supabase = getSupabaseClientOptional() as any
+  if (!supabase) return []
+  const valueField = r.valueField ?? 'id'
+  const labelField = r.labelField ?? 'name'
+  let q = (r.schema ? supabase.schema(r.schema) : supabase)
+    .from(r.table)
+    .select(`${valueField}, ${labelField}`)
+  if (r.tenantScoped !== false) {
+    const tid = getActiveTenantId()
+    if (tid) q = q.eq('tenant_id', tid)
+  }
+  if (r.filter) for (const [k, v] of Object.entries(r.filter)) q = q.eq(k, v)
+  q = q.order(labelField, { ascending: true })
+  const { data } = await q
+  return (data ?? []).map((row: any) => ({
+    value: String(row[valueField]),
+    label: String(row[labelField] ?? row[valueField]),
+  }))
+}
+
+export function loadRelationOptions(r: FieldRelation): Promise<Option[]> {
+  const k = keyOf(r)
+  if (!cache.has(k)) {
+    cache.set(k, fetchOptions(r).catch(() => { cache.delete(k); return [] }))
+  }
+  return cache.get(k)!
+}
+
+/** Drop cached relation options (call after creating/editing a related row). */
+export function invalidateRelationOptions(): void {
+  cache.clear()
+}
+
+export function useRelationOptions(r: FieldRelation | undefined): {
+  options: Option[]
+  loading: boolean
+  labelFor: (value: any) => string
+} {
+  const [options, setOptions] = useState<Option[]>([])
+  const [loading, setLoading] = useState(true)
+  const dep = r ? keyOf(r) : 'none'
+  useEffect(() => {
+    let alive = true
+    if (!r) { setLoading(false); return }
+    setLoading(true)
+    loadRelationOptions(r).then((opts) => {
+      if (alive) { setOptions(opts); setLoading(false) }
+    })
+    return () => { alive = false }
+  }, [dep]) // eslint-disable-line react-hooks/exhaustive-deps
+  const labelFor = (value: any) => options.find((o) => o.value === String(value))?.label ?? ''
+  return { options, loading, labelFor }
+}
+
+export function RelationSelect({
+  relation,
+  value,
+  onChange,
+  className,
+  required,
+  placeholder,
+}: {
+  relation?: FieldRelation
+  value: any
+  onChange: (value: any) => void
+  className?: string
+  required?: boolean
+  placeholder?: string
+}) {
+  const { options, loading } = useRelationOptions(relation)
+  return (
+    <select
+      value={value ?? ''}
+      onChange={(e) => onChange(e.target.value || null)}
+      required={required}
+      className={className}
+    >
+      <option value="">{loading ? 'Loading…' : (placeholder ?? 'Select...')}</option>
+      {options.map((o) => (
+        <option key={o.value} value={o.value}>{o.label}</option>
+      ))}
+    </select>
+  )
+}
+
+export function RelationCell({ relation, value }: { relation?: FieldRelation; value: any }) {
+  const { labelFor, loading } = useRelationOptions(relation)
+  if (value == null || value === '') return <span className="text-muted-foreground">—</span>
+  const label = labelFor(value)
+  return <Badge variant="secondary">{label || (loading ? '…' : String(value))}</Badge>
+}

package/src/hooks/useModuleNavigation.ts

@@ -60,6 +60,21 @@ export function useModuleNavigation(hashBase: string, depthMap?: DepthMap, homeV
   const [direction, setDirection] = useState<NavDirection>('forward')
   const prevDepthRef = useRef(getDepth(getInitialView()))
 
+  // Track recent in-module views so detail/subpages can render a context-aware
+  // back link ("Back to {where you came from}") and return to the actual
+  // previous page rather than a hard-coded parent route. Records every distinct
+  // view (regardless of how it was reached: navigate(), topbar, browser back).
+  const historyRef = useRef<string[]>([getInitialView()])
+  const [previousView, setPreviousView] = useState<string | null>(null)
+  useEffect(() => {
+    const stack = historyRef.current
+    if (stack[stack.length - 1] !== view) {
+      stack.push(view)
+      if (stack.length > 30) stack.shift()
+    }
+    setPreviousView(stack.length >= 2 ? stack[stack.length - 2] : null)
+  }, [view])
+
   // Sync view from external hash changes (e.g., topbar nav clicking the module link)
   useEffect(() => {
     function handler() {
@@ -118,7 +133,18 @@ export function useModuleNavigation(hashBase: string, depthMap?: DepthMap, homeV
     }
   }, [hashBase])
 
+  // Return to the actual previous page. Uses the browser history when there's
+  // in-app history to pop (preserving the prior page); otherwise navigates to a
+  // sensible fallback (deep links / direct loads have nowhere to go back to).
+  const back = useCallback((fallbackView?: string) => {
+    if (historyRef.current.length >= 2) {
+      window.history.back()
+    } else {
+      navigate(fallbackView ?? homeView)
+    }
+  }, [navigate, homeView])
+
   const animationClass = direction === 'forward' ? 'saas-nav-forward' : 'saas-nav-back'
 
-  return { view, direction, animationClass, navigate }
+  return { view, direction, animationClass, navigate, previousView, back }
 }

package/src/index.ts

@@ -159,6 +159,7 @@ export { setScheduleBlockConfig, getScheduleBlockConfig, subscribeScheduleBlockC
 
 // Shell plugin-settings panel + dedup util (used by vertical plugins)
 export { PluginSettingsPanel } from './shell/components/plugins/PluginSettingsPanel'
+export { ConnectorsHub } from './shell/components/plugins/ConnectorsHub'
 export { dedup } from './shell/lib/dedup'
 
 // Full admin theme type (the shell's theme system, richer than @fayz-ai/core's).

package/src/shell/components/plugins/ConnectorsHub.tsx

@@ -0,0 +1,163 @@
+import React, { useCallback, useEffect, useState } from 'react'
+import { Plug, CheckCircle2, Loader2, ChevronDown, Power } from 'lucide-react'
+import { Button, ICON_MAP } from '@fayz-ai/ui'
+import type { ConnectorDefinition, ConnectorStatus } from '@fayz-ai/core'
+import { useTranslation } from '../../hooks/useTranslation'
+import { toast } from '../notifications/ToastProvider'
+
+// ---------------------------------------------------------------------------
+// Connectors hub — the ONE unified setup experience every connector uses.
+//
+// An addon plugin contributes a ConnectorDefinition; the host plugin's settings
+// render this hub in its "Integrations" tab. Credential connectors (api-key /
+// mtls) get a declarative form (Test / Save); OAuth connectors get a Connect
+// button. Each connector's own extras (import statement, sync now, history) come
+// from its `ExtraPanel`. Adding a new connector needs no change here.
+// ---------------------------------------------------------------------------
+
+function ConnectorCard({ connector }: { connector: ConnectorDefinition }) {
+  const { t } = useTranslation()
+  const [status, setStatus] = useState<ConnectorStatus | null>(null)
+  const [open, setOpen] = useState(false)
+  const [values, setValues] = useState<Record<string, string>>({})
+  const [testing, setTesting] = useState(false)
+  const [saving, setSaving] = useState(false)
+  const [oauthing, setOauthing] = useState(false)
+
+  const loadStatus = useCallback(async () => {
+    try { setStatus(await connector.getStatus()) } catch { setStatus({ connected: false }) }
+  }, [connector])
+
+  useEffect(() => { void loadStatus() }, [loadStatus])
+
+  const connected = !!status?.connected
+  const Icon = connector.icon ? (ICON_MAP[connector.icon] ?? Plug) : Plug
+
+  async function handleTest() {
+    if (!connector.testConnection) return
+    setTesting(true)
+    try {
+      const res = await connector.testConnection(values)
+      res.ok ? toast.success(res.message ?? t('connectors.connected')) : toast.error(res.message ?? t('common.error'))
+    } catch (e: any) { toast.error(e?.message ?? t('common.error')) }
+    finally { setTesting(false) }
+  }
+
+  async function handleSave() {
+    if (!connector.saveConnection) return
+    setSaving(true)
+    try {
+      await connector.saveConnection(values)
+      toast.success(t('connectors.save'))
+      await loadStatus()
+    } catch (e: any) { toast.error(e?.message ?? t('common.error')) }
+    finally { setSaving(false) }
+  }
+
+  async function handleConnectOAuth() {
+    if (!connector.startOAuth) return
+    setOauthing(true)
+    try { window.location.href = await connector.startOAuth(window.location.href) }
+    catch (e: any) { toast.error(e?.message ?? t('common.error')); setOauthing(false) }
+  }
+
+  async function handleDisconnect() {
+    if (!connector.disconnect) return
+    try { await connector.disconnect(); toast.success(t('connectors.disconnect')); await loadStatus() }
+    catch (e: any) { toast.error(e?.message ?? t('common.error')) }
+  }
+
+  const ExtraPanel = connector.ExtraPanel
+
+  return (
+    <div className="rounded-lg border bg-card shadow-sm overflow-hidden">
+      {/* Header — always visible */}
+      <button
+        onClick={() => setOpen((o) => !o)}
+        className="w-full flex items-center gap-3 px-4 py-3 text-left hover:bg-muted/30 transition-colors"
+      >
+        <div className="flex h-9 w-9 items-center justify-center rounded-lg bg-muted shrink-0">
+          <Icon className="h-4 w-4 text-muted-foreground" />
+        </div>
+        <div className="min-w-0 flex-1">
+          <p className="text-sm font-semibold truncate">{connector.name}</p>
+          {connector.description && <p className="text-[11px] text-muted-foreground truncate">{connector.description}</p>}
+        </div>
+        <span className={`inline-flex items-center gap-1 text-[11px] shrink-0 ${connected ? 'text-success' : 'text-muted-foreground'}`}>
+          {connected
+            ? <><CheckCircle2 className="h-3.5 w-3.5" /> {t('connectors.connected')}</>
+            : t('connectors.notConnected')}
+        </span>
+        <ChevronDown className={`h-4 w-4 text-muted-foreground shrink-0 transition-transform ${open ? 'rotate-180' : ''}`} />
+      </button>
+
+      {open && (
+        <div className="border-t px-4 py-4 space-y-4">
+          {/* Connect panel — credentials form OR OAuth */}
+          {connector.authKind === 'oauth' ? (
+            <div className="flex items-center gap-2">
+              <Button onClick={handleConnectOAuth} disabled={oauthing}>
+                {oauthing ? <Loader2 className="h-4 w-4 animate-spin" /> : <Plug className="h-4 w-4" />}
+                {connected ? t('connectors.connected') : `${t('connectors.connect')} ${connector.name}`}
+              </Button>
+              {connected && connector.disconnect && (
+                <Button variant="outline" size="sm" onClick={handleDisconnect}>
+                  <Power className="h-3.5 w-3.5" /> {t('connectors.disconnect')}
+                </Button>
+              )}
+            </div>
+          ) : (
+            <div className="space-y-3">
+              <div className="grid gap-3 sm:grid-cols-2">
+                {(connector.fields ?? []).map((f) => (
+                  <label key={f.key} className="block">
+                    <span className="text-xs font-medium text-muted-foreground">{f.label}</span>
+                    <input
+                      type={f.type}
+                      value={values[f.key] ?? ''}
+                      onChange={(e) => setValues((v) => ({ ...v, [f.key]: e.target.value }))}
+                      placeholder={f.placeholder}
+                      className="w-full mt-1 rounded-input border border-input bg-card px-3 py-2 text-sm focus:outline-none focus:ring-2 focus:ring-ring"
+                    />
+                  </label>
+                ))}
+              </div>
+              <div className="flex gap-2">
+                {connector.testConnection && (
+                  <Button variant="outline" size="sm" onClick={handleTest} disabled={testing}>
+                    {testing ? <Loader2 className="h-3.5 w-3.5 animate-spin" /> : <Plug className="h-3.5 w-3.5" />} {t('connectors.test')}
+                  </Button>
+                )}
+                {connector.saveConnection && (
+                  <Button size="sm" onClick={handleSave} disabled={saving}>
+                    {saving ? <Loader2 className="h-3.5 w-3.5 animate-spin" /> : <CheckCircle2 className="h-3.5 w-3.5" />} {t('connectors.save')}
+                  </Button>
+                )}
+                {connected && connector.disconnect && (
+                  <Button variant="outline" size="sm" onClick={handleDisconnect}>
+                    <Power className="h-3.5 w-3.5" /> {t('connectors.disconnect')}
+                  </Button>
+                )}
+              </div>
+            </div>
+          )}
+
+          {/* Connector-specific extras (import / sync / history) */}
+          {ExtraPanel && <div className="pt-1"><ExtraPanel /></div>}
+        </div>
+      )}
+    </div>
+  )
+}
+
+export function ConnectorsHub({ connectors }: { connectors: ConnectorDefinition[] }) {
+  const { t } = useTranslation()
+  if (!connectors || connectors.length === 0) {
+    return <p className="text-sm text-muted-foreground py-8 text-center">{t('connectors.empty')}</p>
+  }
+  return (
+    <div className="space-y-3 max-w-3xl">
+      {connectors.map((c) => <ConnectorCard key={c.id} connector={c} />)}
+    </div>
+  )
+}