payload-reserve 2.3.0 → 3.0.0

package/dist/translations/id.json

@@ -61,6 +61,8 @@
   "errorInvalidTransition": "Tidak dapat berpindah dari \"{{from}}\" ke \"{{to}}\".",
   "errorCancellationNotice": "Pembatalan memerlukan pemberitahuan minimal {{period}} jam. Hanya tersisa {{hours}} jam sebelum janji temu.",
   "errorConflict": "Slot waktu ini berbenturan dengan reservasi yang sudah ada untuk sumber daya ini.",
+  "errorServiceInactive": "Layanan \"{{name}}\" tidak aktif dan tidak dapat dipesan.",
+  "errorResourceInactive": "Sumber daya \"{{name}}\" tidak aktif dan tidak dapat dipesan.",
   "calendarLoading": "Memuat reservasi...",
   "calendarToday": "Hari Ini",
   "calendarCreateNew": "Buat Baru",
@@ -128,8 +130,10 @@
   "filterByResource": "Filter berdasarkan sumber daya",
   "fieldOwner": "Pemilik",
   "fieldResourceType": "Tipe sumber daya",
+  "fieldResources": "Sumber Daya",
+  "fieldResourcesDesc": "Sumber daya yang dapat melakukan layanan ini. Untuk mengubahnya, buka sumber daya dan edit bidang Layanan-nya.",
   "fieldRequiredResources": "Sumber daya yang dibutuhkan",
-  "fieldRequiredResourcesDesc": "Kumpulan sumber daya tambahan yang ditempati oleh setiap pemesanan layanan ini (mis. sebuah kursi). Pemesanan otomatis diperluas untuk menyertakan ini dan diblokir jika ada kumpulan yang penuh.",
+  "fieldRequiredResourcesDesc": "Kumpulan sumber daya tambahan yang ditempati oleh setiap pemesanan layanan ini (mis. sebuah kursi). Pemesanan otomatis diperluas untuk menyertakan ini dan diblokir jika ada kumpulan yang penuh. Ini berbeda dari sumber daya yang dapat melakukan layanan ini — lihat Sumber Daya di atas.",
   "fieldAllowGuestBooking": "Pemesanan tamu",
   "fieldAllowGuestBookingDesc": "Izinkan pemesanan tanpa akun pelanggan. \"Warisi\" menggunakan default tingkat plugin.",
   "guestBookingInherit": "Warisi default plugin",

package/dist/translations/pl.json

@@ -61,6 +61,8 @@
   "errorInvalidTransition": "Nie można przejść ze stanu \"{{from}}\" do \"{{to}}\".",
   "errorCancellationNotice": "Anulowanie wymaga wyprzedzenia co najmniej {{period}} godzin. Do wizyty pozostało tylko {{hours}} godzin.",
   "errorConflict": "Ten przedział czasowy koliduje z istniejącą rezerwacją dla tego zasobu.",
+  "errorServiceInactive": "Usługa „{{name}}\" nie jest aktywna i nie można jej zarezerwować.",
+  "errorResourceInactive": "Zasób „{{name}}\" nie jest aktywny i nie można go zarezerwować.",
   "calendarLoading": "Ładowanie rezerwacji...",
   "calendarToday": "Dziś",
   "calendarCreateNew": "Utwórz nową",
@@ -128,8 +130,10 @@
   "filterByResource": "Filtruj według zasobu",
   "fieldOwner": "Właściciel",
   "fieldResourceType": "Typ zasobu",
+  "fieldResources": "Zasoby",
+  "fieldResourcesDesc": "Zasoby, które mogą wykonać tę usługę. Aby to zmienić, otwórz zasób i edytuj jego pole Usługi.",
   "fieldRequiredResources": "Wymagane zasoby",
