@vicacha-devs/strapi-plugin-bookings 0.0.0-stage → 1.0.0

package/LICENSE.md

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Vicacha Devs
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,3 +1,24 @@
-# Temporary Holding Version
+# `@vicacha-devs/strapi-plugin-bookings`
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+Generic **Bookings, Appointments, Resource Scheduling & Time-Slot Availability Engine** for **Strapi v5**, powered by [`@vicacha-devs/strapi-plugin-calendar`](../strapi-plugin-calendar) as a required dependency.
+
+---
+
+## Key Features
+
+- **Bookable Resources & Operating Schedules (`plugin::bookings.resource`)**:
+  - Model any bookable resource: services, consultations, appointments, rooms, staff members, or equipment.
+  - Supports both **interval slicing** (`slotDurationMinutes` + `bufferBeforeMinutes` + `bufferAfterMinutes`) and **named time windows** (`mode: 'window'`, e.g. `morning` `09:00-12:00`, `afternoon` `14:00-17:00`).
+  - Per-slot capacity (`capacityPerSlot`), maximum party size (`maxPartySize`), minimum lead-time hours (`minLeadTimeHours`), maximum advance horizon (`maxAdvanceDays`), seasonal schedule overrides (`seasonalSchedules`), holiday rules (`holidayRules`), and blackout periods (`blackoutDates`).
+- **Reservations & Self-Service Token Workflows (`plugin::bookings.booking`)**:
+  - Atomic capacity and double-booking validation across overlapping slots and buffer windows.
+  - Automatic staff/host assignment matching `preferredLanguage` and real-time slot availability.
+  - Cryptographically generated self-service reschedule & cancel tokens (`SHA-256` hashed at rest, verified with `crypto.timingSafeEqual`).
+- **Dedicated Reservations Approval & Resource Workspace (`/admin/plugins/bookings`) + Unified Calendar Integration**:
+  - **Required Dependency on `@vicacha-devs/strapi-plugin-calendar`**: Automatically registers `plugin::bookings.booking` into the central `/admin/plugins/calendar` registry on server bootstrap so all schedule grid views are unified in one place (with a 1-click **Open in Calendar** shortcut to `/admin/plugins/calendar?source=bookings`).
+  - **Reservations Approval, Resource Filter & Ledger Workspace**: KPI summary cards, bookable resource / status / search filters, the reservations ledger, `BookingSidePanel` for Approve / Reject / Cancel / Complete & staff host assignment, and `+ New Booking` creation modal.
+- **100% Generic & Extensible**:
+  - Extend `resource` and `booking` schemas via `schemaExtensions` in `config/plugins.ts` without forking the plugin.
+  - Map existing Strapi collections into the Bookings Ledger via `sources`.
+- **13-Locale Admin UI**:
+  - Ships with full translations for `en`, `es`, `ar`, `tr`, `fr`, `de`, `pt`, `it`, `nl`, `pl`, `id`, `ur`, and `zh`.

package/dist/admin/App-BrB9n7EO.mjs

