@fayz-ai/plugin-agenda 0.1.3

package/src/financial-bridge.ts

@@ -0,0 +1,96 @@
+// ---------------------------------------------------------------------------
+// Agenda × Financial Bridge — Cross-plugin integration types
+// Pure types only. Runtime implementation in bridges/create-financial-bridge.ts
+// ---------------------------------------------------------------------------
+
+/** Payment status for a booking's linked invoice */
+export type BookingPaymentStatus = 'none' | 'pending' | 'partial' | 'paid' | 'overdue' | 'cancelled'
+
+/** Compact payment summary for calendar enrichment */
+export interface BookingPaymentSummary {
+  invoiceId: string
+  referenceNumber?: string
+  status: BookingPaymentStatus
+  totalAmount: number
+  paidAmount: number
+}
+
+/** Detailed payment info with installment breakdown */
+export interface BookingPaymentDetail extends BookingPaymentSummary {
+  movements: Array<{
+    id: string
+    amount: number
+    paidAmount: number
+    status: string
+    dueDate: string
+    installmentNumber?: number
+    paymentDate?: string
+    paymentMethodTypeName?: string
+    cardBrand?: string
+    cardInstallments?: number
+  }>
+}
+
+/**
+ * Bridge interface for agenda → financial plugin integration.
+ * Injected via `AgendaPluginOptions.financialBridge`.
+ * Follows the same DI pattern as `EntityLookup`.
+ */
+export interface AgendaFinancialBridge {
+  /** Batch-resolve payment status for multiple order IDs (for calendar enrichment) */
+  resolvePaymentStatuses(orderIds: string[]): Promise<Map<string, BookingPaymentSummary>>
+
+  /** Get detailed payment info for a single booking's order */
+  getPaymentDetail(orderId: string): Promise<BookingPaymentDetail | null>
+
+  /** Create a receivable invoice from the booking's service_order. Returns invoice ID */
+  createInvoiceFromOrder(orderId: string, options?: {
+    installments?: number
+    dueDate?: string
+    paymentMethodTypeId?: string
+  }): Promise<string>
+
+  /**
+   * Accrue the assigned professional's commission for a booking's order as a
+   * payable `financial_movements` row (direction='debit', movement_kind='commission').
+   * Commission = order.total × professional commission_rate%. Resolves the rate
+   * from the `v_staff` bridge view via the order's `assignee_id`.
+   *
+   * Idempotent per order: returns the existing commission movement id if one was
+   * already accrued. Returns null when there is no professional, no configured
+   * rate, a zero base, or Supabase is unavailable (nothing to accrue).
+   */
+  createCommissionMovement?(orderId: string, options?: {
+    dueDate?: string
+  }): Promise<string | null>
+
+  /** Record a payment against a movement (installment) */
+  payMovement(input: {
+    movementId: string
+    amount: number
+    paymentDate: string
+    paymentMethodTypeId?: string
+    paymentMethodId?: string
+    bankAccountId?: string
+    cardBrand?: string
+    cardInstallments?: number
+  }): Promise<void>
+
+  /** One-step POS checkout: create invoice + pay in full. Returns paid detail. */
+  checkout(orderId: string, input: {
+    paymentMethodTypeId: string
+    paymentMethodId?: string
+    bankAccountId?: string
+    cardBrand?: string
+    cardInstallments?: number
+  }): Promise<BookingPaymentDetail>
+
+  /** Get payment methods filtered by type */
+  getPaymentMethods?(paymentMethodTypeId: string): Promise<Array<{ id: string; name: string }>>
+
+  /** Get payment method types for the payment UI */
+  getPaymentMethodTypes(): Promise<Array<{ id: string; name: string; transactionType?: string }>>
+
+  /** Get bank accounts for payment destination */
+  getBankAccounts(): Promise<Array<{ id: string; name: string; accountType: string }>>
+}

package/src/hooks/useAgendaSettings.ts

