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

package/dist/shared/pluginId.d.ts

@@ -0,0 +1,2 @@
+export declare const PLUGIN_ID = "bookings";
+export default PLUGIN_ID;

package/dist/shared/slotEngine.d.ts

@@ -0,0 +1,19 @@
+import { DEFAULT_WEEKLY_SCHEDULE, enumerateLocalDatesInRange, extractMonthDay, extractZonedWallClock, formatTimeMinutes, isSlotBlackedOut, matchesDateOrYearlessRange, matchesSingleDateOrYearless, normalizeTimeZone, parsePeriodTimestampInZone, parseTimeMinutes, resolveDailyScheduleForDate, wallClockToUtcMs, ResolvedDailySchedule, ZonedWallClock } from './slotTimezone';
+import { AssignableHost, AvailableSlot, BookingRecord, BookingResource, HolidayScheduleRule, SeasonalScheduleOverride, SecondaryCalendarConfig } from './types';
+export { DEFAULT_WEEKLY_SCHEDULE, enumerateLocalDatesInRange, extractMonthDay, extractZonedWallClock, formatTimeMinutes, isSlotBlackedOut, matchesDateOrYearlessRange, matchesSingleDateOrYearless, normalizeTimeZone, parsePeriodTimestampInZone, parseTimeMinutes, resolveDailyScheduleForDate, wallClockToUtcMs, type ResolvedDailySchedule, type ZonedWallClock, };
+export declare function isActiveBookingStatus(status: BookingRecord["status"]): boolean;
+export declare function doesBookingOverlapSlot(booking: Pick<BookingRecord, "startDate" | "endDate" | "status">, slotStartMs: number, slotEndMs: number, bufferBeforeMinutes?: number, bufferAfterMinutes?: number): boolean;
+export declare function selectAvailableHostsForSlot(resource: BookingResource, overlappingBookings: BookingRecord[], preferredLanguage?: string): AssignableHost[];
+export interface ComputeAvailableSlotsParams {
+    resource: BookingResource;
+    from: string;
+    to: string;
+    existingBookings: BookingRecord[];
+    partySize?: number;
+    preferredLanguage?: string;
+    secondaryCalendars?: SecondaryCalendarConfig[];
+    globalSeasonalSchedules?: SeasonalScheduleOverride[];
+    globalHolidays?: HolidayScheduleRule[];
+    referenceNow?: Date;
+}
+export declare function computeAvailableSlots(params: ComputeAvailableSlotsParams): AvailableSlot[];

package/dist/shared/slotTimezone.d.ts

