@fayz-ai/plugin-agenda 0.9.0 → 0.10.0

package/src/store.ts

@@ -1,311 +0,0 @@
-import { createStore, type StoreApi } from 'zustand/vanilla'
-import { emitDataChanged } from '@fayz-ai/core'
-import { dedup } from '@fayz-ai/saas'
-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,
-} from './types'
-
-// ---------------------------------------------------------------------------
-// Store state
-// ---------------------------------------------------------------------------
-
-export interface AgendaUIState {
-  // Calendar data
-  bookings: CalendarBooking[]
-  bookingsLoading: boolean
-  dateRange: { start: string; end: string }
-  currentView: string
-  selectedDate: string
-
-  // Resources
-  professionals: Professional[]
-  professionalsLoading: boolean
-
-  // Filters
-  selectedProfessionalIds: string[]
-  selectedLocationId: string | null
-  selectedStatuses: string[]
-
-  // Locations
-  locations: Array<{ id: string; name: string }>
-
-  // Schedules
-  schedules: Schedule[]
-  schedulesLoading: boolean
-
-  // Confirmations
-  pendingConfirmations: CalendarBooking[]
-  confirmationsLoading: boolean
-
-  // Modal state
-  appointmentModal: {
-    open: boolean
-    mode: 'create' | 'edit'
-    bookingId?: string
-    prefill?: Partial<CreateBookingInput> & { endsAt?: string }
-    initialTab?: string
-    externalSource?: ExternalBookingSource
-  }
-
-  // Actions
-  fetchBookings(range: { start: string; end: string }): Promise<void>
-  fetchProfessionals(): Promise<void>
-  fetchLocations(): Promise<void>
-  fetchSchedules(professionalId?: string): Promise<void>
-  fetchConfirmations(): Promise<void>
-  createBooking(input: CreateBookingInput): Promise<CalendarBooking>
-  updateBooking(id: string, data: UpdateBookingInput): Promise<CalendarBooking>
-  deleteBooking(id: string): Promise<void>
-  updateBookingStatus(id: string, status: string): Promise<void>
-  rescheduleBooking(id: string, newStart: string, newEnd: string, newProfessionalId?: string): Promise<void>
-  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; externalSource?: ExternalBookingSource }): void
-  closeAppointmentModal(): void
-}
-
-// ---------------------------------------------------------------------------
-// Store factory
-// ---------------------------------------------------------------------------
-
-function getCurrentBookingQuery(state: AgendaUIState, dateRange = state.dateRange): BookingQuery {
-  return {
-    dateRange,
-    professionalIds: state.selectedProfessionalIds.length ? state.selectedProfessionalIds : undefined,
-    locationId: state.selectedLocationId ?? undefined,
-    statuses: state.selectedStatuses.length ? state.selectedStatuses : undefined,
-  }
-}
-
-export function createAgendaStore(provider: AgendaDataProvider, financialBridge?: AgendaFinancialBridge): StoreApi<AgendaUIState> {
-  return createStore<AgendaUIState>((set, get) => ({
-    bookings: [],
-    bookingsLoading: false,
-    dateRange: { start: '', end: '' },
-    currentView: 'resourceTimeGridDay',
-    selectedDate: new Date().toISOString().slice(0, 10),
-
-    professionals: [],
-    professionalsLoading: false,
-
-    selectedProfessionalIds: [],
-    selectedLocationId: null,
-    selectedStatuses: ['scheduled', 'confirmed', 'in_progress', 'completed'],
-
-    locations: [],
-
-    schedules: [],
-    schedulesLoading: false,
-
-    pendingConfirmations: [],
-    confirmationsLoading: false,
-
-    appointmentModal: { open: false, mode: 'create' },
-
-    async fetchBookings(range) {
-      const key = `agenda:bookings:${range.start}:${range.end}`
-      return dedup(key, async () => {
-        set({ bookingsLoading: true, dateRange: range })
-        const state = get()
-        const query = getCurrentBookingQuery(state, range)
-        let bookings = await provider.getBookings(query)
-
-        // Enrich with payment status if financial bridge is available
-        if (financialBridge) {
-          const orderIds = bookings.map((b) => b.orderId).filter((id): id is string => !!id)
-          if (orderIds.length > 0) {
-            try {
-              const statuses = await financialBridge.resolvePaymentStatuses(orderIds)
-              bookings = bookings.map((b) => {
-                if (!b.orderId) return b
-                const summary = statuses.get(b.orderId)
-                return summary ? { ...b, paymentStatus: summary.status } : b
-              })
-            } catch { /* non-blocking */ }
-          }
-        }
-
-        set({ bookings, bookingsLoading: false })
-      })
-    },
-
-    async fetchProfessionals() {
-      return dedup('agenda:professionals', async () => {
-        set({ professionalsLoading: true })
-        const professionals = await provider.getProfessionals()
-        set({ professionals, professionalsLoading: false })
-      })
-    },
-
-    async fetchLocations() {
-      return dedup('agenda:locations', async () => {
-        if (!provider.getLocations) return
-        const locations = await provider.getLocations()
-        set({ locations })
-        // Update global schedule block config so ScheduleEditor picks up locations
-        const current = getScheduleBlockConfig()
-        if (current) {
-          setScheduleBlockConfig({ ...current, locations })
-        }
-      })
-    },
-
-    async fetchSchedules(professionalId) {
-      return dedup('agenda:schedules:' + (professionalId ?? 'all'), async () => {
-        set({ schedulesLoading: true })
-        const schedules = await provider.getSchedules(professionalId)
-        set({ schedules, schedulesLoading: false })
-      })
-    },
-
-    async fetchConfirmations() {
-      return dedup('agenda:confirmations', async () => {
-        set({ confirmationsLoading: true })
-        const pendingConfirmations = await provider.getConfirmationsPending()
-        set({ pendingConfirmations, confirmationsLoading: false })
-      })
-    },
-
-    async createBooking(input) {
-      try {
-        const booking = await provider.createBooking(input)
-        // Refresh bookings for current range
-        const state = get()
-        if (state.dateRange.start && state.dateRange.end) {
-          const bookings = await provider.getBookings(getCurrentBookingQuery(state))
-          set({ bookings })
-        }
-        emitDataChanged({ table: 'appointments', op: 'create', id: booking.id, source: 'ui' })
-        toast.success('Appointment created')
-        return booking
-      } catch (err: any) {
-        toast.error('Failed to create appointment', { description: err?.message })
-        throw err
-      }
-    },
-
-    async updateBooking(id, data) {
-      try {
-        const booking = await provider.updateBooking(id, data)
-        const state = get()
-        if (state.dateRange.start && state.dateRange.end) {
-          const bookings = await provider.getBookings(getCurrentBookingQuery(state))
-          set({ bookings })
-        }
-        emitDataChanged({ table: 'appointments', op: 'update', id, source: 'ui' })
-        toast.success('Appointment updated')
-        return booking
-      } catch (err: any) {
-        toast.error('Failed to update appointment', { description: err?.message })
-        throw err
-      }
-    },
-
-    async deleteBooking(id) {
-      try {
-        await provider.deleteBooking(id)
-        const state = get()
-        if (state.dateRange.start && state.dateRange.end) {
-          const bookings = await provider.getBookings(getCurrentBookingQuery(state))
-          set({ bookings })
-        }
-        emitDataChanged({ table: 'appointments', op: 'delete', id, source: 'ui' })
-        toast.success('Appointment deleted')
-      } catch (err: any) {
-        toast.error('Failed to delete appointment', { description: err?.message })
-        throw err
-      }
-    },
-
-    async updateBookingStatus(id, status) {
-      // Optimistic update — change color immediately
-      const prev = get().bookings
-      set({ bookings: prev.map((b) => b.id === id ? { ...b, status: status as any } : b) })
-      try {
-        await provider.updateBookingStatus(id, status)
-        // Refresh from server to get full data
-        const state = get()
-        if (state.dateRange.start && state.dateRange.end) {
-          const bookings = await provider.getBookings(getCurrentBookingQuery(state))
-          set({ bookings })
-        }
-        emitDataChanged({ table: 'appointments', op: 'update', id, source: 'ui' })
-        toast.success('Status updated')
-      } catch (err: any) {
-        // Rollback on failure
-        set({ bookings: prev })
-        toast.error('Failed to update status', { description: err?.message })
-        throw err
-      }
-    },
-
-    async rescheduleBooking(id, newStart, newEnd, newProfessionalId) {
-      try {
-        // Check for conflicts
-        const existing = get().bookings.find((b) => b.id === id)
-        const assigneeId = newProfessionalId ?? existing?.professionalId
-        if (assigneeId) {
-          const hasConflict = await provider.checkConflict({
-            assigneeId,
-            startsAt: newStart,
-            endsAt: newEnd,
-            excludeBookingId: id,
-          })
-          if (hasConflict) {
-            toast.error('Time conflict detected', { description: 'This professional already has an appointment at this time.' })
-            throw new Error('Time conflict')
-          }
-        }
-        await provider.updateBooking(id, {
-          startsAt: newStart,
-          endsAt: newEnd,
-          ...(newProfessionalId && { professionalId: newProfessionalId }),
-        })
-        const state = get()
-        if (state.dateRange.start && state.dateRange.end) {
-          const bookings = await provider.getBookings(getCurrentBookingQuery(state))
-          set({ bookings })
-        }
-        toast.success('Appointment rescheduled')
-      } catch (err: any) {
-        if (err?.message !== 'Time conflict') {
-          toast.error('Failed to reschedule', { description: err?.message })
-        }
-        throw err
-      }
-    },
-
-    setFilters(filters) {
-      set({
-        ...(filters.professionalIds !== undefined && { selectedProfessionalIds: filters.professionalIds }),
-        ...(filters.locationId !== undefined && { selectedLocationId: filters.locationId }),
-        ...(filters.statuses !== undefined && { selectedStatuses: filters.statuses }),
-      })
-      // Re-fetch with new filters
-      const { dateRange } = get()
-      if (dateRange.start && dateRange.end) {
-        get().fetchBookings(dateRange)
-      }
-    },
-
-    setView(view) { set({ currentView: view }) },
-    setSelectedDate(date) { set({ selectedDate: date }) },
-
-    openAppointmentModal(mode, options) {
-      set({ appointmentModal: { open: true, mode, bookingId: options?.bookingId, prefill: options?.prefill, initialTab: options?.initialTab, externalSource: options?.externalSource } })
-    },
-
-    closeAppointmentModal() {
-      // Only toggle open — keep mode/bookingId/prefill intact so layout
-      // doesn't shift during the close animation
-      set((state) => ({ appointmentModal: { ...state.appointmentModal, open: false } }))
-    },
-  }))
-}