@@ -0,0 +1,17 @@
+import { usePluginPrefs } from '@fayz-ai/saas'
+
+const DEFAULTS = {
+  startTime: '07:00',
+  endTime: '21:00',
+}
+
+export function useAgendaSettings() {
+  const prefs = usePluginPrefs('agenda', DEFAULTS)
+
+  return {
+    startTime: prefs.get('startTime'),
+    endTime: prefs.get('endTime'),
+    setStartTime: (v: string) => prefs.set('startTime', v),
+    setEndTime: (v: string) => prefs.set('endTime', v),
+  }
+}

package/src/index.ts

@@ -0,0 +1,180 @@
+import React from 'react'
+import type { PluginManifest } from '@fayz-ai/core'
+import { createSafeDataProvider, registerTranslations } from '@fayz-ai/core'
+import type { AgendaPluginOptions } from './config'
+import { resolveConfig } from './config'
+import { AgendaPage } from './AgendaPage'
+import { createSupabaseAgendaProvider } from './data/supabase'
+import { createMockAgendaProvider } from './data/mock'
+import { setAgendaTenantId } from './lib/tenant'
+import { createAgendaStore } from './store'
+import { agendaRegistries } from './registries'
+import { AgendaGeneralSettings } from './components/AgendaGeneralSettings'
+import { agendaLocales } from './locales'
+import { setScheduleBlockConfig, getScheduleBlockConfig } from '@fayz-ai/saas'
+
+// ---------------------------------------------------------------------------
+// Factory
+// ---------------------------------------------------------------------------
+
+export function createAgendaPlugin(options?: AgendaPluginOptions): PluginManifest {
+  const config = resolveConfig(options)
+  registerTranslations(agendaLocales)
+  const provider = options?.dataProvider ?? createSafeDataProvider(
+    () => createSupabaseAgendaProvider(),
+    () => createMockAgendaProvider(),
+  )
+  const store = createAgendaStore(provider, options?.financialBridge)
+
+  // Register schedule block config globally so ScheduleEditor can read it
+  setScheduleBlockConfig({
+    defaults: config.scheduleBlockDefaults,
+    showServices: !!config.serviceLookup,
+    showConcurrent: true,
+    showBookingWindow: true,
+    showLocations: config.modules.locationSelection,
+    locations: config.locations.map((l) => ({ id: l.id, name: l.name })),
+    // Lazy fetcher — called by ScheduleEditor when locations are needed but empty
+    fetchLocations: config.modules.locationSelection && provider.getLocations
+      ? async () => {
+          const locations = await provider.getLocations!()
+          const current = getScheduleBlockConfig()
+          if (current) setScheduleBlockConfig({ ...current, locations })
+          return locations
+        }
+      : undefined,
+  })
+
+  const PageComponent: React.FC<any> = () =>
+    React.createElement(AgendaPage, { config, provider, store })
+
+  return {
+    id: 'agenda',
+    name: config.labels.pageTitle,
+    icon: 'Calendar',
+    version: '1.0.0',
+    scope: options?.scope ?? 'universal',
+    verticalId: options?.verticalId,
+    defaultEnabled: true,
+    dependencies: [],
+    declaredFeatures: [
+      { id: 'appointments', label: config.labels.pageTitle, group: config.labels.pageTitle },
+      { id: 'agenda.schedules', label: 'Schedule Management', group: config.labels.pageTitle },
+    ],
+
+    navigation: [
+      {
+        section: options?.navSection ?? 'main',
+        position: options?.navPosition ?? 2,
+        label: config.labels.pageTitle,
+        route: '/agenda',
+        icon: 'Calendar',
+        permission: { feature: 'appointments', action: 'read' as const },
+      },
+    ],
+
+    routes: [
+      {
+        path: '/agenda',
+        component: PageComponent,
+        permission: { feature: 'appointments', action: 'read' as const },
+      },
+    ],
+
+    widgets: [],
+
+    aiTools: [
+      {
+        id: 'agenda.list-appointments',
+        name: 'listAppointments',
+        description: 'Lists upcoming appointments for a given date or date range, optionally filtered by professional.',
+        icon: 'Calendar',
+        mode: 'read' as const,
+        category: 'Scheduling',
+        parameters: {
+          type: 'object' as const,
+          properties: {
+            date: { type: 'string' as const, description: 'Date (YYYY-MM-DD) or "today", "tomorrow", "this week"' },
+            professional: { type: 'string' as const, description: 'Professional name to filter by' },
+          },
+        },
+        suggestions: [
+          { label: "What's on the agenda today?" },
+          { label: 'Show me tomorrow\'s appointments' },
+          { label: 'Who has the most bookings this week?' },
+        ],
+        permission: { feature: 'appointments', action: 'read' as const },
+      },
+      {
+        id: 'agenda.create-appointment',
+        name: 'createAppointment',
+        description: 'Creates a new appointment for a client with a specific professional and service.',
+        icon: 'CalendarPlus',
+        mode: 'persist' as const,
+        category: 'Scheduling',
+        parameters: {
+          type: 'object' as const,
+          properties: {
+            client: { type: 'string' as const, description: 'Client name' },
+            professional: { type: 'string' as const, description: 'Professional name' },
+            service: { type: 'string' as const, description: 'Service name' },
+            date: { type: 'string' as const, description: 'Date (YYYY-MM-DD)' },
+            time: { type: 'string' as const, description: 'Time (HH:MM)' },
+          },
+          required: ['client', 'professional', 'service', 'date', 'time'],
+        },
+        suggestions: [
+          { label: 'Book a haircut for Sarah tomorrow at 10am' },
+        ],
+        permission: { feature: 'appointments', action: 'create' as const },
+      },
+      {
+        id: 'agenda.check-availability',
+        name: 'checkAvailability',
+        description: 'Checks available time slots for a professional on a given date.',
+        icon: 'Clock',
+        mode: 'read' as const,
+        category: 'Scheduling',
+        parameters: {
+          type: 'object' as const,
+          properties: {
+            professional: { type: 'string' as const, description: 'Professional name' },
+            date: { type: 'string' as const, description: 'Date (YYYY-MM-DD) or "today", "tomorrow"' },
+            duration: { type: 'number' as const, description: 'Required duration in minutes' },
+          },
+          required: ['professional', 'date'],
+        },
+        suggestions: [
+          { label: 'When is Ana available tomorrow?' },
+          { label: 'Find a 90-minute slot for Carlos this week' },
+        ],
+        permission: { feature: 'appointments', action: 'read' as const },
+      },
+    ],
+
+    registries: agendaRegistries,
+
+    settings: [
+      {
+        id: 'agenda',
+        label: 'Agenda',
+        icon: 'Calendar',
+        component: (() => {
+          const AgendaSettingsTab: React.FC = () => React.createElement(AgendaGeneralSettings)
+          AgendaSettingsTab.displayName = 'AgendaSettingsTab'
+          return AgendaSettingsTab as unknown as React.ComponentType<unknown>
+        })(),
+        order: 5,
+        permission: { feature: 'appointments', action: 'read' as const },
+      },
+    ],
+    locales: agendaLocales,
+  }
+}
+
+// Re-export types for consumers
+export type { AgendaPluginOptions } from './config'
+export type { ResolvedAgendaConfig } from './config'
+export type { AgendaDataProvider } from './data/types'
+export type { AgendaFinancialBridge, BookingPaymentStatus, BookingPaymentSummary, BookingPaymentDetail } from './financial-bridge'
+export { createFinancialBridge, computeCommissionAmount } from './bridges/create-financial-bridge'

