@fayz-ai/plugin-agenda 0.1.7 → 0.2.0

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 }),

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({
@@ -152,19 +153,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 +184,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/locales/en.ts

@@ -81,8 +81,12 @@ export const en: Record<string, string> = {
   "agenda.calendar.today": "Today",
   "agenda.calendar.viewAgenda": "Agenda",
   "agenda.calendar.viewDay": "Day",
+  "agenda.calendar.viewList": "List",
   "agenda.calendar.viewMonth": "Month",
   "agenda.calendar.viewWeek": "Week",
+  "agenda.list.today": "Today",
+  "agenda.list.tomorrow": "Tomorrow",
+  "agenda.list.empty": "No upcoming items",
   "agenda.confirmations.confirmed": "Confirmed:",
   "agenda.confirmations.empty": "No pending confirmations",
   "agenda.confirmations.emptySubtitle": "All upcoming appointments have been confirmed",
@@ -93,6 +97,10 @@ export const en: Record<string, string> = {
   "agenda.confirmations.call": "Call",
   "agenda.confirmations.markConfirmed": "Mark Confirmed",
   "agenda.confirmations.markCancelled": "Mark Cancelled",
+  "agenda.cancellation.loadingReasons": "Loading reasons...",
+  "agenda.cancellation.notesOptional": "Cancellation notes (optional)",
+  "agenda.cancellation.notesRequired": "Cancellation notes required",
+  "agenda.cancellation.selectReason": "Select cancellation reason",
   "agenda.contextMenu.changeStatus": "Change status",
   "agenda.contextMenu.delete": "Delete",
   "agenda.contextMenu.edit": "Edit",
@@ -193,7 +201,11 @@ export const en: Record<string, string> = {
   "agenda.appointment.addNotes": "Add notes",
   "agenda.appointment.duration": "Duration (minutes)",
   "agenda.appointment.price": "Price",
+  "agenda.appointment.title": "Title",
+  "agenda.appointment.addTitle": "Add a title",
+  "agenda.appointment.untitled": "(no title)",
   "agenda.bookingType.appointment": "Appointment",
+  "agenda.bookingType.event": "Event",
   "agenda.bookingType.task": "Task",
   "agenda.bookingType.out_of_office": "Out of Office",
   "agenda.bookingType.block": "Block",

package/src/locales/pt-BR.ts

@@ -81,8 +81,12 @@ export const ptBR: Record<string, string> = {
   "agenda.calendar.today": "Hoje",
   "agenda.calendar.viewAgenda": "Agenda",
   "agenda.calendar.viewDay": "Dia",
+  "agenda.calendar.viewList": "Lista",
   "agenda.calendar.viewMonth": "Mês",
   "agenda.calendar.viewWeek": "Semana",
+  "agenda.list.today": "Hoje",
+  "agenda.list.tomorrow": "Amanhã",
+  "agenda.list.empty": "Nenhum item próximo",
   "agenda.confirmations.confirmed": "Confirmado:",
   "agenda.confirmations.empty": "Nenhuma confirmação pendente",
   "agenda.confirmations.emptySubtitle": "Todos os agendamentos futuros foram confirmados",
@@ -93,6 +97,10 @@ export const ptBR: Record<string, string> = {
   "agenda.confirmations.call": "Ligar",
   "agenda.confirmations.markConfirmed": "Marcar Confirmado",
   "agenda.confirmations.markCancelled": "Marcar Cancelado",
+  "agenda.cancellation.loadingReasons": "Carregando motivos...",
+  "agenda.cancellation.notesOptional": "Observações do cancelamento (opcional)",
+  "agenda.cancellation.notesRequired": "Observações do cancelamento obrigatórias",
+  "agenda.cancellation.selectReason": "Selecionar motivo do cancelamento",
   "agenda.contextMenu.changeStatus": "Alterar status",
   "agenda.contextMenu.delete": "Excluir",
   "agenda.contextMenu.edit": "Editar",
@@ -193,7 +201,11 @@ export const ptBR: Record<string, string> = {
   "agenda.appointment.addNotes": "Adicionar observações",
   "agenda.appointment.duration": "Duração (minutos)",
   "agenda.appointment.price": "Preço",
+  "agenda.appointment.title": "Título",
+  "agenda.appointment.addTitle": "Adicionar um título",
+  "agenda.appointment.untitled": "(sem título)",
   "agenda.bookingType.appointment": "Agendamento",
+  "agenda.bookingType.event": "Evento",
   "agenda.bookingType.task": "Tarefa",
   "agenda.bookingType.out_of_office": "Ausência",
   "agenda.bookingType.block": "Bloqueio",

package/src/store.ts

@@ -4,6 +4,7 @@ import { toast } from '@fayz-ai/ui'
 import { getScheduleBlockConfig, setScheduleBlockConfig } from '@fayz-ai/saas'
 import type { AgendaDataProvider } from './data/types'
 import type { AgendaFinancialBridge } from './financial-bridge'
+import type { ExternalBookingSource } from './config'
 import type {
   CalendarBooking, Professional, Schedule,
   CreateBookingInput, UpdateBookingInput, BookingQuery,
@@ -48,6 +49,7 @@ export interface AgendaUIState {
     bookingId?: string
     prefill?: Partial<CreateBookingInput> & { endsAt?: string }
     initialTab?: string
+    externalSource?: ExternalBookingSource
   }
 
   // Actions
@@ -64,7 +66,7 @@ export interface AgendaUIState {
   setFilters(filters: Partial<{ professionalIds: string[]; locationId: string | null; statuses: string[] }>): void
   setView(view: string): void
   setSelectedDate(date: string): void
-  openAppointmentModal(mode: 'create' | 'edit', options?: { bookingId?: string; prefill?: Partial<CreateBookingInput> & { endsAt?: string }; initialTab?: string }): void
+  openAppointmentModal(mode: 'create' | 'edit', options?: { bookingId?: string; prefill?: Partial<CreateBookingInput> & { endsAt?: string }; initialTab?: string; externalSource?: ExternalBookingSource }): void
   closeAppointmentModal(): void
 }
 
@@ -292,7 +294,7 @@ export function createAgendaStore(provider: AgendaDataProvider, financialBridge?
     setSelectedDate(date) { set({ selectedDate: date }) },
 
     openAppointmentModal(mode, options) {
-      set({ appointmentModal: { open: true, mode, bookingId: options?.bookingId, prefill: options?.prefill, initialTab: options?.initialTab } })
+      set({ appointmentModal: { open: true, mode, bookingId: options?.bookingId, prefill: options?.prefill, initialTab: options?.initialTab, externalSource: options?.externalSource } })
     },
 
     closeAppointmentModal() {

package/src/types.ts

@@ -29,6 +29,9 @@ export interface BookingTypeConfig {
   icon: string
   color: string
   fields: {
+    /** Free-text event title (maps to the booking's display name). Used by
+     *  simple / Google-Calendar-style events that have no client party. */
+    title?: boolean
     client: boolean
     professional: boolean
     services: boolean
@@ -205,6 +208,9 @@ export interface CreateBookingInput {
   locationId?: string
   startsAt: string
   notes?: string
+  /** Free-text event title for simple events (no client party). Maps to the
+   *  booking's display name (clientName in the read model). */
+  title?: string
   services: CreateBookingServiceInput[]
 }
 
@@ -224,6 +230,8 @@ export interface UpdateBookingInput {
   endsAt?: string
   status?: BookingStatus
   notes?: string
+  /** Free-text event title for simple events (no client party). */
+  title?: string
   services?: CreateBookingServiceInput[]
 }