payload-reserve 2.1.1 → 2.2.1

package/README.md

@@ -37,6 +37,7 @@ Designed for salons, clinics, hotels, restaurants, event venues, and any busines
 - **Recurring and Manual Schedules** — Weekly patterns with exception dates, or specific one-off dates
 - **12 Bundled Languages** — Every admin string is translatable; ships with English, French, German, Spanish, Russian, Polish, Turkish, Arabic, Simplified Chinese, Indonesian, Persian/Farsi, and Hindi. Override any string or add your own language
 - **Localization Support** — Collection field *content* can be localized when Payload localization is enabled (separate from the admin-UI language above)
+- **External Busy** — Optional `getExternalBusy` resolver folds busy time from calendar sync, legacy booking systems, or ops tooling into availability, with distinct calendar display and fail-open error handling
 - **Type-Safe** — Full TypeScript support with exported types
 
 ---
@@ -311,6 +312,62 @@ The `services` relationship on Resources is now optional. This lets a freshly pr
 
 ---
 
+## External Busy (Calendar Sync & Other Sources)
+
+`getExternalBusy` lets your app fold busy time that payload-reserve doesn't manage — an external calendar, a legacy booking system, ops tooling — into a resource's availability. The plugin never talks to any calendar API itself; it calls a resolver you provide once per candidate window and treats whatever it returns as busy time for that resource.
+
+Use it to:
+
+- Import busy time from two-way calendar sync (Google Calendar, Outlook, iCal feeds)
+- Respect bookings made in another/legacy booking system during a migration
+- Block maintenance/cleaning windows tracked in an ops system
+- Reflect staff leave recorded in an HR system that isn't modeled as plugin time-off
+
+A realistic setup keeps a local collection in sync (via webhooks or a cron job) and has the resolver run a single indexed query against it — the resolver itself never calls a remote API:
+
+```ts
+import type { ExternalBusyInterval, GetExternalBusy } from 'payload-reserve'
+
+// A sync job (webhook handler or scheduled cron task) keeps this collection's
+// rows current from whatever external source you're integrating — a
+// Google/Outlook calendar sync, a legacy system export, an ops tool, etc.
+// The resolver below never calls out itself; it only reads what the sync
+// job already wrote, so it stays a single cheap, indexed query.
+const getExternalBusy: GetExternalBusy = async ({ end, req, resourceId, start }) => {
+  const result = await req.payload.find({
+    collection: 'external-busy', // your locally-synced collection
+    where: {
+      and: [
+        { resource: { equals: resourceId } },
+        { start: { less_than: end.toISOString() } },
+        { end: { greater_than: start.toISOString() } },
+      ],
+    },
+    depth: 0,
+    limit: 0,
+  })
+
+  return result.docs.map(
+    (doc): ExternalBusyInterval => ({
+      start: doc.start,
+      end: doc.end,
+      label: doc.label,
+    }),
+  )
+}
+
+payloadReserve({
+  getExternalBusy,
+})
+```
+
+- **Enforcement:** any booking (hooks, endpoints, slot listings) overlapping an interval is unavailable. An interval blocks the WHOLE resource (all `quantity` units) — external calendars aren't unit-aware.
+- **Display:** the `resource-availability` endpoint returns the intervals as a separate `external[]` array (not mixed into `busy`), and the calendar renders them as a distinct, non-clickable hatched "External event" slot.
+- **Fail-open:** if the resolver throws, the plugin treats it as no external busy for that call — a sync failure never blocks a real booking or breaks the grid.
+- **Performance:** the resolver is called once per candidate window during slot computation, so keep it cheap — a local table lookup or a per-request cache, never a remote API call per invocation.
+
+---
+
 ## Internationalization
 
 Every admin string the plugin renders — field labels, descriptions, select options, calendar/dashboard components, and validation errors — is translatable. The plugin ships **12 languages**: English, French (`fr`), German (`de`), Spanish (`es`), Russian (`ru`), Polish (`pl`), Turkish (`tr`), Arabic (`ar`), Simplified Chinese (`zh`), Indonesian (`id`), Persian/Farsi (`fa`), and Hindi (`hi`). All but Hindi ship in Payload core and appear in the admin language switcher automatically.
