payload-reserve 1.0.0

package/dist/plugin.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/plugin.ts"],"sourcesContent":["import type { Config, Field } from 'payload'\n\nimport { deepMergeSimple } from 'payload/shared'\n\nimport type { ReservationPluginConfig } from './types.js'\n\nimport { createReservationsCollection } from './collections/Reservations.js'\nimport { createResourcesCollection } from './collections/Resources.js'\nimport { createSchedulesCollection } from './collections/Schedules.js'\nimport { createServicesCollection } from './collections/Services.js'\nimport { resolveConfig } from './defaults.js'\nimport { translations } from './translations/index.js'\n\n/** Check whether a top-level field with the given name already exists */\nconst hasField = (fields: Field[], name: string): boolean =>\n  fields.some((f) => 'name' in f && f.name === name)\n\nexport const reservationPlugin =\n  (pluginOptions: ReservationPluginConfig = {}) =>\n  (config: Config): Config => {\n    const resolved = resolveConfig(pluginOptions)\n\n    // Detect localization from the Payload config\n    if (config.localization) {\n      resolved.localized = true\n    }\n\n    if (!config.collections) {\n      config.collections = []\n    }\n\n    if (resolved.disabled) {\n      return config\n    }\n\n    // Add the 4 plugin collections\n    config.collections.push(\n      createServicesCollection(resolved),\n      createResourcesCollection(resolved),\n      createSchedulesCollection(resolved),\n      createReservationsCollection(resolved),\n    )\n\n    // Extend the existing user collection with customer fields\n    const userCol = config.collections.find((c) => c.slug === resolved.userCollection)\n    if (userCol) {\n      const fieldsToAdd: Field[] = [\n        { name: 'name', type: 'text', maxLength: 200 },\n        { name: 'phone', type: 'text', maxLength: 50 },\n        { name: 'notes', type: 'textarea' },\n        {\n          name: 'bookings',\n          type: 'join',\n          collection: resolved.slugs.reservations,\n          on: 'customer',\n        },\n      ]\n\n      for (const field of fieldsToAdd) {\n        if (!hasField(userCol.fields, (field as { name: string }).name)) {\n          userCol.fields.push(field)\n        }\n      }\n    } else {\n      // eslint-disable-next-line no-console\n      console.warn(\n        `[payload-reserve] Could not find collection \"${resolved.userCollection}\" to extend with customer fields. ` +\n          'Make sure your Payload config defines this collection before the reservation plugin runs.',\n      )\n    }\n\n    // Set up admin configuration\n    if (!config.admin) {config.admin = {}}\n    if (!config.admin.components) {config.admin.components = {}}\n\n    // Store slugs in admin custom for component access\n    if (!config.admin.custom) {config.admin.custom = {}}\n    config.admin.custom.reservationSlugs = {\n      ...resolved.slugs,\n      userCollection: resolved.userCollection,\n    }\n\n    // Add dashboard widget\n    if (!config.admin.dashboard) {\n      config.admin.dashboard = { widgets: [] }\n    }\n    if (!config.admin.dashboard.widgets) {\n      config.admin.dashboard.widgets = []\n    }\n    config.admin.dashboard.widgets.push({\n      slug: 'reservation-todays-reservations',\n      ComponentPath: 'payload-reserve/rsc#DashboardWidgetServer',\n      label: 'Today\\'s Reservations',\n      maxWidth: 'large',\n      minWidth: 'medium',\n    })\n\n    // Add availability overview as custom admin view\n    if (!config.admin.components.views) {\n      config.admin.components.views = {}\n    }\n    ;(config.admin.components.views as Record<string, unknown>)['reservation-availability'] = {\n      Component: 'payload-reserve/client#AvailabilityOverview',\n      path: '/reservation-availability',\n    }\n\n    // Merge plugin translations (user translations take precedence)\n    if (!config.i18n) {config.i18n = {}}\n    ;(config.i18n as Record<string, unknown>).translations = deepMergeSimple(\n      translations,\n      (config.i18n as Record<string, unknown>).translations ?? {},\n    )\n\n    return config\n  }\n"],"names":["deepMergeSimple","createReservationsCollection","createResourcesCollection","createSchedulesCollection","createServicesCollection","resolveConfig","translations","hasField","fields","name","some","f","reservationPlugin","pluginOptions","config","resolved","localization","localized","collections","disabled","push","userCol","find","c","slug","userCollection","fieldsToAdd","type","maxLength","collection","slugs","reservations","on","field","console","warn","admin","components","custom","reservationSlugs","dashboard","widgets","ComponentPath","label","maxWidth","minWidth","views","Component","path","i18n"],"mappings":"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"}

package/dist/translations/en.json

@@ -0,0 +1,86 @@
+{
+  "collectionServices": "Services",
+  "collectionResources": "Resources",
+  "collectionSchedules": "Schedules",
+  "collectionReservations": "Reservations",
+  "fieldName": "Name",
+  "fieldDescription": "Description",
+  "fieldPrice": "Price",
+  "fieldActive": "Active",
+  "fieldServices": "Services",
+  "fieldResource": "Resource",
+  "fieldService": "Service",
+  "fieldCustomer": "Customer",
+  "fieldStartTime": "Start Time",
+  "fieldEndTime": "End Time",
+  "fieldCancellationReason": "Cancellation Reason",
+  "fieldNotes": "Notes",
+  "fieldStatus": "Status",
+  "fieldScheduleType": "Schedule Type",
+  "fieldRecurringSlots": "Recurring Slots",
+  "fieldDay": "Day",
+  "fieldManualSlots": "Manual Slots",
+  "fieldDate": "Date",
+  "fieldExceptions": "Exceptions",
+  "fieldReason": "Reason",
+  "fieldDurationMinutes": "Duration (minutes)",
+  "fieldBufferTimeBefore": "Buffer Time Before (minutes)",
+  "fieldBufferTimeAfter": "Buffer Time After (minutes)",
+  "fieldStartTimeHHmm": "Start Time (HH:mm)",
+  "fieldEndTimeHHmm": "End Time (HH:mm)",
+  "scheduleTypeRecurring": "Recurring",
+  "scheduleTypeManual": "Manual",
+  "dayMonday": "Monday",
+  "dayTuesday": "Tuesday",
+  "dayWednesday": "Wednesday",
+  "dayThursday": "Thursday",
+  "dayFriday": "Friday",
+  "daySaturday": "Saturday",
+  "daySunday": "Sunday",
+  "dayShortSun": "Sun",
+  "dayShortMon": "Mon",
+  "dayShortTue": "Tue",
+  "dayShortWed": "Wed",
+  "dayShortThu": "Thu",
+  "dayShortFri": "Fri",
+  "dayShortSat": "Sat",
+  "statusPending": "Pending",
+  "statusConfirmed": "Confirmed",
+  "statusCompleted": "Completed",
+  "statusCancelled": "Cancelled",
+  "statusNoShow": "No Show",
+  "statusNoShowLabel": "No-show",
+  "errorInvalidCreateStatus": "New reservations must start with {{allowed}} status.",
+  "errorInvalidTransition": "Cannot transition from \"{{from}}\" to \"{{to}}\".",
+  "errorCancellationNotice": "Cancellations require at least {{period}} hours notice. Only {{hours}} hours until the appointment.",
+  "errorConflict": "This time slot conflicts with an existing reservation for this resource.",
+  "calendarLoading": "Loading reservations...",
+  "calendarToday": "Today",
+  "calendarCreateNew": "Create New",
+  "calendarMonth": "Month",
+  "calendarWeek": "Week",
+  "calendarDay": "Day",
+  "calendarUnknownService": "Unknown service",
+  "calendarUnknownCustomer": "Unknown customer",
+  "calendarUnknownResource": "Unknown resource",
+  "tooltipCustomer": "Customer:",
+  "tooltipResource": "Resource:",
+  "tooltipStatus": "Status:",
+  "availabilityLoading": "Loading availability...",
+  "availabilityTitle": "Availability Overview",
+  "availabilityThisWeek": "This Week",
+  "availabilityNoResources": "No active resources found.",
+  "availabilityNotConfigured": "Reservation plugin not configured.",
+  "availabilityBooked": "Booked",
+  "availabilityUnavailable": "Unavailable",
+  "availabilityResource": "Resource",
+  "dashboardTitle": "Today's Reservations",
+  "dashboardTotal": "Total",
+  "dashboardUpcoming": "Upcoming",
+  "dashboardCompleted": "Completed",
+  "dashboardCancelled": "Cancelled",
+  "dashboardNextAppointment": "Next Appointment",
+  "dashboardTime": "Time:",
+  "dashboardStatus": "Status:",
+  "dashboardNoUpcoming": "No upcoming appointments today."
+}

package/dist/translations/index.d.ts

@@ -0,0 +1,3 @@
+export declare const translations: Record<string, Record<string, unknown>>;
+/** Helper type for plugin translation calls (bypasses DefaultTranslationKeys constraint) */
+export type PluginT = (key: string, vars?: Record<string, unknown>) => string;

package/dist/translations/index.js

@@ -0,0 +1,8 @@
+import en from './en.json';
+export const translations = {
+    en: {
+        reservation: en
+    }
+};
+
+//# sourceMappingURL=index.js.map

package/dist/translations/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/translations/index.ts"],"sourcesContent":["import en from './en.json' with { type: 'json' }\n\nexport const translations: Record<string, Record<string, unknown>> = {\n  en: { reservation: en },\n}\n\n/** Helper type for plugin translation calls (bypasses DefaultTranslationKeys constraint) */\nexport type PluginT = (key: string, vars?: Record<string, unknown>) => string\n"],"names":["en","translations","reservation"],"mappings":"AAAA,OAAOA,QAAQ,YAAiC;AAEhD,OAAO,MAAMC,eAAwD;IACnED,IAAI;QAAEE,aAAaF;IAAG;AACxB,EAAC"}

package/dist/types.d.ts

@@ -0,0 +1,51 @@
+import type { CollectionConfig } from 'payload';
+export type ReservationPluginConfig = {
+    /** Override access control per collection */
+    access?: {
+        reservations?: CollectionConfig['access'];
+        resources?: CollectionConfig['access'];
+        schedules?: CollectionConfig['access'];
+        services?: CollectionConfig['access'];
+    };
+    /** Admin group name for all reservation collections */
+    adminGroup?: string;
+    /** Hours of notice required before cancellation */
+    cancellationNoticePeriod?: number;
+    /** Default buffer time in minutes between reservations */
+    defaultBufferTime?: number;
+    /** Disable the plugin entirely */
+    disabled?: boolean;
+    /** Override collection slugs */
+    slugs?: {
+        reservations?: string;
+        resources?: string;
+        schedules?: string;
+        services?: string;
+    };
+    /** Slug of the existing auth collection to extend with customer fields (default: 'users') */
+    userCollection?: string;
+};
+export type ResolvedReservationPluginConfig = {
+    access: {
+        reservations?: CollectionConfig['access'];
+        resources?: CollectionConfig['access'];
+        schedules?: CollectionConfig['access'];
+        services?: CollectionConfig['access'];
+    };
+    adminGroup: string;
+    cancellationNoticePeriod: number;
+    defaultBufferTime: number;
+    disabled: boolean;
+    localized: boolean;
+    slugs: {
+        reservations: string;
+        resources: string;
+        schedules: string;
+        services: string;
+    };
+    userCollection: string;
+};
+export type ReservationStatus = 'cancelled' | 'completed' | 'confirmed' | 'no-show' | 'pending';
+export type DayOfWeek = 'fri' | 'mon' | 'sat' | 'sun' | 'thu' | 'tue' | 'wed';
+export type ScheduleType = 'manual' | 'recurring';
+export declare const VALID_STATUS_TRANSITIONS: Record<ReservationStatus, ReservationStatus[]>;

package/dist/types.js

@@ -0,0 +1,16 @@
+export const VALID_STATUS_TRANSITIONS = {
+    cancelled: [],
+    completed: [],
+    confirmed: [
+        'completed',
+        'cancelled',
+        'no-show'
+    ],
+    'no-show': [],
+    pending: [
+        'confirmed',
+        'cancelled'
+    ]
+};
+
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/types.ts"],"sourcesContent":["import type { CollectionConfig } from 'payload'\n\nexport type ReservationPluginConfig = {\n  /** Override access control per collection */\n  access?: {\n    reservations?: CollectionConfig['access']\n    resources?: CollectionConfig['access']\n    schedules?: CollectionConfig['access']\n    services?: CollectionConfig['access']\n  }\n  /** Admin group name for all reservation collections */\n  adminGroup?: string\n  /** Hours of notice required before cancellation */\n  cancellationNoticePeriod?: number\n  /** Default buffer time in minutes between reservations */\n  defaultBufferTime?: number\n  /** Disable the plugin entirely */\n  disabled?: boolean\n  /** Override collection slugs */\n  slugs?: {\n    reservations?: string\n    resources?: string\n    schedules?: string\n    services?: string\n  }\n  /** Slug of the existing auth collection to extend with customer fields (default: 'users') */\n  userCollection?: string\n}\n\nexport type ResolvedReservationPluginConfig = {\n  access: {\n    reservations?: CollectionConfig['access']\n    resources?: CollectionConfig['access']\n    schedules?: CollectionConfig['access']\n    services?: CollectionConfig['access']\n  }\n  adminGroup: string\n  cancellationNoticePeriod: number\n  defaultBufferTime: number\n  disabled: boolean\n  localized: boolean\n  slugs: {\n    reservations: string\n    resources: string\n    schedules: string\n    services: string\n  }\n  userCollection: string\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\nexport const VALID_STATUS_TRANSITIONS: Record<ReservationStatus, ReservationStatus[]> = {\n  cancelled: [],\n  completed: [],\n  confirmed: ['completed', 'cancelled', 'no-show'],\n  'no-show': [],\n  pending: ['confirmed', 'cancelled'],\n}\n"],"names":["VALID_STATUS_TRANSITIONS","cancelled","completed","confirmed","pending"],"mappings":"AAwDA,OAAO,MAAMA,2BAA2E;IACtFC,WAAW,EAAE;IACbC,WAAW,EAAE;IACbC,WAAW;QAAC;QAAa;QAAa;KAAU;IAChD,WAAW,EAAE;IACbC,SAAS;QAAC;QAAa;KAAY;AACrC,EAAC"}

package/dist/utilities/scheduleUtils.d.ts

@@ -0,0 +1,54 @@
+import type { DayOfWeek } from '../types.js';
+/**
+ * Get the DayOfWeek value for a given Date.
+ */
+export declare function getDayOfWeek(date: Date): DayOfWeek;
+/**
+ * Check if a date string (ISO) matches a DayOfWeek.
+ */
+export declare function dateMatchesDay(date: Date, day: DayOfWeek): boolean;
+/**
+ * Parse a HH:mm time string to hours and minutes.
+ */
+export declare function parseTime(time: string): {
+    hours: number;
+    minutes: number;
+};
+/**
+ * Combine a date (day) with a HH:mm time string into a full Date.
+ */
+export declare function combineDateAndTime(date: Date, time: string): Date;
+/**
+ * Check if a given date is an exception date in the schedule.
+ */
+export declare function isExceptionDate(date: Date, exceptions: Array<{
+    date: string;
+}>): boolean;
+type RecurringSlot = {
+    day: DayOfWeek;
+    endTime: string;
+    startTime: string;
+};
+type ManualSlot = {
+    date: string;
+    endTime: string;
+    startTime: string;
+};
+type Schedule = {
+    active?: boolean;
+    exceptions?: Array<{
+        date: string;
+    }>;
+    manualSlots?: ManualSlot[];
+    recurringSlots?: RecurringSlot[];
+    scheduleType: 'manual' | 'recurring';
+};
+type TimeRange = {
+    end: Date;
+    start: Date;
+};
+/**
+ * Resolve a schedule to concrete available time ranges for a given date.
+ */
+export declare function resolveScheduleForDate(schedule: Schedule, date: Date): TimeRange[];
+export {};

package/dist/utilities/scheduleUtils.js

@@ -0,0 +1,87 @@
+const DAY_MAP = {
+    fri: 5,
+    mon: 1,
+    sat: 6,
+    sun: 0,
+    thu: 4,
+    tue: 2,
+    wed: 3
+};
+/**
+ * Get the DayOfWeek value for a given Date.
+ */ export function getDayOfWeek(date) {
+    const jsDay = date.getDay();
+    const entries = Object.entries(DAY_MAP);
+    const found = entries.find(([, num])=>num === jsDay);
+    return found ? found[0] : 'mon';
+}
+/**
+ * Check if a date string (ISO) matches a DayOfWeek.
+ */ export function dateMatchesDay(date, day) {
+    return date.getDay() === DAY_MAP[day];
+}
+/**
+ * Parse a HH:mm time string to hours and minutes.
+ */ export function parseTime(time) {
+    const [h, m] = time.split(':').map(Number);
+    return {
+        hours: h,
+        minutes: m
+    };
+}
+/**
+ * Combine a date (day) with a HH:mm time string into a full Date.
+ */ export function combineDateAndTime(date, time) {
+    const { hours, minutes } = parseTime(time);
+    const combined = new Date(date);
+    combined.setHours(hours, minutes, 0, 0);
+    return combined;
+}
+/**
+ * Check if a given date is an exception date in the schedule.
+ */ export function isExceptionDate(date, exceptions) {
+    const dateStr = date.toISOString().split('T')[0];
+    return exceptions.some((exc)=>{
+        const excDateStr = new Date(exc.date).toISOString().split('T')[0];
+        return excDateStr === dateStr;
+    });
+}
+/**
+ * Resolve a schedule to concrete available time ranges for a given date.
+ */ export function resolveScheduleForDate(schedule, date) {
+    if (schedule.active === false) {
+        return [];
+    }
+    const exceptions = schedule.exceptions ?? [];
+    if (isExceptionDate(date, exceptions)) {
+        return [];
+    }
+    const ranges = [];
+    if (schedule.scheduleType === 'recurring') {
+        const slots = schedule.recurringSlots ?? [];
+        const dayOfWeek = getDayOfWeek(date);
+        for (const slot of slots){
+            if (slot.day === dayOfWeek) {
+                ranges.push({
+                    end: combineDateAndTime(date, slot.endTime),
+                    start: combineDateAndTime(date, slot.startTime)
+                });
+            }
+        }
+    } else if (schedule.scheduleType === 'manual') {
+        const slots = schedule.manualSlots ?? [];
+        const dateStr = date.toISOString().split('T')[0];
+        for (const slot of slots){
+            const slotDateStr = new Date(slot.date).toISOString().split('T')[0];
+            if (slotDateStr === dateStr) {
+                ranges.push({
+                    end: combineDateAndTime(date, slot.endTime),
+                    start: combineDateAndTime(date, slot.startTime)
+                });
+            }
+        }
+    }
+    return ranges;
+}
+
+//# sourceMappingURL=scheduleUtils.js.map

package/dist/utilities/scheduleUtils.js.map

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

package/dist/utilities/slotUtils.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Add minutes to a date and return a new Date.
+ */
+export declare function addMinutes(date: Date, minutes: number): Date;
+/**
+ * Check if two time ranges overlap.
+ * Ranges are [startA, endA) and [startB, endB) (half-open intervals).
+ */
+export declare function doRangesOverlap(startA: Date, endA: Date, startB: Date, endB: Date): boolean;
+/**
+ * Compute the effective blocked window for a reservation,
+ * applying buffer times before and after.
+ */
+export declare function computeBlockedWindow(startTime: Date, endTime: Date, bufferBefore: number, bufferAfter: number): {
+    effectiveEnd: Date;
+    effectiveStart: Date;
+};
+/**
+ * Calculate hours between now and a future date.
+ */
+export declare function hoursUntil(futureDate: Date, now?: Date): number;

package/dist/utilities/slotUtils.js

@@ -0,0 +1,28 @@
+/**
+ * Add minutes to a date and return a new Date.
+ */ export function addMinutes(date, minutes) {
+    return new Date(date.getTime() + minutes * 60_000);
+}
+/**
+ * Check if two time ranges overlap.
+ * Ranges are [startA, endA) and [startB, endB) (half-open intervals).
+ */ export function doRangesOverlap(startA, endA, startB, endB) {
+    return startA < endB && startB < endA;
+}
+/**
+ * Compute the effective blocked window for a reservation,
+ * applying buffer times before and after.
+ */ export function computeBlockedWindow(startTime, endTime, bufferBefore, bufferAfter) {
+    return {
+        effectiveEnd: addMinutes(endTime, bufferAfter),
+        effectiveStart: addMinutes(startTime, -bufferBefore)
+    };
+}
+/**
+ * Calculate hours between now and a future date.
+ */ export function hoursUntil(futureDate, now) {
+    const reference = now ?? new Date();
+    return (futureDate.getTime() - reference.getTime()) / (1000 * 60 * 60);
+}
+
+//# sourceMappingURL=slotUtils.js.map

package/dist/utilities/slotUtils.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/utilities/slotUtils.ts"],"sourcesContent":["/**\n * Add minutes to a date and return a new Date.\n */\nexport function addMinutes(date: Date, minutes: number): Date {\n  return new Date(date.getTime() + minutes * 60_000)\n}\n\n/**\n * Check if two time ranges overlap.\n * Ranges are [startA, endA) and [startB, endB) (half-open intervals).\n */\nexport function doRangesOverlap(\n  startA: Date,\n  endA: Date,\n  startB: Date,\n  endB: Date,\n): boolean {\n  return startA < endB && startB < endA\n}\n\n/**\n * Compute the effective blocked window for a reservation,\n * applying buffer times before and after.\n */\nexport function computeBlockedWindow(\n  startTime: Date,\n  endTime: Date,\n  bufferBefore: number,\n  bufferAfter: number,\n): { effectiveEnd: Date; effectiveStart: Date } {\n  return {\n    effectiveEnd: addMinutes(endTime, bufferAfter),\n    effectiveStart: addMinutes(startTime, -bufferBefore),\n  }\n}\n\n/**\n * Calculate hours between now and a future date.\n */\nexport function hoursUntil(futureDate: Date, now?: Date): number {\n  const reference = now ?? new Date()\n  return (futureDate.getTime() - reference.getTime()) / (1000 * 60 * 60)\n}\n"],"names":["addMinutes","date","minutes","Date","getTime","doRangesOverlap","startA","endA","startB","endB","computeBlockedWindow","startTime","endTime","bufferBefore","bufferAfter","effectiveEnd","effectiveStart","hoursUntil","futureDate","now","reference"],"mappings":"AAAA;;CAEC,GACD,OAAO,SAASA,WAAWC,IAAU,EAAEC,OAAe;IACpD,OAAO,IAAIC,KAAKF,KAAKG,OAAO,KAAKF,UAAU;AAC7C;AAEA;;;CAGC,GACD,OAAO,SAASG,gBACdC,MAAY,EACZC,IAAU,EACVC,MAAY,EACZC,IAAU;IAEV,OAAOH,SAASG,QAAQD,SAASD;AACnC;AAEA;;;CAGC,GACD,OAAO,SAASG,qBACdC,SAAe,EACfC,OAAa,EACbC,YAAoB,EACpBC,WAAmB;IAEnB,OAAO;QACLC,cAAcf,WAAWY,SAASE;QAClCE,gBAAgBhB,WAAWW,WAAW,CAACE;IACzC;AACF;AAEA;;CAEC,GACD,OAAO,SAASI,WAAWC,UAAgB,EAAEC,GAAU;IACrD,MAAMC,YAAYD,OAAO,IAAIhB;IAC7B,OAAO,AAACe,CAAAA,WAAWd,OAAO,KAAKgB,UAAUhB,OAAO,EAAC,IAAM,CAAA,OAAO,KAAK,EAAC;AACtE"}

package/package.json

@@ -0,0 +1,108 @@
+{
+  "name": "payload-reserve",
+  "version": "1.0.0",
+  "description": "A Payload CMS 3.x plugin for reservation and booking management with conflict detection, status workflows, and calendar UI",
+  "keywords": [
+    "payload",
+    "payloadcms",
+    "plugin",
+    "reservation",
+    "booking",
+    "appointment",
+    "scheduling",
+    "calendar"
+  ],
+  "license": "MIT",
+  "author": "elghaied",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/elghaied/payload-reserve.git"
+  },
+  "homepage": "https://github.com/elghaied/payload-reserve#readme",
+  "bugs": {
+    "url": "https://github.com/elghaied/payload-reserve/issues"
+  },
+  "type": "module",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    },
+    "./client": {
+      "import": "./dist/exports/client.js",
+      "types": "./dist/exports/client.d.ts",
+      "default": "./dist/exports/client.js"
+    },
+    "./rsc": {
+      "import": "./dist/exports/rsc.js",
+      "types": "./dist/exports/rsc.d.ts",
+      "default": "./dist/exports/rsc.js"
+    }
+  },
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "files": [
+    "dist"
+  ],
+  "devDependencies": {
+    "@eslint/eslintrc": "^3.2.0",
+    "@payloadcms/db-mongodb": "3.76.1",
+    "@payloadcms/db-postgres": "3.76.1",
+    "@payloadcms/db-sqlite": "3.76.1",
+    "@payloadcms/eslint-config": "3.9.0",
+    "@payloadcms/next": "3.76.1",
+    "@payloadcms/richtext-lexical": "3.76.1",
+    "@payloadcms/ui": "3.76.1",
+    "@playwright/test": "1.56.1",
+    "@swc-node/register": "1.10.9",
+    "@swc/cli": "0.6.0",
+    "@types/node": "22.19.9",
+    "@types/react": "19.2.9",
+    "@types/react-dom": "19.2.3",
+    "copyfiles": "2.4.1",
+    "cross-env": "^7.0.3",
+    "eslint": "^9.23.0",
+    "eslint-config-next": "15.4.11",
+    "graphql": "^16.8.1",
+    "mongodb-memory-server": "10.1.4",
+    "next": "15.4.11",
+    "open": "^10.1.0",
+    "payload": "3.76.1",
+    "prettier": "^3.4.2",
+    "qs-esm": "7.0.2",
+    "react": "19.2.1",
+    "react-dom": "19.2.1",
+    "rimraf": "3.0.2",
+    "sharp": "0.34.2",
+    "sort-package-json": "^2.10.0",
+    "typescript": "5.7.3",
+    "vite-tsconfig-paths": "6.0.5",
+    "vitest": "4.0.18"
+  },
+  "peerDependencies": {
+    "payload": "^3.76.1"
+  },
+  "engines": {
+    "node": "^18.20.2 || >=20.9.0",
+    "pnpm": "^9 || ^10"
+  },
+  "scripts": {
+    "build": "pnpm copyfiles && pnpm build:types && pnpm build:swc",
+    "build:swc": "swc ./src -d ./dist --config-file .swcrc --strip-leading-paths",
+    "build:types": "tsc --outDir dist --rootDir ./src",
+    "clean": "rimraf {dist,*.tsbuildinfo}",
+    "copyfiles": "copyfiles -u 1 \"src/**/*.{html,css,scss,ttf,woff,woff2,eot,svg,jpg,png,json}\" dist/",
+    "dev": "next dev dev --turbo",
+    "dev:generate-importmap": "pnpm dev:payload generate:importmap",
+    "dev:generate-types": "pnpm dev:payload generate:types",
+    "dev:payload": "cross-env PAYLOAD_CONFIG_PATH=./dev/payload.config.ts payload",
+    "generate:importmap": "pnpm dev:generate-importmap",
+    "generate:types": "pnpm dev:generate-types",
+    "lint": "eslint",
+    "lint:fix": "eslint ./src --fix",
+    "test": "pnpm test:int && pnpm test:e2e",
+    "test:e2e": "playwright test",
+    "test:int": "vitest"
+  }
+}