package/src/lib/tenant.ts

@@ -0,0 +1,3 @@
+let t: string | undefined
+export function setAgendaTenantId(id: string | undefined){ t = id }
+export function getAgendaTenantId(): string | undefined { return t }

package/src/locales/en.ts

@@ -0,0 +1,207 @@
+// agenda.* — merged plugin-own + saas-core central i18n
+export const en: Record<string, string> = {
+  "agenda.appointment.addDescription": "Add description...",
+  "agenda.appointment.addService": "Add service",
+  "agenda.appointment.cancel": "Cancel",
+  "agenda.appointment.clientTab": "Client",
+  "agenda.appointment.noClientData": "No client data available",
+  "agenda.appointment.client": "Client",
+  "agenda.appointment.conflict": "Time conflict — this professional is already booked at this time.",
+  "agenda.appointment.create": "Create",
+  "agenda.appointment.createClientFailed": "Failed to create client",
+  "agenda.appointment.creating": "Creating...",
+  "agenda.appointment.delete": "Delete",
+  "agenda.appointment.deleteConfirm": "Delete this appointment?",
+  "agenda.appointment.confirmDelete": "Delete",
+  "agenda.appointment.deleting": "Deleting…",
+  "agenda.appointment.edit": "Edit Appointment",
+  "agenda.appointment.emailOptional": "Email (optional)",
+  "agenda.appointment.location": "Location",
+  "agenda.appointment.name": "Name",
+  "agenda.appointment.new": "New Appointment",
+  "agenda.appointment.newClient": "New client",
+  "agenda.appointment.notes": "Notes",
+  "agenda.appointment.phone": "Phone",
+  "agenda.appointment.professional": "Professional",
+  "agenda.appointment.save": "Save",
+  "agenda.appointment.saving": "Saving...",
+  "agenda.appointment.searchClient": "Search client...",
+  "agenda.appointment.searchService": "Search service to add...",
+  "agenda.appointment.selectLocation": "Select location...",
+  "agenda.appointment.selectProfessional": "Select professional...",
+  "agenda.appointment.services": "Services",
+  "agenda.appointment.status": "Status",
+  "agenda.appointment.to": "to",
+  "agenda.appointment.total": "Total",
+  "agenda.appointment.update": "Update",
+  "agenda.payment.title": "Payment",
+  "agenda.payment.generateInvoice": "Generate invoice",
+  "agenda.payment.generating": "Generating…",
+  "agenda.payment.pending": "Pending",
+  "agenda.payment.partial": "Partial",
+  "agenda.payment.paid": "Paid",
+  "agenda.payment.collect": "Collect",
+  "agenda.payment.overdue": "Overdue",
+  "agenda.payment.cancelled": "Cancelled",
+  "agenda.payment.none": "Payment",
+  "agenda.payment.pay": "Pay",
+  "agenda.payment.paying": "Paying…",
+  "agenda.payment.remaining": "Remaining",
+  "agenda.payment.installment": "Installment",
+  "agenda.payment.total": "Total",
+  "agenda.payment.noInvoice": "No invoice generated",
+  "agenda.payment.selectAccount": "Select account",
+  "agenda.payment.registerPayment": "Register payment",
+  "agenda.payment.registerPaymentHint": "Record a payment for this appointment",
+  "agenda.payment.pendingHint": "Invoice generated, awaiting payment",
+  "agenda.payment.partialHint": "Partially paid, tap to complete",
+  "agenda.payment.paidHint": "Payment completed",
+  "agenda.payment.overdueHint": "Payment overdue",
+  "agenda.payment.backToAppointment": "Back to appointment",
+  "agenda.payment.checkout": "Confirm",
+  "agenda.payment.checkingOut": "Processing…",
+  "agenda.payment.serviceSummary": "Service summary",
+  "agenda.payment.paymentMethod": "Payment method",
+  "agenda.payment.noMethods": "No payment methods configured.",
+  "agenda.payment.configureMethods": "Set up payment methods",
+  "agenda.payment.checkoutComplete": "Payment confirmed",
+  "agenda.payment.card": "Card",
+  "agenda.payment.method": "Method",
+  "agenda.payment.select": "Select…",
+  "agenda.payment.cardBrand": "Brand",
+  "agenda.payment.selectBrand": "Select brand…",
+  "agenda.payment.cardInstallments": "Installments",
+  "agenda.payment.bankAccount": "Account",
+  "agenda.payment.viewInvoice": "View invoice details",
+  "agenda.calendar.agendas": "Agendas",
+  "agenda.calendar.create": "Create",
+  "agenda.calendar.next": "Next",
+  "agenda.calendar.previous": "Previous",
+  "agenda.calendar.status": "Status",
+  "agenda.calendar.today": "Today",
+  "agenda.calendar.viewAgenda": "Agenda",
+  "agenda.calendar.viewDay": "Day",
+  "agenda.calendar.viewMonth": "Month",
+  "agenda.calendar.viewWeek": "Week",
+  "agenda.confirmations.confirmed": "Confirmed:",
+  "agenda.confirmations.empty": "No pending confirmations",
+  "agenda.confirmations.emptySubtitle": "All upcoming appointments have been confirmed",
+  "agenda.confirmations.loading": "Loading...",
+  "agenda.confirmations.subtitle": "Upcoming appointments pending confirmation",
+  "agenda.confirmations.unknownClient": "Unknown client",
+  "agenda.confirmations.sendWhatsApp": "Send WhatsApp",
+  "agenda.confirmations.call": "Call",
+  "agenda.confirmations.markConfirmed": "Mark Confirmed",
+  "agenda.confirmations.markCancelled": "Mark Cancelled",
+  "agenda.contextMenu.changeStatus": "Change status",
+  "agenda.contextMenu.delete": "Delete",
+  "agenda.contextMenu.edit": "Edit",
+  "agenda.contextMenu.notAvailable": "(not available)",
+  "agenda.index.settingsSubtitle": "Working hours, scheduling preferences, and confirmations",
+  "agenda.index.settingsTitle": "Agenda Settings",
+  "settings.plugin.agenda-working-hours": "Working Hours",
+  "agenda.popover.unknown": "Unknown",
+  "agenda.settings.autoConfirm": "Auto-confirm",
+  "agenda.settings.autoConfirmDesc": "Automatically confirm new bookings",
+  "agenda.settings.autoCreateOrder": "Auto-create Order",
+  "agenda.settings.autoCreateOrderDesc": "Automatically create a financial order for new bookings",
+  "agenda.settings.blockOutside": "Block Outside Hours",
+  "agenda.settings.blockOutsideDesc": "Prevent bookings outside working hours",
+  "agenda.settings.calendarDisplay": "Calendar Display",
+  "agenda.settings.calendarDisplayDesc": "Visual settings for the calendar",
+  "agenda.settings.cancelAlerts": "Cancellation Alerts",
+  "agenda.settings.cancelAlertsDesc": "Notify when a booking is cancelled",
+  "agenda.settings.compact": "Compact Mode",
+  "agenda.settings.compactDesc": "Use smaller event blocks",
+  "agenda.settings.confirmations": "Confirmations",
+  "agenda.settings.confirmationsDesc": "Booking confirmation settings",
+  "agenda.settings.conflictDetection": "Conflict Detection",
+  "agenda.settings.conflictDetectionDesc": "Warn when bookings overlap",
+  "agenda.settings.dragDrop": "Drag & Drop",
+  "agenda.settings.dragDropDesc": "Allow rescheduling by dragging events",
+  "agenda.settings.enableConfirmations": "Enable Confirmations",
+  "agenda.settings.enableConfirmationsDesc": "Require confirmation for new bookings",
+  "agenda.settings.enableLocation": "Enable Location Selection",
+  "agenda.settings.enableLocationDesc": "Show location picker in booking modal",
+  "agenda.settings.enableWorkingHours": "Enable Working Hours",
+  "agenda.settings.enableWorkingHoursDesc": "Show working hours overlay on calendar",
+  "agenda.settings.locations": "Locations",
+  "agenda.settings.locationsDesc": "Multi-location settings",
+  "agenda.settings.newBookingNotif": "New Booking Alerts",
+  "agenda.settings.newBookingNotifDesc": "Notify when a new booking is created",
+  "agenda.settings.noShowTracking": "No-show Tracking",
+  "agenda.settings.noShowTrackingDesc": "Track and alert on no-shows",
+  "agenda.settings.notifications": "Notifications",
+  "agenda.settings.notificationsDesc": "Notification preferences",
+  "agenda.settings.reminder": "Reminders",
+  "agenda.settings.reminderDesc": "Send reminders before appointments",
+  "agenda.settings.scheduling": "Scheduling",
+  "agenda.settings.schedulingDesc": "Configure scheduling behavior",
+  "agenda.settings.showCancelled": "Show Cancelled",
+  "agenda.settings.showCancelledDesc": "Display cancelled bookings on calendar",
+  "agenda.settings.showNoShow": "Show No-shows",
+  "agenda.settings.showNoShowDesc": "Display no-show bookings on calendar",
+  "agenda.settings.workingHours": "Working Hours",
+  "agenda.settings.workingHoursDesc": "Working hours and availability",
+  "agenda.sidebar.agendas": "Agendas",
+  "agenda.sidebar.allLocations": "All locations",
+  "agenda.sidebar.create": "Create",
+  "agenda.sidebar.location": "Location",
+  "agenda.sidebar.status": "Status",
+  "agenda.toolbar.next": "Next",
+  "agenda.toolbar.previous": "Previous",
+  "agenda.toolbar.today": "Today",
+  "agenda.workingHours.addBreak": "Add break",
+  "agenda.workingHours.copyToAll": "Copy to all",
+  "agenda.workingHours.dayOff": "Day off",
+  "agenda.workingHours.removePeriod": "Remove period",
+  "agenda.workingHours.professional": "Professional",
+  "agenda.workingHours.save": "Save",
+  "agenda.workingHours.saveFailed": "Failed to save",
+  "agenda.workingHours.saved": "Working hours saved",
+  "agenda.workingHours.saving": "Saving...",
+  "agenda.workingHours.subtitle": "Manage working hours per professional",
+  "agenda.workingHours.to": "to",
+  "agenda.title": "Agenda",
+  "agenda.calendar.title": "Calendar",
+  "agenda.calendar.noScheduleConfirm": "This time slot has no open schedule for this professional. Do you want to book anyway?",
+  "agenda.calendar.newAppointment": "New Appointment",
+  "agenda.booking.create": "New Appointment",
+  "agenda.booking.edit": "Edit Appointment",
+  "agenda.booking.delete": "Delete Appointment",
+  "agenda.booking.deleteConfirm": "Are you sure you want to delete this appointment?",
+  "agenda.booking.client": "Client",
+  "agenda.booking.professional": "Professional",
+  "agenda.booking.services": "Services",
+  "agenda.booking.date": "Date",
+  "agenda.booking.time": "Time",
+  "agenda.booking.duration": "Duration",
+  "agenda.booking.notes": "Notes",
+  "agenda.booking.status": "Status",
+  "agenda.booking.save": "Save Appointment",
+  "agenda.booking.saving": "Saving...",
+  "agenda.confirmations.title": "Confirmations",
+  "agenda.confirmations.pending": "Pending Confirmations",
+  "agenda.confirmations.emptyDescription": "All upcoming appointments have been confirmed",
+  "agenda.confirmations.confirm": "Confirm",
+  "agenda.confirmations.cancel": "Cancel",
+  "agenda.workingHours.title": "Working Hours",
+  "agenda.workingHours.addPeriod": "Add period",
+  "agenda.workingHours.loading": "Loading...",
+  "agenda.appointment.addClient": "Add client",
+  "agenda.appointment.addServiceFirst": "Add service",
+  "agenda.appointment.addNotes": "Add notes",
+  "agenda.appointment.duration": "Duration (minutes)",
+  "agenda.appointment.price": "Price",
+  "agenda.bookingType.appointment": "Appointment",
+  "agenda.bookingType.task": "Task",
+  "agenda.bookingType.out_of_office": "Out of Office",
+  "agenda.bookingType.block": "Block",
+  "agenda.settings.title": "Agenda Settings",
+  "agenda.settings.slotDuration": "Slot Duration",
+  "agenda.settings.bookingKind": "Booking Kind",
+  "agenda.settings.dayStartTime": "Day Start Time",
+  "agenda.settings.dayStartTimeDesc": "First hour shown on the calendar",
+  "agenda.settings.dayEndTime": "Day End Time",
+  "agenda.settings.dayEndTimeDesc": "Last hour shown on the calendar",
+}

package/src/locales/index.ts

@@ -0,0 +1,7 @@
+import { en } from './en'
+import { ptBR } from './pt-BR'
+
+export const agendaLocales: Record<string, Record<string, string>> = {
+  en,
+  'pt-BR': ptBR,
+}