-  "fieldRequiredResourcesDesc": "Dodatkowe pule zasobów zajmowane przez każdą rezerwację tej usługi (np. fotel). Rezerwacje są automatycznie rozszerzane o nie i są blokowane, jeśli którakolwiek pula jest pełna.",
+  "fieldRequiredResourcesDesc": "Dodatkowe pule zasobów zajmowane przez każdą rezerwację tej usługi (np. fotel). Rezerwacje są automatycznie rozszerzane o nie i są blokowane, jeśli którakolwiek pula jest pełna. To nie to samo co zasoby, które mogą wykonać tę usługę — zobacz Zasoby powyżej.",
   "fieldAllowGuestBooking": "Rezerwacja gościnna",
   "fieldAllowGuestBookingDesc": "Zezwalaj na rezerwacje bez konta klienta. \"Dziedzicz\" używa domyślnego ustawienia wtyczki.",
   "guestBookingInherit": "Dziedzicz domyślne ustawienie wtyczki",

package/dist/translations/ru.json

@@ -61,6 +61,8 @@
   "errorInvalidTransition": "Невозможно перейти из «{{from}}» в «{{to}}».",
   "errorCancellationNotice": "Для отмены требуется уведомление не менее чем за {{period}} часов. До приёма осталось всего {{hours}} часов.",
   "errorConflict": "Этот временной слот конфликтует с существующим бронированием для данного ресурса.",
+  "errorServiceInactive": "Услуга «{{name}}» неактивна и недоступна для бронирования.",
+  "errorResourceInactive": "Ресурс «{{name}}» неактивен и недоступен для бронирования.",
   "calendarLoading": "Загрузка бронирований...",
   "calendarToday": "Сегодня",
   "calendarCreateNew": "Создать",
@@ -128,8 +130,10 @@
   "filterByResource": "Фильтровать по ресурсу",
   "fieldOwner": "Владелец",
   "fieldResourceType": "Тип ресурса",
+  "fieldResources": "Ресурсы",
+  "fieldResourcesDesc": "Ресурсы, которые могут оказывать эту услугу. Чтобы изменить, откройте ресурс и отредактируйте его поле «Услуги».",
   "fieldRequiredResources": "Необходимые ресурсы",
-  "fieldRequiredResourcesDesc": "Дополнительные пулы ресурсов, которые занимает каждое бронирование этой услуги (например, кресло). Бронирования автоматически расширяются для их включения и блокируются, если какой-либо пул заполнен.",
+  "fieldRequiredResourcesDesc": "Дополнительные пулы ресурсов, которые занимает каждое бронирование этой услуги (например, кресло). Бронирования автоматически расширяются для их включения и блокируются, если какой-либо пул заполнен. Это не то же самое, что ресурсы, которые могут оказывать эту услугу — см. «Ресурсы» выше.",
   "fieldAllowGuestBooking": "Гостевое бронирование",
   "fieldAllowGuestBookingDesc": "Разрешить бронирования без учётной записи клиента. «Наследовать» использует значение по умолчанию на уровне плагина.",
   "guestBookingInherit": "Наследовать значение плагина по умолчанию",

package/dist/translations/tr.json

@@ -61,6 +61,8 @@
   "errorInvalidTransition": "\"{{from}}\" durumundan \"{{to}}\" durumuna geçiş yapılamaz.",
   "errorCancellationNotice": "İptaller en az {{period}} saat önceden bildirim gerektirir. Randevuya yalnızca {{hours}} saat kaldı.",
   "errorConflict": "Bu zaman aralığı, bu kaynak için mevcut bir rezervasyonla çakışıyor.",
+  "errorServiceInactive": "\"{{name}}\" hizmeti aktif değil ve rezerve edilemez.",
+  "errorResourceInactive": "\"{{name}}\" kaynağı aktif değil ve rezerve edilemez.",
   "calendarLoading": "Rezervasyonlar yükleniyor...",
   "calendarToday": "Bugün",
   "calendarCreateNew": "Yeni Oluştur",
@@ -128,8 +130,10 @@
   "filterByResource": "Kaynağa göre filtrele",
   "fieldOwner": "Sahip",
   "fieldResourceType": "Kaynak türü",
+  "fieldResources": "Kaynaklar",
+  "fieldResourcesDesc": "Bu hizmeti verebilecek kaynaklar. Değiştirmek için kaynağı açın ve Hizmetler alanını düzenleyin.",
   "fieldRequiredResources": "Gerekli kaynaklar",