@@ -0,0 +1,45 @@
+import { BlackoutPeriod, BookingResource, DailyTimeWindow, DayOfWeekKey, HolidayScheduleRule, SeasonalScheduleOverride, WeeklyScheduleConfig } from './types';
+export declare const DEFAULT_WEEKLY_SCHEDULE: WeeklyScheduleConfig;
+export declare function normalizeTimeZone(tz?: string): string;
+export interface ZonedWallClock {
+    year: number;
+    month: number;
+    day: number;
+    dateStr: string;
+    dayKey: DayOfWeekKey;
+    hours: number;
+    minutes: number;
+    seconds: number;
+    ms: number;
+    minutesOfDay: number;
+}
+export declare function extractZonedWallClock(epochMs: number, rawTimeZone?: string): ZonedWallClock;
+export declare function parseIsoDateYmd(dateStr: string): {
+    year: number;
+    month: number;
+    day: number;
+} | null;
+/**
+ * Resolves a local wall-clock `(dateStr, totalMinutes)` in `timeZone` to UTC epoch ms.
+ * When `strictGap` is true, returns `null` if the local wall-clock falls inside a
+ * non-existent Spring-Forward DST transition gap (e.g. 02:30 on US DST start).
+ */
+export declare function wallClockToUtcMs(dateStr: string, totalMinutes: number, rawTimeZone?: string, strictGap?: boolean): number | null;
+export declare function parsePeriodTimestampInZone(raw: string, endOfDay: boolean, rawTimeZone?: string): number;
+export declare function enumerateLocalDatesInRange(rangeStartMs: number, rangeEndMs: number, rawTimeZone?: string, maxDays?: number): Array<{
+    dateStr: string;
+    dayKey: DayOfWeekKey;
+}>;
+export declare function parseTimeMinutes(hhmm: string): number;
+export declare function formatTimeMinutes(totalMinutes: number): string;
+export declare function extractMonthDay(dateOrMmDd: string): string;
+export declare function matchesDateOrYearlessRange(dateStr: string, startStr: string, endStr: string, yearless?: boolean): boolean;
+export declare function matchesSingleDateOrYearless(dateStr: string, ruleDateStr: string, yearless?: boolean): boolean;
+export declare function isSlotBlackedOut(slotStartMs: number, slotEndMs: number, blackoutDates: BlackoutPeriod[], rawTimeZone?: string): boolean;
+export interface ResolvedDailySchedule {
+    mode: "interval" | "window";
+    durationMins: number;
+    windows: DailyTimeWindow[];
+    scheduleLabel?: string;
+}
+export declare function resolveDailyScheduleForDate(dateStr: string, dayKey: DayOfWeekKey, resource: BookingResource, globalSeasonalSchedules?: SeasonalScheduleOverride[], globalHolidays?: HolidayScheduleRule[]): ResolvedDailySchedule;

package/dist/shared/types.d.ts

