@fayz-ai/plugin-agenda 0.1.8 → 0.2.1

package/src/components/AppointmentModal.tsx

@@ -21,6 +21,7 @@ import { useTranslation } from '@fayz-ai/core'
 import { getCurrentLocale } from '@fayz-ai/core'
 import { isStatusAvailable } from '../types'
 import type { CreateBookingInput, BookingTypeId } from '../types'
+import type { ExternalBookingSource } from '../config'
 
 // ---------------------------------------------------------------------------
 // Helpers
@@ -38,6 +39,7 @@ function formatCompactDate(dateStr: string, locale: string): string {
 }
 
 interface ServiceItem { serviceId: string; name: string; durationMinutes: number; price: number }
+interface CancellationReasonItem { id: string; label: string; requiresNotes?: boolean }
 
 // ---------------------------------------------------------------------------
 // Inline editable number — allows clearing, commits on blur/enter
@@ -266,11 +268,12 @@ interface Props {
   bookingId?: string
   prefill?: Partial<CreateBookingInput> & { endsAt?: string }
   initialTab?: string
+  externalSource?: ExternalBookingSource
   onClose: () => void
-  onCreated?: (bookingId: string) => void
+  onCreated?: (bookingId: string, source?: ExternalBookingSource) => void
 }
 
-export function AppointmentModal({ open, mode, bookingId, prefill, initialTab, onClose, onCreated }: Props) {
+export function AppointmentModal({ open, mode, bookingId, prefill, initialTab, externalSource, onClose, onCreated }: Props) {
   const t = useTranslation()
   const locale = getCurrentLocale()
   const config = useAgendaConfig()
@@ -285,8 +288,12 @@ export function AppointmentModal({ open, mode, bookingId, prefill, initialTab, o
   const storeLocations = useAgendaStore((s) => s.locations)
 
   // --- State ---
+  // Default to the first configured booking type (e.g. 'event' in simple mode,
+  // 'appointment' otherwise) so single-type agendas resolve their type cleanly.
+  const defaultBookingType = (config.bookingTypes[0]?.id ?? 'appointment') as BookingTypeId
   const [loading, setLoading] = useState(mode === 'edit')
-  const [bookingType, setBookingType] = useState<BookingTypeId>(prefill?.kind ?? 'appointment')
+  const [bookingType, setBookingType] = useState<BookingTypeId>(prefill?.kind ?? defaultBookingType)
+  const [title, setTitle] = useState('')
   const [clientId, setClientId] = useState(prefill?.clientId ?? '')
   const [clientSearch, setClientSearch] = useState('')
   const [clientPhone, setClientPhone] = useState('')
@@ -331,6 +338,10 @@ export function AppointmentModal({ open, mode, bookingId, prefill, initialTab, o
   const [clientData, setClientData] = useState<Record<string, any> | null>(null)
   const [clientDataLoading, setClientDataLoading] = useState(false)
   const [clientEditing, setClientEditing] = useState(false)
+  const [cancellationReasons, setCancellationReasons] = useState<CancellationReasonItem[]>([])
+  const [cancellationReasonId, setCancellationReasonId] = useState('')
+  const [cancellationNotes, setCancellationNotes] = useState('')
+  const [cancellationReasonsLoading, setCancellationReasonsLoading] = useState(false)
 
   // Active booking type config
   const activeType = config.bookingTypes.find((bt) => bt.id === bookingType) ?? config.bookingTypes[0]
@@ -343,10 +354,11 @@ export function AppointmentModal({ open, mode, bookingId, prefill, initialTab, o
     setServiceSearch(''); setNotes(''); setStatus('scheduled'); setShowNotes(false)
     setConflict(false); setLoading(mode === 'edit')
     setQuickCreate(false); setNewClientName(''); setNewClientPhone(''); setNewClientEmail(''); setCreatingClient(false)
-    setBookingType(prefill?.kind ?? 'appointment')
+    setBookingType(prefill?.kind ?? defaultBookingType); setTitle('')
     setEditingDate(false); setEditingTime(false); setConfirmingDelete(false); setDeleting(false)
     setEditOrderId(null); setEditOrderTotal(0); setEditPaymentStatus('none'); setPaymentStatusLoading(false)
     setClientData(null); setClientDataLoading(false); setClientEditing(false)
+    setCancellationReasonId(''); setCancellationNotes(''); setCancellationReasonsLoading(false)
     setModalTab((initialTab as 'appointment' | 'client' | 'financial') || 'appointment')
     if (!prefill?.professionalId && professionals.length === 1) setProfessionalId(professionals[0].id)
     setDate(() => {
@@ -368,7 +380,8 @@ export function AppointmentModal({ open, mode, bookingId, prefill, initialTab, o
     setLoading(true)
     provider.getBookingById(bookingId).then((b) => {
       if (!b) { setLoading(false); return }
-      setBookingType((b.kind as BookingTypeId) ?? 'appointment')
+      setBookingType((b.kind as BookingTypeId) ?? defaultBookingType)
+      setTitle(b.clientName ?? '')
       setClientId(b.clientId ?? ''); setClientSearch(b.clientName ?? '')
       setProfessionalId(b.professionalId ?? ''); setLocationId(b.locationId ?? '')
       setDate(b.startsAt.slice(0, 10))
@@ -385,10 +398,11 @@ export function AppointmentModal({ open, mode, bookingId, prefill, initialTab, o
       // Save initial snapshot for dirty check
       const svcSnap = b.services ? b.services.map((s: any) => ({ id: s.serviceId ?? '', dur: s.durationMinutes, price: s.price })) : []
       initialSnapshot.current = JSON.stringify({
+        title: b.clientName ?? '',
         clientId: b.clientId ?? '', professionalId: b.professionalId ?? '', locationId: b.locationId ?? '',
         date: b.startsAt.slice(0, 10),
         startTime: `${String(new Date(b.startsAt).getHours()).padStart(2, '0')}:${String(new Date(b.startsAt).getMinutes()).padStart(2, '0')}`,
-        status: b.status, notes: b.notes ?? '', services: svcSnap,
+        status: b.status, notes: b.notes ?? '', cancellationReasonId: '', cancellationNotes: '', services: svcSnap,
       })
       setLoading(false)
       // Resolve payment status from bridge if available
@@ -415,6 +429,15 @@ export function AppointmentModal({ open, mode, bookingId, prefill, initialTab, o
     }).catch(() => setClientDataLoading(false))
   }, [modalTab, clientId])
 
+  useEffect(() => {
+    if (!open || status !== 'cancelled' || !config.cancellationDetails || cancellationReasons.length > 0) return
+    setCancellationReasonsLoading(true)
+    config.cancellationDetails.listReasons()
+      .then((reasons) => setCancellationReasons(reasons))
+      .catch(() => setCancellationReasons([]))
+      .finally(() => setCancellationReasonsLoading(false))
+  }, [open, status, config.cancellationDetails, cancellationReasons.length])
+
   // Fetch initial service list when modal opens
   useEffect(() => {
     if (!open || !config.serviceLookup) return
@@ -497,14 +520,24 @@ export function AppointmentModal({ open, mode, bookingId, prefill, initialTab, o
       const startsAt = new Date(`${date}T${startTime}:00`).toISOString()
       if (mode === 'create') {
         const newBooking = await createBooking({ kind: bookingType, clientId, professionalId, locationId: locationId || undefined, startsAt, notes: notes || undefined,
+          title: activeType.fields.title ? title.trim() : undefined,
           services: services.map((s: any) => ({ serviceId: s.serviceId, name: s.name, durationMinutes: s.durationMinutes, price: s.price })) })
         onClose()
-        onCreated?.(newBooking.id)
+        onCreated?.(newBooking.id, externalSource)
       } else if (bookingId) {
         await updateBooking(bookingId, {
           clientId, professionalId, locationId: locationId || undefined, startsAt, notes: notes || undefined, status: status as any,
+          title: activeType.fields.title ? title.trim() : undefined,
           services: services.map((s: any) => ({ serviceId: s.serviceId, name: s.name, durationMinutes: s.durationMinutes, price: s.price })),
         })
+        if (status === 'cancelled' && config.cancellationDetails && cancellationReasonId) {
+          await config.cancellationDetails.saveCancellationDetails({
+            bookingId,
+            reasonId: cancellationReasonId,
+            notes: cancellationNotes.trim() || undefined,
+            cancelledAt: new Date().toISOString(),
+          })
+        }
         onClose()
       }
     } catch { /* toast */ }
@@ -519,18 +552,24 @@ export function AppointmentModal({ open, mode, bookingId, prefill, initialTab, o
   }
 
   const isPaidBooking = editPaymentStatus === 'paid'
+  const selectedCancellationReason = cancellationReasons.find((reason) => reason.id === cancellationReasonId)
+  const needsCancellationReason = mode === 'edit' && status === 'cancelled' && !!config.cancellationDetails
+  const needsCancellationNotes = needsCancellationReason && !!selectedCancellationReason?.requiresNotes
 
   // Dirty check — only enable Update when something changed
   const formSnapshot = useMemo(() =>
-    JSON.stringify({ clientId, professionalId, locationId, date, startTime, status, notes, services: services.map((s: any) => ({ id: s.serviceId, dur: s.durationMinutes, price: s.price })) }),
-    [clientId, professionalId, locationId, date, startTime, status, notes, services]
+    JSON.stringify({ title, clientId, professionalId, locationId, date, startTime, status, notes, cancellationReasonId, cancellationNotes, services: services.map((s: any) => ({ id: s.serviceId, dur: s.durationMinutes, price: s.price })) }),
+    [title, clientId, professionalId, locationId, date, startTime, status, notes, cancellationReasonId, cancellationNotes, services]
   )
   const isDirty = mode === 'create' || formSnapshot !== initialSnapshot.current
 
   const canSubmit = (
+    (!activeType.fields.title || title.trim()) &&
     (!activeType.requiresClient || clientId) &&
     (!activeType.fields.professional || professionalId) &&
     (!activeType.requiresServices || services.length > 0) &&
+    (!needsCancellationReason || !!cancellationReasonId) &&
+    (!needsCancellationNotes || !!cancellationNotes.trim()) &&
     !conflict && !saving
   )
 
@@ -748,6 +787,16 @@ export function AppointmentModal({ open, mode, bookingId, prefill, initialTab, o
 
             {!loading && <>
 
+            {/* Title — free-text event name (simple / Google-Calendar-style events) */}
+            {activeType.fields.title && (
+              <div className="flex items-center gap-3 py-1">
+                <Calendar className="h-4 w-4 text-muted-foreground shrink-0" />
+                <input type="text" value={title} onChange={(e) => setTitle(e.target.value)}
+                  placeholder={t('agenda.appointment.addTitle')} autoFocus={mode === 'create'}
+                  className="w-full flex-1 rounded-input border border-input bg-card shadow-[inset_0_1px_0_rgb(0_0_0_/0.06)] px-2.5 py-1.5 text-sm font-medium focus:outline-none focus:ring-2 focus:ring-ring" />
+              </div>
+            )}
+
             {/* Client */}
             {activeType.fields.client && (
               <div className="flex items-center gap-3 py-1">
@@ -927,6 +976,34 @@ export function AppointmentModal({ open, mode, bookingId, prefill, initialTab, o
               </div>
             )}
 
+            {needsCancellationReason && (
+              <div className="flex items-start gap-3 py-1">
+                <Ban className="h-4 w-4 mt-2 text-muted-foreground shrink-0" />
+                <div className="flex-1 space-y-2">
+                  <select
+                    value={cancellationReasonId}
+                    onChange={(event) => setCancellationReasonId(event.target.value)}
+                    disabled={cancellationReasonsLoading}
+                    className="w-full rounded-input border border-input bg-card px-2.5 py-1.5 text-sm shadow-[inset_0_1px_0_rgb(0_0_0_/0.06)] focus:outline-none focus:ring-2 focus:ring-ring"
+                  >
+                    <option value="">{cancellationReasonsLoading ? t('agenda.cancellation.loadingReasons') : t('agenda.cancellation.selectReason')}</option>
+                    {cancellationReasons.map((reason) => (
+                      <option key={reason.id} value={reason.id}>
+                        {reason.label}{reason.requiresNotes ? ' *' : ''}
+                      </option>
+                    ))}
+                  </select>
+                  <textarea
+                    value={cancellationNotes}
+                    onChange={(event) => setCancellationNotes(event.target.value)}
+                    placeholder={needsCancellationNotes ? t('agenda.cancellation.notesRequired') : t('agenda.cancellation.notesOptional')}
+                    rows={2}
+                    className="w-full rounded-input border border-input bg-card px-2.5 py-1.5 text-sm resize-none shadow-[inset_0_1px_0_rgb(0_0_0_/0.06)] focus:outline-none focus:ring-2 focus:ring-ring"
+                  />
+                </div>
+              </div>
+            )}
+
             {/* Notes — progressive disclosure */}
             {!showNotes ? (
               <div className="flex items-center gap-3 py-1">

package/src/components/AppointmentPopover.tsx

@@ -126,7 +126,14 @@ export function AppointmentPopover({ booking, position, onClose, onEdit }: Props
             <div className="flex items-start gap-3">
               <span className="mt-1.5 h-3 w-3 rounded shrink-0" style={{ backgroundColor: color }} />
               <div className="min-w-0">
-                <PersonLink personId={booking.clientId} name={booking.clientName ?? 'Unknown'} className="text-base" />
+                {/* Client agendas link to the person; simple events (no client
+                    capability) render the free-text title as a plain heading —
+                    booking.clientName carries the event title in that model. */}
+                {config.capabilities.client ? (
+                  <PersonLink personId={booking.clientId} name={booking.clientName ?? 'Unknown'} className="text-base" />
+                ) : (
+                  <p className="text-base font-medium truncate">{booking.clientName || t('agenda.appointment.untitled')}</p>
+                )}
                 <p className="text-sm text-muted-foreground mt-0.5">{fmtDate(booking.startsAt)} &middot; {timeRange}</p>
               </div>
             </div>
@@ -142,7 +149,7 @@ export function AppointmentPopover({ booking, position, onClose, onEdit }: Props
               </div>
             )}
 
-            {booking.professionalName && (
+            {config.capabilities.professional && booking.professionalName && (
               <div className="flex items-center gap-3">
                 <User className="h-4 w-4 text-muted-foreground shrink-0" />
                 <span className="text-sm">{booking.professionalName}</span>
@@ -204,14 +211,17 @@ export function AppointmentPopover({ booking, position, onClose, onEdit }: Props
               )
             })()}
 
-            <div className="pt-2 border-t fayz-glass-divider">
-              <PopoverStatusSelect
-                value={booking.status}
-                statuses={config.statuses}
-                bookingStartsAt={booking.startsAt}
-                onChange={(v) => { updateStatus(booking.id, v); onClose() }}
-              />
-            </div>
+            {/* Status workflow — hidden for simple events (no status capability). */}
+            {config.capabilities.status && (
+              <div className="pt-2 border-t fayz-glass-divider">
+                <PopoverStatusSelect
+                  value={booking.status}
+                  statuses={config.statuses}
+                  bookingStartsAt={booking.startsAt}
+                  onChange={(v) => { updateStatus(booking.id, v); onClose() }}
+                />
+              </div>
+            )}
           </div>
         </>
       )}

package/src/components/EventContextMenu.tsx

@@ -101,6 +101,8 @@ export function EventContextMenu({ booking, position, onClose, onEdit }: Props)
             )}
           </div>
 
+          {/* Status workflow — hidden for simple events (no status capability). */}
+          {config.capabilities.status && (
           <div className="border-t px-4 py-3">
             <p className="text-[11px] font-medium text-muted-foreground mb-2">{t('agenda.contextMenu.changeStatus')}</p>
             <div className="flex items-center gap-1.5">
@@ -115,6 +117,7 @@ export function EventContextMenu({ booking, position, onClose, onEdit }: Props)
               })}
             </div>
           </div>
+          )}
         </>
       )}
     </FloatingPanel>

package/src/config.ts

@@ -1,4 +1,4 @@
-import type { PluginScope, VerticalId } from '@fayz-ai/core'
+import type { PluginRegistryDef, PluginScope, VerticalId } from '@fayz-ai/core'
 import type { EntityLookup } from '@fayz-ai/saas'
 import type { AgendaDataProvider } from './data/types'
 import type { StatusConfig, BookingTypeConfig } from './types'
@@ -29,6 +29,28 @@ export interface ConfirmationChannelOption {
   icon: string
 }
 
+export interface CancellationReasonOption {
+  id: string
+  label: string
+  requiresNotes?: boolean
+}
+
+export interface CancellationDetailsProvider {
+  listReasons(): Promise<CancellationReasonOption[]>
+  saveCancellationDetails(input: {
+    bookingId: string
+    reasonId: string
+    notes?: string
+    cancelledAt?: string
+  }): Promise<void>
+}
+
+export interface ExternalBookingSource {
+  type: string
+  id?: string
+  [key: string]: unknown
+}
+
 export interface LocationOption {
   id: string
   name: string
@@ -60,6 +82,14 @@ export interface AgendaPluginOptions {
   /** Booking type tabs shown in the appointment modal */
   bookingTypes?: BookingTypeConfig[]
 
+  /**
+   * Simplifies the agenda to Google-Calendar-style events (no client /
+   * professional / service). When set to 'simple', the plugin exposes a single
+   * "Evento" booking type whose modal shows only title / date-time / notes.
+   * Ignored when an explicit `bookingTypes` override is provided.
+   */
+  eventMode?: 'simple'
+
   /** Booking status options */
   statuses?: StatusConfig[]
 
@@ -105,6 +135,15 @@ export interface AgendaPluginOptions {
   /** Confirmation channel options */
   confirmationChannels?: ConfirmationChannelOption[]
 
+  /** Optional app/plugin bridge for cancel-time reason capture. */
+  cancellationDetails?: CancellationDetailsProvider
+
+  /** Called after a booking is created from an external operational source. */
+  onBookingCreated?: (input: { bookingId: string; source?: ExternalBookingSource }) => void | Promise<void>
+
+  /** App-owned registries shown under /settings/agenda Properties. */
+  settingsRegistries?: PluginRegistryDef[]
+
   /** Financial bridge for agenda × financial cross-plugin integration */
   financialBridge?: AgendaFinancialBridge
 
@@ -172,6 +211,17 @@ const DEFAULT_BOOKING_TYPES: BookingTypeConfig[] = [
   },
 ]
 
+// Simple / Google-Calendar-style event — a single "Evento" type with just a
+// free-text title, date-time and notes. No client / professional / service.
+// Used by personal-finance-style agendas (see eventMode: 'simple').
+const SIMPLE_EVENT_BOOKING_TYPES: BookingTypeConfig[] = [
+  {
+    id: 'event', label: 'Event', icon: 'Calendar', color: '#6366f1',
+    fields: { title: true, client: false, professional: false, services: false, location: false, status: false },
+    requiresServices: false, requiresClient: false,
+  },
+]
+
 // ---------------------------------------------------------------------------
 // Resolved config — fully merged, no optionals
 // ---------------------------------------------------------------------------
@@ -185,6 +235,24 @@ export interface AgendaModules {
   financial: boolean
 }
 
+/**
+ * Derived UI capabilities — computed ONCE in resolveConfig from the resolved
+ * bookingTypes so no component ever re-derives "is this a simple event agenda?"
+ * ad-hoc. A capability is enabled when ANY booking type uses that field. In
+ * eventMode:'simple' the single "Evento" type disables
+ * client/professional/services/location/status, so every consumer (popover,
+ * filter rail, modal) hides the professional/service/status machinery in one
+ * place instead of scattering `eventMode === 'simple'` checks.
+ */
+export interface AgendaCapabilities {
+  title: boolean
+  client: boolean
+  professional: boolean
+  services: boolean
+  location: boolean
+  status: boolean
+}
+
 export interface AgendaCurrency {
   code: string
   locale: string
@@ -193,6 +261,10 @@ export interface AgendaCurrency {
 
 export interface ResolvedAgendaConfig {
   modules: AgendaModules
+  /** Whether this is a simple Google-Calendar-style event agenda (eventMode:'simple'). */
+  simpleMode: boolean
+  /** Derived once from bookingTypes — see AgendaCapabilities. */
+  capabilities: AgendaCapabilities
   labels: AgendaPluginLabels
   currency: AgendaCurrency
   bookingKind: string
@@ -207,6 +279,8 @@ export interface ResolvedAgendaConfig {
   autoCreateOrder: boolean
   locations: LocationOption[]
   confirmationChannels: ConfirmationChannelOption[]
+  cancellationDetails?: CancellationDetailsProvider
+  onBookingCreated?: (input: { bookingId: string; source?: ExternalBookingSource }) => void | Promise<void>
   contactLookup?: EntityLookup
   clientEntityDef?: EntityDef
   serviceLookup?: EntityLookup
@@ -228,22 +302,45 @@ export interface ResolvedAgendaConfig {
 // ---------------------------------------------------------------------------
 
 export function resolveConfig(options?: AgendaPluginOptions): ResolvedAgendaConfig {
+  // ── eventMode:'simple' derives ALL module + capability defaults ONCE, here. ──
+  // Simple = Google-Calendar-style events (title/description + timestamp). It
+  // flips professional/service machinery OFF by default: no working-hours /
+  // schedule checks, no confirmations outreach, no conflict (double-booking)
+  // detection, no location. Explicit `modules.*` re-enable individually. Full
+  // mode (beauty) is unchanged — every default below matches the old behavior
+  // when `simple` is false. Field-level machinery (client/professional/
+  // services/location/status/title) is derived into `capabilities` from the
+  // resolved bookingTypes, so components never test eventMode themselves.
+  const simple = options?.eventMode === 'simple'
+  const bookingTypes = options?.bookingTypes
+    ?? (simple ? SIMPLE_EVENT_BOOKING_TYPES : DEFAULT_BOOKING_TYPES)
+  const capabilities: AgendaCapabilities = {
+    title: bookingTypes.some((bt) => bt.fields.title === true),
+    client: bookingTypes.some((bt) => bt.fields.client),
+    professional: bookingTypes.some((bt) => bt.fields.professional),
+    services: bookingTypes.some((bt) => bt.fields.services),
+    location: bookingTypes.some((bt) => bt.fields.location),
+    status: bookingTypes.some((bt) => bt.fields.status),
+  }
   return {
     modules: {
-      workingHours: options?.modules?.workingHours !== false,
-      confirmations: options?.modules?.confirmations !== false,
-      conflictDetection: options?.modules?.conflictDetection !== false,
+      // Off-unless-explicit in simple mode (`?? !simple`); default-on in full.
+      workingHours: options?.modules?.workingHours ?? !simple,
+      confirmations: options?.modules?.confirmations ?? !simple,
+      conflictDetection: options?.modules?.conflictDetection ?? !simple,
       dragAndDrop: options?.modules?.dragAndDrop !== false,
       locationSelection: options?.modules?.locationSelection === true,
       financial: options?.modules?.financial ?? !!options?.financialBridge,
     },
+    simpleMode: simple,
+    capabilities,
     labels: { ...DEFAULT_LABELS, ...options?.labels },
     currency: { ...DEFAULT_CURRENCY, ...options?.currency },
     bookingKind: options?.bookingKind ?? 'appointment',
     orderKind: options?.orderKind ?? 'service_order',
     scheduleKind: options?.scheduleKind ?? 'working_hours',
     statuses: options?.statuses ?? DEFAULT_STATUSES,
-    bookingTypes: options?.bookingTypes ?? DEFAULT_BOOKING_TYPES,
+    bookingTypes,
     businessHours: options?.businessHours ?? { startTime: '07:00', endTime: '21:00' },
     slotDuration: options?.slotDuration ?? 30,
     professionalKind: options?.professionalKind ?? 'staff',
@@ -251,6 +348,8 @@ export function resolveConfig(options?: AgendaPluginOptions): ResolvedAgendaConf
     autoCreateOrder: options?.autoCreateOrder !== false,
     locations: options?.locations ?? [],
     confirmationChannels: options?.confirmationChannels ?? [],
+    cancellationDetails: options?.cancellationDetails,
+    onBookingCreated: options?.onBookingCreated,
     contactLookup: options?.contactLookup,
     clientEntityDef: options?.clientEntityDef,
     serviceLookup: options?.serviceLookup,

package/src/data/index.ts

@@ -1,3 +1,4 @@
 export type { AgendaDataProvider } from './types'
 export { createMockAgendaProvider } from './mock'
+export type { MockAgendaSeed, MockAgendaProviderOptions } from './mock'
 export { createSupabaseAgendaProvider } from './supabase'

package/src/data/mock.ts

@@ -133,10 +133,26 @@ function createSampleSchedules(): Schedule[] {
 // Mock provider factory
 // ---------------------------------------------------------------------------
 
-export function createMockAgendaProvider(): AgendaDataProvider {
-  const bookings: CalendarBooking[] = createSampleBookings()
-  const schedules: Schedule[] = createSampleSchedules()
-  const professionals: Professional[] = [...SAMPLE_PROFESSIONALS]
+/**
+ * Pre-populated agenda data. Any omitted collection falls back to the built-in
+ * salon-style sample. Pass `bookings` (and optionally an empty `professionals`)
+ * to render a calendar seeded with app-specific events.
+ */
+export interface MockAgendaSeed {
+  bookings?: CalendarBooking[]
+  professionals?: Professional[]
+  schedules?: Schedule[]
+}
+
+export interface MockAgendaProviderOptions {
+  seed?: MockAgendaSeed
+}
+
+export function createMockAgendaProvider(options?: MockAgendaProviderOptions): AgendaDataProvider {
+  const seed = options?.seed
+  const bookings: CalendarBooking[] = seed?.bookings ? [...seed.bookings] : createSampleBookings()
+  const schedules: Schedule[] = seed?.schedules ? [...seed.schedules] : createSampleSchedules()
+  const professionals: Professional[] = seed?.professionals ? [...seed.professionals] : [...SAMPLE_PROFESSIONALS]
 
   return {
     async getLocations(): Promise<Array<{ id: string; name: string }>> {
@@ -167,7 +183,7 @@ export function createMockAgendaProvider(): AgendaDataProvider {
         startsAt: input.startsAt, endsAt: addMinutes(input.startsAt, totalDuration || 30),
         status: 'scheduled', notes: input.notes ?? null,
         orderId: input.services.length > 0 ? uid() : null, locationId: input.locationId ?? null, metadata: {},
-        clientId: input.clientId, clientName: 'New Client', clientPhone: null, clientEmail: null, clientAvatarUrl: null,
+        clientId: input.clientId, clientName: input.title?.trim() || 'New Client', clientPhone: null, clientEmail: null, clientAvatarUrl: null,
         professionalId: input.professionalId,
         professionalName: professionals.find((p) => p.id === input.professionalId)?.name ?? 'Unknown',
         professionalAvatarUrl: null,
@@ -201,6 +217,7 @@ export function createMockAgendaProvider(): AgendaDataProvider {
         ...existing,
         ...(data.startsAt && { startsAt: data.startsAt }),
         ...(data.endsAt && { endsAt: data.endsAt }),
+        ...(data.title !== undefined && { clientName: data.title }),
         ...(data.status && { status: data.status }),
         ...(data.notes !== undefined && { notes: data.notes ?? null }),
         ...(data.professionalId && { professionalId: data.professionalId }),
@@ -235,7 +252,10 @@ export function createMockAgendaProvider(): AgendaDataProvider {
     },
 
     async getAvailableSlots(params: AvailableSlotsParams): Promise<TimeSlot[]> {
-      const date = new Date(params.date)
+      // Parse 'YYYY-MM-DD' as LOCAL midnight (not UTC) so the weekday and the
+      // generated slot instants land on the requested calendar day in any tz.
+      const [yy, mm, dd] = params.date.split('-').map(Number)
+      const date = new Date(yy, (mm ?? 1) - 1, dd ?? 1)
       const dayOfWeek = date.getDay()
       const interval = params.slotInterval ?? 30
 

package/src/data/supabase.ts

@@ -150,7 +150,8 @@ async function hydrateCanonicalBookings(core: any, bookings: any[]): Promise<Cal
       locationId: booking.location_id,
       metadata: booking.metadata ?? {},
       clientId: booking.party_id,
-      clientName: client?.name ?? null,
+      // Simple events (no party) fall back to the title stored in metadata.
+      clientName: client?.name ?? (booking.metadata?.title as string | undefined) ?? null,
       clientPhone: client?.phone ?? null,
       clientEmail: client?.email ?? null,
       clientAvatarUrl: client?.avatar_url ?? null,
@@ -253,6 +254,10 @@ export function createSupabaseAgendaProvider(): AgendaDataProvider {
         contactName = person?.name as string | undefined
       }
 
+      // Simple / Google-Calendar-style events have no client party — persist the
+      // free-text title in metadata so the read model can surface it as the name.
+      const eventTitle = input.title?.trim() || undefined
+
       const { data: order, error: orderErr } = await core.from('orders').insert({
         tenant_id: tenantId,
         kind: input.kind ?? 'appointment',
@@ -267,6 +272,7 @@ export function createSupabaseAgendaProvider(): AgendaDataProvider {
           source: 'agenda',
           ...(serviceNames ? { serviceNames, itemsSummary: serviceNames } : {}),
           ...(contactName ? { contactName } : {}),
+          ...(eventTitle ? { title: eventTitle } : {}),
         },
       }).select('id').single()
       if (orderErr) throw orderErr
@@ -286,6 +292,7 @@ export function createSupabaseAgendaProvider(): AgendaDataProvider {
           source: 'agenda',
           ...(serviceNames ? { serviceNames, itemsSummary: serviceNames } : {}),
           ...(contactName ? { contactName } : {}),
+          ...(eventTitle ? { title: eventTitle } : {}),
         },
       }).select('id').single()
       if (bookingErr) throw bookingErr
@@ -315,7 +322,7 @@ export function createSupabaseAgendaProvider(): AgendaDataProvider {
     async updateBooking(id: string, data: UpdateBookingInput): Promise<CalendarBooking> {
       const { core } = getClients()
       const { data: existing, error: existingErr } = await core.from('bookings')
-        .select('id, order_id, starts_at, assignee_id')
+        .select('id, order_id, starts_at, assignee_id, metadata')
         .eq('id', id)
         .single()
       if (existingErr) throw existingErr
@@ -323,6 +330,10 @@ export function createSupabaseAgendaProvider(): AgendaDataProvider {
       const updates: Record<string, unknown> = {}
       if (data.startsAt) updates.starts_at = data.startsAt
       if (data.endsAt) updates.ends_at = data.endsAt
+      // Simple-event title lives in metadata (no client party) — merge, don't clobber.
+      if (data.title !== undefined) {
+        updates.metadata = { ...(existing?.metadata as Record<string, unknown> ?? {}), title: data.title }
+      }
       if (data.status) {
         // Only update the agenda status — never touch the financial stage
         updates.status = data.status

package/src/index.ts

@@ -25,6 +25,7 @@ export function createAgendaPlugin(options?: AgendaPluginOptions): PluginManifes
     () => createMockAgendaProvider(),
   )
   const store = createAgendaStore(provider, options?.financialBridge)
+  const registries = [...agendaRegistries, ...(options?.settingsRegistries ?? [])]
 
   // Register schedule block config globally so ScheduleEditor can read it
   setScheduleBlockConfig({
@@ -55,6 +56,9 @@ export function createAgendaPlugin(options?: AgendaPluginOptions): PluginManifes
     version: '1.0.0',
     scope: options?.scope ?? 'universal',
     verticalId: options?.verticalId,
+    // Booking/scheduling is business-ops (clinic, salon, services) — targets
+    // the saas/admin Panel world, not the ecommerce storefront.
+    scaffolds: ['saas'],
     defaultEnabled: true,
     dependencies: [],
     declaredFeatures: [
@@ -152,19 +156,19 @@ export function createAgendaPlugin(options?: AgendaPluginOptions): PluginManifes
       },
     ],
 
-    registries: agendaRegistries,
+    registries,
 
     settings: [
       {
         id: 'agenda',
         label: 'Agenda',
         icon: 'Calendar',
-        // Standard layout: General | Integrations (Google Calendar addon) | Properties (holidays).
+        // Standard layout: General | Integrations (Google Calendar addon) | Properties.
         component: (() => {
           const AgendaSettingsTab: React.FC = () => React.createElement(PluginSettingsPanel, {
             title: 'Agenda',
             generalSettings: React.createElement(AgendaGeneralSettings),
-            registries: agendaRegistries,
+            registries,
             hostPluginId: 'agenda',
             routeBase: '/settings/agenda',
           })
@@ -183,6 +187,10 @@ export function createAgendaPlugin(options?: AgendaPluginOptions): PluginManifes
 export type { AgendaPluginOptions } from './config'
 export type { ResolvedAgendaConfig } from './config'
 export type { AgendaDataProvider } from './data/types'
+// Seedable in-memory provider — apps pass a seed to render the calendar with
+// app-specific events instead of the built-in salon sample.
+export { createMockAgendaProvider } from './data/mock'
+export type { MockAgendaSeed, MockAgendaProviderOptions } from './data/mock'
 export type { AgendaFinancialBridge, BookingPaymentStatus, BookingPaymentSummary, BookingPaymentDetail } from './financial-bridge'
 export { createFinancialBridge, computeCommissionAmount } from './bridges/create-financial-bridge'
 

package/src/integrations/google-calendar/integration.test.ts

@@ -4,7 +4,7 @@
 // booking↔event mapping are all proven HERE — before/without the deployed edge
 // function. The data-plane behaviors that need a live Google account are written
 // as it.todo specs so the intended contract is documented and pending, not
-// silently missing. See PLUGIN_PATTERNS.md → integration capability.
+// silently missing. See docs/PLUGIN-PATTERNS.md → integration capability.
 import { describe, it, expect } from 'vitest'
 import { assertConnectorContract } from '@fayz-ai/core/testing'
 import { googleCalendarConnector } from './connector'