@@ -0,0 +1,371 @@
+import { jsxs, jsx } from "react/jsx-runtime";
+import { useNavigate, Routes, Route } from "react-router-dom";
+import { Flex, Button, Box, Typography, Badge, Field, SingleSelect, SingleSelectOption, TextInput } from "@strapi/design-system";
+import { useFetchClient, useNotification, Layouts } from "@strapi/strapi/admin";
+import { useRef, useEffect, useCallback, useState } from "react";
+import { useIntl } from "react-intl";
+import { PLUGIN_ID, BookingsGridCanvas, BookingSidePanel, QuickCreateBookingModal } from "./index.mjs";
+import { g as getTranslation } from "./getTranslation-CZAJyMSt.mjs";
+const EMPTY_STATS = {
+  totalBookings: 0,
+  confirmedBookings: 0,
+  pendingBookings: 0,
+  cancelledBookings: 0,
+  completedBookings: 0,
+  totalGuests: 0,
+  activeResources: 0
+};
+const CalendarPage = () => {
+  const { formatMessage } = useIntl();
+  const navigate = useNavigate();
+  const { get, post, put } = useFetchClient();
+  const { toggleNotification } = useNotification();
+  const isMountedRef = useRef(true);
+  useEffect(() => {
+    isMountedRef.current = true;
+    return () => {
+      isMountedRef.current = false;
+    };
+  }, []);
+  const t = useCallback(
+    (id, defaultMessage) => formatMessage({ id: getTranslation(id), defaultMessage }),
+    [formatMessage]
+  );
+  const [bookings, setBookings] = useState([]);
+  const [resources, setResources] = useState([]);
+  const [stats, setStats] = useState(EMPTY_STATS);
+  const [selectedResourceId, setSelectedResourceId] = useState("");
+  const [selectedStatus, setSelectedStatus] = useState("");
+  const [search, setSearch] = useState("");
+  const [debouncedSearch, setDebouncedSearch] = useState("");
+  const [selectedBooking, setSelectedBooking] = useState(
+    null
+  );
+  const [quickCreateStartIso, setQuickCreateStartIso] = useState(
+    null
+  );
+  useEffect(() => {
+    const timer = setTimeout(() => {
+      if (isMountedRef.current) {
+        setDebouncedSearch(search);
+      }
+    }, 250);
+    return () => clearTimeout(timer);
+  }, [search]);
+  const fetchBookingsData = useCallback(async () => {
+    try {
+      const params = new URLSearchParams();
+      if (selectedResourceId) {
+        params.set("resourceDocumentId", selectedResourceId);
+      }
+      if (selectedStatus) {
+        params.set("status", selectedStatus);
+      }
+      if (debouncedSearch.trim()) {
+        params.set("search", debouncedSearch.trim());
+      }
+      const res = await get(`/${PLUGIN_ID}/calendar?${params.toString()}`);
+      if (!isMountedRef.current) return;
+      const payload = res.data?.data;
+      if (payload) {
+        const nextBookings = payload.bookings ?? [];
+        setBookings(nextBookings);
+        setResources(payload.resources ?? []);
+        setStats(payload.stats ?? EMPTY_STATS);
+        setSelectedBooking((prev) => {
+          if (!prev) return null;
+          return nextBookings.find((b) => b.documentId === prev.documentId) ?? null;
+        });
+      }
+    } catch {
+      if (!isMountedRef.current) return;
+      toggleNotification({
+        type: "danger",
+        message: t("notifications.loadError", "Failed to load bookings")
+      });
+    }
+  }, [
+    get,
+    selectedResourceId,
+    selectedStatus,
+    debouncedSearch,
+    toggleNotification,
+    t
+  ]);
+  useEffect(() => {
+    void fetchBookingsData();
+  }, [fetchBookingsData]);
+  const handleUpdateStatus = async (documentId, status, assignedHost, internalNotes) => {
+    try {
+      const res = await put(
+        `/${PLUGIN_ID}/bookings/${documentId}/status`,
+        {
+          status,
+          assignedHost,
+          internalNotes
+        }
+      );
+      if (isMountedRef.current && res.data?.data) {
+        setSelectedBooking(res.data.data);
+      }
+      toggleNotification({
+        type: "success",
+        message: t("notifications.updated", "Booking updated")
+      });
+      await fetchBookingsData();
+    } catch {
+      toggleNotification({
+        type: "danger",
+        message: t("notifications.updateError", "Failed to update booking")
+      });
+    }
+  };
+  const handleCreateBooking = async (payload) => {
+    try {
+      await post(`/${PLUGIN_ID}/bookings`, payload);
+      toggleNotification({
+        type: "success",
+        message: t("notifications.created", "Booking created")
+      });
+      await fetchBookingsData();
+    } catch (err) {
+      toggleNotification({
+        type: "danger",
+        message: t("notifications.createError", "Failed to create booking")
+      });
+      throw err;
+    }
+  };
+  const handleExportCsv = async () => {
+    try {
+      const params = new URLSearchParams();
+      if (selectedResourceId) {
+        params.set("resourceDocumentId", selectedResourceId);
+      }
+      if (selectedStatus) {
+        params.set("status", selectedStatus);
+      }
+      if (debouncedSearch.trim()) {
+        params.set("search", debouncedSearch.trim());
+      }
+      const qs = params.toString();
+      const url = qs ? `/${PLUGIN_ID}/export.csv?${qs}` : `/${PLUGIN_ID}/export.csv`;
+      const res = await get(url);
+      const csvText = typeof res.data === "string" ? res.data : String(res.data ?? "");
+      const blob = new Blob([csvText], { type: "text/csv;charset=utf-8;" });
+      const objectUrl = URL.createObjectURL(blob);
+      try {
+        const link = document.createElement("a");
+        link.href = objectUrl;
+        link.setAttribute("download", "bookings.csv");
+        document.body.appendChild(link);
+        link.click();
+        document.body.removeChild(link);
+      } finally {
+        URL.revokeObjectURL(objectUrl);
+      }
+    } catch {
+      toggleNotification({
+        type: "danger",
+        message: t("notifications.exportError", "Failed to export CSV")
+      });
+    }
+  };
+  const handleOpenInContentManager = (booking) => {
+    const uid = booking.sourceCollection || "plugin::bookings.booking";
+    navigate(`/content-manager/collection-types/${uid}/${booking.documentId}`);
+  };
+  return /* @__PURE__ */ jsxs(Layouts.Root, { children: [
+    /* @__PURE__ */ jsx(
+      Layouts.Header,
+      {
+        title: t("plugin.title", "Bookings & Slot Availability"),
+        subtitle: t(
+          "plugin.subtitle",
+          "Manage bookable resources, time-slot availability, staff assignment, and reservation approvals. Schedule views are unified in Calendar."
+        ),
+        primaryAction: /* @__PURE__ */ jsxs(Flex, { gap: 2, children: [
+          /* @__PURE__ */ jsx(
+            Button,
+            {
+              variant: "secondary",
+              onClick: () => navigate("/plugins/calendar?source=bookings"),
+              children: t("actions.openUnifiedCalendar", "Open in Calendar")
+            }
+          ),
+          /* @__PURE__ */ jsx(
+            Button,
+            {
+              variant: "tertiary",
+              onClick: () => navigate(`/settings/${PLUGIN_ID}`),
+              children: t("actions.settings", "Settings")
+            }
+          ),
+          /* @__PURE__ */ jsx(Button, { variant: "secondary", onClick: () => void handleExportCsv(), children: t("actions.exportCsv", "Export CSV") }),
+          /* @__PURE__ */ jsx(
+            Button,
+            {
+              variant: "default",
+              onClick: () => setQuickCreateStartIso((/* @__PURE__ */ new Date()).toISOString().slice(0, 10)),
+              children: t("actions.newBooking", "New Booking")
+            }
+          )
+        ] })
+      }
+    ),
+    /* @__PURE__ */ jsxs(Layouts.Content, { children: [
+      /* @__PURE__ */ jsxs(Flex, { direction: "column", alignItems: "stretch", gap: 5, children: [
+        /* @__PURE__ */ jsx(Flex, { gap: 4, wrap: "wrap", children: [
+          {
+            label: t("stats.total", "Total Bookings"),
+            value: stats.totalBookings,
+            badge: "neutral100"
+          },
+          {
+            label: t("stats.confirmed", "Confirmed"),
+            value: stats.confirmedBookings,
+            badge: "success100"
+          },
+          {
+            label: t("stats.pending", "Pending Approval"),
+            value: stats.pendingBookings,
+            badge: "warning100"
+          },
+          {
+            label: t("stats.guests", "Total Guests / Seats"),
+            value: stats.totalGuests,
+            badge: "primary100"
+          },
+          {
+            label: t("stats.resources", "Active Resources"),
+            value: stats.activeResources,
+            badge: "secondary100"
+          }
+        ].map((card) => /* @__PURE__ */ jsx(
+          Box,
+          {
+            background: "neutral0",
+            hasRadius: true,
+            shadow: "tableShadow",
+            padding: 4,
+            style: { flex: "1 1 180px" },
+            children: /* @__PURE__ */ jsxs(Flex, { direction: "column", alignItems: "flex-start", gap: 1, children: [
+              /* @__PURE__ */ jsx(Typography, { variant: "sigma", textColor: "neutral600", children: card.label }),
+              /* @__PURE__ */ jsx(Badge, { backgroundColor: card.badge, children: card.value })
+            ] })
+          },
+          card.label
+        )) }),
+        /* @__PURE__ */ jsx(Box, { background: "neutral0", hasRadius: true, shadow: "tableShadow", padding: 4, children: /* @__PURE__ */ jsxs(
+          "div",
+          {
+            style: {
+              display: "grid",
+              gridTemplateColumns: "repeat(3, minmax(0, 1fr))",
+              gap: 12
+            },
+            children: [
+              /* @__PURE__ */ jsxs(Field.Root, { children: [
+                /* @__PURE__ */ jsx(Field.Label, { children: t("filters.resource", "Bookable Resource") }),
+                /* @__PURE__ */ jsxs(
+                  SingleSelect,
+                  {
+                    placeholder: t("placeholder.all_resources", "All Resources"),
+                    value: selectedResourceId || "all",
+                    onChange: (val) => setSelectedResourceId(
+                      String(val) === "all" ? "" : String(val)
+                    ),
+                    children: [
+                      /* @__PURE__ */ jsx(SingleSelectOption, { value: "all", children: t("filters.allResources", "All Resources") }),
+                      resources.map((res) => /* @__PURE__ */ jsx(
+                        SingleSelectOption,
+                        {
+                          value: res.documentId,
+                          children: res.name
+                        },
+                        res.documentId
+                      ))
+                    ]
+                  }
+                )
+              ] }),
+              /* @__PURE__ */ jsxs(Field.Root, { children: [
+                /* @__PURE__ */ jsx(Field.Label, { children: t("filters.status", "Booking Status") }),
+                /* @__PURE__ */ jsxs(
+                  SingleSelect,
+                  {
+                    placeholder: t("placeholder.all_statuses", "All Statuses"),
+                    value: selectedStatus || "all",
+                    onChange: (val) => setSelectedStatus(String(val) === "all" ? "" : String(val)),
+                    children: [
+                      /* @__PURE__ */ jsx(SingleSelectOption, { value: "all", children: t("filters.allStatuses", "All Statuses") }),
+                      /* @__PURE__ */ jsx(SingleSelectOption, { value: "pending", children: t("page.ui.pending", "PENDING") }),
+                      /* @__PURE__ */ jsx(SingleSelectOption, { value: "confirmed", children: t("page.ui.confirmed", "CONFIRMED") }),
+                      /* @__PURE__ */ jsx(SingleSelectOption, { value: "completed", children: t("page.ui.completed", "COMPLETED") }),
+                      /* @__PURE__ */ jsx(SingleSelectOption, { value: "cancelled", children: t("page.ui.cancelled", "CANCELLED") }),
+                      /* @__PURE__ */ jsx(SingleSelectOption, { value: "no_show", children: t("page.ui.no_show", "NO SHOW") })
+                    ]
+                  }
+                )
+              ] }),
+              /* @__PURE__ */ jsxs(Field.Root, { children: [
+                /* @__PURE__ */ jsx(Field.Label, { children: t("filters.search", "Search Reservations") }),
+                /* @__PURE__ */ jsx(
+                  TextInput,
+                  {
+                    placeholder: t(
+                      "filters.searchPlaceholder",
+                      "Code, customer, host, org..."
+                    ),
+                    value: search,
+                    onChange: (e) => setSearch(e.target.value)
+                  }
+                )
+              ] })
+            ]
+          }
+        ) }),
+        /* @__PURE__ */ jsxs(Flex, { gap: 4, alignItems: "flex-start", children: [
+          /* @__PURE__ */ jsx(Box, { style: { flex: 1, minWidth: 0 }, children: /* @__PURE__ */ jsx(
+            BookingsGridCanvas,
+            {
+              t,
+              bookings,
+              onSelectBooking: (b) => setSelectedBooking(b)
+            }
+          ) }),
+          selectedBooking && /* @__PURE__ */ jsx(
+            BookingSidePanel,
+            {
+              t,
+              booking: selectedBooking,
+              onClose: () => setSelectedBooking(null),
+              onUpdateStatus: handleUpdateStatus,
+              onOpenInContentManager: handleOpenInContentManager
+            }
+          )
+        ] })
+      ] }),
+      /* @__PURE__ */ jsx(
+        QuickCreateBookingModal,
+        {
+          t,
+          isOpen: Boolean(quickCreateStartIso),
+          initialStartIso: quickCreateStartIso || (/* @__PURE__ */ new Date()).toISOString().slice(0, 10),
+          resources,
+          onClose: () => setQuickCreateStartIso(null),
+          onSubmit: handleCreateBooking
+        }
+      )
+    ] })
+  ] });
+};
+const App = () => {
+  return /* @__PURE__ */ jsxs(Routes, { children: [
+    /* @__PURE__ */ jsx(Route, { index: true, element: /* @__PURE__ */ jsx(CalendarPage, {}) }),
+    /* @__PURE__ */ jsx(Route, { path: "*", element: /* @__PURE__ */ jsx(CalendarPage, {}) })
+  ] });
+};
+export {
+  App
+};