@@ -0,0 +1,245 @@
+import { AlternateDateValue as SecondaryCalendarDateBadge, CalendarSystemConfig as SecondaryCalendarConfig, CalendarThemePreset, SecondaryCalendarLanguageMode } from '../../strapi-plugin-calendar/shared/index.ts';
+export type { SecondaryCalendarConfig, SecondaryCalendarDateBadge, CalendarThemePreset, SecondaryCalendarLanguageMode, };
+export type BookingResourceType = "service" | "appointment" | "room" | "staff" | "equipment" | "other";
+export type BookingStatus = "pending" | "confirmed" | "completed" | "cancelled" | "no_show";
+export interface DailyTimeWindow {
+    /** Start time in HH:mm (24h), e.g. '09:00' */
+    start: string;
+    /** End time in HH:mm (24h), e.g. '12:00' */
+    end: string;
+    /** Optional named slot label, e.g. 'morning' or 'afternoon' */
+    label?: string;
+    /** Optional slot-specific capacity override */
+    capacity?: number;
+}
+export type DayOfWeekKey = "0" | "1" | "2" | "3" | "4" | "5" | "6";
+export interface WeeklyScheduleConfig {
+    /**
+     * Mode of slot generation:
+     * - 'interval': slices each daily window into `slotDurationMinutes` intervals (e.g. 09:00-10:00, 10:00-11:00)
+     * - 'window': treats each daily window as a single bookable block (e.g. 'morning' 09:00-12:00, 'afternoon' 14:00-17:00)
+     */
+    mode?: "interval" | "window";
+    /** Operating windows keyed by JS UTC day of week ('0'=Sunday ... '6'=Saturday) */
+    days: Partial<Record<DayOfWeekKey, DailyTimeWindow[]>>;
+}
+export interface BlackoutPeriod {
+    /** ISO date ('YYYY-MM-DD'), month-day ('MM-DD' when yearless=true), or ISO datetime string */
+    start: string;
+    /** ISO date ('YYYY-MM-DD'), month-day ('MM-DD' when yearless=true), or ISO datetime string */
+    end: string;
+    /** When true, applies every year on the same MM-DD range (supports cross-year ranges like 12-20 to 01-05) */
+    yearless?: boolean;
+    reason?: string;
+}
+export interface SeasonalScheduleOverride {
+    id?: string;
+    /** Human-readable schedule label, e.g. 'Summer Hours', 'Ramadan Schedule', 'Holiday Season' */
+    label: string;
+    /** ISO date ('YYYY-MM-DD') or month-day ('MM-DD') when yearless=true */
+    startDate: string;
+    /** ISO date ('YYYY-MM-DD') or month-day ('MM-DD') when yearless=true */
+    endDate: string;
+    /** When true, repeats every year on the same month-day range */
+    yearless?: boolean;
+    /** Optional priority when multiple seasonal schedules overlap (higher number wins) */
+    priority?: number;
+    /** Optional slot duration override (in minutes) while this seasonal schedule is active */
+    slotDurationMinutes?: number;
+    /** Weekly schedule active during this date range */
+    schedule: WeeklyScheduleConfig;
+}
+export interface HolidayScheduleRule {
+    id?: string;
+    /** Holiday name, e.g. 'New Year', 'Eid al-Fitr', 'National Holiday' */
+    name: string;
+    /** ISO date ('YYYY-MM-DD') or month-day ('MM-DD') when yearless=true */
+    date: string;
+    /** When true, repeats every year on the same month-day */
+    yearless?: boolean;
+    /** When true (or when windows is empty/omitted), the resource is closed on this holiday */
+    isClosed?: boolean;
+    /** Optional slot generation mode when custom holiday windows are provided */
+    mode?: "interval" | "window";
+    /** Optional reduced/special operating windows when open on a holiday */
+    windows?: DailyTimeWindow[];
+}
+export interface AssignableHost {
+    id: string;
+    name: string;
+    email?: string;
+    languages?: string[];
+    role?: string;
+}
+export interface BookingResource {
+    documentId: string;
+    name: string;
+    slug: string;
+    resourceType: BookingResourceType;
+    description?: string;
+    color: string;
+    timezone: string;
+    slotDurationMinutes: number;
+    bufferBeforeMinutes: number;
+    bufferAfterMinutes: number;
+    capacityPerSlot: number;
+    maxPartySize: number;
+    minLeadTimeHours: number;
+    maxAdvanceDays: number;
+    requiresApproval: boolean;
+    weeklySchedule: WeeklyScheduleConfig;
+    seasonalSchedules?: SeasonalScheduleOverride[];
+    holidayRules?: HolidayScheduleRule[];
+    blackoutDates: BlackoutPeriod[];
+    recurrenceRule?: string;
+    supportedLanguages: string[];
+    assignedHosts: AssignableHost[];
+    location?: string;
+    price?: number;
+    currency?: string;
+    isActive: boolean;
+    metadata?: Record<string, unknown>;
+}
+export interface AvailableSlot {
+    slotId: string;
+    resourceDocumentId: string;
+    resourceName: string;
+    resourceSlug: string;
+    start: string;
+    end: string;
+    date: string;
+    slotLabel: string;
+    scheduleLabel?: string;
+    capacity: number;
+    bookedCount: number;
+    remainingCapacity: number;
+    isAvailable: boolean;
+    availableHosts: AssignableHost[];
+    secondaryDates?: Record<string, SecondaryCalendarDateBadge>;
+}
+export interface BookingRecord {
+    documentId: string;
+    bookingCode: string;
+    title: string;
+    resourceDocumentId?: string;
+    resourceName?: string;
+    resourceColor?: string;
+    customerName: string;
+    customerEmail: string;
+    customerPhone?: string;
+    organization?: string;
+    startDate: string;
+    endDate: string;
+    slotLabel?: string;
+    timezone: string;
+    partySize: number;
+    status: BookingStatus;
+    preferredLanguage?: string;
+    assignedHost?: string;
+    notes?: string;
+    internalNotes?: string;
+    sourceCollection?: string;
+    secondaryDates?: Record<string, SecondaryCalendarDateBadge>;
+    metadata?: Record<string, unknown>;
+    createdAt?: string;
+    updatedAt?: string;
+}
+export interface CreateReservationInput {
+    resourceDocumentId?: string;
+    resourceSlug?: string;
+    customerName: string;
+    customerEmail: string;
+    customerPhone?: string;
+    organization?: string;
+    startDate: string;
+    endDate?: string;
+    slotLabel?: string;
+    timezone?: string;
+    partySize?: number;
+    preferredLanguage?: string;
+    assignedHost?: string;
+    notes?: string;
+    metadata?: Record<string, unknown>;
+}
+export interface CreateReservationResult {
+    booking: BookingRecord;
+    cancelToken: string;
+    waitlisted: boolean;
+}
+export interface RescheduleBookingInput {
+    bookingDocumentId?: string;
+    bookingCode?: string;
+    cancelToken?: string;
+    newStartDate: string;
+    newEndDate?: string;
+    newSlotLabel?: string;
+    partySize?: number;
+}
+export interface CancelBookingInput {
+    bookingDocumentId?: string;
+    bookingCode?: string;
+    cancelToken?: string;
+    reason?: string;
+}
+export interface BookingSourceMapping {
+    id: string;
+    uid: string;
+    label: string;
+    color: string;
+    enabled: boolean;
+    customerNameField: string;
+    customerEmailField?: string;
+    customerPhoneField?: string;
+    organizationField?: string;
+    dateField: string;
+    endDateField?: string;
+    slotLabelField?: string;
+    partySizeField?: string;
+    statusField?: string;
+    languageField?: string;
+    notesField?: string;
+    slotWindows?: Record<string, {
+        start: string;
+        end: string;
+    }>;
+}
+export interface BookingsPluginSettings {
+    theme?: CalendarThemePreset;
+    defaultLocale?: string;
+    secondaryCalendarLanguage?: SecondaryCalendarLanguageMode;
+    defaultTimezone: string;
+    defaultSlotDurationMinutes: number;
+    defaultBufferBeforeMinutes: number;
+    defaultBufferAfterMinutes: number;
+    defaultCapacityPerSlot: number;
+    defaultMinLeadTimeHours: number;
+    defaultMaxAdvanceDays: number;
+    defaultRequiresApproval: boolean;
+    sendEmailNotifications: boolean;
+    secondaryCalendars: SecondaryCalendarConfig[];
+    defaultSeasonalSchedules?: SeasonalScheduleOverride[];
+    holidays?: HolidayScheduleRule[];
+    icalFeedToken?: string;
+    sources: BookingSourceMapping[];
+}
+export interface BookingFilterQuery {
+    from?: string;
+    to?: string;
+    resourceDocumentId?: string;
+    resourceSlug?: string;
+    status?: BookingStatus | "";
+    preferredLanguage?: string;
+    search?: string;
+    source?: string;
+    activeOnly?: boolean;
+    limit?: number;
+}
+export interface BookingStats {
+    totalBookings: number;
+    confirmedBookings: number;
+    pendingBookings: number;
+    cancelledBookings: number;
+    completedBookings: number;
+    totalGuests: number;
+    activeResources: number;
+}