package/src/types.ts

@@ -1,273 +0,0 @@
-// ---------------------------------------------------------------------------
-// Agenda Plugin — Pure TypeScript types
-// Zero dependencies. Maps to public archetype tables.
-// ---------------------------------------------------------------------------
-
-// ============================================================
-// ENUMS / LITERALS
-// ============================================================
-
-/** Booking status lifecycle */
-export type BookingStatus =
-  | 'scheduled'
-  | 'confirmed'
-  | 'in_progress'
-  | 'completed'
-  | 'cancelled'
-  | 'no_show'
-
-/** Confirmation outreach status */
-export type ConfirmationStatus = 'pending' | 'sent' | 'confirmed' | 'declined'
-
-/** Booking type identifier — extensible via string literal union */
-export type BookingTypeId = 'appointment' | 'task' | 'out_of_office' | 'block' | (string & {})
-
-/** Configuration for a booking type (event type) */
-export interface BookingTypeConfig {
-  id: BookingTypeId
-  label: string
-  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
-    location: boolean
-    status: boolean
-  }
-  requiresServices: boolean
-  requiresClient: boolean
-}
-
-// ============================================================
-// CORE ENTITIES
-// ============================================================
-
-/** A booking service line item (from public.appointment_items) */
-export interface BookingService {
-  id: string
-  serviceId: string | null
-  name: string
-  durationMinutes: number
-  price: number
-  assigneeId: string | null
-}
-
-/** Calendar booking — the main entity rendered on the calendar (from v_appointments view on orders) */
-export interface CalendarBooking {
-  id: string
-  tenantId: string
-  kind: string
-  /** Lifecycle stage: booked, invoiced, paid, etc. */
-  stage?: string
-  /** Financial direction: credit, debit, null */
-  direction?: string | null
-  startsAt: string
-  endsAt: string | null
-  status: BookingStatus
-  notes: string | null
-  /** In unified model, orderId === id (the booking IS the order) */
-  orderId: string | null
-  locationId: string | null
-  metadata: Record<string, unknown>
-
-  // Client (party)
-  clientId: string | null
-  clientName: string | null
-  clientPhone: string | null
-  clientEmail: string | null
-  clientAvatarUrl: string | null
-
-  // Professional (assignee)
-  professionalId: string | null
-  professionalName: string | null
-  professionalAvatarUrl: string | null
-
-  // Location
-  locationName: string | null
-
-  // Order totals
-  orderTotal: number | null
-  orderStatus: string | null
-  /** Payment status from financial bridge (enriched at runtime) */
-  paymentStatus?: import('./financial-bridge').BookingPaymentStatus
-
-  // Aggregated services
-  services: BookingService[] | null
-  totalDurationMinutes: number | null
-
-  createdAt: string
-  updatedAt: string
-}
-
-/** Professional / staff resource for the calendar */
-export interface Professional {
-  id: string
-  name: string
-  avatarUrl: string | null
-  locationId: string | null
-  locationName: string | null
-  isActive: boolean
-}
-
-/** Working hours schedule (from public.schedules) */
-export interface Schedule {
-  id: string
-  tenantId: string
-  kind: string
-  assigneeId: string | null
-  locationId: string | null
-  dayOfWeek: number | null
-  specificDate: string | null
-  startsAt: string
-  endsAt: string
-  isActive: boolean
-  metadata: Record<string, unknown>
-}
-
-/** Available time slot */
-export interface TimeSlot {
-  start: string
-  end: string
-}
-
-/** Confirmation record stored in booking metadata */
-export interface ConfirmationRecord {
-  channel: string
-  sentAt: string
-  status: ConfirmationStatus
-  confirmedAt?: string
-}
-
-// ============================================================
-// STATUS CONFIGURATION
-// ============================================================
-
-/**
- * When a status is available for selection relative to the booking date.
- * - 'always'        — any date (e.g. scheduled, confirmed, cancelled)
- * - 'today_or_past' — booking is today or earlier (e.g. completed, no_show)
- * - 'today_only'    — booking is today (e.g. in_progress)
- */
-export type StatusAvailability = 'always' | 'today_or_past' | 'today_only'
-
-export interface StatusConfig {
-  value: string
-  label: string
-  color: string
-  /** When this status can be selected (default: 'always') */
-  availableWhen?: StatusAvailability
-}
-
-/** Check if a status is available for a given booking date */
-export function isStatusAvailable(status: StatusConfig, bookingStartsAt: string): boolean {
-  const when = status.availableWhen ?? 'always'
-  if (when === 'always') return true
-  const bookingDate = bookingStartsAt.slice(0, 10)
-  const today = new Date().toISOString().slice(0, 10)
-  if (when === 'today_or_past') return bookingDate <= today
-  if (when === 'today_only') return bookingDate === today
-  return true
-}
-
-// ============================================================
-// MODAL TAB EXTENSION
-// ============================================================
-
-/** Props passed to every booking modal tab component */
-export interface BookingModalTabProps {
-  bookingId?: string
-  clientId: string
-  orderId: string | null
-  services: Array<{ name: string; price: number; durationMinutes: number }>
-  formatCurrency: (amount: number) => string
-  onDataChange?: () => void
-}
-
-/** A tab registered in the booking edit modal */
-export interface BookingModalTab {
-  id: string
-  label: string
-  icon: string
-  order: number
-  component: React.ComponentType<BookingModalTabProps>
-  visible?: (ctx: { mode: 'create' | 'edit'; clientId?: string; orderId?: string }) => boolean
-}
-
-// ============================================================
-// INPUT TYPES (create / mutate)
-// ============================================================
-
-export interface CreateBookingInput {
-  kind?: BookingTypeId
-  clientId: string
-  professionalId: string
-  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[]
-}
-
-export interface CreateBookingServiceInput {
-  serviceId: string
-  name: string
-  durationMinutes: number
-  price: number
-  assigneeId?: string
-}
-
-export interface UpdateBookingInput {
-  clientId?: string
-  professionalId?: string
-  locationId?: string
-  startsAt?: string
-  endsAt?: string
-  status?: BookingStatus
-  notes?: string
-  /** Free-text event title for simple events (no client party). */
-  title?: string
-  services?: CreateBookingServiceInput[]
-}
-
-export interface SaveScheduleInput {
-  assigneeId: string
-  locationId?: string
-  dayOfWeek?: number
-  specificDate?: string
-  startsAt: string
-  endsAt: string
-  isActive?: boolean
-  metadata?: Record<string, unknown>
-}
-
-// ============================================================
-// QUERY / FILTER TYPES
-// ============================================================
-
-export interface BookingQuery {
-  dateRange: { start: string; end: string }
-  professionalIds?: string[]
-  locationId?: string
-  statuses?: string[]
-  kind?: string
-}
-
-export interface ConflictCheckParams {
-  assigneeId: string
-  startsAt: string
-  endsAt: string
-  excludeBookingId?: string
-}
-
-export interface AvailableSlotsParams {
-  assigneeId: string
-  date: string
-  durationMinutes: number
-  slotInterval?: number
-}