-  "fieldRequiredResourcesDesc": "Bu hizmetin her rezervasyonunun kullandığı ek kaynak havuzları (ör. bir koltuk). Rezervasyonlar bunları içerecek şekilde otomatik genişletilir ve herhangi bir havuz dolarsa engellenir.",
+  "fieldRequiredResourcesDesc": "Bu hizmetin her rezervasyonunun kullandığı ek kaynak havuzları (ör. bir koltuk). Rezervasyonlar bunları içerecek şekilde otomatik genişletilir ve herhangi bir havuz dolarsa engellenir. Bu, hizmeti hangi kaynakların verebileceğiyle aynı şey değildir — yukarıdaki Kaynaklar'a bakın.",
   "fieldAllowGuestBooking": "Misafir rezervasyonu",
   "fieldAllowGuestBookingDesc": "Müşteri hesabı olmadan rezervasyona izin ver. \"Devral\" eklenti düzeyindeki varsayılanı kullanır.",
   "guestBookingInherit": "Eklenti varsayılanını devral",

package/dist/translations/zh.json

@@ -61,6 +61,8 @@
   "errorInvalidTransition": "无法从“{{from}}”转换为“{{to}}”。",
   "errorCancellationNotice": "取消预约至少需要提前 {{period}} 小时通知。距离预约仅剩 {{hours}} 小时。",
   "errorConflict": "此时间段与该资源的现有预约冲突。",
+  "errorServiceInactive": "服务\"{{name}}\"未启用，无法预订。",
+  "errorResourceInactive": "资源\"{{name}}\"未启用，无法预订。",
   "calendarLoading": "正在加载预约……",
   "calendarToday": "今天",
   "calendarCreateNew": "新建",
@@ -128,8 +130,10 @@
   "filterByResource": "按资源筛选",
   "fieldOwner": "负责人",
   "fieldResourceType": "资源类型",
+  "fieldResources": "资源",
+  "fieldResourcesDesc": "可以提供此服务的资源。如需更改，请打开该资源并编辑其\"服务\"字段。",
   "fieldRequiredResources": "必需资源",
-  "fieldRequiredResourcesDesc": "此服务的每次预约都会占用的额外资源池（例如一把座椅）。预约会自动扩展以包含这些资源，若任一资源池已满则会被阻止。",
+  "fieldRequiredResourcesDesc": "此服务的每次预约都会占用的额外资源池（例如一把座椅）。预约会自动扩展以包含这些资源，若任一资源池已满则会被阻止。这与可以提供此服务的资源不是同一回事 — 请参见上方的\"资源\"。",
   "fieldAllowGuestBooking": "访客预约",
   "fieldAllowGuestBookingDesc": "允许无客户账户的预约。“继承”将使用插件级别的默认设置。",
   "guestBookingInherit": "继承插件默认设置",

package/dist/types.d.ts

@@ -162,10 +162,18 @@ export type ReservationPluginConfig = {
         schedules?: CollectionOverride;
         services?: CollectionOverride;
     };
+    /** Emit info-level `reserve_debug` traces for slot generation and conflict detection (default false) */
+    debug?: boolean;
     /** Default buffer time in minutes between reservations */
     defaultBufferTime?: number;
     /** Disable the plugin entirely */
     disabled?: boolean;
+    /**
+     * Reject bookings against an inactive service or resource, and omit them from
+     * availability. Default `true`. Set `false` to restore the previous behaviour
+     * where `active` was advisory and only filtered in the admin UI.
+     */
+    enforceActive?: boolean;
     /** @deprecated Use `collectionOverrides.reservations.fields` instead. Extra fields appended to Reservations. */
     extraReservationFields?: Field[];
     /** Resolve external busy intervals (calendar sync etc.) folded into availability + calendar display. */
