# React Scheduler Remote Data

> Load events on demand as users navigate, and persist every change back to your server.

Instead of passing `events` up front, hand the scheduler a `dataSource`:
`getEvents(start, end)` runs whenever the visible range changes, and
`persistEvents` runs after every committed change.

```tsx
<CScheduler
  dataSource={{
    getEvents: async (start, end) =>
      (await fetch(`/api/events?from=${start}&to=${end}`)).json(),

    persistEvents: async ({ action, event, occurrence, scope }) => {
      const response = await fetch('/api/events', {
        method: 'POST',
        body: JSON.stringify({ action, event, occurrence, scope }),
      })
      return { success: response.ok } // success: false reverts the change
    },
  }}
/>
```

Keep the `dataSource` object identity stable across renders (module scope,
`useMemo`, or `useRef`) — a new object clears the fetched-range cache and
refetches.

## Behavior

- `getEvents` receives the visible window as ISO strings (end exclusive) and
  fires on mount and whenever navigation, view switches or prop changes move
  the range — never twice for the same range. A spinner
  (`data-part="loading"`) shows while a request is in flight, and stale
  responses from superseded requests are discarded.
- A failed load keeps the current events and announces the localizable
  `loadFailed` message.
- `persistEvents` gets the same payload as `onEventChange` (minus `revert`).
  Returning `{ success: false }` — or throwing — reverts the change and
  announces `saveFailed`. `onEventChange` still fires first, so analytics
  and optimistic UI keep working.
- The `getVisibleRange()` ref method returns the current window
  (`{ start, end }`) if you prefer wiring fetches yourself through
  `onDateChange`/`onViewChange`.

## Manual wiring

Everything above is also possible without `dataSource` — listen to
`onDateChange`, fetch, call `setEvents()` on the ref, and call `revert()`
from your `onEventChange` handler when the server rejects a change.
`dataSource` is the packaged version of exactly that pattern.