package/package.json

@@ -1,6 +1,114 @@
 {
   "name": "@vicacha-devs/strapi-plugin-bookings",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
+  "version": "1.0.0",
+  "description": "Generic Strapi v5 Bookings, Appointments, Resource Scheduling & Time-Slot Availability Engine powered by @vicacha-devs/strapi-plugin-calendar",
+  "keywords": [
+    "appointments",
+    "availability",
+    "bookings",
+    "calendar",
+    "reservations",
+    "scheduling",
+    "strapi",
+    "strapi-plugin",
+    "strapi-v5",
+    "time-slots"
+  ],
+  "homepage": "https://github.com/Vicacha-Devs/strapi-v5-extensions/tree/main/packages/strapi-plugin-bookings#readme",
+  "bugs": {
+    "url": "https://github.com/Vicacha-Devs/strapi-v5-extensions/issues"
+  },
+  "license": "MIT",
+  "author": "Vicacha Devs",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Vicacha-Devs/strapi-v5-extensions.git",
+    "directory": "packages/strapi-plugin-bookings"
+  },
+  "files": [
+    "dist"
+  ],
+  "exports": {
+    "./package.json": "./package.json",
+    "./strapi-admin": {
+      "types": "./dist/admin/src/index.d.ts",
+      "source": "./admin/src/index.ts",
+      "import": "./dist/admin/index.mjs",
+      "require": "./dist/admin/index.js",
+      "default": "./dist/admin/index.js"
+    },
+    "./strapi-server": {
+      "types": "./dist/server/src/index.d.ts",
+      "source": "./server/src/index.ts",
+      "import": "./dist/server/index.mjs",
+      "require": "./dist/server/index.js",
+      "default": "./dist/server/index.js"
+    },
+    "./shared": {
+      "types": "./dist/shared/index.d.ts",
+      "source": "./shared/index.ts",
+      "import": "./dist/shared/index.mjs",
+      "require": "./dist/shared/index.js",
+      "default": "./dist/shared/index.js"
+    }
+  },
+  "publishConfig": {
+    "access": "public",
+    "provenance": true
+  },
+  "dependencies": {
+    "@strapi/design-system": "2.2.0",
+    "@strapi/icons": "2.2.0",
+    "react-intl": "8.1.3",
+    "@vicacha-devs/strapi-plugin-calendar": "1.1.1"
+  },
+  "devDependencies": {
+    "@strapi/sdk-plugin": "6.1.1",
+    "@strapi/strapi": "5.39.0",
+    "@strapi/typescript-utils": "5.39.0",
+    "@types/node": "22.10.2",
+    "@types/react": "19.2.14",
+    "@types/react-dom": "19.2.3",
+    "react": "18.3.1",
+    "react-dom": "18.3.1",
+    "react-router-dom": "6.30.3",
+    "styled-components": "6.3.11",
+    "typescript": "5.9.3",
+    "vitest": "4.1.0",
+    "@vicacha-devs/eslint-config": "1.0.0",
+    "@vicacha-devs/plugin-shared": "1.0.0",
+    "@vicacha-devs/typescript-config": "1.0.0"
+  },
+  "peerDependencies": {
+    "@strapi/sdk-plugin": "^5.0.0 || ^6.0.0",
+    "@strapi/strapi": "^5.0.0",
+    "@vicacha-devs/strapi-plugin-calendar": "^1.0.0",
+    "react": "^18.0.0",
+    "react-dom": "^18.0.0",
+    "react-router-dom": "^6.0.0",
+    "styled-components": "^6.0.0"
+  },
+  "engines": {
+    "node": ">=20.16.0",
+    "pnpm": ">=10.0.0"
+  },
+  "strapi": {
+    "kind": "plugin",
+    "name": "bookings",
+    "displayName": "Bookings & Scheduling",
+    "description": "Manage bookable resources, operating schedules, time-slot availability, staff assignment, and reservations in Strapi v5 powered by @vicacha-devs/strapi-plugin-calendar"
+  },
+  "scripts": {
+    "build": "strapi-plugin build && node ../../scripts/ensure-dist-types.ts",
+    "clean": "rm -rf dist",
+    "test": "node --import ./tests/register-ts-resolver.ts --test tests/*.test.ts",
+    "test:ts": "npm run test:ts:front && npm run test:ts:back",
+    "test:ts:back": "tsc --noEmit -p server/tsconfig.json",
+    "test:ts:front": "tsc --noEmit -p admin/tsconfig.json",
+    "test:vitest": "vitest run",
+    "test:watch": "vitest",
+    "verify": "strapi-plugin verify",
+    "watch": "strapi-plugin watch",
+    "watch:link": "strapi-plugin watch:link"
+  }
 }