@@ -191,9 +199,23 @@ export type ReservationPluginConfig = {
     resourceOwnerMode?: ResourceOwnerModeConfig;
     /** Configurable resourceType vocabulary (default: staff/equipment/room) */
     resourceTypes?: string[];
+    /**
+     * Short-lived slot claims taken while a customer completes checkout.
+     *
+     * Opt-in: when absent, no holds collection is created and availability
+     * behaviour is byte-identical to before. Enabling it makes unexpired holds
+     * occupy their resource in every availability check.
+     */
+    slotHolds?: {
+        enabled?: boolean;
+        /** Minutes a hold survives before it stops occupying its slot. Default 10. */
+        ttlMinutes?: number;
+    };
     /** Override collection slugs */
     slugs?: {
         customers?: string;
+        /** Slug for the slot-holds collection (only created when `slotHolds.enabled`). */
+        holds?: string;
         media?: string;
         reservations?: string;
         resources?: string;
@@ -227,12 +249,17 @@ export type ResolvedReservationPluginConfig = {
         schedules?: CollectionOverride;
         services?: CollectionOverride;
     };
+    debug: boolean;
     defaultBufferTime: number;
     disabled: boolean;
+    enforceActive: boolean;
     extraReservationFields: Field[];
     getExternalBusy: GetExternalBusy | undefined;
     /** Whether the media collection (`slugs.media`) exists — set by the plugin; gates the image upload fields. */
     hasMediaCollection: boolean;
+    /** Set by the plugin once Resources is built: does it still expose a
+     *  top-level `services` relationship for the Services join to target? */
+    hasResourceServicesField: boolean;
     hooks: ReservationPluginHooks;
     leaveTypes: string[];
     localized: boolean;
@@ -243,8 +270,13 @@ export type ResolvedReservationPluginConfig = {
     };
     resourceOwnerMode: ResolvedResourceOwnerModeConfig | undefined;
     resourceTypes: string[];
+    slotHolds: {
+        enabled: boolean;
+        ttlMinutes: number;
+    };
     slugs: {
         customers: string;
+        holds: string;
         media: string;
         reservations: string;
         resources: string;

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  /** 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  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;AA+QD,+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/reserveDebug.d.ts

@@ -0,0 +1,26 @@
+/** Structured fields attached to one debug line. */
+export type ReserveDebugFields = Record<string, unknown>;
+/** Minimal logger surface — Payload's Pino `logger.info(obj, msg?)`. */
+type DebugLogger = {
+    info: (obj: unknown, msg?: string) => void;
+};
+export type ReserveDebug = {
+    /** New instance, same traceId, merging baseFields into every subsequent line. */
+    child: (baseFields: ReserveDebugFields) => ReserveDebug;
+    /** Emit one trace line (no-op when disabled). */
+    dbg: (stage: string, fields?: ReserveDebugFields) => void;
+    enabled: boolean;
+    traceId: string;
+};
+/**
+ * Create a debug tracer. When `enabled`, every `dbg(stage, fields)` emits a
+ * single Pino line:
+ * `logger.info({ event: 'reserve_debug', traceId, stage, ...base, ...fields }, 'reserve_debug')`.
+ * When disabled, `dbg` is an immediate no-op. Emitting at INFO is deliberate:
+ * the opt-in flag is the gate, so traces survive Pino's default info level in
+ * production (a `.debug()` line would be silently dropped there).
+ */
+export declare function createReserveDebug(logger: DebugLogger, enabled: boolean, traceId?: string, baseFields?: ReserveDebugFields): ReserveDebug;
+/** Shared disabled tracer — the default for functions whose `debug` param is omitted. */
+export declare const NOOP_RESERVE_DEBUG: ReserveDebug;
+export {};

package/dist/utilities/reserveDebug.js

@@ -0,0 +1,35 @@
+/** Structured fields attached to one debug line. */ /**
+ * Create a debug tracer. When `enabled`, every `dbg(stage, fields)` emits a
+ * single Pino line:
+ * `logger.info({ event: 'reserve_debug', traceId, stage, ...base, ...fields }, 'reserve_debug')`.
+ * When disabled, `dbg` is an immediate no-op. Emitting at INFO is deliberate:
+ * the opt-in flag is the gate, so traces survive Pino's default info level in
+ * production (a `.debug()` line would be silently dropped there).
+ */ export function createReserveDebug(logger, enabled, traceId, baseFields = {}) {
+    const id = traceId ?? Math.random().toString(36).slice(2, 10);
+    return {
+        child: (extra)=>createReserveDebug(logger, enabled, id, {
+                ...baseFields,
+                ...extra
+            }),
+        dbg: (stage, fields = {})=>{
+            if (!enabled) {
+                return;
+            }
+            logger.info({
+                event: 'reserve_debug',
+                stage,
+                traceId: id,
+                ...baseFields,
+                ...fields
+            }, 'reserve_debug');
+        },
+        enabled,
+        traceId: id
+    };
+}
+/** Shared disabled tracer — the default for functions whose `debug` param is omitted. */ export const NOOP_RESERVE_DEBUG = createReserveDebug({
+    info: ()=>{}
+}, false);
+
+//# sourceMappingURL=reserveDebug.js.map

package/dist/utilities/reserveDebug.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/utilities/reserveDebug.ts"],"sourcesContent":["/** Structured fields attached to one debug line. */\nexport type ReserveDebugFields = Record<string, unknown>\n\n/** Minimal logger surface — Payload's Pino `logger.info(obj, msg?)`. */\ntype DebugLogger = { info: (obj: unknown, msg?: string) => void }\n\nexport type ReserveDebug = {\n  /** New instance, same traceId, merging baseFields into every subsequent line. */\n  child: (baseFields: ReserveDebugFields) => ReserveDebug\n  /** Emit one trace line (no-op when disabled). */\n  dbg: (stage: string, fields?: ReserveDebugFields) => void\n  enabled: boolean\n  traceId: string\n}\n\n/**\n * Create a debug tracer. When `enabled`, every `dbg(stage, fields)` emits a\n * single Pino line:\n * `logger.info({ event: 'reserve_debug', traceId, stage, ...base, ...fields }, 'reserve_debug')`.\n * When disabled, `dbg` is an immediate no-op. Emitting at INFO is deliberate:\n * the opt-in flag is the gate, so traces survive Pino's default info level in\n * production (a `.debug()` line would be silently dropped there).\n */\nexport function createReserveDebug(\n  logger: DebugLogger,\n  enabled: boolean,\n  traceId?: string,\n  baseFields: ReserveDebugFields = {},\n): ReserveDebug {\n  const id = traceId ?? Math.random().toString(36).slice(2, 10)\n  return {\n    child: (extra) => createReserveDebug(logger, enabled, id, { ...baseFields, ...extra }),\n    dbg: (stage, fields = {}) => {\n      if (!enabled) {\n        return\n      }\n      logger.info(\n        { event: 'reserve_debug', stage, traceId: id, ...baseFields, ...fields },\n        'reserve_debug',\n      )\n    },\n    enabled,\n    traceId: id,\n  }\n}\n\n/** Shared disabled tracer — the default for functions whose `debug` param is omitted. */\nexport const NOOP_RESERVE_DEBUG: ReserveDebug = createReserveDebug({ info: () => {} }, false)\n"],"names":["createReserveDebug","logger","enabled","traceId","baseFields","id","Math","random","toString","slice","child","extra","dbg","stage","fields","info","event","NOOP_RESERVE_DEBUG"],"mappings":"AAAA,kDAAkD,GAelD;;;;;;;CAOC,GACD,OAAO,SAASA,mBACdC,MAAmB,EACnBC,OAAgB,EAChBC,OAAgB,EAChBC,aAAiC,CAAC,CAAC;IAEnC,MAAMC,KAAKF,WAAWG,KAAKC,MAAM,GAAGC,QAAQ,CAAC,IAAIC,KAAK,CAAC,GAAG;IAC1D,OAAO;QACLC,OAAO,CAACC,QAAUX,mBAAmBC,QAAQC,SAASG,IAAI;gBAAE,GAAGD,UAAU;gBAAE,GAAGO,KAAK;YAAC;QACpFC,KAAK,CAACC,OAAOC,SAAS,CAAC,CAAC;YACtB,IAAI,CAACZ,SAAS;gBACZ;YACF;YACAD,OAAOc,IAAI,CACT;gBAAEC,OAAO;gBAAiBH;gBAAOV,SAASE;gBAAI,GAAGD,UAAU;gBAAE,GAAGU,MAAM;YAAC,GACvE;QAEJ;QACAZ;QACAC,SAASE;IACX;AACF;AAEA,uFAAuF,GACvF,OAAO,MAAMY,qBAAmCjB,mBAAmB;IAAEe,MAAM,KAAO;AAAE,GAAG,OAAM"}

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;