payload-reserve 1.3.2 → 1.5.0

package/dist/types.d.ts

@@ -55,14 +55,48 @@ export type ResourceOwnerModeConfig = {
     adminRoles?: string[];
     /** Whether Services also get an owner field (default: false — Services are platform-managed) */
     ownedServices?: boolean;
+    /**
+     * Collection the owner field relates to (where owners/staff live). Defaults to
+     * `staffProvisioning.userCollection` when set, otherwise `slugs.customers`. Set
+     * this when owners live in a different collection than your customers (e.g.
+     * separate `users` and `customers` collections).
+     */
+    ownerCollection?: string;
     /** Field name for the owner relationship on Resources (default: 'owner') */
     ownerField?: string;
 };
 export type ResolvedResourceOwnerModeConfig = {
     adminRoles: string[];
     ownedServices: boolean;
+    ownerCollection?: string;
     ownerField: string;
 };
+export type StaffProvisioningConfig = {
+    /** Stamp tenant / custom fields onto the provisioned Resource before create. */
+    beforeCreate?: (args: {
+        data: Record<string, unknown>;
+        req: PayloadRequest;
+        user: Record<string, unknown>;
+    }) => Promise<Record<string, unknown>> | Record<string, unknown>;
+    /** User field copied into Resource `name` (default 'name', falls back to email). */
+    nameFrom?: string;
+    /** resourceType to stamp (default 'staff'). Must be a valid resourceType. */
+    resourceType?: string;
+    /** Field on the user holding the role (default 'role'). */
+    roleField?: string;
+    /** Role value(s) marking a user as staff. Required, non-empty. */
+    staffRoles: string[];
+    /** Auth collection holding staff users. Defaults to top-level `userCollection`. */
+    userCollection?: string;
+};
+export type ResolvedStaffProvisioningConfig = {
+    beforeCreate?: StaffProvisioningConfig['beforeCreate'];
+    nameFrom: string;
+    resourceType: string;
+    roleField: string;
+    staffRoles: string[];
+    userCollection: string;
+};
 export type ReservationPluginConfig = {
     /** Override access control per collection */
     access?: {
@@ -74,6 +108,8 @@ export type ReservationPluginConfig = {
     };
     /** Admin group name for all reservation collections */
     adminGroup?: string;
+    /** Allow bookings without a customer account by default (per-service override available) */
+    allowGuestBooking?: boolean;
     /** Hours of notice required before cancellation */
     cancellationNoticePeriod?: number;
     /** Default buffer time in minutes between reservations */
@@ -84,8 +120,12 @@ export type ReservationPluginConfig = {
     extraReservationFields?: Field[];
     /** Plugin hooks for external integrations */
     hooks?: ReservationPluginHooks;
+    /** Configurable leave/exception type vocabulary (default: vacation/sick/personal/closure/other) */
+    leaveTypes?: string[];
     /** Enable resource-owner multi-tenancy (opt-in) */
     resourceOwnerMode?: ResourceOwnerModeConfig;
+    /** Configurable resourceType vocabulary (default: staff/equipment/room) */
+    resourceTypes?: string[];
     /** Override collection slugs */
     slugs?: {
         customers?: string;
@@ -95,6 +135,8 @@ export type ReservationPluginConfig = {
         schedules?: string;
         services?: string;
     };
+    /** Auto-provision a Resource from staff-role users (opt-in; requires resourceOwnerMode) */
+    staffProvisioning?: StaffProvisioningConfig;
     /** Configurable status machine (defaults to current behavior) */
     statusMachine?: Partial<StatusMachineConfig>;
     /** Which existing auth collection to extend with customer fields */
@@ -109,13 +151,16 @@ export type ResolvedReservationPluginConfig = {
         services?: CollectionConfig['access'];
     };
     adminGroup: string;
+    allowGuestBooking: boolean;
     cancellationNoticePeriod: number;
     defaultBufferTime: number;
     disabled: boolean;
     extraReservationFields: Field[];
     hooks: ReservationPluginHooks;
+    leaveTypes: string[];
     localized: boolean;
     resourceOwnerMode: ResolvedResourceOwnerModeConfig | undefined;
+    resourceTypes: string[];
     slugs: {
         customers: string;
         media: string;
@@ -124,6 +169,7 @@ export type ResolvedReservationPluginConfig = {
         schedules: string;
         services: string;
     };
+    staffProvisioning: ResolvedStaffProvisioningConfig | undefined;
     statusMachine: StatusMachineConfig;
     userCollection: string | undefined;
 };

package/dist/types.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/types.ts"],"sourcesContent":["import type { CollectionConfig, Field, PayloadRequest } from 'payload'\n\n// --- Duration & Capacity models ---\n\nexport type DurationType = 'fixed' | 'flexible' | 'full-day'\n\nexport type CapacityMode = 'per-guest' | 'per-reservation'\n\n// --- Configurable status machine ---\n\nexport type StatusMachineConfig = {\n  blockingStatuses: string[]\n  defaultStatus: string\n  statuses: string[]\n  terminalStatuses: string[]\n  transitions: Record<string, string[]>\n}\n\nexport const DEFAULT_STATUS_MACHINE: StatusMachineConfig = {\n  blockingStatuses: ['pending', 'confirmed'],\n  defaultStatus: 'pending',\n  statuses: ['pending', 'confirmed', 'completed', 'cancelled', 'no-show'],\n  terminalStatuses: ['completed', 'cancelled', 'no-show'],\n  transitions: {\n    cancelled: [],\n    completed: [],\n    confirmed: ['completed', 'cancelled', 'no-show'],\n    'no-show': [],\n    pending: ['confirmed', 'cancelled'],\n  },\n}\n\n// --- Reservation item (for multi-resource bookings, Phase 3) ---\n\nexport type ReservationItemConfig = {\n  endTime?: string\n  guestCount?: number\n  resource: string\n  service?: string\n  startTime?: string\n}\n\n// --- Plugin hooks for external integrations ---\n\nexport type ReservationPluginHooks = {\n  afterBookingCancel?: Array<\n    (args: { doc: Record<string, unknown>; req: PayloadRequest }) => Promise<void> | void\n  >\n  afterBookingConfirm?: Array<\n    (args: { doc: Record<string, unknown>; req: PayloadRequest }) => Promise<void> | void\n  >\n  afterBookingCreate?: Array<\n    (args: { doc: Record<string, unknown>; req: PayloadRequest }) => Promise<void> | void\n  >\n  afterStatusChange?: Array<\n    (args: {\n      doc: Record<string, unknown>\n      newStatus: string\n      previousStatus: string\n      req: PayloadRequest\n    }) => Promise<void> | void\n  >\n  beforeBookingCancel?: Array<\n    (args: {\n      doc: Record<string, unknown>\n      reason?: string\n      req: PayloadRequest\n    }) => Promise<void> | void\n  >\n  beforeBookingConfirm?: Array<\n    (args: {\n      doc: Record<string, unknown>\n      newStatus: string\n      req: PayloadRequest\n    }) => Promise<void> | void\n  >\n  beforeBookingCreate?: Array<\n    (args: {\n      data: Record<string, unknown>\n      req: PayloadRequest\n    }) => Promise<Record<string, unknown>> | Record<string, unknown>\n  >\n}\n\n// --- Resource owner mode ---\n\nexport type ResourceOwnerModeConfig = {\n  /** Roles that can see all records (default: check req.user.collection === adminCollection) */\n  adminRoles?: string[]\n  /** Whether Services also get an owner field (default: false — Services are platform-managed) */\n  ownedServices?: boolean\n  /** Field name for the owner relationship on Resources (default: 'owner') */\n  ownerField?: string\n}\n\nexport type ResolvedResourceOwnerModeConfig = {\n  adminRoles: string[]\n  ownedServices: boolean\n  ownerField: string\n}\n\n// --- Plugin configuration ---\n\nexport type ReservationPluginConfig = {\n  /** Override access control per collection */\n  access?: {\n    customers?: CollectionConfig['access']\n    reservations?: CollectionConfig['access']\n    resources?: CollectionConfig['access']\n    schedules?: CollectionConfig['access']\n    services?: CollectionConfig['access']\n  }\n  /** Admin group name for all reservation collections */\n  adminGroup?: string\n  /** Hours of notice required before cancellation */\n  cancellationNoticePeriod?: number\n  /** Default buffer time in minutes between reservations */\n  defaultBufferTime?: number\n  /** Disable the plugin entirely */\n  disabled?: boolean\n  /** Extra fields to append to the Reservations collection */\n  extraReservationFields?: Field[]\n  /** Plugin hooks for external integrations */\n  hooks?: ReservationPluginHooks\n  /** Enable resource-owner multi-tenancy (opt-in) */\n  resourceOwnerMode?: ResourceOwnerModeConfig\n  /** Override collection slugs */\n  slugs?: {\n    customers?: string\n    media?: string\n    reservations?: string\n    resources?: string\n    schedules?: string\n    services?: string\n  }\n  /** Configurable status machine (defaults to current behavior) */\n  statusMachine?: Partial<StatusMachineConfig>\n  /** Which existing auth collection to extend with customer fields */\n  userCollection?: string\n}\n\nexport type ResolvedReservationPluginConfig = {\n  access: {\n    customers?: CollectionConfig['access']\n    reservations?: CollectionConfig['access']\n    resources?: CollectionConfig['access']\n    schedules?: CollectionConfig['access']\n    services?: CollectionConfig['access']\n  }\n  adminGroup: string\n  cancellationNoticePeriod: number\n  defaultBufferTime: number\n  disabled: boolean\n  extraReservationFields: Field[]\n  hooks: ReservationPluginHooks\n  localized: boolean\n  resourceOwnerMode: ResolvedResourceOwnerModeConfig | undefined\n  slugs: {\n    customers: string\n    media: string\n    reservations: string\n    resources: string\n    schedules: string\n    services: string\n  }\n  statusMachine: StatusMachineConfig\n  userCollection: string | undefined\n}\n\nexport type ReservationStatus = 'cancelled' | 'completed' | 'confirmed' | 'no-show' | 'pending'\n\nexport type DayOfWeek = 'fri' | 'mon' | 'sat' | 'sun' | 'thu' | 'tue' | 'wed'\n\nexport type ScheduleType = 'manual' | 'recurring'\n\n/** @deprecated Use DEFAULT_STATUS_MACHINE.transitions instead */\nexport const VALID_STATUS_TRANSITIONS: Record<ReservationStatus, ReservationStatus[]> =\n  DEFAULT_STATUS_MACHINE.transitions as Record<ReservationStatus, ReservationStatus[]>\n"],"names":["DEFAULT_STATUS_MACHINE","blockingStatuses","defaultStatus","statuses","terminalStatuses","transitions","cancelled","completed","confirmed","pending","VALID_STATUS_TRANSITIONS"],"mappings":"AAkBA,OAAO,MAAMA,yBAA8C;IACzDC,kBAAkB;QAAC;QAAW;KAAY;IAC1CC,eAAe;IACfC,UAAU;QAAC;QAAW;QAAa;QAAa;QAAa;KAAU;IACvEC,kBAAkB;QAAC;QAAa;QAAa;KAAU;IACvDC,aAAa;QACXC,WAAW,EAAE;QACbC,WAAW,EAAE;QACbC,WAAW;YAAC;YAAa;YAAa;SAAU;QAChD,WAAW,EAAE;QACbC,SAAS;YAAC;YAAa;SAAY;IACrC;AACF,EAAC;AAiJD,+DAA+D,GAC/D,OAAO,MAAMC,2BACXV,uBAAuBK,WAAW,CAAkD"}
+{"version":3,"sources":["../src/types.ts"],"sourcesContent":["import type { CollectionConfig, Field, PayloadRequest } from 'payload'\n\n// --- Duration & Capacity models ---\n\nexport type DurationType = 'fixed' | 'flexible' | 'full-day'\n\nexport type CapacityMode = 'per-guest' | 'per-reservation'\n\n// --- Configurable status machine ---\n\nexport type StatusMachineConfig = {\n  blockingStatuses: string[]\n  defaultStatus: string\n  statuses: string[]\n  terminalStatuses: string[]\n  transitions: Record<string, string[]>\n}\n\nexport const DEFAULT_STATUS_MACHINE: StatusMachineConfig = {\n  blockingStatuses: ['pending', 'confirmed'],\n  defaultStatus: 'pending',\n  statuses: ['pending', 'confirmed', 'completed', 'cancelled', 'no-show'],\n  terminalStatuses: ['completed', 'cancelled', 'no-show'],\n  transitions: {\n    cancelled: [],\n    completed: [],\n    confirmed: ['completed', 'cancelled', 'no-show'],\n    'no-show': [],\n    pending: ['confirmed', 'cancelled'],\n  },\n}\n\n// --- Reservation item (for multi-resource bookings, Phase 3) ---\n\nexport type ReservationItemConfig = {\n  endTime?: string\n  guestCount?: number\n  resource: string\n  service?: string\n  startTime?: string\n}\n\n// --- Plugin hooks for external integrations ---\n\nexport type ReservationPluginHooks = {\n  afterBookingCancel?: Array<\n    (args: { doc: Record<string, unknown>; req: PayloadRequest }) => Promise<void> | void\n  >\n  afterBookingConfirm?: Array<\n    (args: { doc: Record<string, unknown>; req: PayloadRequest }) => Promise<void> | void\n  >\n  afterBookingCreate?: Array<\n    (args: { doc: Record<string, unknown>; req: PayloadRequest }) => Promise<void> | void\n  >\n  afterStatusChange?: Array<\n    (args: {\n      doc: Record<string, unknown>\n      newStatus: string\n      previousStatus: string\n      req: PayloadRequest\n    }) => Promise<void> | void\n  >\n  beforeBookingCancel?: Array<\n    (args: {\n      doc: Record<string, unknown>\n      reason?: string\n      req: PayloadRequest\n    }) => Promise<void> | void\n  >\n  beforeBookingConfirm?: Array<\n    (args: {\n      doc: Record<string, unknown>\n      newStatus: string\n      req: PayloadRequest\n    }) => Promise<void> | void\n  >\n  beforeBookingCreate?: Array<\n    (args: {\n      data: Record<string, unknown>\n      req: PayloadRequest\n    }) => Promise<Record<string, unknown>> | Record<string, unknown>\n  >\n}\n\n// --- Resource owner mode ---\n\nexport type ResourceOwnerModeConfig = {\n  /** Roles that can see all records (default: check req.user.collection === adminCollection) */\n  adminRoles?: string[]\n  /** Whether Services also get an owner field (default: false — Services are platform-managed) */\n  ownedServices?: boolean\n  /**\n   * Collection the owner field relates to (where owners/staff live). Defaults to\n   * `staffProvisioning.userCollection` when set, otherwise `slugs.customers`. Set\n   * this when owners live in a different collection than your customers (e.g.\n   * separate `users` and `customers` collections).\n   */\n  ownerCollection?: string\n  /** Field name for the owner relationship on Resources (default: 'owner') */\n  ownerField?: string\n}\n\nexport type ResolvedResourceOwnerModeConfig = {\n  adminRoles: string[]\n  ownedServices: boolean\n  ownerCollection?: string\n  ownerField: string\n}\n\n// --- Staff provisioning ---\n\nexport type StaffProvisioningConfig = {\n  /** Stamp tenant / custom fields onto the provisioned Resource before create. */\n  beforeCreate?: (args: {\n    data: Record<string, unknown>\n    req: PayloadRequest\n    user: Record<string, unknown>\n  }) => Promise<Record<string, unknown>> | Record<string, unknown>\n  /** User field copied into Resource `name` (default 'name', falls back to email). */\n  nameFrom?: string\n  /** resourceType to stamp (default 'staff'). Must be a valid resourceType. */\n  resourceType?: string\n  /** Field on the user holding the role (default 'role'). */\n  roleField?: string\n  /** Role value(s) marking a user as staff. Required, non-empty. */\n  staffRoles: string[]\n  /** Auth collection holding staff users. Defaults to top-level `userCollection`. */\n  userCollection?: string\n}\n\nexport type ResolvedStaffProvisioningConfig = {\n  beforeCreate?: StaffProvisioningConfig['beforeCreate']\n  nameFrom: string\n  resourceType: string\n  roleField: string\n  staffRoles: string[]\n  userCollection: string\n}\n\n// --- Plugin configuration ---\n\nexport type ReservationPluginConfig = {\n  /** Override access control per collection */\n  access?: {\n    customers?: CollectionConfig['access']\n    reservations?: CollectionConfig['access']\n    resources?: CollectionConfig['access']\n    schedules?: CollectionConfig['access']\n    services?: CollectionConfig['access']\n  }\n  /** Admin group name for all reservation collections */\n  adminGroup?: string\n  /** Allow bookings without a customer account by default (per-service override available) */\n  allowGuestBooking?: boolean\n  /** Hours of notice required before cancellation */\n  cancellationNoticePeriod?: number\n  /** Default buffer time in minutes between reservations */\n  defaultBufferTime?: number\n  /** Disable the plugin entirely */\n  disabled?: boolean\n  /** Extra fields to append to the Reservations collection */\n  extraReservationFields?: Field[]\n  /** Plugin hooks for external integrations */\n  hooks?: ReservationPluginHooks\n  /** Configurable leave/exception type vocabulary (default: vacation/sick/personal/closure/other) */\n  leaveTypes?: string[]\n  /** Enable resource-owner multi-tenancy (opt-in) */\n  resourceOwnerMode?: ResourceOwnerModeConfig\n  /** Configurable resourceType vocabulary (default: staff/equipment/room) */\n  resourceTypes?: string[]\n  /** Override collection slugs */\n  slugs?: {\n    customers?: string\n    media?: string\n    reservations?: string\n    resources?: string\n    schedules?: string\n    services?: string\n  }\n  /** Auto-provision a Resource from staff-role users (opt-in; requires resourceOwnerMode) */\n  staffProvisioning?: StaffProvisioningConfig\n  /** Configurable status machine (defaults to current behavior) */\n  statusMachine?: Partial<StatusMachineConfig>\n  /** Which existing auth collection to extend with customer fields */\n  userCollection?: string\n}\n\nexport type ResolvedReservationPluginConfig = {\n  access: {\n    customers?: CollectionConfig['access']\n    reservations?: CollectionConfig['access']\n    resources?: CollectionConfig['access']\n    schedules?: CollectionConfig['access']\n    services?: CollectionConfig['access']\n  }\n  adminGroup: string\n  allowGuestBooking: boolean\n  cancellationNoticePeriod: number\n  defaultBufferTime: number\n  disabled: boolean\n  extraReservationFields: Field[]\n  hooks: ReservationPluginHooks\n  leaveTypes: string[]\n  localized: boolean\n  resourceOwnerMode: ResolvedResourceOwnerModeConfig | undefined\n  resourceTypes: string[]\n  slugs: {\n    customers: string\n    media: string\n    reservations: string\n    resources: string\n    schedules: string\n    services: string\n  }\n  staffProvisioning: ResolvedStaffProvisioningConfig | undefined\n  statusMachine: StatusMachineConfig\n  userCollection: string | undefined\n}\n\nexport type ReservationStatus = 'cancelled' | 'completed' | 'confirmed' | 'no-show' | 'pending'\n\nexport type DayOfWeek = 'fri' | 'mon' | 'sat' | 'sun' | 'thu' | 'tue' | 'wed'\n\nexport type ScheduleType = 'manual' | 'recurring'\n\n/** @deprecated Use DEFAULT_STATUS_MACHINE.transitions instead */\nexport const VALID_STATUS_TRANSITIONS: Record<ReservationStatus, ReservationStatus[]> =\n  DEFAULT_STATUS_MACHINE.transitions as Record<ReservationStatus, ReservationStatus[]>\n"],"names":["DEFAULT_STATUS_MACHINE","blockingStatuses","defaultStatus","statuses","terminalStatuses","transitions","cancelled","completed","confirmed","pending","VALID_STATUS_TRANSITIONS"],"mappings":"AAkBA,OAAO,MAAMA,yBAA8C;IACzDC,kBAAkB;QAAC;QAAW;KAAY;IAC1CC,eAAe;IACfC,UAAU;QAAC;QAAW;QAAa;QAAa;QAAa;KAAU;IACvEC,kBAAkB;QAAC;QAAa;QAAa;KAAU;IACvDC,aAAa;QACXC,WAAW,EAAE;QACbC,WAAW,EAAE;QACbC,WAAW;YAAC;YAAa;YAAa;SAAU;QAChD,WAAW,EAAE;QACbC,SAAS;YAAC;YAAa;SAAY;IACrC;AACF,EAAC;AAmMD,+DAA+D,GAC/D,OAAO,MAAMC,2BACXV,uBAAuBK,WAAW,CAAkD"}

package/dist/utilities/computeSlotStates.d.ts

@@ -0,0 +1,39 @@
+export type SlotState = 'free' | 'full' | 'off-shift' | 'time-off';
+export type SlotInfo = {
+    end: Date;
+    occupancy: number;
+    start: Date;
+    state: SlotState;
+};
+type Busy = Array<{
+    end: string;
+    start: string;
+    units: number;
+}>;
+type Interval = {
+    end: string;
+    start: string;
+};
+type RequiredPool = {
+    busy: Busy;
+    quantity: number;
+};
+/**
+ * Classify each step-sized slot in [dayStart, dayEnd) for a single resource.
+ * A slot is `full` when the resource itself is at capacity OR any of its
+ * `requiredPools` (e.g. a shared chair pool a service also needs) is at
+ * capacity — so the grid reflects true bookability, not just the stylist.
+ * Pure — no DB, no clock.
+ */
+export declare function computeSlotStates(params: {
+    busy: Busy;
+    capacityMode: 'per-guest' | 'per-reservation';
+    dayEnd: Date;
+    dayStart: Date;
+    quantity: number;
+    requiredPools?: RequiredPool[];
+    shiftWindows: Interval[];
+    step: number;
+    timeOff: Interval[];
+}): SlotInfo[];
+export {};

package/dist/utilities/computeSlotStates.js

@@ -0,0 +1,49 @@
+import { addMinutes, doRangesOverlap } from './slotUtils.js';
+const within = (slotStart, slotEnd, windows)=>windows.some((w)=>doRangesOverlap(slotStart, slotEnd, new Date(w.start), new Date(w.end)));
+/** Sum the `units` of busy intervals overlapping [slotStart, slotEnd). */ const occupancyAt = (slotStart, slotEnd, busy)=>{
+    let occ = 0;
+    for (const b of busy){
+        if (doRangesOverlap(slotStart, slotEnd, new Date(b.start), new Date(b.end))) {
+            occ += b.units;
+        }
+    }
+    return occ;
+};
+/**
+ * Classify each step-sized slot in [dayStart, dayEnd) for a single resource.
+ * A slot is `full` when the resource itself is at capacity OR any of its
+ * `requiredPools` (e.g. a shared chair pool a service also needs) is at
+ * capacity — so the grid reflects true bookability, not just the stylist.
+ * Pure — no DB, no clock.
+ */ export function computeSlotStates(params) {
+    const { busy, dayEnd, dayStart, quantity, requiredPools, shiftWindows, step, timeOff } = params;
+    const pools = requiredPools ?? [];
+    const slots = [];
+    let cursor = new Date(dayStart);
+    while(cursor < dayEnd){
+        const slotStart = new Date(cursor);
+        const slotEnd = addMinutes(slotStart, step);
+        const occupancy = occupancyAt(slotStart, slotEnd, busy);
+        const poolFull = pools.some((p)=>occupancyAt(slotStart, slotEnd, p.busy) >= p.quantity);
+        let state;
+        if (!within(slotStart, slotEnd, shiftWindows)) {
+            state = 'off-shift';
+        } else if (within(slotStart, slotEnd, timeOff)) {
+            state = 'time-off';
+        } else if (occupancy >= quantity || poolFull) {
+            state = 'full';
+        } else {
+            state = 'free';
+        }
+        slots.push({
+            end: slotEnd,
+            occupancy,
+            start: slotStart,
+            state
+        });
+        cursor = slotEnd;
+    }
+    return slots;
+}
+
+//# sourceMappingURL=computeSlotStates.js.map

package/dist/utilities/computeSlotStates.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/utilities/computeSlotStates.ts"],"sourcesContent":["import { addMinutes, doRangesOverlap } from './slotUtils.js'\n\nexport type SlotState = 'free' | 'full' | 'off-shift' | 'time-off'\n\nexport type SlotInfo = {\n  end: Date\n  occupancy: number\n  start: Date\n  state: SlotState\n}\n\ntype Busy = Array<{ end: string; start: string; units: number }>\ntype Interval = { end: string; start: string }\ntype RequiredPool = { busy: Busy; quantity: number }\n\nconst within = (slotStart: Date, slotEnd: Date, windows: Interval[]): boolean =>\n  windows.some((w) => doRangesOverlap(slotStart, slotEnd, new Date(w.start), new Date(w.end)))\n\n/** Sum the `units` of busy intervals overlapping [slotStart, slotEnd). */\nconst occupancyAt = (slotStart: Date, slotEnd: Date, busy: Busy): number => {\n  let occ = 0\n  for (const b of busy) {\n    if (doRangesOverlap(slotStart, slotEnd, new Date(b.start), new Date(b.end))) {\n      occ += b.units\n    }\n  }\n  return occ\n}\n\n/**\n * Classify each step-sized slot in [dayStart, dayEnd) for a single resource.\n * A slot is `full` when the resource itself is at capacity OR any of its\n * `requiredPools` (e.g. a shared chair pool a service also needs) is at\n * capacity — so the grid reflects true bookability, not just the stylist.\n * Pure — no DB, no clock.\n */\nexport function computeSlotStates(params: {\n  busy: Busy\n  capacityMode: 'per-guest' | 'per-reservation'\n  dayEnd: Date\n  dayStart: Date\n  quantity: number\n  requiredPools?: RequiredPool[]\n  shiftWindows: Interval[]\n  step: number\n  timeOff: Interval[]\n}): SlotInfo[] {\n  const { busy, dayEnd, dayStart, quantity, requiredPools, shiftWindows, step, timeOff } = params\n  const pools = requiredPools ?? []\n  const slots: SlotInfo[] = []\n\n  let cursor = new Date(dayStart)\n  while (cursor < dayEnd) {\n    const slotStart = new Date(cursor)\n    const slotEnd = addMinutes(slotStart, step)\n\n    const occupancy = occupancyAt(slotStart, slotEnd, busy)\n    const poolFull = pools.some((p) => occupancyAt(slotStart, slotEnd, p.busy) >= p.quantity)\n\n    let state: SlotState\n    if (!within(slotStart, slotEnd, shiftWindows)) {\n      state = 'off-shift'\n    } else if (within(slotStart, slotEnd, timeOff)) {\n      state = 'time-off'\n    } else if (occupancy >= quantity || poolFull) {\n      state = 'full'\n    } else {\n      state = 'free'\n    }\n\n    slots.push({ end: slotEnd, occupancy, start: slotStart, state })\n    cursor = slotEnd\n  }\n\n  return slots\n}\n"],"names":["addMinutes","doRangesOverlap","within","slotStart","slotEnd","windows","some","w","Date","start","end","occupancyAt","busy","occ","b","units","computeSlotStates","params","dayEnd","dayStart","quantity","requiredPools","shiftWindows","step","timeOff","pools","slots","cursor","occupancy","poolFull","p","state","push"],"mappings":"AAAA,SAASA,UAAU,EAAEC,eAAe,QAAQ,iBAAgB;AAe5D,MAAMC,SAAS,CAACC,WAAiBC,SAAeC,UAC9CA,QAAQC,IAAI,CAAC,CAACC,IAAMN,gBAAgBE,WAAWC,SAAS,IAAII,KAAKD,EAAEE,KAAK,GAAG,IAAID,KAAKD,EAAEG,GAAG;AAE3F,wEAAwE,GACxE,MAAMC,cAAc,CAACR,WAAiBC,SAAeQ;IACnD,IAAIC,MAAM;IACV,KAAK,MAAMC,KAAKF,KAAM;QACpB,IAAIX,gBAAgBE,WAAWC,SAAS,IAAII,KAAKM,EAAEL,KAAK,GAAG,IAAID,KAAKM,EAAEJ,GAAG,IAAI;YAC3EG,OAAOC,EAAEC,KAAK;QAChB;IACF;IACA,OAAOF;AACT;AAEA;;;;;;CAMC,GACD,OAAO,SAASG,kBAAkBC,MAUjC;IACC,MAAM,EAAEL,IAAI,EAAEM,MAAM,EAAEC,QAAQ,EAAEC,QAAQ,EAAEC,aAAa,EAAEC,YAAY,EAAEC,IAAI,EAAEC,OAAO,EAAE,GAAGP;IACzF,MAAMQ,QAAQJ,iBAAiB,EAAE;IACjC,MAAMK,QAAoB,EAAE;IAE5B,IAAIC,SAAS,IAAInB,KAAKW;IACtB,MAAOQ,SAAST,OAAQ;QACtB,MAAMf,YAAY,IAAIK,KAAKmB;QAC3B,MAAMvB,UAAUJ,WAAWG,WAAWoB;QAEtC,MAAMK,YAAYjB,YAAYR,WAAWC,SAASQ;QAClD,MAAMiB,WAAWJ,MAAMnB,IAAI,CAAC,CAACwB,IAAMnB,YAAYR,WAAWC,SAAS0B,EAAElB,IAAI,KAAKkB,EAAEV,QAAQ;QAExF,IAAIW;QACJ,IAAI,CAAC7B,OAAOC,WAAWC,SAASkB,eAAe;YAC7CS,QAAQ;QACV,OAAO,IAAI7B,OAAOC,WAAWC,SAASoB,UAAU;YAC9CO,QAAQ;QACV,OAAO,IAAIH,aAAaR,YAAYS,UAAU;YAC5CE,QAAQ;QACV,OAAO;YACLA,QAAQ;QACV;QAEAL,MAAMM,IAAI,CAAC;YAAEtB,KAAKN;YAASwB;YAAWnB,OAAON;YAAW4B;QAAM;QAC9DJ,SAASvB;IACX;IAEA,OAAOsB;AACT"}

package/dist/utilities/guestBooking.d.ts

@@ -0,0 +1,10 @@
+/** Tri-state per-service guest booking setting. */
+export type GuestBookingSetting = 'disabled' | 'enabled' | 'inherit';
+/**
+ * Resolve whether guest bookings are allowed for a service.
+ * 'enabled'/'disabled' on the service win; 'inherit' (or unset) falls back to
+ * the plugin-level default.
+ */
+export declare function resolveGuestBookingAllowed(service: {
+    allowGuestBooking?: GuestBookingSetting | null;
+} | null | undefined, pluginDefault: boolean): boolean;

package/dist/utilities/guestBooking.js

@@ -0,0 +1,16 @@
+/** Tri-state per-service guest booking setting. */ /**
+ * Resolve whether guest bookings are allowed for a service.
+ * 'enabled'/'disabled' on the service win; 'inherit' (or unset) falls back to
+ * the plugin-level default.
+ */ export function resolveGuestBookingAllowed(service, pluginDefault) {
+    const value = service?.allowGuestBooking;
+    if (value === 'enabled') {
+        return true;
+    }
+    if (value === 'disabled') {
+        return false;
+    }
+    return pluginDefault;
+}
+
+//# sourceMappingURL=guestBooking.js.map

package/dist/utilities/guestBooking.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/utilities/guestBooking.ts"],"sourcesContent":["/** Tri-state per-service guest booking setting. */\nexport type GuestBookingSetting = 'disabled' | 'enabled' | 'inherit'\n\n/**\n * Resolve whether guest bookings are allowed for a service.\n * 'enabled'/'disabled' on the service win; 'inherit' (or unset) falls back to\n * the plugin-level default.\n */\nexport function resolveGuestBookingAllowed(\n  service: { allowGuestBooking?: GuestBookingSetting | null } | null | undefined,\n  pluginDefault: boolean,\n): boolean {\n  const value = service?.allowGuestBooking\n  if (value === 'enabled') {\n    return true\n  }\n  if (value === 'disabled') {\n    return false\n  }\n  return pluginDefault\n}\n"],"names":["resolveGuestBookingAllowed","service","pluginDefault","value","allowGuestBooking"],"mappings":"AAAA,iDAAiD,GAGjD;;;;CAIC,GACD,OAAO,SAASA,2BACdC,OAA8E,EAC9EC,aAAsB;IAEtB,MAAMC,QAAQF,SAASG;IACvB,IAAID,UAAU,WAAW;QACvB,OAAO;IACT;IACA,IAAIA,UAAU,YAAY;QACxB,OAAO;IACT;IACA,OAAOD;AACT"}

package/dist/utilities/resolveRequiredResources.d.ts

@@ -0,0 +1,8 @@
+import { extractId } from './resolveReservationItems.js';
+export { extractId };
+/**
+ * Merge a primary set of resource ids with a service's required-resource ids,
+ * deduping by string value and preserving first-seen order. Empty/undefined
+ * values are dropped.
+ */
+export declare function mergeResourceIds(primary: Array<number | string | undefined>, required: Array<number | string | undefined>): Array<number | string>;

package/dist/utilities/resolveRequiredResources.js

@@ -0,0 +1,27 @@
+import { extractId } from './resolveReservationItems.js';
+export { extractId };
+/**
+ * Merge a primary set of resource ids with a service's required-resource ids,
+ * deduping by string value and preserving first-seen order. Empty/undefined
+ * values are dropped.
+ */ export function mergeResourceIds(primary, required) {
+    const seen = new Set();
+    const out = [];
+    for (const id of [
+        ...primary,
+        ...required
+    ]){
+        if (id === undefined || id === null || id === '') {
+            continue;
+        }
+        const key = String(id);
+        if (seen.has(key)) {
+            continue;
+        }
+        seen.add(key);
+        out.push(id);
+    }
+    return out;
+}
+
+//# sourceMappingURL=resolveRequiredResources.js.map

package/dist/utilities/resolveRequiredResources.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/utilities/resolveRequiredResources.ts"],"sourcesContent":["import { extractId } from './resolveReservationItems.js'\n\nexport { extractId }\n\n/**\n * Merge a primary set of resource ids with a service's required-resource ids,\n * deduping by string value and preserving first-seen order. Empty/undefined\n * values are dropped.\n */\nexport function mergeResourceIds(\n  primary: Array<number | string | undefined>,\n  required: Array<number | string | undefined>,\n): Array<number | string> {\n  const seen = new Set<string>()\n  const out: Array<number | string> = []\n  for (const id of [...primary, ...required]) {\n    if (id === undefined || id === null || id === '') {\n      continue\n    }\n    const key = String(id)\n    if (seen.has(key)) {\n      continue\n    }\n    seen.add(key)\n    out.push(id)\n  }\n  return out\n}\n"],"names":["extractId","mergeResourceIds","primary","required","seen","Set","out","id","undefined","key","String","has","add","push"],"mappings":"AAAA,SAASA,SAAS,QAAQ,+BAA8B;AAExD,SAASA,SAAS,GAAE;AAEpB;;;;CAIC,GACD,OAAO,SAASC,iBACdC,OAA2C,EAC3CC,QAA4C;IAE5C,MAAMC,OAAO,IAAIC;IACjB,MAAMC,MAA8B,EAAE;IACtC,KAAK,MAAMC,MAAM;WAAIL;WAAYC;KAAS,CAAE;QAC1C,IAAII,OAAOC,aAAaD,OAAO,QAAQA,OAAO,IAAI;YAChD;QACF;QACA,MAAME,MAAMC,OAAOH;QACnB,IAAIH,KAAKO,GAAG,CAACF,MAAM;YACjB;QACF;QACAL,KAAKQ,GAAG,CAACH;QACTH,IAAIO,IAAI,CAACN;IACX;IACA,OAAOD;AACT"}

package/dist/utilities/resolveReservationItems.d.ts

@@ -1,8 +1,8 @@
 export type ResolvedItem = {
     endTime: string;
     guestCount: number;
-    resource: string;
-    service?: string;
+    resource: number | string;
+    service?: number | string;
     startTime: string;
 };
 /**
@@ -17,3 +17,4 @@ export type ResolvedItem = {
  * works with ResolvedItem[], never with raw reservation data.
  */
 export declare function resolveReservationItems(data: Record<string, unknown>): ResolvedItem[];
+export declare function extractId(value: unknown): number | string | undefined;

package/dist/utilities/resolveReservationItems.js

@@ -16,9 +16,9 @@ import { ValidationError } from 'payload';
         const seen = new Set();
         for(let i = 0; i < items.length; i++){
             const item = items[i];
-            const resource = extractId(item.resource) || extractId(data.resource) || '';
+            const resource = extractId(item.resource) ?? extractId(data.resource);
             const startTime = item.startTime ?? data.startTime;
-            if (!resource) {
+            if (resource === undefined || resource === '') {
                 throw new ValidationError({
                     errors: [
                         {
@@ -54,7 +54,7 @@ import { ValidationError } from 'payload';
                 endTime: item.endTime ?? data.endTime,
                 guestCount: item.guestCount ?? data.guestCount ?? 1,
                 resource,
-                service: extractId(item.service) || extractId(data.service) || undefined,
+                service: extractId(item.service) ?? extractId(data.service),
                 startTime
             });
         }
@@ -64,20 +64,33 @@ import { ValidationError } from 'payload';
     if (!data.resource || !data.startTime) {
         return [];
     }
+    const resource = extractId(data.resource);
+    if (resource === undefined || resource === '') {
+        return [];
+    }
     return [
         {
             endTime: data.endTime,
             guestCount: data.guestCount ?? 1,
-            resource: extractId(data.resource) || '',
-            service: extractId(data.service) || undefined,
+            resource,
+            service: extractId(data.service),
             startTime: data.startTime
         }
     ];
 }
-function extractId(value) {
+// Exported for unit testing. Returns the underlying id value from a relationship
+// field which Payload represents as either the raw id (string for Mongo, number
+// for Postgres) or a populated document `{ id, ... }`.
+//
+// Note: `0` is a valid numeric Postgres id but rare; we still return it rather
+// than treat it as missing.
+export function extractId(value) {
     if (typeof value === 'string' && value) {
         return value;
     }
+    if (typeof value === 'number') {
+        return value;
+    }
     if (value && typeof value === 'object' && 'id' in value) {
         return value.id;
     }

package/dist/utilities/resolveReservationItems.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/utilities/resolveReservationItems.ts"],"sourcesContent":["import { ValidationError } from 'payload'\n\nexport type ResolvedItem = {\n  endTime: string\n  guestCount: number\n  resource: string\n  service?: string\n  startTime: string\n}\n\n/**\n * Normalize reservation data into a list of resource-level items.\n *\n * - If items[] is populated -> return items (filling defaults from parent).\n *   Items missing startTime or resource throw a ValidationError.\n *   Duplicate (resource, startTime) pairs throw a ValidationError.\n * - If items[] is empty/absent -> return single item from top-level fields\n *\n * Every downstream function (conflict check, endTime calc, availability)\n * works with ResolvedItem[], never with raw reservation data.\n */\nexport function resolveReservationItems(data: Record<string, unknown>): ResolvedItem[] {\n  const items = data.items as Array<Record<string, unknown>> | undefined\n\n  if (items && items.length > 0) {\n    const resolved: ResolvedItem[] = []\n    const seen = new Set<string>()\n\n    for (let i = 0; i < items.length; i++) {\n      const item = items[i]\n      const resource = extractId(item.resource) || extractId(data.resource) || ''\n      const startTime = (item.startTime as string) ?? (data.startTime as string)\n\n      if (!resource) {\n        throw new ValidationError({\n          errors: [\n            {\n              message: `Item ${i} is missing a resource`,\n              path: `items.${i}.resource`,\n            },\n          ],\n        })\n      }\n\n      if (!startTime) {\n        throw new ValidationError({\n          errors: [\n            {\n              message: `Item ${i} is missing a startTime`,\n              path: `items.${i}.startTime`,\n            },\n          ],\n        })\n      }\n\n      const key = `${resource}::${startTime}`\n      if (seen.has(key)) {\n        throw new ValidationError({\n          errors: [\n            {\n              message: `Duplicate booking: item ${i} has the same resource and startTime as a previous item`,\n              path: `items.${i}.startTime`,\n            },\n          ],\n        })\n      }\n      seen.add(key)\n\n      resolved.push({\n        endTime: (item.endTime as string) ?? (data.endTime as string),\n        guestCount: (item.guestCount as number) ?? (data.guestCount as number) ?? 1,\n        resource,\n        service: extractId(item.service) || extractId(data.service) || undefined,\n        startTime,\n      })\n    }\n\n    return resolved\n  }\n\n  // Single-resource fallback (current behavior)\n  if (!data.resource || !data.startTime) {\n    return []\n  }\n\n  return [\n    {\n      endTime: data.endTime as string,\n      guestCount: (data.guestCount as number) ?? 1,\n      resource: extractId(data.resource) || '',\n      service: extractId(data.service) || undefined,\n      startTime: data.startTime as string,\n    },\n  ]\n}\n\nfunction extractId(value: unknown): string | undefined {\n  if (typeof value === 'string' && value) {\n    return value\n  }\n  if (value && typeof value === 'object' && 'id' in value) {\n    return (value as { id: string }).id\n  }\n  return undefined\n}\n"],"names":["ValidationError","resolveReservationItems","data","items","length","resolved","seen","Set","i","item","resource","extractId","startTime","errors","message","path","key","has","add","push","endTime","guestCount","service","undefined","value","id"],"mappings":"AAAA,SAASA,eAAe,QAAQ,UAAS;AAUzC;;;;;;;;;;CAUC,GACD,OAAO,SAASC,wBAAwBC,IAA6B;IACnE,MAAMC,QAAQD,KAAKC,KAAK;IAExB,IAAIA,SAASA,MAAMC,MAAM,GAAG,GAAG;QAC7B,MAAMC,WAA2B,EAAE;QACnC,MAAMC,OAAO,IAAIC;QAEjB,IAAK,IAAIC,IAAI,GAAGA,IAAIL,MAAMC,MAAM,EAAEI,IAAK;YACrC,MAAMC,OAAON,KAAK,CAACK,EAAE;YACrB,MAAME,WAAWC,UAAUF,KAAKC,QAAQ,KAAKC,UAAUT,KAAKQ,QAAQ,KAAK;YACzE,MAAME,YAAY,AAACH,KAAKG,SAAS,IAAgBV,KAAKU,SAAS;YAE/D,IAAI,CAACF,UAAU;gBACb,MAAM,IAAIV,gBAAgB;oBACxBa,QAAQ;wBACN;4BACEC,SAAS,CAAC,KAAK,EAAEN,EAAE,sBAAsB,CAAC;4BAC1CO,MAAM,CAAC,MAAM,EAAEP,EAAE,SAAS,CAAC;wBAC7B;qBACD;gBACH;YACF;YAEA,IAAI,CAACI,WAAW;gBACd,MAAM,IAAIZ,gBAAgB;oBACxBa,QAAQ;wBACN;4BACEC,SAAS,CAAC,KAAK,EAAEN,EAAE,uBAAuB,CAAC;4BAC3CO,MAAM,CAAC,MAAM,EAAEP,EAAE,UAAU,CAAC;wBAC9B;qBACD;gBACH;YACF;YAEA,MAAMQ,MAAM,GAAGN,SAAS,EAAE,EAAEE,WAAW;YACvC,IAAIN,KAAKW,GAAG,CAACD,MAAM;gBACjB,MAAM,IAAIhB,gBAAgB;oBACxBa,QAAQ;wBACN;4BACEC,SAAS,CAAC,wBAAwB,EAAEN,EAAE,uDAAuD,CAAC;4BAC9FO,MAAM,CAAC,MAAM,EAAEP,EAAE,UAAU,CAAC;wBAC9B;qBACD;gBACH;YACF;YACAF,KAAKY,GAAG,CAACF;YAETX,SAASc,IAAI,CAAC;gBACZC,SAAS,AAACX,KAAKW,OAAO,IAAgBlB,KAAKkB,OAAO;gBAClDC,YAAY,AAACZ,KAAKY,UAAU,IAAgBnB,KAAKmB,UAAU,IAAe;gBAC1EX;gBACAY,SAASX,UAAUF,KAAKa,OAAO,KAAKX,UAAUT,KAAKoB,OAAO,KAAKC;gBAC/DX;YACF;QACF;QAEA,OAAOP;IACT;IAEA,8CAA8C;IAC9C,IAAI,CAACH,KAAKQ,QAAQ,IAAI,CAACR,KAAKU,SAAS,EAAE;QACrC,OAAO,EAAE;IACX;IAEA,OAAO;QACL;YACEQ,SAASlB,KAAKkB,OAAO;YACrBC,YAAY,AAACnB,KAAKmB,UAAU,IAAe;YAC3CX,UAAUC,UAAUT,KAAKQ,QAAQ,KAAK;YACtCY,SAASX,UAAUT,KAAKoB,OAAO,KAAKC;YACpCX,WAAWV,KAAKU,SAAS;QAC3B;KACD;AACH;AAEA,SAASD,UAAUa,KAAc;IAC/B,IAAI,OAAOA,UAAU,YAAYA,OAAO;QACtC,OAAOA;IACT;IACA,IAAIA,SAAS,OAAOA,UAAU,YAAY,QAAQA,OAAO;QACvD,OAAO,AAACA,MAAyBC,EAAE;IACrC;IACA,OAAOF;AACT"}
+{"version":3,"sources":["../../src/utilities/resolveReservationItems.ts"],"sourcesContent":["import { ValidationError } from 'payload'\n\nexport type ResolvedItem = {\n  endTime: string\n  guestCount: number\n  resource: number | string\n  service?: number | string\n  startTime: string\n}\n\n/**\n * Normalize reservation data into a list of resource-level items.\n *\n * - If items[] is populated -> return items (filling defaults from parent).\n *   Items missing startTime or resource throw a ValidationError.\n *   Duplicate (resource, startTime) pairs throw a ValidationError.\n * - If items[] is empty/absent -> return single item from top-level fields\n *\n * Every downstream function (conflict check, endTime calc, availability)\n * works with ResolvedItem[], never with raw reservation data.\n */\nexport function resolveReservationItems(data: Record<string, unknown>): ResolvedItem[] {\n  const items = data.items as Array<Record<string, unknown>> | undefined\n\n  if (items && items.length > 0) {\n    const resolved: ResolvedItem[] = []\n    const seen = new Set<string>()\n\n    for (let i = 0; i < items.length; i++) {\n      const item = items[i]\n      const resource = extractId(item.resource) ?? extractId(data.resource)\n      const startTime = (item.startTime as string) ?? (data.startTime as string)\n\n      if (resource === undefined || resource === '') {\n        throw new ValidationError({\n          errors: [\n            {\n              message: `Item ${i} is missing a resource`,\n              path: `items.${i}.resource`,\n            },\n          ],\n        })\n      }\n\n      if (!startTime) {\n        throw new ValidationError({\n          errors: [\n            {\n              message: `Item ${i} is missing a startTime`,\n              path: `items.${i}.startTime`,\n            },\n          ],\n        })\n      }\n\n      const key = `${resource}::${startTime}`\n      if (seen.has(key)) {\n        throw new ValidationError({\n          errors: [\n            {\n              message: `Duplicate booking: item ${i} has the same resource and startTime as a previous item`,\n              path: `items.${i}.startTime`,\n            },\n          ],\n        })\n      }\n      seen.add(key)\n\n      resolved.push({\n        endTime: (item.endTime as string) ?? (data.endTime as string),\n        guestCount: (item.guestCount as number) ?? (data.guestCount as number) ?? 1,\n        resource,\n        service: extractId(item.service) ?? extractId(data.service),\n        startTime,\n      })\n    }\n\n    return resolved\n  }\n\n  // Single-resource fallback (current behavior)\n  if (!data.resource || !data.startTime) {\n    return []\n  }\n\n  const resource = extractId(data.resource)\n  if (resource === undefined || resource === '') {\n    return []\n  }\n\n  return [\n    {\n      endTime: data.endTime as string,\n      guestCount: (data.guestCount as number) ?? 1,\n      resource,\n      service: extractId(data.service),\n      startTime: data.startTime as string,\n    },\n  ]\n}\n\n// Exported for unit testing. Returns the underlying id value from a relationship\n// field which Payload represents as either the raw id (string for Mongo, number\n// for Postgres) or a populated document `{ id, ... }`.\n//\n// Note: `0` is a valid numeric Postgres id but rare; we still return it rather\n// than treat it as missing.\nexport function extractId(value: unknown): number | string | undefined {\n  if (typeof value === 'string' && value) {\n    return value\n  }\n  if (typeof value === 'number') {\n    return value\n  }\n  if (value && typeof value === 'object' && 'id' in value) {\n    return (value as { id: number | string }).id\n  }\n  return undefined\n}\n"],"names":["ValidationError","resolveReservationItems","data","items","length","resolved","seen","Set","i","item","resource","extractId","startTime","undefined","errors","message","path","key","has","add","push","endTime","guestCount","service","value","id"],"mappings":"AAAA,SAASA,eAAe,QAAQ,UAAS;AAUzC;;;;;;;;;;CAUC,GACD,OAAO,SAASC,wBAAwBC,IAA6B;IACnE,MAAMC,QAAQD,KAAKC,KAAK;IAExB,IAAIA,SAASA,MAAMC,MAAM,GAAG,GAAG;QAC7B,MAAMC,WAA2B,EAAE;QACnC,MAAMC,OAAO,IAAIC;QAEjB,IAAK,IAAIC,IAAI,GAAGA,IAAIL,MAAMC,MAAM,EAAEI,IAAK;YACrC,MAAMC,OAAON,KAAK,CAACK,EAAE;YACrB,MAAME,WAAWC,UAAUF,KAAKC,QAAQ,KAAKC,UAAUT,KAAKQ,QAAQ;YACpE,MAAME,YAAY,AAACH,KAAKG,SAAS,IAAgBV,KAAKU,SAAS;YAE/D,IAAIF,aAAaG,aAAaH,aAAa,IAAI;gBAC7C,MAAM,IAAIV,gBAAgB;oBACxBc,QAAQ;wBACN;4BACEC,SAAS,CAAC,KAAK,EAAEP,EAAE,sBAAsB,CAAC;4BAC1CQ,MAAM,CAAC,MAAM,EAAER,EAAE,SAAS,CAAC;wBAC7B;qBACD;gBACH;YACF;YAEA,IAAI,CAACI,WAAW;gBACd,MAAM,IAAIZ,gBAAgB;oBACxBc,QAAQ;wBACN;4BACEC,SAAS,CAAC,KAAK,EAAEP,EAAE,uBAAuB,CAAC;4BAC3CQ,MAAM,CAAC,MAAM,EAAER,EAAE,UAAU,CAAC;wBAC9B;qBACD;gBACH;YACF;YAEA,MAAMS,MAAM,GAAGP,SAAS,EAAE,EAAEE,WAAW;YACvC,IAAIN,KAAKY,GAAG,CAACD,MAAM;gBACjB,MAAM,IAAIjB,gBAAgB;oBACxBc,QAAQ;wBACN;4BACEC,SAAS,CAAC,wBAAwB,EAAEP,EAAE,uDAAuD,CAAC;4BAC9FQ,MAAM,CAAC,MAAM,EAAER,EAAE,UAAU,CAAC;wBAC9B;qBACD;gBACH;YACF;YACAF,KAAKa,GAAG,CAACF;YAETZ,SAASe,IAAI,CAAC;gBACZC,SAAS,AAACZ,KAAKY,OAAO,IAAgBnB,KAAKmB,OAAO;gBAClDC,YAAY,AAACb,KAAKa,UAAU,IAAgBpB,KAAKoB,UAAU,IAAe;gBAC1EZ;gBACAa,SAASZ,UAAUF,KAAKc,OAAO,KAAKZ,UAAUT,KAAKqB,OAAO;gBAC1DX;YACF;QACF;QAEA,OAAOP;IACT;IAEA,8CAA8C;IAC9C,IAAI,CAACH,KAAKQ,QAAQ,IAAI,CAACR,KAAKU,SAAS,EAAE;QACrC,OAAO,EAAE;IACX;IAEA,MAAMF,WAAWC,UAAUT,KAAKQ,QAAQ;IACxC,IAAIA,aAAaG,aAAaH,aAAa,IAAI;QAC7C,OAAO,EAAE;IACX;IAEA,OAAO;QACL;YACEW,SAASnB,KAAKmB,OAAO;YACrBC,YAAY,AAACpB,KAAKoB,UAAU,IAAe;YAC3CZ;YACAa,SAASZ,UAAUT,KAAKqB,OAAO;YAC/BX,WAAWV,KAAKU,SAAS;QAC3B;KACD;AACH;AAEA,iFAAiF;AACjF,gFAAgF;AAChF,uDAAuD;AACvD,EAAE;AACF,+EAA+E;AAC/E,4BAA4B;AAC5B,OAAO,SAASD,UAAUa,KAAc;IACtC,IAAI,OAAOA,UAAU,YAAYA,OAAO;QACtC,OAAOA;IACT;IACA,IAAI,OAAOA,UAAU,UAAU;QAC7B,OAAOA;IACT;IACA,IAAIA,SAAS,OAAOA,UAAU,YAAY,QAAQA,OAAO;QACvD,OAAO,AAACA,MAAkCC,EAAE;IAC9C;IACA,OAAOZ;AACT"}

package/dist/utilities/scheduleUtils.d.ts

@@ -20,9 +20,11 @@ export declare function parseTime(time: string): {
 export declare function combineDateAndTime(date: Date, time: string): Date;
 /**
  * Check if a given date is an exception date in the schedule.
+ * Supports range exceptions via optional endDate (inclusive on both ends).
  */
 export declare function isExceptionDate(date: Date, exceptions: Array<{
     date: string;
+    endDate?: string;
 }>): boolean;
 type RecurringSlot = {
     day: DayOfWeek;
@@ -38,6 +40,7 @@ type Schedule = {
     active?: boolean;
     exceptions?: Array<{
         date: string;
+        endDate?: string;
     }>;
     manualSlots?: ManualSlot[];
     recurringSlots?: RecurringSlot[];

package/dist/utilities/scheduleUtils.js

@@ -39,11 +39,13 @@ const DAY_MAP = {
 }
 /**
  * Check if a given date is an exception date in the schedule.
+ * Supports range exceptions via optional endDate (inclusive on both ends).
  */ export function isExceptionDate(date, exceptions) {
-    const dateStr = date.toISOString().split('T')[0];
+    const target = date.toISOString().split('T')[0];
     return exceptions.some((exc)=>{
-        const excDateStr = new Date(exc.date).toISOString().split('T')[0];
-        return excDateStr === dateStr;
+        const start = new Date(exc.date).toISOString().split('T')[0];
+        const end = exc.endDate ? new Date(exc.endDate).toISOString().split('T')[0] : start;
+        return target >= start && target <= end;
     });
 }
 /**

package/dist/utilities/scheduleUtils.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/utilities/scheduleUtils.ts"],"sourcesContent":["import type { DayOfWeek } from '../types.js'\n\nconst DAY_MAP: Record<DayOfWeek, number> = {\n  fri: 5,\n  mon: 1,\n  sat: 6,\n  sun: 0,\n  thu: 4,\n  tue: 2,\n  wed: 3,\n}\n\n/**\n * Get the DayOfWeek value for a given Date.\n */\nexport function getDayOfWeek(date: Date): DayOfWeek {\n  const jsDay = date.getDay()\n  const entries = Object.entries(DAY_MAP) as [DayOfWeek, number][]\n  const found = entries.find(([, num]) => num === jsDay)\n  return found ? found[0] : 'mon'\n}\n\n/**\n * Check if a date string (ISO) matches a DayOfWeek.\n */\nexport function dateMatchesDay(date: Date, day: DayOfWeek): boolean {\n  return date.getDay() === DAY_MAP[day]\n}\n\n/**\n * Parse a HH:mm time string to hours and minutes.\n */\nexport function parseTime(time: string): { hours: number; minutes: number } {\n  const [h, m] = time.split(':').map(Number)\n  return { hours: h, minutes: m }\n}\n\n/**\n * Combine a date (day) with a HH:mm time string into a full Date.\n */\nexport function combineDateAndTime(date: Date, time: string): Date {\n  const { hours, minutes } = parseTime(time)\n  const combined = new Date(date)\n  combined.setHours(hours, minutes, 0, 0)\n  return combined\n}\n\n/**\n * Check if a given date is an exception date in the schedule.\n */\nexport function isExceptionDate(\n  date: Date,\n  exceptions: Array<{ date: string }>,\n): boolean {\n  const dateStr = date.toISOString().split('T')[0]\n  return exceptions.some((exc) => {\n    const excDateStr = new Date(exc.date).toISOString().split('T')[0]\n    return excDateStr === dateStr\n  })\n}\n\ntype RecurringSlot = {\n  day: DayOfWeek\n  endTime: string\n  startTime: string\n}\n\ntype ManualSlot = {\n  date: string\n  endTime: string\n  startTime: string\n}\n\ntype Schedule = {\n  active?: boolean\n  exceptions?: Array<{ date: string }>\n  manualSlots?: ManualSlot[]\n  recurringSlots?: RecurringSlot[]\n  scheduleType: 'manual' | 'recurring'\n}\n\ntype TimeRange = {\n  end: Date\n  start: Date\n}\n\n/**\n * Resolve a schedule to concrete available time ranges for a given date.\n */\nexport function resolveScheduleForDate(schedule: Schedule, date: Date): TimeRange[] {\n  if (schedule.active === false) {return []}\n\n  const exceptions = schedule.exceptions ?? []\n  if (isExceptionDate(date, exceptions)) {return []}\n\n  const ranges: TimeRange[] = []\n\n  if (schedule.scheduleType === 'recurring') {\n    const slots = schedule.recurringSlots ?? []\n    const dayOfWeek = getDayOfWeek(date)\n    for (const slot of slots) {\n      if (slot.day === dayOfWeek) {\n        ranges.push({\n          end: combineDateAndTime(date, slot.endTime),\n          start: combineDateAndTime(date, slot.startTime),\n        })\n      }\n    }\n  } else if (schedule.scheduleType === 'manual') {\n    const slots = schedule.manualSlots ?? []\n    const dateStr = date.toISOString().split('T')[0]\n    for (const slot of slots) {\n      const slotDateStr = new Date(slot.date).toISOString().split('T')[0]\n      if (slotDateStr === dateStr) {\n        ranges.push({\n          end: combineDateAndTime(date, slot.endTime),\n          start: combineDateAndTime(date, slot.startTime),\n        })\n      }\n    }\n  }\n\n  return ranges\n}\n"],"names":["DAY_MAP","fri","mon","sat","sun","thu","tue","wed","getDayOfWeek","date","jsDay","getDay","entries","Object","found","find","num","dateMatchesDay","day","parseTime","time","h","m","split","map","Number","hours","minutes","combineDateAndTime","combined","Date","setHours","isExceptionDate","exceptions","dateStr","toISOString","some","exc","excDateStr","resolveScheduleForDate","schedule","active","ranges","scheduleType","slots","recurringSlots","dayOfWeek","slot","push","end","endTime","start","startTime","manualSlots","slotDateStr"],"mappings":"AAEA,MAAMA,UAAqC;IACzCC,KAAK;IACLC,KAAK;IACLC,KAAK;IACLC,KAAK;IACLC,KAAK;IACLC,KAAK;IACLC,KAAK;AACP;AAEA;;CAEC,GACD,OAAO,SAASC,aAAaC,IAAU;IACrC,MAAMC,QAAQD,KAAKE,MAAM;IACzB,MAAMC,UAAUC,OAAOD,OAAO,CAACZ;IAC/B,MAAMc,QAAQF,QAAQG,IAAI,CAAC,CAAC,GAAGC,IAAI,GAAKA,QAAQN;IAChD,OAAOI,QAAQA,KAAK,CAAC,EAAE,GAAG;AAC5B;AAEA;;CAEC,GACD,OAAO,SAASG,eAAeR,IAAU,EAAES,GAAc;IACvD,OAAOT,KAAKE,MAAM,OAAOX,OAAO,CAACkB,IAAI;AACvC;AAEA;;CAEC,GACD,OAAO,SAASC,UAAUC,IAAY;IACpC,MAAM,CAACC,GAAGC,EAAE,GAAGF,KAAKG,KAAK,CAAC,KAAKC,GAAG,CAACC;IACnC,OAAO;QAAEC,OAAOL;QAAGM,SAASL;IAAE;AAChC;AAEA;;CAEC,GACD,OAAO,SAASM,mBAAmBnB,IAAU,EAAEW,IAAY;IACzD,MAAM,EAAEM,KAAK,EAAEC,OAAO,EAAE,GAAGR,UAAUC;IACrC,MAAMS,WAAW,IAAIC,KAAKrB;IAC1BoB,SAASE,QAAQ,CAACL,OAAOC,SAAS,GAAG;IACrC,OAAOE;AACT;AAEA;;CAEC,GACD,OAAO,SAASG,gBACdvB,IAAU,EACVwB,UAAmC;IAEnC,MAAMC,UAAUzB,KAAK0B,WAAW,GAAGZ,KAAK,CAAC,IAAI,CAAC,EAAE;IAChD,OAAOU,WAAWG,IAAI,CAAC,CAACC;QACtB,MAAMC,aAAa,IAAIR,KAAKO,IAAI5B,IAAI,EAAE0B,WAAW,GAAGZ,KAAK,CAAC,IAAI,CAAC,EAAE;QACjE,OAAOe,eAAeJ;IACxB;AACF;AA2BA;;CAEC,GACD,OAAO,SAASK,uBAAuBC,QAAkB,EAAE/B,IAAU;IACnE,IAAI+B,SAASC,MAAM,KAAK,OAAO;QAAC,OAAO,EAAE;IAAA;IAEzC,MAAMR,aAAaO,SAASP,UAAU,IAAI,EAAE;IAC5C,IAAID,gBAAgBvB,MAAMwB,aAAa;QAAC,OAAO,EAAE;IAAA;IAEjD,MAAMS,SAAsB,EAAE;IAE9B,IAAIF,SAASG,YAAY,KAAK,aAAa;QACzC,MAAMC,QAAQJ,SAASK,cAAc,IAAI,EAAE;QAC3C,MAAMC,YAAYtC,aAAaC;QAC/B,KAAK,MAAMsC,QAAQH,MAAO;YACxB,IAAIG,KAAK7B,GAAG,KAAK4B,WAAW;gBAC1BJ,OAAOM,IAAI,CAAC;oBACVC,KAAKrB,mBAAmBnB,MAAMsC,KAAKG,OAAO;oBAC1CC,OAAOvB,mBAAmBnB,MAAMsC,KAAKK,SAAS;gBAChD;YACF;QACF;IACF,OAAO,IAAIZ,SAASG,YAAY,KAAK,UAAU;QAC7C,MAAMC,QAAQJ,SAASa,WAAW,IAAI,EAAE;QACxC,MAAMnB,UAAUzB,KAAK0B,WAAW,GAAGZ,KAAK,CAAC,IAAI,CAAC,EAAE;QAChD,KAAK,MAAMwB,QAAQH,MAAO;YACxB,MAAMU,cAAc,IAAIxB,KAAKiB,KAAKtC,IAAI,EAAE0B,WAAW,GAAGZ,KAAK,CAAC,IAAI,CAAC,EAAE;YACnE,IAAI+B,gBAAgBpB,SAAS;gBAC3BQ,OAAOM,IAAI,CAAC;oBACVC,KAAKrB,mBAAmBnB,MAAMsC,KAAKG,OAAO;oBAC1CC,OAAOvB,mBAAmBnB,MAAMsC,KAAKK,SAAS;gBAChD;YACF;QACF;IACF;IAEA,OAAOV;AACT"}
+{"version":3,"sources":["../../src/utilities/scheduleUtils.ts"],"sourcesContent":["import type { DayOfWeek } from '../types.js'\n\nconst DAY_MAP: Record<DayOfWeek, number> = {\n  fri: 5,\n  mon: 1,\n  sat: 6,\n  sun: 0,\n  thu: 4,\n  tue: 2,\n  wed: 3,\n}\n\n/**\n * Get the DayOfWeek value for a given Date.\n */\nexport function getDayOfWeek(date: Date): DayOfWeek {\n  const jsDay = date.getDay()\n  const entries = Object.entries(DAY_MAP) as [DayOfWeek, number][]\n  const found = entries.find(([, num]) => num === jsDay)\n  return found ? found[0] : 'mon'\n}\n\n/**\n * Check if a date string (ISO) matches a DayOfWeek.\n */\nexport function dateMatchesDay(date: Date, day: DayOfWeek): boolean {\n  return date.getDay() === DAY_MAP[day]\n}\n\n/**\n * Parse a HH:mm time string to hours and minutes.\n */\nexport function parseTime(time: string): { hours: number; minutes: number } {\n  const [h, m] = time.split(':').map(Number)\n  return { hours: h, minutes: m }\n}\n\n/**\n * Combine a date (day) with a HH:mm time string into a full Date.\n */\nexport function combineDateAndTime(date: Date, time: string): Date {\n  const { hours, minutes } = parseTime(time)\n  const combined = new Date(date)\n  combined.setHours(hours, minutes, 0, 0)\n  return combined\n}\n\n/**\n * Check if a given date is an exception date in the schedule.\n * Supports range exceptions via optional endDate (inclusive on both ends).\n */\nexport function isExceptionDate(\n  date: Date,\n  exceptions: Array<{ date: string; endDate?: string }>,\n): boolean {\n  const target = date.toISOString().split('T')[0]\n  return exceptions.some((exc) => {\n    const start = new Date(exc.date).toISOString().split('T')[0]\n    const end = exc.endDate ? new Date(exc.endDate).toISOString().split('T')[0] : start\n    return target >= start && target <= end\n  })\n}\n\ntype RecurringSlot = {\n  day: DayOfWeek\n  endTime: string\n  startTime: string\n}\n\ntype ManualSlot = {\n  date: string\n  endTime: string\n  startTime: string\n}\n\ntype Schedule = {\n  active?: boolean\n  exceptions?: Array<{ date: string; endDate?: string }>\n  manualSlots?: ManualSlot[]\n  recurringSlots?: RecurringSlot[]\n  scheduleType: 'manual' | 'recurring'\n}\n\ntype TimeRange = {\n  end: Date\n  start: Date\n}\n\n/**\n * Resolve a schedule to concrete available time ranges for a given date.\n */\nexport function resolveScheduleForDate(schedule: Schedule, date: Date): TimeRange[] {\n  if (schedule.active === false) {return []}\n\n  const exceptions = schedule.exceptions ?? []\n  if (isExceptionDate(date, exceptions)) {return []}\n\n  const ranges: TimeRange[] = []\n\n  if (schedule.scheduleType === 'recurring') {\n    const slots = schedule.recurringSlots ?? []\n    const dayOfWeek = getDayOfWeek(date)\n    for (const slot of slots) {\n      if (slot.day === dayOfWeek) {\n        ranges.push({\n          end: combineDateAndTime(date, slot.endTime),\n          start: combineDateAndTime(date, slot.startTime),\n        })\n      }\n    }\n  } else if (schedule.scheduleType === 'manual') {\n    const slots = schedule.manualSlots ?? []\n    const dateStr = date.toISOString().split('T')[0]\n    for (const slot of slots) {\n      const slotDateStr = new Date(slot.date).toISOString().split('T')[0]\n      if (slotDateStr === dateStr) {\n        ranges.push({\n          end: combineDateAndTime(date, slot.endTime),\n          start: combineDateAndTime(date, slot.startTime),\n        })\n      }\n    }\n  }\n\n  return ranges\n}\n"],"names":["DAY_MAP","fri","mon","sat","sun","thu","tue","wed","getDayOfWeek","date","jsDay","getDay","entries","Object","found","find","num","dateMatchesDay","day","parseTime","time","h","m","split","map","Number","hours","minutes","combineDateAndTime","combined","Date","setHours","isExceptionDate","exceptions","target","toISOString","some","exc","start","end","endDate","resolveScheduleForDate","schedule","active","ranges","scheduleType","slots","recurringSlots","dayOfWeek","slot","push","endTime","startTime","manualSlots","dateStr","slotDateStr"],"mappings":"AAEA,MAAMA,UAAqC;IACzCC,KAAK;IACLC,KAAK;IACLC,KAAK;IACLC,KAAK;IACLC,KAAK;IACLC,KAAK;IACLC,KAAK;AACP;AAEA;;CAEC,GACD,OAAO,SAASC,aAAaC,IAAU;IACrC,MAAMC,QAAQD,KAAKE,MAAM;IACzB,MAAMC,UAAUC,OAAOD,OAAO,CAACZ;IAC/B,MAAMc,QAAQF,QAAQG,IAAI,CAAC,CAAC,GAAGC,IAAI,GAAKA,QAAQN;IAChD,OAAOI,QAAQA,KAAK,CAAC,EAAE,GAAG;AAC5B;AAEA;;CAEC,GACD,OAAO,SAASG,eAAeR,IAAU,EAAES,GAAc;IACvD,OAAOT,KAAKE,MAAM,OAAOX,OAAO,CAACkB,IAAI;AACvC;AAEA;;CAEC,GACD,OAAO,SAASC,UAAUC,IAAY;IACpC,MAAM,CAACC,GAAGC,EAAE,GAAGF,KAAKG,KAAK,CAAC,KAAKC,GAAG,CAACC;IACnC,OAAO;QAAEC,OAAOL;QAAGM,SAASL;IAAE;AAChC;AAEA;;CAEC,GACD,OAAO,SAASM,mBAAmBnB,IAAU,EAAEW,IAAY;IACzD,MAAM,EAAEM,KAAK,EAAEC,OAAO,EAAE,GAAGR,UAAUC;IACrC,MAAMS,WAAW,IAAIC,KAAKrB;IAC1BoB,SAASE,QAAQ,CAACL,OAAOC,SAAS,GAAG;IACrC,OAAOE;AACT;AAEA;;;CAGC,GACD,OAAO,SAASG,gBACdvB,IAAU,EACVwB,UAAqD;IAErD,MAAMC,SAASzB,KAAK0B,WAAW,GAAGZ,KAAK,CAAC,IAAI,CAAC,EAAE;IAC/C,OAAOU,WAAWG,IAAI,CAAC,CAACC;QACtB,MAAMC,QAAQ,IAAIR,KAAKO,IAAI5B,IAAI,EAAE0B,WAAW,GAAGZ,KAAK,CAAC,IAAI,CAAC,EAAE;QAC5D,MAAMgB,MAAMF,IAAIG,OAAO,GAAG,IAAIV,KAAKO,IAAIG,OAAO,EAAEL,WAAW,GAAGZ,KAAK,CAAC,IAAI,CAAC,EAAE,GAAGe;QAC9E,OAAOJ,UAAUI,SAASJ,UAAUK;IACtC;AACF;AA2BA;;CAEC,GACD,OAAO,SAASE,uBAAuBC,QAAkB,EAAEjC,IAAU;IACnE,IAAIiC,SAASC,MAAM,KAAK,OAAO;QAAC,OAAO,EAAE;IAAA;IAEzC,MAAMV,aAAaS,SAAST,UAAU,IAAI,EAAE;IAC5C,IAAID,gBAAgBvB,MAAMwB,aAAa;QAAC,OAAO,EAAE;IAAA;IAEjD,MAAMW,SAAsB,EAAE;IAE9B,IAAIF,SAASG,YAAY,KAAK,aAAa;QACzC,MAAMC,QAAQJ,SAASK,cAAc,IAAI,EAAE;QAC3C,MAAMC,YAAYxC,aAAaC;QAC/B,KAAK,MAAMwC,QAAQH,MAAO;YACxB,IAAIG,KAAK/B,GAAG,KAAK8B,WAAW;gBAC1BJ,OAAOM,IAAI,CAAC;oBACVX,KAAKX,mBAAmBnB,MAAMwC,KAAKE,OAAO;oBAC1Cb,OAAOV,mBAAmBnB,MAAMwC,KAAKG,SAAS;gBAChD;YACF;QACF;IACF,OAAO,IAAIV,SAASG,YAAY,KAAK,UAAU;QAC7C,MAAMC,QAAQJ,SAASW,WAAW,IAAI,EAAE;QACxC,MAAMC,UAAU7C,KAAK0B,WAAW,GAAGZ,KAAK,CAAC,IAAI,CAAC,EAAE;QAChD,KAAK,MAAM0B,QAAQH,MAAO;YACxB,MAAMS,cAAc,IAAIzB,KAAKmB,KAAKxC,IAAI,EAAE0B,WAAW,GAAGZ,KAAK,CAAC,IAAI,CAAC,EAAE;YACnE,IAAIgC,gBAAgBD,SAAS;gBAC3BV,OAAOM,IAAI,CAAC;oBACVX,KAAKX,mBAAmBnB,MAAMwC,KAAKE,OAAO;oBAC1Cb,OAAOV,mBAAmBnB,MAAMwC,KAAKG,SAAS;gBAChD;YACF;QACF;IACF;IAEA,OAAOR;AACT"}

package/dist/utilities/selectOptions.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Build Payload select `options` from a list of string values.
+ * Labels default to a capitalized form of the value.
+ */
+export declare function buildSelectOptions(values: string[]): Array<{
+    label: string;
+    value: string;
+}>;

package/dist/utilities/selectOptions.js

@@ -0,0 +1,11 @@
+/**
+ * Build Payload select `options` from a list of string values.
+ * Labels default to a capitalized form of the value.
+ */ export function buildSelectOptions(values) {
+    return values.map((value)=>({
+            label: value.charAt(0).toUpperCase() + value.slice(1),
+            value
+        }));
+}
+
+//# sourceMappingURL=selectOptions.js.map

package/dist/utilities/selectOptions.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/utilities/selectOptions.ts"],"sourcesContent":["/**\n * Build Payload select `options` from a list of string values.\n * Labels default to a capitalized form of the value.\n */\nexport function buildSelectOptions(\n  values: string[],\n): Array<{ label: string; value: string }> {\n  return values.map((value) => ({\n    label: value.charAt(0).toUpperCase() + value.slice(1),\n    value,\n  }))\n}\n"],"names":["buildSelectOptions","values","map","value","label","charAt","toUpperCase","slice"],"mappings":"AAAA;;;CAGC,GACD,OAAO,SAASA,mBACdC,MAAgB;IAEhB,OAAOA,OAAOC,GAAG,CAAC,CAACC,QAAW,CAAA;YAC5BC,OAAOD,MAAME,MAAM,CAAC,GAAGC,WAAW,KAAKH,MAAMI,KAAK,CAAC;YACnDJ;QACF,CAAA;AACF"}

package/dist/utilities/slotUtils.d.ts

@@ -19,3 +19,22 @@ export declare function computeBlockedWindow(startTime: Date, endTime: Date, buf
  * Calculate hours between now and a future date.
  */
 export declare function hoursUntil(futureDate: Date, now?: Date): number;
+/**
+ * Local-calendar day key (YYYY-MM-DD) for a Date, using local components (not UTC).
+ */
+export declare function localDayKey(date: Date): string;
+/**
+ * Intersect two lists of half-open [start, end) intervals.
+ * Returns every non-empty overlap between an interval in `a` and one in `b`.
+ * Fold over N lists to intersect more than two.
+ */
+export declare function intersectIntervals(a: Array<{
+    end: Date;
+    start: Date;
+}>, b: Array<{
+    end: Date;
+    start: Date;
+}>): Array<{
+    end: Date;
+    start: Date;
+}>;

package/dist/utilities/slotUtils.js

@@ -24,5 +24,33 @@
     const reference = now ?? new Date();
     return (futureDate.getTime() - reference.getTime()) / (1000 * 60 * 60);
 }
+/**
+ * Local-calendar day key (YYYY-MM-DD) for a Date, using local components (not UTC).
+ */ export function localDayKey(date) {
+    const y = date.getFullYear();
+    const m = String(date.getMonth() + 1).padStart(2, '0');
+    const d = String(date.getDate()).padStart(2, '0');
+    return `${y}-${m}-${d}`;
+}
+/**
+ * Intersect two lists of half-open [start, end) intervals.
+ * Returns every non-empty overlap between an interval in `a` and one in `b`.
+ * Fold over N lists to intersect more than two.
+ */ export function intersectIntervals(a, b) {
+    const out = [];
+    for (const x of a){
+        for (const y of b){
+            const start = x.start > y.start ? x.start : y.start;
+            const end = x.end < y.end ? x.end : y.end;
+            if (start < end) {
+                out.push({
+                    end,
+                    start
+                });
+            }
+        }
+    }
+    return out;
+}
 
 //# sourceMappingURL=slotUtils.js.map

package/dist/utilities/slotUtils.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/utilities/slotUtils.ts"],"sourcesContent":["/**\n * Add minutes to a date and return a new Date.\n */\nexport function addMinutes(date: Date, minutes: number): Date {\n  return new Date(date.getTime() + minutes * 60_000)\n}\n\n/**\n * Check if two time ranges overlap.\n * Ranges are [startA, endA) and [startB, endB) (half-open intervals).\n */\nexport function doRangesOverlap(\n  startA: Date,\n  endA: Date,\n  startB: Date,\n  endB: Date,\n): boolean {\n  return startA < endB && startB < endA\n}\n\n/**\n * Compute the effective blocked window for a reservation,\n * applying buffer times before and after.\n */\nexport function computeBlockedWindow(\n  startTime: Date,\n  endTime: Date,\n  bufferBefore: number,\n  bufferAfter: number,\n): { effectiveEnd: Date; effectiveStart: Date } {\n  return {\n    effectiveEnd: addMinutes(endTime, bufferAfter),\n    effectiveStart: addMinutes(startTime, -bufferBefore),\n  }\n}\n\n/**\n * Calculate hours between now and a future date.\n */\nexport function hoursUntil(futureDate: Date, now?: Date): number {\n  const reference = now ?? new Date()\n  return (futureDate.getTime() - reference.getTime()) / (1000 * 60 * 60)\n}\n"],"names":["addMinutes","date","minutes","Date","getTime","doRangesOverlap","startA","endA","startB","endB","computeBlockedWindow","startTime","endTime","bufferBefore","bufferAfter","effectiveEnd","effectiveStart","hoursUntil","futureDate","now","reference"],"mappings":"AAAA;;CAEC,GACD,OAAO,SAASA,WAAWC,IAAU,EAAEC,OAAe;IACpD,OAAO,IAAIC,KAAKF,KAAKG,OAAO,KAAKF,UAAU;AAC7C;AAEA;;;CAGC,GACD,OAAO,SAASG,gBACdC,MAAY,EACZC,IAAU,EACVC,MAAY,EACZC,IAAU;IAEV,OAAOH,SAASG,QAAQD,SAASD;AACnC;AAEA;;;CAGC,GACD,OAAO,SAASG,qBACdC,SAAe,EACfC,OAAa,EACbC,YAAoB,EACpBC,WAAmB;IAEnB,OAAO;QACLC,cAAcf,WAAWY,SAASE;QAClCE,gBAAgBhB,WAAWW,WAAW,CAACE;IACzC;AACF;AAEA;;CAEC,GACD,OAAO,SAASI,WAAWC,UAAgB,EAAEC,GAAU;IACrD,MAAMC,YAAYD,OAAO,IAAIhB;IAC7B,OAAO,AAACe,CAAAA,WAAWd,OAAO,KAAKgB,UAAUhB,OAAO,EAAC,IAAM,CAAA,OAAO,KAAK,EAAC;AACtE"}
+{"version":3,"sources":["../../src/utilities/slotUtils.ts"],"sourcesContent":["/**\n * Add minutes to a date and return a new Date.\n */\nexport function addMinutes(date: Date, minutes: number): Date {\n  return new Date(date.getTime() + minutes * 60_000)\n}\n\n/**\n * Check if two time ranges overlap.\n * Ranges are [startA, endA) and [startB, endB) (half-open intervals).\n */\nexport function doRangesOverlap(\n  startA: Date,\n  endA: Date,\n  startB: Date,\n  endB: Date,\n): boolean {\n  return startA < endB && startB < endA\n}\n\n/**\n * Compute the effective blocked window for a reservation,\n * applying buffer times before and after.\n */\nexport function computeBlockedWindow(\n  startTime: Date,\n  endTime: Date,\n  bufferBefore: number,\n  bufferAfter: number,\n): { effectiveEnd: Date; effectiveStart: Date } {\n  return {\n    effectiveEnd: addMinutes(endTime, bufferAfter),\n    effectiveStart: addMinutes(startTime, -bufferBefore),\n  }\n}\n\n/**\n * Calculate hours between now and a future date.\n */\nexport function hoursUntil(futureDate: Date, now?: Date): number {\n  const reference = now ?? new Date()\n  return (futureDate.getTime() - reference.getTime()) / (1000 * 60 * 60)\n}\n\n/**\n * Local-calendar day key (YYYY-MM-DD) for a Date, using local components (not UTC).\n */\nexport function localDayKey(date: Date): string {\n  const y = date.getFullYear()\n  const m = String(date.getMonth() + 1).padStart(2, '0')\n  const d = String(date.getDate()).padStart(2, '0')\n  return `${y}-${m}-${d}`\n}\n\n/**\n * Intersect two lists of half-open [start, end) intervals.\n * Returns every non-empty overlap between an interval in `a` and one in `b`.\n * Fold over N lists to intersect more than two.\n */\nexport function intersectIntervals(\n  a: Array<{ end: Date; start: Date }>,\n  b: Array<{ end: Date; start: Date }>,\n): Array<{ end: Date; start: Date }> {\n  const out: Array<{ end: Date; start: Date }> = []\n  for (const x of a) {\n    for (const y of b) {\n      const start = x.start > y.start ? x.start : y.start\n      const end = x.end < y.end ? x.end : y.end\n      if (start < end) {\n        out.push({ end, start })\n      }\n    }\n  }\n  return out\n}\n"],"names":["addMinutes","date","minutes","Date","getTime","doRangesOverlap","startA","endA","startB","endB","computeBlockedWindow","startTime","endTime","bufferBefore","bufferAfter","effectiveEnd","effectiveStart","hoursUntil","futureDate","now","reference","localDayKey","y","getFullYear","m","String","getMonth","padStart","d","getDate","intersectIntervals","a","b","out","x","start","end","push"],"mappings":"AAAA;;CAEC,GACD,OAAO,SAASA,WAAWC,IAAU,EAAEC,OAAe;IACpD,OAAO,IAAIC,KAAKF,KAAKG,OAAO,KAAKF,UAAU;AAC7C;AAEA;;;CAGC,GACD,OAAO,SAASG,gBACdC,MAAY,EACZC,IAAU,EACVC,MAAY,EACZC,IAAU;IAEV,OAAOH,SAASG,QAAQD,SAASD;AACnC;AAEA;;;CAGC,GACD,OAAO,SAASG,qBACdC,SAAe,EACfC,OAAa,EACbC,YAAoB,EACpBC,WAAmB;IAEnB,OAAO;QACLC,cAAcf,WAAWY,SAASE;QAClCE,gBAAgBhB,WAAWW,WAAW,CAACE;IACzC;AACF;AAEA;;CAEC,GACD,OAAO,SAASI,WAAWC,UAAgB,EAAEC,GAAU;IACrD,MAAMC,YAAYD,OAAO,IAAIhB;IAC7B,OAAO,AAACe,CAAAA,WAAWd,OAAO,KAAKgB,UAAUhB,OAAO,EAAC,IAAM,CAAA,OAAO,KAAK,EAAC;AACtE;AAEA;;CAEC,GACD,OAAO,SAASiB,YAAYpB,IAAU;IACpC,MAAMqB,IAAIrB,KAAKsB,WAAW;IAC1B,MAAMC,IAAIC,OAAOxB,KAAKyB,QAAQ,KAAK,GAAGC,QAAQ,CAAC,GAAG;IAClD,MAAMC,IAAIH,OAAOxB,KAAK4B,OAAO,IAAIF,QAAQ,CAAC,GAAG;IAC7C,OAAO,GAAGL,EAAE,CAAC,EAAEE,EAAE,CAAC,EAAEI,GAAG;AACzB;AAEA;;;;CAIC,GACD,OAAO,SAASE,mBACdC,CAAoC,EACpCC,CAAoC;IAEpC,MAAMC,MAAyC,EAAE;IACjD,KAAK,MAAMC,KAAKH,EAAG;QACjB,KAAK,MAAMT,KAAKU,EAAG;YACjB,MAAMG,QAAQD,EAAEC,KAAK,GAAGb,EAAEa,KAAK,GAAGD,EAAEC,KAAK,GAAGb,EAAEa,KAAK;YACnD,MAAMC,MAAMF,EAAEE,GAAG,GAAGd,EAAEc,GAAG,GAAGF,EAAEE,GAAG,GAAGd,EAAEc,GAAG;YACzC,IAAID,QAAQC,KAAK;gBACfH,IAAII,IAAI,CAAC;oBAAED;oBAAKD;gBAAM;YACxB;QACF;IACF;IACA,OAAOF;AACT"}

package/dist/utilities/userRoles.d.ts

@@ -0,0 +1,20 @@
+import type { ResolvedReservationPluginConfig } from '../types.js';
+/**
+ * Roles considered privileged (staff/admin) — the union of `resourceOwnerMode`
+ * admin roles and `staffProvisioning` staff roles. Empty when neither is set.
+ */
+export declare function privilegedRoles(config: ResolvedReservationPluginConfig): string[];
+/**
+ * True if the request user is staff/admin (i.e. NOT a customer).
+ *
+ * Two-collection model (default): anyone whose collection differs from
+ * `slugs.customers` is staff/admin — the original behaviour, unchanged.
+ *
+ * Single-collection model (`userCollection` set, so `slugs.customers` IS the
+ * auth collection): collection can't distinguish staff from customers, so fall
+ * back to the user's role against `privilegedRoles`. With no privileged roles
+ * configured this returns false (safe — treats everyone as a customer).
+ */
+export declare function isPrivilegedUser(user: ({
+    collection?: string;
+} & Record<string, unknown>) | null | undefined, config: ResolvedReservationPluginConfig): boolean;