@@ -340,7 +397,7 @@ This is separate from Payload **field localization** (localizing the *content* o
 | Topic | Contents |
 |-------|----------|
 | [Getting Started](https://github.com/elghaied/payload-reserve/blob/main/docs/getting-started.md) | Installation, quick start, what gets created |
-| [Configuration](https://github.com/elghaied/payload-reserve/blob/main/docs/configuration.md) | All plugin options with types and defaults, including `resourceOwnerMode` |
+| [Configuration](https://github.com/elghaied/payload-reserve/blob/main/docs/configuration.md) | All plugin options with types and defaults, including `resourceOwnerMode` and `getExternalBusy` |
 | [Collections](https://github.com/elghaied/payload-reserve/blob/main/docs/collections.md) | Services, Resources, Schedules, Customers, Reservations schemas |
 | [Status Machine](https://github.com/elghaied/payload-reserve/blob/main/docs/status-machine.md) | Default flow, custom machines, business logic hooks, escape hatch |
 | [Booking Features](https://github.com/elghaied/payload-reserve/blob/main/docs/booking-features.md) | Duration types, multi-resource bookings, capacity modes |

package/dist/components/CalendarView/CalendarView.module.css

@@ -520,6 +520,17 @@
   cursor: not-allowed;
 }
 
+.slotExternal {
+  background: repeating-linear-gradient(
+    45deg,
+    var(--theme-elevation-100),
+    var(--theme-elevation-100) 6px,
+    var(--theme-error-50) 6px,
+    var(--theme-error-50) 12px
+  );
+  cursor: not-allowed;
+}
+
 .slotFree {
   cursor: pointer;
 }

package/dist/components/CalendarView/LaneTimelineView.js

@@ -7,6 +7,7 @@ import { getDayKeyInTimezone } from '../../utilities/timezoneUtils.js';
 import styles from './CalendarView.module.css';
 import { useResourceAvailability } from './useResourceAvailability.js';
 const SLOT_STATE_KEYS = {
+    external: 'reservation:slotExternal',
     free: 'reservation:slotFree',
     full: 'reservation:slotFull',
     'off-shift': 'reservation:slotOffShift',
@@ -27,6 +28,7 @@ function Lane({ apiBase, day, endHour, onBook, resource, startHour, timeZone })
         capacityMode: data.capacityMode,
         dayEnd,
         dayStart,
+        external: data.external,
         quantity: data.quantity,
         requiredPools: data.requiredPools,
         shiftWindows: dayAvail.shiftWindows,
@@ -43,7 +45,7 @@ function Lane({ apiBase, day, endHour, onBook, resource, startHour, timeZone })
             /*#__PURE__*/ _jsx("div", {
                 className: styles.laneTrack,
                 children: slots.map((s)=>{
-                    const cls = s.state === 'off-shift' ? styles.slotOffShift : s.state === 'time-off' ? styles.slotTimeOff : s.state === 'full' ? styles.slotFull : styles.slotFree;
+                    const cls = s.state === 'off-shift' ? styles.slotOffShift : s.state === 'time-off' ? styles.slotTimeOff : s.state === 'external' ? styles.slotExternal : s.state === 'full' ? styles.slotFull : styles.slotFree;
                     const isFree = s.state === 'free';
                     const slotLabel = `${s.start.toLocaleTimeString([], {
                         hour: '2-digit',

package/dist/components/CalendarView/LaneTimelineView.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../src/components/CalendarView/LaneTimelineView.tsx"],"sourcesContent":["'use client'\nimport { useTranslation } from '@payloadcms/ui'\nimport React from 'react'\n\nimport type { PluginT } from '../../translations/index.js'\nimport type { SlotState } from '../../utilities/computeSlotStates.js'\n\nimport { computeSlotStates } from '../../utilities/computeSlotStates.js'\nimport { getDayKeyInTimezone } from '../../utilities/timezoneUtils.js'\nimport styles from './CalendarView.module.css'\nimport { useResourceAvailability } from './useResourceAvailability.js'\n\ntype LaneResource = { id: string; name: string }\n\nconst SLOT_STATE_KEYS: Record<SlotState, string> = {\n  free: 'reservation:slotFree',\n  full: 'reservation:slotFull',\n  'off-shift': 'reservation:slotOffShift',\n  'time-off': 'reservation:slotTimeOff',\n}\n\nfunction Lane({\n  apiBase,\n  day,\n  endHour,\n  onBook,\n  resource,\n  startHour,\n  timeZone,\n}: {\n  apiBase: string\n  day: Date\n  endHour: number\n  onBook: (resourceId: string, startIso: string) => void\n  resource: LaneResource\n  startHour: number\n  timeZone: string\n}) {\n  const { t: _t } = useTranslation()\n  const t = _t as PluginT\n\n  const dayStart = new Date(day)\n  dayStart.setHours(startHour, 0, 0, 0)\n  const dayEnd = new Date(day)\n  dayEnd.setHours(endHour, 0, 0, 0)\n\n  const { data } = useResourceAvailability(apiBase, resource.id, dayStart, dayEnd)\n  const isoDay = getDayKeyInTimezone(day, timeZone)\n  const dayAvail = data?.days.find((d) => d.date === isoDay)\n\n  const slots = dayAvail\n    ? computeSlotStates({\n        busy: data!.busy,\n        capacityMode: data!.capacityMode,\n        dayEnd,\n        dayStart,\n        quantity: data!.quantity,\n        requiredPools: data!.requiredPools,\n        shiftWindows: dayAvail.shiftWindows,\n        step: 60,\n        timeOff: dayAvail.timeOff,\n      })\n    : []\n\n  return (\n    <div className={styles.lane}>\n      <div className={styles.laneLabel}>{resource.name}</div>\n      <div className={styles.laneTrack}>\n        {slots.map((s) => {\n          const cls =\n            s.state === 'off-shift'\n              ? styles.slotOffShift\n              : s.state === 'time-off'\n                ? styles.slotTimeOff\n                : s.state === 'full'\n                  ? styles.slotFull\n                  : styles.slotFree\n          const isFree = s.state === 'free'\n          const slotLabel = `${s.start.toLocaleTimeString([], {\n            hour: '2-digit',\n            minute: '2-digit',\n            timeZone,\n          })} — ${t(SLOT_STATE_KEYS[s.state])}`\n          return isFree ? (\n            <div\n              aria-label={slotLabel}\n              className={`${styles.laneCell} ${cls}`}\n              key={s.start.toISOString()}\n              onClick={() => onBook(resource.id, s.start.toISOString())}\n              onKeyDown={(e) => {\n                if (e.key === 'Enter' || e.key === ' ') {\n                  e.preventDefault()\n                  onBook(resource.id, s.start.toISOString())\n                }\n              }}\n              role=\"button\"\n              tabIndex={0}\n              title={slotLabel}\n            />\n          ) : (\n            <div\n              className={`${styles.laneCell} ${cls}`}\n              key={s.start.toISOString()}\n              title={slotLabel}\n            />\n          )\n        })}\n      </div>\n    </div>\n  )\n}\n\nexport function LaneTimelineView({\n  apiBase,\n  day,\n  endHour,\n  onBook,\n  resources,\n  startHour,\n  timeZone,\n}: {\n  apiBase: string\n  day: Date\n  endHour: number\n  onBook: (resourceId: string, startIso: string) => void\n  resources: LaneResource[]\n  startHour: number\n  timeZone: string\n}) {\n  const { t: _t } = useTranslation()\n  const t = _t as PluginT\n  if (resources.length === 0) {\n    return <p className={styles.hint}>{t('reservation:laneNoResources')}</p>\n  }\n  const hours = Array.from({ length: endHour - startHour }, (_, i) => startHour + i)\n  return (\n    <div className={styles.lanes}>\n      <div className={styles.laneHeader}>\n        <div className={styles.laneLabel} />\n        <div className={styles.laneTrack}>\n          {hours.map((h) => (\n            <div className={styles.laneTime} key={h}>\n              {String(h).padStart(2, '0')}:00\n            </div>\n          ))}\n        </div>\n      </div>\n      {resources.map((r) => (\n        <Lane\n          apiBase={apiBase}\n          day={day}\n          endHour={endHour}\n          key={r.id}\n          onBook={onBook}\n          resource={r}\n          startHour={startHour}\n          timeZone={timeZone}\n        />\n      ))}\n    </div>\n  )\n}\n"],"names":["useTranslation","React","computeSlotStates","getDayKeyInTimezone","styles","useResourceAvailability","SLOT_STATE_KEYS","free","full","Lane","apiBase","day","endHour","onBook","resource","startHour","timeZone","t","_t","dayStart","Date","setHours","dayEnd","data","id","isoDay","dayAvail","days","find","d","date","slots","busy","capacityMode","quantity","requiredPools","shiftWindows","step","timeOff","div","className","lane","laneLabel","name","laneTrack","map","s","cls","state","slotOffShift","slotTimeOff","slotFull","slotFree","isFree","slotLabel","start","toLocaleTimeString","hour","minute","aria-label","laneCell","onClick","toISOString","onKeyDown","e","key","preventDefault","role","tabIndex","title","LaneTimelineView","resources","length","p","hint","hours","Array","from","_","i","lanes","laneHeader","h","laneTime","String","padStart","r"],"mappings":"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"}
+{"version":3,"sources":["../../../src/components/CalendarView/LaneTimelineView.tsx"],"sourcesContent":["'use client'\nimport { useTranslation } from '@payloadcms/ui'\nimport React from 'react'\n\nimport type { PluginT } from '../../translations/index.js'\nimport type { SlotState } from '../../utilities/computeSlotStates.js'\n\nimport { computeSlotStates } from '../../utilities/computeSlotStates.js'\nimport { getDayKeyInTimezone } from '../../utilities/timezoneUtils.js'\nimport styles from './CalendarView.module.css'\nimport { useResourceAvailability } from './useResourceAvailability.js'\n\ntype LaneResource = { id: string; name: string }\n\nconst SLOT_STATE_KEYS: Record<SlotState, string> = {\n  external: 'reservation:slotExternal',\n  free: 'reservation:slotFree',\n  full: 'reservation:slotFull',\n  'off-shift': 'reservation:slotOffShift',\n  'time-off': 'reservation:slotTimeOff',\n}\n\nfunction Lane({\n  apiBase,\n  day,\n  endHour,\n  onBook,\n  resource,\n  startHour,\n  timeZone,\n}: {\n  apiBase: string\n  day: Date\n  endHour: number\n  onBook: (resourceId: string, startIso: string) => void\n  resource: LaneResource\n  startHour: number\n  timeZone: string\n}) {\n  const { t: _t } = useTranslation()\n  const t = _t as PluginT\n\n  const dayStart = new Date(day)\n  dayStart.setHours(startHour, 0, 0, 0)\n  const dayEnd = new Date(day)\n  dayEnd.setHours(endHour, 0, 0, 0)\n\n  const { data } = useResourceAvailability(apiBase, resource.id, dayStart, dayEnd)\n  const isoDay = getDayKeyInTimezone(day, timeZone)\n  const dayAvail = data?.days.find((d) => d.date === isoDay)\n\n  const slots = dayAvail\n    ? computeSlotStates({\n        busy: data!.busy,\n        capacityMode: data!.capacityMode,\n        dayEnd,\n        dayStart,\n        external: data!.external,\n        quantity: data!.quantity,\n        requiredPools: data!.requiredPools,\n        shiftWindows: dayAvail.shiftWindows,\n        step: 60,\n        timeOff: dayAvail.timeOff,\n      })\n    : []\n\n  return (\n    <div className={styles.lane}>\n      <div className={styles.laneLabel}>{resource.name}</div>\n      <div className={styles.laneTrack}>\n        {slots.map((s) => {\n          const cls =\n            s.state === 'off-shift'\n              ? styles.slotOffShift\n              : s.state === 'time-off'\n                ? styles.slotTimeOff\n                : s.state === 'external'\n                  ? styles.slotExternal\n                  : s.state === 'full'\n                    ? styles.slotFull\n                    : styles.slotFree\n          const isFree = s.state === 'free'\n          const slotLabel = `${s.start.toLocaleTimeString([], {\n            hour: '2-digit',\n            minute: '2-digit',\n            timeZone,\n          })} — ${t(SLOT_STATE_KEYS[s.state])}`\n          return isFree ? (\n            <div\n              aria-label={slotLabel}\n              className={`${styles.laneCell} ${cls}`}\n              key={s.start.toISOString()}\n              onClick={() => onBook(resource.id, s.start.toISOString())}\n              onKeyDown={(e) => {\n                if (e.key === 'Enter' || e.key === ' ') {\n                  e.preventDefault()\n                  onBook(resource.id, s.start.toISOString())\n                }\n              }}\n              role=\"button\"\n              tabIndex={0}\n              title={slotLabel}\n            />\n          ) : (\n            <div\n              className={`${styles.laneCell} ${cls}`}\n              key={s.start.toISOString()}\n              title={slotLabel}\n            />\n          )\n        })}\n      </div>\n    </div>\n  )\n}\n\nexport function LaneTimelineView({\n  apiBase,\n  day,\n  endHour,\n  onBook,\n  resources,\n  startHour,\n  timeZone,\n}: {\n  apiBase: string\n  day: Date\n  endHour: number\n  onBook: (resourceId: string, startIso: string) => void\n  resources: LaneResource[]\n  startHour: number\n  timeZone: string\n}) {\n  const { t: _t } = useTranslation()\n  const t = _t as PluginT\n  if (resources.length === 0) {\n    return <p className={styles.hint}>{t('reservation:laneNoResources')}</p>\n  }\n  const hours = Array.from({ length: endHour - startHour }, (_, i) => startHour + i)\n  return (\n    <div className={styles.lanes}>\n      <div className={styles.laneHeader}>\n        <div className={styles.laneLabel} />\n        <div className={styles.laneTrack}>\n          {hours.map((h) => (\n            <div className={styles.laneTime} key={h}>\n              {String(h).padStart(2, '0')}:00\n            </div>\n          ))}\n        </div>\n      </div>\n      {resources.map((r) => (\n        <Lane\n          apiBase={apiBase}\n          day={day}\n          endHour={endHour}\n          key={r.id}\n          onBook={onBook}\n          resource={r}\n          startHour={startHour}\n          timeZone={timeZone}\n        />\n      ))}\n    </div>\n  )\n}\n"],"names":["useTranslation","React","computeSlotStates","getDayKeyInTimezone","styles","useResourceAvailability","SLOT_STATE_KEYS","external","free","full","Lane","apiBase","day","endHour","onBook","resource","startHour","timeZone","t","_t","dayStart","Date","setHours","dayEnd","data","id","isoDay","dayAvail","days","find","d","date","slots","busy","capacityMode","quantity","requiredPools","shiftWindows","step","timeOff","div","className","lane","laneLabel","name","laneTrack","map","s","cls","state","slotOffShift","slotTimeOff","slotExternal","slotFull","slotFree","isFree","slotLabel","start","toLocaleTimeString","hour","minute","aria-label","laneCell","onClick","toISOString","onKeyDown","e","key","preventDefault","role","tabIndex","title","LaneTimelineView","resources","length","p","hint","hours","Array","from","_","i","lanes","laneHeader","h","laneTime","String","padStart","r"],"mappings":"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"}

package/dist/components/CalendarView/index.js

@@ -219,6 +219,13 @@ export const CalendarView = ()=>{
                         id: d.id,
                         name: d.name ?? ''
                     })));
+                // Single-resource installs have no resource filter (it renders only for 2+),
+                // so nothing could ever select the resource and the week/day availability
+                // shading (off-shift / full / time-off / external) never loaded. Auto-select
+                // the sole resource; with 2+ the user chooses via the filter as before.
+                if (docs.length === 1) {
+                    setSelectedResourceId((prev)=>prev || String(docs[0].id));
+                }
             } catch  {
                 setResources([]);
             }
@@ -846,6 +853,7 @@ export const CalendarView = ()=>{
                 capacityMode: availability.capacityMode,
                 dayEnd,
                 dayStart,
+                external: availability.external,
                 quantity: availability.quantity,
                 requiredPools: availability.requiredPools,
                 shiftWindows: dayAvail.shiftWindows,
@@ -907,6 +915,9 @@ export const CalendarView = ()=>{
                                     } else if (slotInfo.state === 'time-off') {
                                         slotClass = styles.slotTimeOff;
                                         isNonInteractive = true;
+                                    } else if (slotInfo.state === 'external') {
+                                        slotClass = styles.slotExternal;
+                                        isNonInteractive = true;
                                     } else if (slotInfo.state === 'full') {
                                         slotClass = styles.slotFull;
                                         isNonInteractive = true;
@@ -981,6 +992,7 @@ export const CalendarView = ()=>{
                 capacityMode: availability.capacityMode,
                 dayEnd,
                 dayStart,
+                external: availability.external,
                 quantity: availability.quantity,
                 requiredPools: availability.requiredPools,
                 shiftWindows: dayAvail.shiftWindows,
@@ -1013,6 +1025,9 @@ export const CalendarView = ()=>{
                     } else if (slotInfo.state === 'time-off') {
                         slotClass = styles.slotTimeOff;
                         isNonInteractive = true;
+                    } else if (slotInfo.state === 'external') {
+                        slotClass = styles.slotExternal;
+                        isNonInteractive = true;
                     } else if (slotInfo.state === 'full') {
                         slotClass = styles.slotFull;
                         isNonInteractive = true;