payload-reserve 2.4.0 → 3.0.1

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  /** Status treated as \"cancelled\" — fires beforeBookingCancel/afterBookingCancel, the cancellation notice period, and the cancellationReason field. */\n  cancelStatus: string\n  /** Status treated as \"confirmed\" — fires beforeBookingConfirm/afterBookingConfirm. */\n  confirmStatus: 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  cancelStatus: 'cancelled',\n  confirmStatus: '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  /** User field holding the role for admin detection (default: staffProvisioning.roleField or 'role') */\n  roleField?: string\n}\n\nexport type ResolvedResourceOwnerModeConfig = {\n  adminRoles: string[]\n  ownedServices: boolean\n  ownerCollection?: string\n  ownerField: string\n  roleField: 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\n/**\n * Per-collection override applied to a generated collection. `fields` is a\n * function receiving the plugin's default fields so you can append/reorder/\n * replace them; supplied `hooks` are merged with (not replacing) the plugin's;\n * `access` composes per operation; `slug` is ignored (use the `slugs` option).\n */\nexport type CollectionOverride = {\n  fields?: (args: { defaultFields: Field[] }) => Field[]\n} & Omit<Partial<CollectionConfig>, 'fields' | 'slug'>\n\n/** One external busy interval returned by `getExternalBusy` (ISO date strings). */\nexport type ExternalBusyInterval = { end: string; label?: string; start: string }\n\n/**\n * App-supplied resolver mapping an external source (e.g. Google/Outlook sync\n * tables) to busy intervals for one resource over [start, end). Wired into\n * checkAvailability (bookings overlapping an interval are unavailable — the\n * interval blocks the WHOLE resource, all units) and into the\n * resource-availability endpoint (returned as `external` for distinct\n * rendering). The plugin calls it inside try/catch and treats an error as []\n * (fail-open): a calendar/sync failure must never block a real booking.\n * Called once per candidate window during slot computation (N calls per\n * request) — keep it cheap: read a local sync table or a per-request cache,\n * never a remote API directly.\n */\nexport type GetExternalBusy = (args: {\n  end: Date\n  req: PayloadRequest\n  resourceId: number | string\n  start: Date\n}) => Promise<ExternalBusyInterval[]>\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  /** Per-collection overrides applied to the generated collections (issue #4) */\n  collectionOverrides?: {\n    customers?: CollectionOverride\n    reservations?: CollectionOverride\n    resources?: CollectionOverride\n    schedules?: CollectionOverride\n    services?: CollectionOverride\n  }\n  /** Emit info-level `reserve_debug` traces for slot generation and conflict detection (default false) */\n  debug?: boolean\n  /** Default buffer time in minutes between reservations */\n  defaultBufferTime?: number\n  /** Disable the plugin entirely */\n  disabled?: boolean\n  /** @deprecated Use `collectionOverrides.reservations.fields` instead. Extra fields appended to Reservations. */\n  extraReservationFields?: Field[]\n  /** Resolve external busy intervals (calendar sync etc.) folded into availability + calendar display. */\n  getExternalBusy?: GetExternalBusy\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  /** Tenant scoping for the custom admin views (calendar, availability, dashboard). Applied only when the scoped collection has the tenant field AND the tenant cookie is set. */\n  multiTenant?: {\n    /** Cookie written by the tenant-selector (default 'payload-tenant'). */\n    cookieName?: string\n    /** Tenant field name on scoped collections (default 'tenant'). */\n    tenantField?: string\n    /**\n     * Field on the tenant document holding its IANA timezone (default 'timezone').\n     * When set and the selected tenant has a valid value, the admin views resolve\n     * day-boundaries in that tenant's zone instead of the global `timezone`.\n     */\n    timezoneField?: string\n  }\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  /** IANA business timezone governing schedules and day boundaries (default 'UTC') */\n  timezone?: string\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  collectionOverrides: {\n    customers?: CollectionOverride\n    reservations?: CollectionOverride\n    resources?: CollectionOverride\n    schedules?: CollectionOverride\n    services?: CollectionOverride\n  }\n  debug: boolean\n  defaultBufferTime: number\n  disabled: boolean\n  extraReservationFields: Field[]\n  getExternalBusy: GetExternalBusy | undefined\n  /** Whether the media collection (`slugs.media`) exists — set by the plugin; gates the image upload fields. */\n  hasMediaCollection: boolean\n  hooks: ReservationPluginHooks\n  leaveTypes: string[]\n  localized: boolean\n  multiTenant: {\n    cookieName: string\n    tenantField: string\n    timezoneField: string\n  }\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  timezone: string\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","cancelStatus","confirmStatus","defaultStatus","statuses","terminalStatuses","transitions","cancelled","completed","confirmed","pending","VALID_STATUS_TRANSITIONS"],"mappings":"AAsBA,OAAO,MAAMA,yBAA8C;IACzDC,kBAAkB;QAAC;QAAW;KAAY;IAC1CC,cAAc;IACdC,eAAe;IACfC,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;AAkRD,+DAA+D,GAC/D,OAAO,MAAMC,2BACXZ,uBAAuBO,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  /** Status treated as \"cancelled\" — fires beforeBookingCancel/afterBookingCancel, the cancellation notice period, and the cancellationReason field. */\n  cancelStatus: string\n  /** Status treated as \"confirmed\" — fires beforeBookingConfirm/afterBookingConfirm. */\n  confirmStatus: 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  cancelStatus: 'cancelled',\n  confirmStatus: '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  /** User field holding the role for admin detection (default: staffProvisioning.roleField or 'role') */\n  roleField?: string\n}\n\nexport type ResolvedResourceOwnerModeConfig = {\n  adminRoles: string[]\n  ownedServices: boolean\n  ownerCollection?: string\n  ownerField: string\n  roleField: 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\n/**\n * Per-collection override applied to a generated collection. `fields` is a\n * function receiving the plugin's default fields so you can append/reorder/\n * replace them; supplied `hooks` are merged with (not replacing) the plugin's;\n * `access` composes per operation; `slug` is ignored (use the `slugs` option).\n */\nexport type CollectionOverride = {\n  fields?: (args: { defaultFields: Field[] }) => Field[]\n} & Omit<Partial<CollectionConfig>, 'fields' | 'slug'>\n\n/** One external busy interval returned by `getExternalBusy` (ISO date strings). */\nexport type ExternalBusyInterval = { end: string; label?: string; start: string }\n\n/**\n * App-supplied resolver mapping an external source (e.g. Google/Outlook sync\n * tables) to busy intervals for one resource over [start, end). Wired into\n * checkAvailability (bookings overlapping an interval are unavailable — the\n * interval blocks the WHOLE resource, all units) and into the\n * resource-availability endpoint (returned as `external` for distinct\n * rendering). The plugin calls it inside try/catch and treats an error as []\n * (fail-open): a calendar/sync failure must never block a real booking.\n * Called once per candidate window during slot computation (N calls per\n * request) — keep it cheap: read a local sync table or a per-request cache,\n * never a remote API directly.\n */\nexport type GetExternalBusy = (args: {\n  end: Date\n  req: PayloadRequest\n  resourceId: number | string\n  start: Date\n}) => Promise<ExternalBusyInterval[]>\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  /** Per-collection overrides applied to the generated collections (issue #4) */\n  collectionOverrides?: {\n    customers?: CollectionOverride\n    reservations?: CollectionOverride\n    resources?: CollectionOverride\n    schedules?: CollectionOverride\n    services?: CollectionOverride\n  }\n  /** Emit info-level `reserve_debug` traces for slot generation and conflict detection (default false) */\n  debug?: boolean\n  /** Default buffer time in minutes between reservations */\n  defaultBufferTime?: number\n  /** Disable the plugin entirely */\n  disabled?: boolean\n  /**\n   * Reject bookings against an inactive service or resource, and omit them from\n   * availability. Default `true`. Set `false` to restore the previous behaviour\n   * where `active` was advisory and only filtered in the admin UI.\n   */\n  enforceActive?: boolean\n  /** @deprecated Use `collectionOverrides.reservations.fields` instead. Extra fields appended to Reservations. */\n  extraReservationFields?: Field[]\n  /** Resolve external busy intervals (calendar sync etc.) folded into availability + calendar display. */\n  getExternalBusy?: GetExternalBusy\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  /** Tenant scoping for the custom admin views (calendar, availability, dashboard). Applied only when the scoped collection has the tenant field AND the tenant cookie is set. */\n  multiTenant?: {\n    /** Cookie written by the tenant-selector (default 'payload-tenant'). */\n    cookieName?: string\n    /** Tenant field name on scoped collections (default 'tenant'). */\n    tenantField?: string\n    /**\n     * Field on the tenant document holding its IANA timezone (default 'timezone').\n     * When set and the selected tenant has a valid value, the admin views resolve\n     * day-boundaries in that tenant's zone instead of the global `timezone`.\n     */\n    timezoneField?: string\n  }\n  /** Enable resource-owner multi-tenancy (opt-in) */\n  resourceOwnerMode?: ResourceOwnerModeConfig\n  /** Configurable resourceType vocabulary (default: staff/equipment/room) */\n  resourceTypes?: string[]\n  /**\n   * Short-lived slot claims taken while a customer completes checkout.\n   *\n   * Opt-in: when absent, no holds collection is created and availability\n   * behaviour is byte-identical to before. Enabling it makes unexpired holds\n   * occupy their resource in every availability check.\n   */\n  slotHolds?: {\n    enabled?: boolean\n    /** Minutes a hold survives before it stops occupying its slot. Default 10. */\n    ttlMinutes?: number\n  }\n  /** Override collection slugs */\n  slugs?: {\n    customers?: string\n    /** Slug for the slot-holds collection (only created when `slotHolds.enabled`). */\n    holds?: 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  /** IANA business timezone governing schedules and day boundaries (default 'UTC') */\n  timezone?: string\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  collectionOverrides: {\n    customers?: CollectionOverride\n    reservations?: CollectionOverride\n    resources?: CollectionOverride\n    schedules?: CollectionOverride\n    services?: CollectionOverride\n  }\n  debug: boolean\n  defaultBufferTime: number\n  disabled: boolean\n  enforceActive: boolean\n  extraReservationFields: Field[]\n  getExternalBusy: GetExternalBusy | undefined\n  /** Whether the media collection (`slugs.media`) exists — set by the plugin; gates the image upload fields. */\n  hasMediaCollection: boolean\n  /** Set by the plugin once Resources is built: does it still expose a\n   *  top-level `services` relationship for the Services join to target? */\n  hasResourceServicesField: boolean\n  hooks: ReservationPluginHooks\n  leaveTypes: string[]\n  localized: boolean\n  multiTenant: {\n    cookieName: string\n    tenantField: string\n    timezoneField: string\n  }\n  resourceOwnerMode: ResolvedResourceOwnerModeConfig | undefined\n  resourceTypes: string[]\n  slotHolds: {\n    enabled: boolean\n    ttlMinutes: number\n  }\n  slugs: {\n    customers: string\n    holds: 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  timezone: string\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","cancelStatus","confirmStatus","defaultStatus","statuses","terminalStatuses","transitions","cancelled","completed","confirmed","pending","VALID_STATUS_TRANSITIONS"],"mappings":"AAsBA,OAAO,MAAMA,yBAA8C;IACzDC,kBAAkB;QAAC;QAAW;KAAY;IAC1CC,cAAc;IACdC,eAAe;IACfC,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;AA+SD,+DAA+D,GAC/D,OAAO,MAAMC,2BACXZ,uBAAuBO,WAAW,CAAkD"}

package/dist/utilities/calendarGrid.d.ts

@@ -0,0 +1,44 @@
+/**
+ * Weekday index for a calendar date, 0 = Sunday. TZ-independent pure calendar
+ * math — the UTC instant is a carrier for the date only, never a real time.
+ */
+export declare function weekdayIndexOfDayKey(dayKey: string): number;
+/** The Sunday on or before `dayKey`. */
+export declare function startOfWeekDayKey(dayKey: string): string;
+/** The Sunday on or before the 1st of `dayKey`'s month — the month grid origin. */
+export declare function monthGridStartDayKey(dayKey: string): string;
+/** `count` consecutive day keys starting at `startDayKey`. */
+export declare function dayKeySequence(startDayKey: string, count: number): string[];
+/**
+ * The instant at `hour`:00 on `dayKey` in the BUSINESS timezone.
+ *
+ * This is the whole point of the module: calendar rows are labelled with
+ * getHourInTimezone(date, businessTZ), so the instant a row maps to must be
+ * built in that same zone. Using Date#setHours here builds it in the VIEWER's
+ * zone, which is how clicking "10:00" came to book a different hour.
+ */
+export declare function instantAtHour(dayKey: string, hour: number, timeZone: string): Date;
+/**
+ * Like `instantAtHour`, but tolerates the exclusive end hour a grid window can
+ * carry: hour 24 is not a wall-clock time (`combineDayKeyAndTime` rejects
+ * "24:00"), it means midnight starting the FOLLOWING day, so carry it onto the
+ * next day key.
+ *
+ * The carry is deliberately a day-key increment rather than `+24h` on the day's
+ * start: on a DST-transition day the grid spans 23 or 25 real hours, and only
+ * re-resolving midnight in the business zone lands on the right instant.
+ */
+export declare function gridInstant(dayKey: string, hour: number, timeZone: string): Date;
+/**
+ * A Date safe to hand to Intl for rendering `dayKey`'s calendar date.
+ *
+ * Noon is deliberate: far enough from both midnights that formatting it back
+ * with the SAME `timeZone` it was built with can never render the adjacent
+ * date, DST included — which is how every caller in this codebase uses it
+ * (construct and format in the one business zone). The margin is only ±12h
+ * from that zone's own offset, not unconditional: formatting in a *different*
+ * zone whose offset differs from `timeZone`'s by more than ~12h (e.g. noon
+ * built in Pacific/Auckland, UTC+12/+13, formatted in a UTC-11 zone) can still
+ * land on the adjacent day.
+ */
+export declare function displayDateForDayKey(dayKey: string, timeZone: string): Date;

package/dist/utilities/calendarGrid.js

@@ -0,0 +1,67 @@
+import { addDaysToDayKey, combineDayKeyAndTime } from './timezoneUtils.js';
+const DAY_KEY_RE = /^\d{4}-\d{2}-\d{2}$/;
+function assertDayKey(dayKey) {
+    if (!DAY_KEY_RE.test(dayKey)) {
+        throw new Error(`Invalid day key "${dayKey}" — expected YYYY-MM-DD`);
+    }
+}
+/**
+ * Weekday index for a calendar date, 0 = Sunday. TZ-independent pure calendar
+ * math — the UTC instant is a carrier for the date only, never a real time.
+ */ export function weekdayIndexOfDayKey(dayKey) {
+    assertDayKey(dayKey);
+    return new Date(`${dayKey}T00:00:00Z`).getUTCDay();
+}
+/** The Sunday on or before `dayKey`. */ export function startOfWeekDayKey(dayKey) {
+    return addDaysToDayKey(dayKey, -weekdayIndexOfDayKey(dayKey));
+}
+/** The Sunday on or before the 1st of `dayKey`'s month — the month grid origin. */ export function monthGridStartDayKey(dayKey) {
+    assertDayKey(dayKey);
+    return startOfWeekDayKey(`${dayKey.slice(0, 8)}01`);
+}
+/** `count` consecutive day keys starting at `startDayKey`. */ export function dayKeySequence(startDayKey, count) {
+    assertDayKey(startDayKey);
+    const keys = [];
+    for(let i = 0; i < count; i++){
+        keys.push(addDaysToDayKey(startDayKey, i));
+    }
+    return keys;
+}
+/**
+ * The instant at `hour`:00 on `dayKey` in the BUSINESS timezone.
+ *
+ * This is the whole point of the module: calendar rows are labelled with
+ * getHourInTimezone(date, businessTZ), so the instant a row maps to must be
+ * built in that same zone. Using Date#setHours here builds it in the VIEWER's
+ * zone, which is how clicking "10:00" came to book a different hour.
+ */ export function instantAtHour(dayKey, hour, timeZone) {
+    return combineDayKeyAndTime(dayKey, `${String(hour).padStart(2, '0')}:00`, timeZone);
+}
+/**
+ * Like `instantAtHour`, but tolerates the exclusive end hour a grid window can
+ * carry: hour 24 is not a wall-clock time (`combineDayKeyAndTime` rejects
+ * "24:00"), it means midnight starting the FOLLOWING day, so carry it onto the
+ * next day key.
+ *
+ * The carry is deliberately a day-key increment rather than `+24h` on the day's
+ * start: on a DST-transition day the grid spans 23 or 25 real hours, and only
+ * re-resolving midnight in the business zone lands on the right instant.
+ */ export function gridInstant(dayKey, hour, timeZone) {
+    return instantAtHour(addDaysToDayKey(dayKey, Math.floor(hour / 24)), hour % 24, timeZone);
+}
+/**
+ * A Date safe to hand to Intl for rendering `dayKey`'s calendar date.
+ *
+ * Noon is deliberate: far enough from both midnights that formatting it back
+ * with the SAME `timeZone` it was built with can never render the adjacent
+ * date, DST included — which is how every caller in this codebase uses it
+ * (construct and format in the one business zone). The margin is only ±12h
+ * from that zone's own offset, not unconditional: formatting in a *different*
+ * zone whose offset differs from `timeZone`'s by more than ~12h (e.g. noon
+ * built in Pacific/Auckland, UTC+12/+13, formatted in a UTC-11 zone) can still
+ * land on the adjacent day.
+ */ export function displayDateForDayKey(dayKey, timeZone) {
+    return combineDayKeyAndTime(dayKey, '12:00', timeZone);
+}
+
+//# sourceMappingURL=calendarGrid.js.map

package/dist/utilities/calendarGrid.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/utilities/calendarGrid.ts"],"sourcesContent":["import { addDaysToDayKey, combineDayKeyAndTime } from './timezoneUtils.js'\n\nconst DAY_KEY_RE = /^\\d{4}-\\d{2}-\\d{2}$/\n\nfunction assertDayKey(dayKey: string): void {\n  if (!DAY_KEY_RE.test(dayKey)) {\n    throw new Error(`Invalid day key \"${dayKey}\" — expected YYYY-MM-DD`)\n  }\n}\n\n/**\n * Weekday index for a calendar date, 0 = Sunday. TZ-independent pure calendar\n * math — the UTC instant is a carrier for the date only, never a real time.\n */\nexport function weekdayIndexOfDayKey(dayKey: string): number {\n  assertDayKey(dayKey)\n  return new Date(`${dayKey}T00:00:00Z`).getUTCDay()\n}\n\n/** The Sunday on or before `dayKey`. */\nexport function startOfWeekDayKey(dayKey: string): string {\n  return addDaysToDayKey(dayKey, -weekdayIndexOfDayKey(dayKey))\n}\n\n/** The Sunday on or before the 1st of `dayKey`'s month — the month grid origin. */\nexport function monthGridStartDayKey(dayKey: string): string {\n  assertDayKey(dayKey)\n  return startOfWeekDayKey(`${dayKey.slice(0, 8)}01`)\n}\n\n/** `count` consecutive day keys starting at `startDayKey`. */\nexport function dayKeySequence(startDayKey: string, count: number): string[] {\n  assertDayKey(startDayKey)\n  const keys: string[] = []\n  for (let i = 0; i < count; i++) {\n    keys.push(addDaysToDayKey(startDayKey, i))\n  }\n  return keys\n}\n\n/**\n * The instant at `hour`:00 on `dayKey` in the BUSINESS timezone.\n *\n * This is the whole point of the module: calendar rows are labelled with\n * getHourInTimezone(date, businessTZ), so the instant a row maps to must be\n * built in that same zone. Using Date#setHours here builds it in the VIEWER's\n * zone, which is how clicking \"10:00\" came to book a different hour.\n */\nexport function instantAtHour(dayKey: string, hour: number, timeZone: string): Date {\n  return combineDayKeyAndTime(dayKey, `${String(hour).padStart(2, '0')}:00`, timeZone)\n}\n\n/**\n * Like `instantAtHour`, but tolerates the exclusive end hour a grid window can\n * carry: hour 24 is not a wall-clock time (`combineDayKeyAndTime` rejects\n * \"24:00\"), it means midnight starting the FOLLOWING day, so carry it onto the\n * next day key.\n *\n * The carry is deliberately a day-key increment rather than `+24h` on the day's\n * start: on a DST-transition day the grid spans 23 or 25 real hours, and only\n * re-resolving midnight in the business zone lands on the right instant.\n */\nexport function gridInstant(dayKey: string, hour: number, timeZone: string): Date {\n  return instantAtHour(addDaysToDayKey(dayKey, Math.floor(hour / 24)), hour % 24, timeZone)\n}\n\n/**\n * A Date safe to hand to Intl for rendering `dayKey`'s calendar date.\n *\n * Noon is deliberate: far enough from both midnights that formatting it back\n * with the SAME `timeZone` it was built with can never render the adjacent\n * date, DST included — which is how every caller in this codebase uses it\n * (construct and format in the one business zone). The margin is only ±12h\n * from that zone's own offset, not unconditional: formatting in a *different*\n * zone whose offset differs from `timeZone`'s by more than ~12h (e.g. noon\n * built in Pacific/Auckland, UTC+12/+13, formatted in a UTC-11 zone) can still\n * land on the adjacent day.\n */\nexport function displayDateForDayKey(dayKey: string, timeZone: string): Date {\n  return combineDayKeyAndTime(dayKey, '12:00', timeZone)\n}\n"],"names":["addDaysToDayKey","combineDayKeyAndTime","DAY_KEY_RE","assertDayKey","dayKey","test","Error","weekdayIndexOfDayKey","Date","getUTCDay","startOfWeekDayKey","monthGridStartDayKey","slice","dayKeySequence","startDayKey","count","keys","i","push","instantAtHour","hour","timeZone","String","padStart","gridInstant","Math","floor","displayDateForDayKey"],"mappings":"AAAA,SAASA,eAAe,EAAEC,oBAAoB,QAAQ,qBAAoB;AAE1E,MAAMC,aAAa;AAEnB,SAASC,aAAaC,MAAc;IAClC,IAAI,CAACF,WAAWG,IAAI,CAACD,SAAS;QAC5B,MAAM,IAAIE,MAAM,CAAC,iBAAiB,EAAEF,OAAO,uBAAuB,CAAC;IACrE;AACF;AAEA;;;CAGC,GACD,OAAO,SAASG,qBAAqBH,MAAc;IACjDD,aAAaC;IACb,OAAO,IAAII,KAAK,GAAGJ,OAAO,UAAU,CAAC,EAAEK,SAAS;AAClD;AAEA,sCAAsC,GACtC,OAAO,SAASC,kBAAkBN,MAAc;IAC9C,OAAOJ,gBAAgBI,QAAQ,CAACG,qBAAqBH;AACvD;AAEA,iFAAiF,GACjF,OAAO,SAASO,qBAAqBP,MAAc;IACjDD,aAAaC;IACb,OAAOM,kBAAkB,GAAGN,OAAOQ,KAAK,CAAC,GAAG,GAAG,EAAE,CAAC;AACpD;AAEA,4DAA4D,GAC5D,OAAO,SAASC,eAAeC,WAAmB,EAAEC,KAAa;IAC/DZ,aAAaW;IACb,MAAME,OAAiB,EAAE;IACzB,IAAK,IAAIC,IAAI,GAAGA,IAAIF,OAAOE,IAAK;QAC9BD,KAAKE,IAAI,CAAClB,gBAAgBc,aAAaG;IACzC;IACA,OAAOD;AACT;AAEA;;;;;;;CAOC,GACD,OAAO,SAASG,cAAcf,MAAc,EAAEgB,IAAY,EAAEC,QAAgB;IAC1E,OAAOpB,qBAAqBG,QAAQ,GAAGkB,OAAOF,MAAMG,QAAQ,CAAC,GAAG,KAAK,GAAG,CAAC,EAAEF;AAC7E;AAEA;;;;;;;;;CASC,GACD,OAAO,SAASG,YAAYpB,MAAc,EAAEgB,IAAY,EAAEC,QAAgB;IACxE,OAAOF,cAAcnB,gBAAgBI,QAAQqB,KAAKC,KAAK,CAACN,OAAO,MAAMA,OAAO,IAAIC;AAClF;AAEA;;;;;;;;;;;CAWC,GACD,OAAO,SAASM,qBAAqBvB,MAAc,EAAEiB,QAAgB;IACnE,OAAOpB,qBAAqBG,QAAQ,SAASiB;AAC/C"}

package/dist/utilities/reservationChanges.d.ts

@@ -11,7 +11,12 @@ export declare function mergeReservationData(data: Record<string, unknown>, orig
  * field, and a notes-only edit must not trigger re-validation.
  */
 export declare function schedulingFieldsChanged({ blockingStatuses, data, originalDoc, }: {
-    blockingStatuses: string[];
+    /**
+     * Omit to compare scheduling VALUES only, skipping the status clause below.
+     * `validateActive` needs that: a confirm or cancel must stay possible on a
+     * booking whose service or resource was deactivated after it was made.
+     */
+    blockingStatuses?: string[];
     data: Record<string, unknown>;
     originalDoc: Record<string, unknown> | undefined;
 }): boolean;

package/dist/utilities/reservationChanges.js

@@ -76,7 +76,7 @@ function itemsEqual(a, b) {
             return true;
         }
     }
-    if ('status' in data && typeof data.status === 'string') {
+    if (blockingStatuses && 'status' in data && typeof data.status === 'string') {
         const prevStatus = originalDoc.status;
         if (data.status !== prevStatus && blockingStatuses.includes(data.status) && (prevStatus === undefined || !blockingStatuses.includes(prevStatus))) {
             return true;

package/dist/utilities/reservationChanges.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/utilities/reservationChanges.ts"],"sourcesContent":["import { extractId } from './resolveReservationItems.js'\n\n/**\n * Fields whose change means a reservation's slot occupancy may differ,\n * requiring conflict re-validation and endTime recomputation on update.\n */\nconst SCHEDULING_FIELDS = [\n  'endTime',\n  'guestCount',\n  'items',\n  'resource',\n  'service',\n  'startTime',\n] as const\n\n/**\n * Read-only merged view of an update: the original document overlaid with the\n * incoming partial patch. Used for validation only — never assign the result\n * back into `data`, or unchanged fields get written back to the database.\n */\nexport function mergeReservationData(\n  data: Record<string, unknown>,\n  originalDoc: Record<string, unknown> | undefined,\n): Record<string, unknown> {\n  return { ...(originalDoc ?? {}), ...(data ?? {}) }\n}\n\nfunction normalizeDate(value: unknown): null | number {\n  if (value === null || value === undefined || value === '') {\n    return null\n  }\n  const time = new Date(value as string).getTime()\n  return Number.isNaN(time) ? null : time\n}\n\nfunction normalizeRelationship(value: unknown): null | string {\n  const id = extractId(value)\n  return id === undefined ? null : String(id)\n}\n\nfunction itemsEqual(a: unknown, b: unknown): boolean {\n  const listA = Array.isArray(a) ? (a as Array<Record<string, unknown>>) : []\n  const listB = Array.isArray(b) ? (b as Array<Record<string, unknown>>) : []\n  if (listA.length !== listB.length) {\n    return false\n  }\n  return listA.every((itemA, i) => {\n    const itemB = listB[i]\n    return (\n      normalizeRelationship(itemA.resource) === normalizeRelationship(itemB.resource) &&\n      normalizeRelationship(itemA.service) === normalizeRelationship(itemB.service) &&\n      normalizeDate(itemA.startTime) === normalizeDate(itemB.startTime) &&\n      normalizeDate(itemA.endTime) === normalizeDate(itemB.endTime) &&\n      ((itemA.guestCount ?? null) as null | number) ===\n        ((itemB.guestCount ?? null) as null | number)\n    )\n  })\n}\n\n/**\n * True when the update patch changes any scheduling-relevant field, or moves\n * status from a non-blocking value into a blocking one (re-occupying a slot).\n * Key presence alone is not a change — full-document admin saves include every\n * field, and a notes-only edit must not trigger re-validation.\n */\nexport function schedulingFieldsChanged({\n  blockingStatuses,\n  data,\n  originalDoc,\n}: {\n  blockingStatuses: string[]\n  data: Record<string, unknown>\n  originalDoc: Record<string, unknown> | undefined\n}): boolean {\n  if (!originalDoc) {\n    return true\n  }\n\n  for (const field of SCHEDULING_FIELDS) {\n    if (!(field in data)) {\n      continue\n    }\n    const next = data[field]\n    const prev = originalDoc[field]\n    let changed: boolean\n    switch (field) {\n      case 'endTime':\n      case 'startTime':\n        changed = normalizeDate(next) !== normalizeDate(prev)\n        break\n      case 'guestCount':\n        changed = ((next ?? null) as null | number) !== ((prev ?? null) as null | number)\n        break\n      case 'items':\n        changed = !itemsEqual(next, prev)\n        break\n      default:\n        changed = normalizeRelationship(next) !== normalizeRelationship(prev)\n    }\n    if (changed) {\n      return true\n    }\n  }\n\n  if ('status' in data && typeof data.status === 'string') {\n    const prevStatus = originalDoc.status as string | undefined\n    if (\n      data.status !== prevStatus &&\n      blockingStatuses.includes(data.status) &&\n      (prevStatus === undefined || !blockingStatuses.includes(prevStatus))\n    ) {\n      return true\n    }\n  }\n\n  return false\n}\n"],"names":["extractId","SCHEDULING_FIELDS","mergeReservationData","data","originalDoc","normalizeDate","value","undefined","time","Date","getTime","Number","isNaN","normalizeRelationship","id","String","itemsEqual","a","b","listA","Array","isArray","listB","length","every","itemA","i","itemB","resource","service","startTime","endTime","guestCount","schedulingFieldsChanged","blockingStatuses","field","next","prev","changed","status","prevStatus","includes"],"mappings":"AAAA,SAASA,SAAS,QAAQ,+BAA8B;AAExD;;;CAGC,GACD,MAAMC,oBAAoB;IACxB;IACA;IACA;IACA;IACA;IACA;CACD;AAED;;;;CAIC,GACD,OAAO,SAASC,qBACdC,IAA6B,EAC7BC,WAAgD;IAEhD,OAAO;QAAE,GAAIA,eAAe,CAAC,CAAC;QAAG,GAAID,QAAQ,CAAC,CAAC;IAAE;AACnD;AAEA,SAASE,cAAcC,KAAc;IACnC,IAAIA,UAAU,QAAQA,UAAUC,aAAaD,UAAU,IAAI;QACzD,OAAO;IACT;IACA,MAAME,OAAO,IAAIC,KAAKH,OAAiBI,OAAO;IAC9C,OAAOC,OAAOC,KAAK,CAACJ,QAAQ,OAAOA;AACrC;AAEA,SAASK,sBAAsBP,KAAc;IAC3C,MAAMQ,KAAKd,UAAUM;IACrB,OAAOQ,OAAOP,YAAY,OAAOQ,OAAOD;AAC1C;AAEA,SAASE,WAAWC,CAAU,EAAEC,CAAU;IACxC,MAAMC,QAAQC,MAAMC,OAAO,CAACJ,KAAMA,IAAuC,EAAE;IAC3E,MAAMK,QAAQF,MAAMC,OAAO,CAACH,KAAMA,IAAuC,EAAE;IAC3E,IAAIC,MAAMI,MAAM,KAAKD,MAAMC,MAAM,EAAE;QACjC,OAAO;IACT;IACA,OAAOJ,MAAMK,KAAK,CAAC,CAACC,OAAOC;QACzB,MAAMC,QAAQL,KAAK,CAACI,EAAE;QACtB,OACEb,sBAAsBY,MAAMG,QAAQ,MAAMf,sBAAsBc,MAAMC,QAAQ,KAC9Ef,sBAAsBY,MAAMI,OAAO,MAAMhB,sBAAsBc,MAAME,OAAO,KAC5ExB,cAAcoB,MAAMK,SAAS,MAAMzB,cAAcsB,MAAMG,SAAS,KAChEzB,cAAcoB,MAAMM,OAAO,MAAM1B,cAAcsB,MAAMI,OAAO,KAC5D,AAAEN,CAAAA,MAAMO,UAAU,IAAI,IAAG,MACrBL,CAAAA,MAAMK,UAAU,IAAI,IAAG;IAE/B;AACF;AAEA;;;;;CAKC,GACD,OAAO,SAASC,wBAAwB,EACtCC,gBAAgB,EAChB/B,IAAI,EACJC,WAAW,EAKZ;IACC,IAAI,CAACA,aAAa;QAChB,OAAO;IACT;IAEA,KAAK,MAAM+B,SAASlC,kBAAmB;QACrC,IAAI,CAAEkC,CAAAA,SAAShC,IAAG,GAAI;YACpB;QACF;QACA,MAAMiC,OAAOjC,IAAI,CAACgC,MAAM;QACxB,MAAME,OAAOjC,WAAW,CAAC+B,MAAM;QAC/B,IAAIG;QACJ,OAAQH;YACN,KAAK;YACL,KAAK;gBACHG,UAAUjC,cAAc+B,UAAU/B,cAAcgC;gBAChD;YACF,KAAK;gBACHC,UAAU,AAAEF,CAAAA,QAAQ,IAAG,MAA2BC,CAAAA,QAAQ,IAAG;gBAC7D;YACF,KAAK;gBACHC,UAAU,CAACtB,WAAWoB,MAAMC;gBAC5B;YACF;gBACEC,UAAUzB,sBAAsBuB,UAAUvB,sBAAsBwB;QACpE;QACA,IAAIC,SAAS;YACX,OAAO;QACT;IACF;IAEA,IAAI,YAAYnC,QAAQ,OAAOA,KAAKoC,MAAM,KAAK,UAAU;QACvD,MAAMC,aAAapC,YAAYmC,MAAM;QACrC,IACEpC,KAAKoC,MAAM,KAAKC,cAChBN,iBAAiBO,QAAQ,CAACtC,KAAKoC,MAAM,KACpCC,CAAAA,eAAejC,aAAa,CAAC2B,iBAAiBO,QAAQ,CAACD,WAAU,GAClE;YACA,OAAO;QACT;IACF;IAEA,OAAO;AACT"}
+{"version":3,"sources":["../../src/utilities/reservationChanges.ts"],"sourcesContent":["import { extractId } from './resolveReservationItems.js'\n\n/**\n * Fields whose change means a reservation's slot occupancy may differ,\n * requiring conflict re-validation and endTime recomputation on update.\n */\nconst SCHEDULING_FIELDS = [\n  'endTime',\n  'guestCount',\n  'items',\n  'resource',\n  'service',\n  'startTime',\n] as const\n\n/**\n * Read-only merged view of an update: the original document overlaid with the\n * incoming partial patch. Used for validation only — never assign the result\n * back into `data`, or unchanged fields get written back to the database.\n */\nexport function mergeReservationData(\n  data: Record<string, unknown>,\n  originalDoc: Record<string, unknown> | undefined,\n): Record<string, unknown> {\n  return { ...(originalDoc ?? {}), ...(data ?? {}) }\n}\n\nfunction normalizeDate(value: unknown): null | number {\n  if (value === null || value === undefined || value === '') {\n    return null\n  }\n  const time = new Date(value as string).getTime()\n  return Number.isNaN(time) ? null : time\n}\n\nfunction normalizeRelationship(value: unknown): null | string {\n  const id = extractId(value)\n  return id === undefined ? null : String(id)\n}\n\nfunction itemsEqual(a: unknown, b: unknown): boolean {\n  const listA = Array.isArray(a) ? (a as Array<Record<string, unknown>>) : []\n  const listB = Array.isArray(b) ? (b as Array<Record<string, unknown>>) : []\n  if (listA.length !== listB.length) {\n    return false\n  }\n  return listA.every((itemA, i) => {\n    const itemB = listB[i]\n    return (\n      normalizeRelationship(itemA.resource) === normalizeRelationship(itemB.resource) &&\n      normalizeRelationship(itemA.service) === normalizeRelationship(itemB.service) &&\n      normalizeDate(itemA.startTime) === normalizeDate(itemB.startTime) &&\n      normalizeDate(itemA.endTime) === normalizeDate(itemB.endTime) &&\n      ((itemA.guestCount ?? null) as null | number) ===\n        ((itemB.guestCount ?? null) as null | number)\n    )\n  })\n}\n\n/**\n * True when the update patch changes any scheduling-relevant field, or moves\n * status from a non-blocking value into a blocking one (re-occupying a slot).\n * Key presence alone is not a change — full-document admin saves include every\n * field, and a notes-only edit must not trigger re-validation.\n */\nexport function schedulingFieldsChanged({\n  blockingStatuses,\n  data,\n  originalDoc,\n}: {\n  /**\n   * Omit to compare scheduling VALUES only, skipping the status clause below.\n   * `validateActive` needs that: a confirm or cancel must stay possible on a\n   * booking whose service or resource was deactivated after it was made.\n   */\n  blockingStatuses?: string[]\n  data: Record<string, unknown>\n  originalDoc: Record<string, unknown> | undefined\n}): boolean {\n  if (!originalDoc) {\n    return true\n  }\n\n  for (const field of SCHEDULING_FIELDS) {\n    if (!(field in data)) {\n      continue\n    }\n    const next = data[field]\n    const prev = originalDoc[field]\n    let changed: boolean\n    switch (field) {\n      case 'endTime':\n      case 'startTime':\n        changed = normalizeDate(next) !== normalizeDate(prev)\n        break\n      case 'guestCount':\n        changed = ((next ?? null) as null | number) !== ((prev ?? null) as null | number)\n        break\n      case 'items':\n        changed = !itemsEqual(next, prev)\n        break\n      default:\n        changed = normalizeRelationship(next) !== normalizeRelationship(prev)\n    }\n    if (changed) {\n      return true\n    }\n  }\n\n  if (blockingStatuses && 'status' in data && typeof data.status === 'string') {\n    const prevStatus = originalDoc.status as string | undefined\n    if (\n      data.status !== prevStatus &&\n      blockingStatuses.includes(data.status) &&\n      (prevStatus === undefined || !blockingStatuses.includes(prevStatus))\n    ) {\n      return true\n    }\n  }\n\n  return false\n}\n"],"names":["extractId","SCHEDULING_FIELDS","mergeReservationData","data","originalDoc","normalizeDate","value","undefined","time","Date","getTime","Number","isNaN","normalizeRelationship","id","String","itemsEqual","a","b","listA","Array","isArray","listB","length","every","itemA","i","itemB","resource","service","startTime","endTime","guestCount","schedulingFieldsChanged","blockingStatuses","field","next","prev","changed","status","prevStatus","includes"],"mappings":"AAAA,SAASA,SAAS,QAAQ,+BAA8B;AAExD;;;CAGC,GACD,MAAMC,oBAAoB;IACxB;IACA;IACA;IACA;IACA;IACA;CACD;AAED;;;;CAIC,GACD,OAAO,SAASC,qBACdC,IAA6B,EAC7BC,WAAgD;IAEhD,OAAO;QAAE,GAAIA,eAAe,CAAC,CAAC;QAAG,GAAID,QAAQ,CAAC,CAAC;IAAE;AACnD;AAEA,SAASE,cAAcC,KAAc;IACnC,IAAIA,UAAU,QAAQA,UAAUC,aAAaD,UAAU,IAAI;QACzD,OAAO;IACT;IACA,MAAME,OAAO,IAAIC,KAAKH,OAAiBI,OAAO;IAC9C,OAAOC,OAAOC,KAAK,CAACJ,QAAQ,OAAOA;AACrC;AAEA,SAASK,sBAAsBP,KAAc;IAC3C,MAAMQ,KAAKd,UAAUM;IACrB,OAAOQ,OAAOP,YAAY,OAAOQ,OAAOD;AAC1C;AAEA,SAASE,WAAWC,CAAU,EAAEC,CAAU;IACxC,MAAMC,QAAQC,MAAMC,OAAO,CAACJ,KAAMA,IAAuC,EAAE;IAC3E,MAAMK,QAAQF,MAAMC,OAAO,CAACH,KAAMA,IAAuC,EAAE;IAC3E,IAAIC,MAAMI,MAAM,KAAKD,MAAMC,MAAM,EAAE;QACjC,OAAO;IACT;IACA,OAAOJ,MAAMK,KAAK,CAAC,CAACC,OAAOC;QACzB,MAAMC,QAAQL,KAAK,CAACI,EAAE;QACtB,OACEb,sBAAsBY,MAAMG,QAAQ,MAAMf,sBAAsBc,MAAMC,QAAQ,KAC9Ef,sBAAsBY,MAAMI,OAAO,MAAMhB,sBAAsBc,MAAME,OAAO,KAC5ExB,cAAcoB,MAAMK,SAAS,MAAMzB,cAAcsB,MAAMG,SAAS,KAChEzB,cAAcoB,MAAMM,OAAO,MAAM1B,cAAcsB,MAAMI,OAAO,KAC5D,AAAEN,CAAAA,MAAMO,UAAU,IAAI,IAAG,MACrBL,CAAAA,MAAMK,UAAU,IAAI,IAAG;IAE/B;AACF;AAEA;;;;;CAKC,GACD,OAAO,SAASC,wBAAwB,EACtCC,gBAAgB,EAChB/B,IAAI,EACJC,WAAW,EAUZ;IACC,IAAI,CAACA,aAAa;QAChB,OAAO;IACT;IAEA,KAAK,MAAM+B,SAASlC,kBAAmB;QACrC,IAAI,CAAEkC,CAAAA,SAAShC,IAAG,GAAI;YACpB;QACF;QACA,MAAMiC,OAAOjC,IAAI,CAACgC,MAAM;QACxB,MAAME,OAAOjC,WAAW,CAAC+B,MAAM;QAC/B,IAAIG;QACJ,OAAQH;YACN,KAAK;YACL,KAAK;gBACHG,UAAUjC,cAAc+B,UAAU/B,cAAcgC;gBAChD;YACF,KAAK;gBACHC,UAAU,AAAEF,CAAAA,QAAQ,IAAG,MAA2BC,CAAAA,QAAQ,IAAG;gBAC7D;YACF,KAAK;gBACHC,UAAU,CAACtB,WAAWoB,MAAMC;gBAC5B;YACF;gBACEC,UAAUzB,sBAAsBuB,UAAUvB,sBAAsBwB;QACpE;QACA,IAAIC,SAAS;YACX,OAAO;QACT;IACF;IAEA,IAAIJ,oBAAoB,YAAY/B,QAAQ,OAAOA,KAAKoC,MAAM,KAAK,UAAU;QAC3E,MAAMC,aAAapC,YAAYmC,MAAM;QACrC,IACEpC,KAAKoC,MAAM,KAAKC,cAChBN,iBAAiBO,QAAQ,CAACtC,KAAKoC,MAAM,KACpCC,CAAAA,eAAejC,aAAa,CAAC2B,iBAAiBO,QAAQ,CAACD,WAAU,GAClE;YACA,OAAO;QACT;IACF;IAEA,OAAO;AACT"}

package/dist/utilities/resolveReservationItems.d.ts

@@ -1,5 +1,7 @@
 export type ResolvedItem = {
     endTime: string;
+    /** True when this item was synthesised from the top-level resource/startTime. */
+    fromParent?: boolean;
     guestCount: number;
     resource: number | string;
     service?: number | string;
@@ -8,13 +10,22 @@ export type ResolvedItem = {
 /**
  * Normalize reservation data into a list of resource-level items.
  *
- * - If items[] is populated -> return items (filling defaults from parent).
+ * - If items[] is populated -> return items (filling defaults from parent), then
+ *   append a synthesised item for the top-level resource/startTime/endTime UNLESS
+ *   an items[] entry can already be shown to cover that same window (see B1 in
+ *   the synthesis step below) — this is what makes the top-level `resource`
+ *   conflict-checked even when items[] never names it.
  *   Items missing startTime or resource throw a ValidationError.
  *   Duplicate (resource, startTime) pairs throw a ValidationError.
+ *   An inverted top-level (parent) window throws a ValidationError too — UNLESS
+ *   `options.lenient` is set, in which case parent synthesis is silently
+ *   skipped instead (see the lenient-mode note below).
  * - If items[] is empty/absent -> return single item from top-level fields
  *
  * Every downstream function (conflict check, endTime calc, availability)
  * works with ResolvedItem[], never with raw reservation data.
  */
-export declare function resolveReservationItems(data: Record<string, unknown>): ResolvedItem[];
+export declare function resolveReservationItems(data: Record<string, unknown>, options?: {
+    lenient?: boolean;
+}): ResolvedItem[];
 export declare function extractId(value: unknown): number | string | undefined;

package/dist/utilities/resolveReservationItems.js

@@ -1,15 +1,24 @@
 import { ValidationError } from 'payload';
+import { doRangesOverlap } from './slotUtils.js';
 /**
  * Normalize reservation data into a list of resource-level items.
  *
- * - If items[] is populated -> return items (filling defaults from parent).
+ * - If items[] is populated -> return items (filling defaults from parent), then
+ *   append a synthesised item for the top-level resource/startTime/endTime UNLESS
+ *   an items[] entry can already be shown to cover that same window (see B1 in
+ *   the synthesis step below) — this is what makes the top-level `resource`
+ *   conflict-checked even when items[] never names it.
  *   Items missing startTime or resource throw a ValidationError.
  *   Duplicate (resource, startTime) pairs throw a ValidationError.
+ *   An inverted top-level (parent) window throws a ValidationError too — UNLESS
+ *   `options.lenient` is set, in which case parent synthesis is silently
+ *   skipped instead (see the lenient-mode note below).
  * - If items[] is empty/absent -> return single item from top-level fields
  *
  * Every downstream function (conflict check, endTime calc, availability)
  * works with ResolvedItem[], never with raw reservation data.
- */ export function resolveReservationItems(data) {
+ */ export function resolveReservationItems(data, options) {
+    const lenient = options?.lenient ?? false;
     const items = data.items;
     if (items && items.length > 0) {
         const resolved = [];
@@ -58,6 +67,82 @@ import { ValidationError } from 'payload';
                 startTime
             });
         }
+        // The stored row occupies its top-level `resource` for every OTHER booking's
+        // conflict check (buildCoarseOverlapQuery matches top level OR items[]), so
+        // it must occupy it for its own check too. Sharing a resource id with an
+        // items[] entry is NOT sufficient to skip synthesis — an items[] entry for
+        // the same resource at an unrelated time is a genuinely separate occupancy,
+        // and treating "same resource anywhere" as "already covered" reopens the
+        // exact double-booking class this function exists to close (a caller can
+        // list resource A at one time in items[] while the top-level fields book A
+        // at a completely different, uncovered time). Synthesis is skipped only
+        // when an items[] entry for the SAME resource can be shown to cover the
+        // SAME window:
+        //  (a) an exact startTime match — needs no endTime, so it still works when
+        //      this function runs before endTime is computed (validateActive and
+        //      calculateEndTime both call it before calculateEndTime has run); or
+        //  (b) both endTimes are known and the windows overlap — covers
+        //      calculateEndTime's multi-resource branch, which can overwrite the
+        //      top-level startTime/endTime to SPAN every item, so by the time this
+        //      function runs again (e.g. from validateConflicts) the parent's
+        //      window no longer starts at the same instant as any one item even
+        //      though that item's own window is fully contained in it.
+        // When neither can be shown, synthesize: a redundant-but-harmless extra
+        // check is far cheaper than a silently missed one.
+        const parentResource = extractId(data.resource);
+        const parentStart = data.startTime;
+        const parentEnd = data.endTime;
+        // An inverted parent window can never overlap anything, so the coverage test
+        // below would always say "not covered" and synthesise a phantom item that
+        // conflicts with nothing. Reject it at the source instead — it is malformed
+        // input, not a case to paper over.
+        //
+        // Lenient mode (reservationOccupancies only — see AvailabilityService.ts)
+        // resolves ALREADY-STORED documents, which can carry an inverted window
+        // from a context.skipReservationHooks write or data predating this check.
+        // A read must never crash over one malformed row, and — critically — it
+        // must not lose the real items[] occupancies already resolved above by
+        // throwing out of this function entirely. So lenient mode just skips
+        // parent synthesis here instead of throwing: precisely the pre-check
+        // behavior minus the (harmless but pointless) phantom item. The write
+        // path never passes `lenient`, so it keeps the hard rejection.
+        if (parentStart && parentEnd && new Date(parentEnd) <= new Date(parentStart)) {
+            if (lenient) {
+                return resolved;
+            }
+            throw new ValidationError({
+                errors: [
+                    {
+                        message: 'endTime must be after startTime',
+                        path: 'endTime'
+                    }
+                ]
+            });
+        }
+        if (parentResource !== undefined && parentResource !== '' && parentStart) {
+            const parentAlreadyItemized = resolved.some((item)=>{
+                // String-compare ids: a raw id (string for Mongo, number for Postgres)
+                // and a populated relationship's extracted `.id` should match even if
+                // one side came through as a different primitive type than the other.
+                if (String(item.resource) !== String(parentResource)) {
+                    return false;
+                }
+                if (item.startTime === parentStart) {
+                    return true;
+                }
+                return Boolean(parentEnd && item.endTime && doRangesOverlap(new Date(parentStart), new Date(parentEnd), new Date(item.startTime), new Date(item.endTime)));
+            });
+            if (!parentAlreadyItemized) {
+                resolved.push({
+                    endTime: parentEnd,
+                    fromParent: true,
+                    guestCount: data.guestCount ?? 1,
+                    resource: parentResource,
+                    service: extractId(data.service),
+                    startTime: parentStart
+                });
+            }
+        }
         return resolved;
     }
     // Single-resource fallback (current behavior)

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: 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"}
+{"version":3,"sources":["../../src/utilities/resolveReservationItems.ts"],"sourcesContent":["import { ValidationError } from 'payload'\n\nimport { doRangesOverlap } from './slotUtils.js'\n\nexport type ResolvedItem = {\n  endTime: string\n  /** True when this item was synthesised from the top-level resource/startTime. */\n  fromParent?: boolean\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), then\n *   append a synthesised item for the top-level resource/startTime/endTime UNLESS\n *   an items[] entry can already be shown to cover that same window (see B1 in\n *   the synthesis step below) — this is what makes the top-level `resource`\n *   conflict-checked even when items[] never names it.\n *   Items missing startTime or resource throw a ValidationError.\n *   Duplicate (resource, startTime) pairs throw a ValidationError.\n *   An inverted top-level (parent) window throws a ValidationError too — UNLESS\n *   `options.lenient` is set, in which case parent synthesis is silently\n *   skipped instead (see the lenient-mode note below).\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(\n  data: Record<string, unknown>,\n  options?: { lenient?: boolean },\n): ResolvedItem[] {\n  const lenient = options?.lenient ?? false\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    // The stored row occupies its top-level `resource` for every OTHER booking's\n    // conflict check (buildCoarseOverlapQuery matches top level OR items[]), so\n    // it must occupy it for its own check too. Sharing a resource id with an\n    // items[] entry is NOT sufficient to skip synthesis — an items[] entry for\n    // the same resource at an unrelated time is a genuinely separate occupancy,\n    // and treating \"same resource anywhere\" as \"already covered\" reopens the\n    // exact double-booking class this function exists to close (a caller can\n    // list resource A at one time in items[] while the top-level fields book A\n    // at a completely different, uncovered time). Synthesis is skipped only\n    // when an items[] entry for the SAME resource can be shown to cover the\n    // SAME window:\n    //  (a) an exact startTime match — needs no endTime, so it still works when\n    //      this function runs before endTime is computed (validateActive and\n    //      calculateEndTime both call it before calculateEndTime has run); or\n    //  (b) both endTimes are known and the windows overlap — covers\n    //      calculateEndTime's multi-resource branch, which can overwrite the\n    //      top-level startTime/endTime to SPAN every item, so by the time this\n    //      function runs again (e.g. from validateConflicts) the parent's\n    //      window no longer starts at the same instant as any one item even\n    //      though that item's own window is fully contained in it.\n    // When neither can be shown, synthesize: a redundant-but-harmless extra\n    // check is far cheaper than a silently missed one.\n    const parentResource = extractId(data.resource)\n    const parentStart = data.startTime as string\n    const parentEnd = data.endTime as string | undefined\n\n    // An inverted parent window can never overlap anything, so the coverage test\n    // below would always say \"not covered\" and synthesise a phantom item that\n    // conflicts with nothing. Reject it at the source instead — it is malformed\n    // input, not a case to paper over.\n    //\n    // Lenient mode (reservationOccupancies only — see AvailabilityService.ts)\n    // resolves ALREADY-STORED documents, which can carry an inverted window\n    // from a context.skipReservationHooks write or data predating this check.\n    // A read must never crash over one malformed row, and — critically — it\n    // must not lose the real items[] occupancies already resolved above by\n    // throwing out of this function entirely. So lenient mode just skips\n    // parent synthesis here instead of throwing: precisely the pre-check\n    // behavior minus the (harmless but pointless) phantom item. The write\n    // path never passes `lenient`, so it keeps the hard rejection.\n    if (parentStart && parentEnd && new Date(parentEnd) <= new Date(parentStart)) {\n      if (lenient) {\n        return resolved\n      }\n      throw new ValidationError({\n        errors: [{ message: 'endTime must be after startTime', path: 'endTime' }],\n      })\n    }\n\n    if (parentResource !== undefined && parentResource !== '' && parentStart) {\n      const parentAlreadyItemized = resolved.some((item) => {\n        // String-compare ids: a raw id (string for Mongo, number for Postgres)\n        // and a populated relationship's extracted `.id` should match even if\n        // one side came through as a different primitive type than the other.\n        if (String(item.resource) !== String(parentResource)) {\n          return false\n        }\n        if (item.startTime === parentStart) {\n          return true\n        }\n        return Boolean(\n          parentEnd &&\n            item.endTime &&\n            doRangesOverlap(\n              new Date(parentStart),\n              new Date(parentEnd),\n              new Date(item.startTime),\n              new Date(item.endTime),\n            ),\n        )\n      })\n\n      if (!parentAlreadyItemized) {\n        resolved.push({\n          endTime: parentEnd as string,\n          fromParent: true,\n          guestCount: (data.guestCount as number) ?? 1,\n          resource: parentResource,\n          service: extractId(data.service),\n          startTime: parentStart,\n        })\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","doRangesOverlap","resolveReservationItems","data","options","lenient","items","length","resolved","seen","Set","i","item","resource","extractId","startTime","undefined","errors","message","path","key","has","add","push","endTime","guestCount","service","parentResource","parentStart","parentEnd","Date","parentAlreadyItemized","some","String","Boolean","fromParent","value","id"],"mappings":"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"}

package/dist/utilities/retryOnWriteConflict.d.ts

@@ -0,0 +1,66 @@
+/**
+ * Retry a write that lost a transaction-level lock race.
+ *
+ * `acquireBookingLock` makes concurrent bookings for one resource contend on a
+ * single document so the database serializes them. On MongoDB the loser does
+ * not wait — it aborts immediately with a WriteConflict. That is correct for a
+ * `quantity: 1` resource (only one booking should win anyway) but wrong for a
+ * `quantity: 3` one, where two more bookings legitimately fit. Measured
+ * without retry: 8 simultaneous bookings against a `quantity: 3` resource
+ * persisted only 1.
+ *
+ * Retrying re-runs the whole operation on a fresh transaction. The retry takes
+ * the lock cleanly, re-reads availability — now seeing the winner's committed
+ * booking — and is admitted or rejected by `validateConflicts` on the merits.
+ */
+/**
+ * Whether an error means "the database refused this transaction because
+ * another one touched the same rows; running it again may succeed."
+ *
+ * Detection is by the driver's own structured signals, never by message text.
+ * MongoDB tags exactly this class with the `TransientTransactionError` label,
+ * which is the retry contract its drivers document; Postgres uses SQLSTATE;
+ * SQLite/libsql use a `code` string in the `SQLITE_BUSY`/`SQLITE_LOCKED*`
+ * family.
+ */
+export declare function isTransientWriteConflict(error: unknown): boolean;
+/**
+ * Run `operation`, retrying only transient write conflicts.
+ *
+ * Every other error — a genuine booking conflict, a validation failure, an
+ * access denial — propagates on the first attempt. Retrying those would turn a
+ * clean rejection into a slow one.
+ *
+ * Backoff is exponential with full jitter, so a burst of losers does not
+ * synchronise into a second stampede on the same document.
+ *
+ * Pass `req` whenever the operation writes through the Payload Local API. Every
+ * attempt re-invokes a closure over the SAME `req`, and Payload's
+ * `initTransaction` JOINS an existing `req.transactionID` rather than opening a
+ * fresh transaction — so a transaction id left behind by a failed attempt would
+ * make the next attempt re-enter a transaction the database already discarded.
+ * Payload's own operations normally clean up after themselves (`killTransaction`
+ * deletes the id from their catch), with one gap they cannot close: when
+ * `beginTransaction` ITSELF rejects, `initTransaction` has already stored the
+ * rejected promise on the req and `killTransaction`'s guard skips promises, so
+ * the req stays poisoned — every later `initTransaction` short-circuits on
+ * `instanceof Promise` and re-throws the first error without touching the
+ * database. Clearing a leftover here closes it. See dev/retryTransaction.spec.ts.
+ *
+ * Do NOT attribute SQLite's "raising the retry budget changes nothing"
+ * measurement to this. That has a different, independent cause: `@payloadcms/
+ * drizzle` rethrows the driver's error as a bare `Error`, so
+ * `isTransientWriteConflict` returns FALSE and this loop throws on attempt 1 —
+ * attempts 2..N never happen, and poisoning never gets a chance to matter. See
+ * README's "Concurrent booking: database adapter support". The shape this
+ * clearing actually protects is any caller that swallows a
+ * begin-transaction failure and then keeps using the same req (see the expiry
+ * sweep in HoldService.takeHold).
+ */
+export declare function retryOnWriteConflict<T>(operation: () => Promise<T>, { attempts, baseDelayMs, req, }?: {
+    attempts?: number;
+    baseDelayMs?: number;
+    req?: {
+        transactionID?: unknown;
+    };
+}): Promise<T>;