types-salon-management 1.0.50 → 1.0.52

package/dist/api/appointments/appointment.constants.d.ts

@@ -25,12 +25,17 @@ export declare const OccupancyStaffRole: {
 };
 export type OccupancyStaffRole = (typeof OccupancyStaffRole)[keyof typeof OccupancyStaffRole];
 /**
- * Advisory scheduling problems. These never block a booking — double-booking is the
- * only hard conflict, enforced by exclusion constraints and surfaced as 409.
+ * Advisory scheduling problems. None of these block a booking: the caller may proceed by
+ * setting `allowOverlap` on the write request, which is recorded on the occupancy. The
+ * exclusion constraints still reject overlaps that were never acknowledged.
  */
 export declare const SchedulingWarningCode: {
     readonly STAFF_DAY_OFF: "staff_day_off";
     readonly STAFF_OUTSIDE_WORKING_HOURS: "staff_outside_working_hours";
+    readonly STAFF_DOUBLE_BOOKED: "staff_double_booked";
+    readonly RESOURCE_DOUBLE_BOOKED: "resource_double_booked";
+    /** Clash with a staff block rather than a booking; overridable like a double-booking. */
+    readonly STAFF_BLOCKED: "staff_blocked";
 };
 export type SchedulingWarningCode = (typeof SchedulingWarningCode)[keyof typeof SchedulingWarningCode];
 //# sourceMappingURL=appointment.constants.d.ts.map

package/dist/api/appointments/appointment.constants.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"appointment.constants.d.ts","sourceRoot":"","sources":["../../../src/api/appointments/appointment.constants.ts"],"names":[],"mappings":"AAAA,oGAAoG;AACpG,eAAO,MAAM,2BAA2B;;;;;;;;CAQ9B,CAAC;AAEX,MAAM,MAAM,2BAA2B,GACrC,CAAC,OAAO,2BAA2B,CAAC,CAAC,MAAM,OAAO,2BAA2B,CAAC,CAAC;AAEjF,iEAAiE;AACjE,eAAO,MAAM,qBAAqB;;;CAGxB,CAAC;AAEX,MAAM,MAAM,qBAAqB,GAC/B,CAAC,OAAO,qBAAqB,CAAC,CAAC,MAAM,OAAO,qBAAqB,CAAC,CAAC;AAErE,eAAO,MAAM,eAAe;;CAElB,CAAC;AAEX,MAAM,MAAM,eAAe,GAAG,CAAC,OAAO,eAAe,CAAC,CAAC,MAAM,OAAO,eAAe,CAAC,CAAC;AAErF,eAAO,MAAM,kBAAkB;;;CAGrB,CAAC;AAEX,MAAM,MAAM,kBAAkB,GAAG,CAAC,OAAO,kBAAkB,CAAC,CAAC,MAAM,OAAO,kBAAkB,CAAC,CAAC;AAE9F;;;GAGG;AACH,eAAO,MAAM,qBAAqB;;;CAGxB,CAAC;AAEX,MAAM,MAAM,qBAAqB,GAC/B,CAAC,OAAO,qBAAqB,CAAC,CAAC,MAAM,OAAO,qBAAqB,CAAC,CAAC"}
+{"version":3,"file":"appointment.constants.d.ts","sourceRoot":"","sources":["../../../src/api/appointments/appointment.constants.ts"],"names":[],"mappings":"AAAA,oGAAoG;AACpG,eAAO,MAAM,2BAA2B;;;;;;;;CAQ9B,CAAC;AAEX,MAAM,MAAM,2BAA2B,GACrC,CAAC,OAAO,2BAA2B,CAAC,CAAC,MAAM,OAAO,2BAA2B,CAAC,CAAC;AAEjF,iEAAiE;AACjE,eAAO,MAAM,qBAAqB;;;CAGxB,CAAC;AAEX,MAAM,MAAM,qBAAqB,GAC/B,CAAC,OAAO,qBAAqB,CAAC,CAAC,MAAM,OAAO,qBAAqB,CAAC,CAAC;AAErE,eAAO,MAAM,eAAe;;CAElB,CAAC;AAEX,MAAM,MAAM,eAAe,GAAG,CAAC,OAAO,eAAe,CAAC,CAAC,MAAM,OAAO,eAAe,CAAC,CAAC;AAErF,eAAO,MAAM,kBAAkB;;;CAGrB,CAAC;AAEX,MAAM,MAAM,kBAAkB,GAAG,CAAC,OAAO,kBAAkB,CAAC,CAAC,MAAM,OAAO,kBAAkB,CAAC,CAAC;AAE9F;;;;GAIG;AACH,eAAO,MAAM,qBAAqB;;;;;IAKhC,yFAAyF;;CAEjF,CAAC;AAEX,MAAM,MAAM,qBAAqB,GAC/B,CAAC,OAAO,qBAAqB,CAAC,CAAC,MAAM,OAAO,qBAAqB,CAAC,CAAC"}

package/dist/api/appointments/appointment.constants.js

@@ -24,11 +24,16 @@ exports.OccupancyStaffRole = {
     ASSISTANT: 'assistant',
 };
 /**
- * Advisory scheduling problems. These never block a booking — double-booking is the
- * only hard conflict, enforced by exclusion constraints and surfaced as 409.
+ * Advisory scheduling problems. None of these block a booking: the caller may proceed by
+ * setting `allowOverlap` on the write request, which is recorded on the occupancy. The
+ * exclusion constraints still reject overlaps that were never acknowledged.
  */
 exports.SchedulingWarningCode = {
     STAFF_DAY_OFF: 'staff_day_off',
     STAFF_OUTSIDE_WORKING_HOURS: 'staff_outside_working_hours',
+    STAFF_DOUBLE_BOOKED: 'staff_double_booked',
+    RESOURCE_DOUBLE_BOOKED: 'resource_double_booked',
+    /** Clash with a staff block rather than a booking; overridable like a double-booking. */
+    STAFF_BLOCKED: 'staff_blocked',
 };
 //# sourceMappingURL=appointment.constants.js.map

package/dist/api/appointments/appointment.constants.js.map

@@ -1 +1 @@
-{"version":3,"file":"appointment.constants.js","sourceRoot":"","sources":["../../../src/api/appointments/appointment.constants.ts"],"names":[],"mappings":";;;AAAA,oGAAoG;AACvF,QAAA,2BAA2B,GAAG;IACzC,GAAG,EAAE,KAAK;IACV,SAAS,EAAE,WAAW;IACtB,OAAO,EAAE,SAAS;IAClB,OAAO,EAAE,SAAS;IAClB,SAAS,EAAE,WAAW;IACtB,SAAS,EAAE,WAAW;IACtB,OAAO,EAAE,SAAS;CACV,CAAC;AAKX,iEAAiE;AACpD,QAAA,qBAAqB,GAAG;IACnC,OAAO,EAAE,SAAS;IAClB,QAAQ,EAAE,UAAU;CACZ,CAAC;AAKE,QAAA,eAAe,GAAG;IAC7B,OAAO,EAAE,SAAS;CACV,CAAC;AAIE,QAAA,kBAAkB,GAAG;IAChC,OAAO,EAAE,SAAS;IAClB,SAAS,EAAE,WAAW;CACd,CAAC;AAIX;;;GAGG;AACU,QAAA,qBAAqB,GAAG;IACnC,aAAa,EAAE,eAAe;IAC9B,2BAA2B,EAAE,6BAA6B;CAClD,CAAC"}
+{"version":3,"file":"appointment.constants.js","sourceRoot":"","sources":["../../../src/api/appointments/appointment.constants.ts"],"names":[],"mappings":";;;AAAA,oGAAoG;AACvF,QAAA,2BAA2B,GAAG;IACzC,GAAG,EAAE,KAAK;IACV,SAAS,EAAE,WAAW;IACtB,OAAO,EAAE,SAAS;IAClB,OAAO,EAAE,SAAS;IAClB,SAAS,EAAE,WAAW;IACtB,SAAS,EAAE,WAAW;IACtB,OAAO,EAAE,SAAS;CACV,CAAC;AAKX,iEAAiE;AACpD,QAAA,qBAAqB,GAAG;IACnC,OAAO,EAAE,SAAS;IAClB,QAAQ,EAAE,UAAU;CACZ,CAAC;AAKE,QAAA,eAAe,GAAG;IAC7B,OAAO,EAAE,SAAS;CACV,CAAC;AAIE,QAAA,kBAAkB,GAAG;IAChC,OAAO,EAAE,SAAS;IAClB,SAAS,EAAE,WAAW;CACd,CAAC;AAIX;;;;GAIG;AACU,QAAA,qBAAqB,GAAG;IACnC,aAAa,EAAE,eAAe;IAC9B,2BAA2B,EAAE,6BAA6B;IAC1D,mBAAmB,EAAE,qBAAqB;IAC1C,sBAAsB,EAAE,wBAAwB;IAChD,yFAAyF;IACzF,aAAa,EAAE,eAAe;CACtB,CAAC"}

package/dist/api/appointments/book-appointment.request.d.ts

@@ -14,5 +14,10 @@ export interface BookAppointmentRequest {
     clientEmail?: string | null;
     notes?: string | null;
     items: BookAppointmentItemRequest[];
+    /**
+     * Set once the user has seen a clash and chosen to double-book anyway. Without it the
+     * exclusion constraints reject the overlap with a 409.
+     */
+    allowOverlap?: boolean;
 }
 //# sourceMappingURL=book-appointment.request.d.ts.map

package/dist/api/appointments/book-appointment.request.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"book-appointment.request.d.ts","sourceRoot":"","sources":["../../../src/api/appointments/book-appointment.request.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,iCAAiC,CAAC;AAExE,MAAM,WAAW,0BAA0B;IACzC,gBAAgB,EAAE,MAAM,CAAC;IACzB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,sBAAsB;IACrC,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,iBAAiB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAClC,WAAW,CAAC,EAAE,gBAAgB,GAAG,IAAI,CAAC;IACtC,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,KAAK,EAAE,0BAA0B,EAAE,CAAC;CACrC"}
+{"version":3,"file":"book-appointment.request.d.ts","sourceRoot":"","sources":["../../../src/api/appointments/book-appointment.request.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,iCAAiC,CAAC;AAExE,MAAM,WAAW,0BAA0B;IACzC,gBAAgB,EAAE,MAAM,CAAC;IACzB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,sBAAsB;IACrC,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,iBAAiB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAClC,WAAW,CAAC,EAAE,gBAAgB,GAAG,IAAI,CAAC;IACtC,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,KAAK,EAAE,0BAA0B,EAAE,CAAC;IACpC;;;OAGG;IACH,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB"}

package/dist/api/appointments/check-scheduling.request.d.ts

@@ -4,18 +4,24 @@ export interface CheckSchedulingSlotRequest {
     serviceVariantId?: string;
     staffId: string;
     staffId2?: string;
+    resourceId?: string;
     startAt: string;
     endAt?: string;
 }
 export interface CheckSchedulingRequest {
     locationId: string;
     slots: CheckSchedulingSlotRequest[];
+    /** Occupancies of this item are ignored, so rescheduling never clashes with itself. */
+    excludeAppointmentItemId?: string;
+    /** Same, for a staff block being moved or resized. */
+    excludeStaffBlockId?: string;
 }
 export interface SchedulingWarningDto {
     code: SchedulingWarningCode;
     /** Ready-to-display sentence; the server owns the wording. */
     message: string;
-    staffId: string;
+    /** Null for resource clashes, which aren't tied to a staff member. */
+    staffId: string | null;
     staffName: string | null;
     startAt: string;
     endAt: string;

package/dist/api/appointments/check-scheduling.request.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"check-scheduling.request.d.ts","sourceRoot":"","sources":["../../../src/api/appointments/check-scheduling.request.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAC;AAErE,gGAAgG;AAChG,MAAM,WAAW,0BAA0B;IACzC,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,sBAAsB;IACrC,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,0BAA0B,EAAE,CAAC;CACrC;AAED,MAAM,WAAW,oBAAoB;IACnC,IAAI,EAAE,qBAAqB,CAAC;IAC5B,8DAA8D;IAC9D,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,uBAAuB;IACtC,QAAQ,EAAE,oBAAoB,EAAE,CAAC;CAClC"}
+{"version":3,"file":"check-scheduling.request.d.ts","sourceRoot":"","sources":["../../../src/api/appointments/check-scheduling.request.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAC;AAErE,gGAAgG;AAChG,MAAM,WAAW,0BAA0B;IACzC,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,sBAAsB;IACrC,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,0BAA0B,EAAE,CAAC;IACpC,uFAAuF;IACvF,wBAAwB,CAAC,EAAE,MAAM,CAAC;IAClC,sDAAsD;IACtD,mBAAmB,CAAC,EAAE,MAAM,CAAC;CAC9B;AAED,MAAM,WAAW,oBAAoB;IACnC,IAAI,EAAE,qBAAqB,CAAC;IAC5B,8DAA8D;IAC9D,OAAO,EAAE,MAAM,CAAC;IAChB,sEAAsE;IACtE,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,uBAAuB;IACtC,QAAQ,EAAE,oBAAoB,EAAE,CAAC;CAClC"}

package/dist/api/appointments/reschedule-item.request.d.ts

@@ -1,10 +1,16 @@
-import type { OccupancyStaffRole } from './appointment.constants';
 export interface RescheduleItemRequest {
     startAt: string;
     endAt: string;
+    /** New primary staff; omit to leave unchanged. */
     staffId?: string;
+    /** New assistant staff for two-staff services; omit to leave unchanged. */
     staffId2?: string;
+    /** New room; omit or null to leave unchanged. */
     resourceId?: string | null;
-    staffRole?: OccupancyStaffRole;
+    /**
+     * Set once the user has seen a clash and chosen to double-book anyway. Without it the
+     * exclusion constraints reject the overlap with a 409.
+     */
+    allowOverlap?: boolean;
 }
 //# sourceMappingURL=reschedule-item.request.d.ts.map

package/dist/api/appointments/reschedule-item.request.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"reschedule-item.request.d.ts","sourceRoot":"","sources":["../../../src/api/appointments/reschedule-item.request.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAElE,MAAM,WAAW,qBAAqB;IACpC,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,SAAS,CAAC,EAAE,kBAAkB,CAAC;CAChC"}
+{"version":3,"file":"reschedule-item.request.d.ts","sourceRoot":"","sources":["../../../src/api/appointments/reschedule-item.request.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,qBAAqB;IACpC,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,kDAAkD;IAClD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,2EAA2E;IAC3E,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,iDAAiD;IACjD,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B;;;OAGG;IACH,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB"}

package/dist/api/calendar/calendar.dto.d.ts

@@ -24,11 +24,35 @@ export interface CalendarOccupancyDto {
     durationMinutes: number;
     durationSegments: AppointmentItemDurationSegmentDto[];
 }
+/**
+ * A staff block on the calendar. Kept separate from `CalendarOccupancyDto` because a
+ * block has no client, service or status — sharing one shape would mean a dozen
+ * meaningless nulls per row.
+ */
+export interface CalendarStaffBlockDto {
+    occupancyId: string;
+    staffBlockId: string;
+    locationId: string;
+    staffId: string | null;
+    staffName: string | null;
+    title: string;
+    notes: string | null;
+    allowsOnlineBooking: boolean;
+    startAt: string;
+    endAt: string;
+}
+/** SSE `calendar.changed` payload; tells other sessions which location's feed is stale. */
+export interface CalendarChangedEvent {
+    locationId: string;
+    changeType: 'book' | 'reschedule' | 'staff_block';
+    entityId: string;
+}
 export interface CalendarFeedDto {
     locationId: string;
     from: string;
     to: string;
     occupancies: CalendarOccupancyDto[];
+    staffBlocks: CalendarStaffBlockDto[];
     closures: LocationClosureDto[];
 }
 //# sourceMappingURL=calendar.dto.d.ts.map

package/dist/api/calendar/calendar.dto.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"calendar.dto.d.ts","sourceRoot":"","sources":["../../../src/api/calendar/calendar.dto.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,2CAA2C,CAAC;AACpF,OAAO,KAAK,EAAE,iCAAiC,EAAE,MAAM,iCAAiC,CAAC;AACzF,OAAO,KAAK,EAAE,2BAA2B,EAAE,kBAAkB,EAAE,MAAM,uCAAuC,CAAC;AAE7G,MAAM,WAAW,oBAAoB;IACnC,WAAW,EAAE,MAAM,CAAC;IACpB,aAAa,EAAE,MAAM,CAAC;IACtB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,SAAS,EAAE,kBAAkB,GAAG,IAAI,CAAC;IACrC,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,iBAAiB,EAAE,MAAM,GAAG,IAAI,CAAC;IACjC,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,yEAAyE;IACzE,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,MAAM,EAAE,2BAA2B,CAAC;IACpC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,iBAAiB,EAAE,OAAO,CAAC;IAC3B,eAAe,EAAE,MAAM,CAAC;IACxB,gBAAgB,EAAE,iCAAiC,EAAE,CAAC;CACvD;AAED,MAAM,WAAW,eAAe;IAC9B,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,MAAM,CAAC;IACX,WAAW,EAAE,oBAAoB,EAAE,CAAC;IACpC,QAAQ,EAAE,kBAAkB,EAAE,CAAC;CAChC"}
+{"version":3,"file":"calendar.dto.d.ts","sourceRoot":"","sources":["../../../src/api/calendar/calendar.dto.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,2CAA2C,CAAC;AACpF,OAAO,KAAK,EAAE,iCAAiC,EAAE,MAAM,iCAAiC,CAAC;AACzF,OAAO,KAAK,EAAE,2BAA2B,EAAE,kBAAkB,EAAE,MAAM,uCAAuC,CAAC;AAE7G,MAAM,WAAW,oBAAoB;IACnC,WAAW,EAAE,MAAM,CAAC;IACpB,aAAa,EAAE,MAAM,CAAC;IACtB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,SAAS,EAAE,kBAAkB,GAAG,IAAI,CAAC;IACrC,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,iBAAiB,EAAE,MAAM,GAAG,IAAI,CAAC;IACjC,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,yEAAyE;IACzE,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,MAAM,EAAE,2BAA2B,CAAC;IACpC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,iBAAiB,EAAE,OAAO,CAAC;IAC3B,eAAe,EAAE,MAAM,CAAC;IACxB,gBAAgB,EAAE,iCAAiC,EAAE,CAAC;CACvD;AAED;;;;GAIG;AACH,MAAM,WAAW,qBAAqB;IACpC,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,mBAAmB,EAAE,OAAO,CAAC;IAC7B,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;CACf;AAED,2FAA2F;AAC3F,MAAM,WAAW,oBAAoB;IACnC,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,GAAG,YAAY,GAAG,aAAa,CAAC;IAClD,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,eAAe;IAC9B,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,MAAM,CAAC;IACX,WAAW,EAAE,oBAAoB,EAAE,CAAC;IACpC,WAAW,EAAE,qBAAqB,EAAE,CAAC;IACrC,QAAQ,EAAE,kBAAkB,EAAE,CAAC;CAChC"}

package/dist/api/index.d.ts

@@ -10,6 +10,7 @@ export * from './gst-number/index';
 export * from './cancellation-reason';
 export * from './location-closures/index';
 export * from './appointments/index';
+export * from './staff-blocks/index';
 export * from './calendar/index';
 export * from './location';
 export * from './platform-terms';

package/dist/api/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/api/index.ts"],"names":[],"mappings":"AAAA,qEAAqE;AACrE,cAAc,SAAS,CAAC;AACxB,cAAc,WAAW,CAAC;AAC1B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,cAAc,CAAC;AAC7B,cAAc,UAAU,CAAC;AACzB,cAAc,cAAc,CAAC;AAC7B,cAAc,aAAa,CAAC;AAC5B,cAAc,oBAAoB,CAAC;AACnC,cAAc,uBAAuB,CAAC;AACtC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,sBAAsB,CAAC;AACrC,cAAc,kBAAkB,CAAC;AACjC,cAAc,YAAY,CAAC;AAC3B,cAAc,kBAAkB,CAAC;AACjC,cAAc,cAAc,CAAC;AAC7B,cAAc,0BAA0B,CAAC;AACzC,cAAc,mBAAmB,CAAC;AAClC,cAAc,eAAe,CAAC;AAC9B,cAAc,sBAAsB,CAAC;AACrC,cAAc,mBAAmB,CAAC;AAClC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,4BAA4B,CAAC;AAC3C,cAAc,kBAAkB,CAAC;AACjC,cAAc,wBAAwB,CAAC;AACvC,cAAc,oBAAoB,CAAC;AACnC,cAAc,qBAAqB,CAAC;AACpC,cAAc,yBAAyB,CAAC;AACxC,cAAc,iBAAiB,CAAC;AAChC,cAAc,kBAAkB,CAAC;AACjC,cAAc,8BAA8B,CAAC;AAC7C,cAAc,oBAAoB,CAAC;AACnC,cAAc,4BAA4B,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/api/index.ts"],"names":[],"mappings":"AAAA,qEAAqE;AACrE,cAAc,SAAS,CAAC;AACxB,cAAc,WAAW,CAAC;AAC1B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,cAAc,CAAC;AAC7B,cAAc,UAAU,CAAC;AACzB,cAAc,cAAc,CAAC;AAC7B,cAAc,aAAa,CAAC;AAC5B,cAAc,oBAAoB,CAAC;AACnC,cAAc,uBAAuB,CAAC;AACtC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,sBAAsB,CAAC;AACrC,cAAc,sBAAsB,CAAC;AACrC,cAAc,kBAAkB,CAAC;AACjC,cAAc,YAAY,CAAC;AAC3B,cAAc,kBAAkB,CAAC;AACjC,cAAc,cAAc,CAAC;AAC7B,cAAc,0BAA0B,CAAC;AACzC,cAAc,mBAAmB,CAAC;AAClC,cAAc,eAAe,CAAC;AAC9B,cAAc,sBAAsB,CAAC;AACrC,cAAc,mBAAmB,CAAC;AAClC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,4BAA4B,CAAC;AAC3C,cAAc,kBAAkB,CAAC;AACjC,cAAc,wBAAwB,CAAC;AACvC,cAAc,oBAAoB,CAAC;AACnC,cAAc,qBAAqB,CAAC;AACpC,cAAc,yBAAyB,CAAC;AACxC,cAAc,iBAAiB,CAAC;AAChC,cAAc,kBAAkB,CAAC;AACjC,cAAc,8BAA8B,CAAC;AAC7C,cAAc,oBAAoB,CAAC;AACnC,cAAc,4BAA4B,CAAC"}

package/dist/api/index.js

@@ -26,6 +26,7 @@ __exportStar(require("./gst-number/index"), exports);
 __exportStar(require("./cancellation-reason"), exports);
 __exportStar(require("./location-closures/index"), exports);
 __exportStar(require("./appointments/index"), exports);
+__exportStar(require("./staff-blocks/index"), exports);
 __exportStar(require("./calendar/index"), exports);
 __exportStar(require("./location"), exports);
 __exportStar(require("./platform-terms"), exports);

package/dist/api/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/api/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,qEAAqE;AACrE,0CAAwB;AACxB,4CAA0B;AAC1B,iDAA+B;AAC/B,+CAA6B;AAC7B,2CAAyB;AACzB,+CAA6B;AAC7B,8CAA4B;AAC5B,qDAAmC;AACnC,wDAAsC;AACtC,4DAA0C;AAC1C,uDAAqC;AACrC,mDAAiC;AACjC,6CAA2B;AAC3B,mDAAiC;AACjC,+CAA6B;AAC7B,2DAAyC;AACzC,oDAAkC;AAClC,gDAA8B;AAC9B,uDAAqC;AACrC,oDAAkC;AAClC,4DAA0C;AAC1C,6DAA2C;AAC3C,mDAAiC;AACjC,yDAAuC;AACvC,qDAAmC;AACnC,sDAAoC;AACpC,0DAAwC;AACxC,kDAAgC;AAChC,mDAAiC;AACjC,+DAA6C;AAC7C,qDAAmC;AACnC,6DAA2C"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/api/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,qEAAqE;AACrE,0CAAwB;AACxB,4CAA0B;AAC1B,iDAA+B;AAC/B,+CAA6B;AAC7B,2CAAyB;AACzB,+CAA6B;AAC7B,8CAA4B;AAC5B,qDAAmC;AACnC,wDAAsC;AACtC,4DAA0C;AAC1C,uDAAqC;AACrC,uDAAqC;AACrC,mDAAiC;AACjC,6CAA2B;AAC3B,mDAAiC;AACjC,+CAA6B;AAC7B,2DAAyC;AACzC,oDAAkC;AAClC,gDAA8B;AAC9B,uDAAqC;AACrC,oDAAkC;AAClC,4DAA0C;AAC1C,6DAA2C;AAC3C,mDAAiC;AACjC,yDAAuC;AACvC,qDAAmC;AACnC,sDAAoC;AACpC,0DAAwC;AACxC,kDAAgC;AAChC,mDAAiC;AACjC,+DAA6C;AAC7C,qDAAmC;AACnC,6DAA2C"}

package/dist/api/staff-blocks/index.d.ts

@@ -0,0 +1,3 @@
+export * from './staff-block.dto';
+export * from './staff-block.request';
+//# sourceMappingURL=index.d.ts.map

package/dist/api/staff-blocks/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/api/staff-blocks/index.ts"],"names":[],"mappings":"AAAA,cAAc,mBAAmB,CAAC;AAClC,cAAc,uBAAuB,CAAC"}

package/dist/api/staff-blocks/index.js

@@ -0,0 +1,19 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./staff-block.dto"), exports);
+__exportStar(require("./staff-block.request"), exports);
+//# sourceMappingURL=index.js.map

package/dist/api/staff-blocks/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/api/staff-blocks/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,oDAAkC;AAClC,wDAAsC"}

package/dist/api/staff-blocks/staff-block.dto.d.ts

@@ -0,0 +1,26 @@
+import type { AuditActor } from '../audit';
+/**
+ * Time a staff member is unavailable for reasons other than an appointment (break,
+ * training, personal). The held time itself lives on a schedule occupancy, so blocks
+ * and appointments contend for the same slots through the same exclusion constraints.
+ */
+export interface StaffBlockDto {
+    id: string;
+    locationId: string;
+    staffId: string;
+    staffName: string | null;
+    title: string;
+    notes: string | null;
+    /** When true the slot stays bookable online; the block is internal-only. */
+    allowsOnlineBooking: boolean;
+    startAt: string;
+    endAt: string;
+    /** The occupancy holding the time. Calendar events are keyed off this. */
+    occupancyId: string;
+    createdAt: string;
+    updatedAt: string | null;
+    createdBy: AuditActor | null;
+    updatedBy: AuditActor | null;
+    deletedBy: AuditActor | null;
+}
+//# sourceMappingURL=staff-block.dto.d.ts.map

package/dist/api/staff-blocks/staff-block.dto.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"staff-block.dto.d.ts","sourceRoot":"","sources":["../../../src/api/staff-blocks/staff-block.dto.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAE3C;;;;GAIG;AACH,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,4EAA4E;IAC5E,mBAAmB,EAAE,OAAO,CAAC;IAC7B,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,0EAA0E;IAC1E,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,SAAS,EAAE,UAAU,GAAG,IAAI,CAAC;IAC7B,SAAS,EAAE,UAAU,GAAG,IAAI,CAAC;IAC7B,SAAS,EAAE,UAAU,GAAG,IAAI,CAAC;CAC9B"}

package/dist/api/staff-blocks/staff-block.dto.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=staff-block.dto.js.map

package/dist/api/staff-blocks/staff-block.dto.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"staff-block.dto.js","sourceRoot":"","sources":["../../../src/api/staff-blocks/staff-block.dto.ts"],"names":[],"mappings":""}

package/dist/api/staff-blocks/staff-block.request.d.ts

@@ -0,0 +1,26 @@
+export interface CreateStaffBlockRequest {
+    locationId: string;
+    staffId: string;
+    title: string;
+    notes?: string | null;
+    /** Defaults to false: a block normally closes the slot to online booking too. */
+    allowsOnlineBooking?: boolean;
+    startAt: string;
+    endAt: string;
+    /**
+     * Set once the user has seen a clash and chosen to overlap anyway. Without it the
+     * exclusion constraints reject the overlap with a 409.
+     */
+    allowOverlap?: boolean;
+}
+/** Also carries drag/resize on the calendar, which sends only `startAt`/`endAt`/`staffId`. */
+export interface UpdateStaffBlockRequest {
+    staffId?: string;
+    title?: string;
+    notes?: string | null;
+    allowsOnlineBooking?: boolean;
+    startAt?: string;
+    endAt?: string;
+    allowOverlap?: boolean;
+}
+//# sourceMappingURL=staff-block.request.d.ts.map

package/dist/api/staff-blocks/staff-block.request.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"staff-block.request.d.ts","sourceRoot":"","sources":["../../../src/api/staff-blocks/staff-block.request.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,uBAAuB;IACtC,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,iFAAiF;IACjF,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd;;;OAGG;IACH,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB;AAED,8FAA8F;AAC9F,MAAM,WAAW,uBAAuB;IACtC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAC9B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB"}

package/dist/api/staff-blocks/staff-block.request.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=staff-block.request.js.map

package/dist/api/staff-blocks/staff-block.request.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"staff-block.request.js","sourceRoot":"","sources":["../../../src/api/staff-blocks/staff-block.request.ts"],"names":[],"mappings":""}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "types-salon-management",
-  "version": "1.0.50",
+  "version": "1.0.52",
   "description": "Types for Salon Management",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",

package/src/api/appointments/appointment.constants.ts

@@ -35,12 +35,17 @@ export const OccupancyStaffRole = {
 export type OccupancyStaffRole = (typeof OccupancyStaffRole)[keyof typeof OccupancyStaffRole];
 
 /**
- * Advisory scheduling problems. These never block a booking — double-booking is the
- * only hard conflict, enforced by exclusion constraints and surfaced as 409.
+ * Advisory scheduling problems. None of these block a booking: the caller may proceed by
+ * setting `allowOverlap` on the write request, which is recorded on the occupancy. The
+ * exclusion constraints still reject overlaps that were never acknowledged.
  */
 export const SchedulingWarningCode = {
   STAFF_DAY_OFF: 'staff_day_off',
   STAFF_OUTSIDE_WORKING_HOURS: 'staff_outside_working_hours',
+  STAFF_DOUBLE_BOOKED: 'staff_double_booked',
+  RESOURCE_DOUBLE_BOOKED: 'resource_double_booked',
+  /** Clash with a staff block rather than a booking; overridable like a double-booking. */
+  STAFF_BLOCKED: 'staff_blocked',
 } as const;
 
 export type SchedulingWarningCode =

package/src/api/appointments/book-appointment.request.ts

@@ -16,4 +16,9 @@ export interface BookAppointmentRequest {
   clientEmail?: string | null;
   notes?: string | null;
   items: BookAppointmentItemRequest[];
+  /**
+   * Set once the user has seen a clash and chosen to double-book anyway. Without it the
+   * exclusion constraints reject the overlap with a 409.
+   */
+  allowOverlap?: boolean;
 }

package/src/api/appointments/check-scheduling.request.ts

@@ -5,6 +5,7 @@ export interface CheckSchedulingSlotRequest {
   serviceVariantId?: string;
   staffId: string;
   staffId2?: string;
+  resourceId?: string;
   startAt: string;
   endAt?: string;
 }
@@ -12,13 +13,18 @@ export interface CheckSchedulingSlotRequest {
 export interface CheckSchedulingRequest {
   locationId: string;
   slots: CheckSchedulingSlotRequest[];
+  /** Occupancies of this item are ignored, so rescheduling never clashes with itself. */
+  excludeAppointmentItemId?: string;
+  /** Same, for a staff block being moved or resized. */
+  excludeStaffBlockId?: string;
 }
 
 export interface SchedulingWarningDto {
   code: SchedulingWarningCode;
   /** Ready-to-display sentence; the server owns the wording. */
   message: string;
-  staffId: string;
+  /** Null for resource clashes, which aren't tied to a staff member. */
+  staffId: string | null;
   staffName: string | null;
   startAt: string;
   endAt: string;

package/src/api/appointments/reschedule-item.request.ts

@@ -1,10 +1,15 @@
-import type { OccupancyStaffRole } from './appointment.constants';
-
 export interface RescheduleItemRequest {
   startAt: string;
   endAt: string;
+  /** New primary staff; omit to leave unchanged. */
   staffId?: string;
+  /** New assistant staff for two-staff services; omit to leave unchanged. */
   staffId2?: string;
+  /** New room; omit or null to leave unchanged. */
   resourceId?: string | null;
-  staffRole?: OccupancyStaffRole;
+  /**
+   * Set once the user has seen a clash and chosen to double-book anyway. Without it the
+   * exclusion constraints reject the overlap with a 409.
+   */
+  allowOverlap?: boolean;
 }

package/src/api/calendar/calendar.dto.ts

@@ -26,10 +26,36 @@ export interface CalendarOccupancyDto {
   durationSegments: AppointmentItemDurationSegmentDto[];
 }
 
+/**
+ * A staff block on the calendar. Kept separate from `CalendarOccupancyDto` because a
+ * block has no client, service or status — sharing one shape would mean a dozen
+ * meaningless nulls per row.
+ */
+export interface CalendarStaffBlockDto {
+  occupancyId: string;
+  staffBlockId: string;
+  locationId: string;
+  staffId: string | null;
+  staffName: string | null;
+  title: string;
+  notes: string | null;
+  allowsOnlineBooking: boolean;
+  startAt: string;
+  endAt: string;
+}
+
+/** SSE `calendar.changed` payload; tells other sessions which location's feed is stale. */
+export interface CalendarChangedEvent {
+  locationId: string;
+  changeType: 'book' | 'reschedule' | 'staff_block';
+  entityId: string;
+}
+
 export interface CalendarFeedDto {
   locationId: string;
   from: string;
   to: string;
   occupancies: CalendarOccupancyDto[];
+  staffBlocks: CalendarStaffBlockDto[];
   closures: LocationClosureDto[];
 }

package/src/api/index.ts

@@ -10,6 +10,7 @@ export * from './gst-number/index';
 export * from './cancellation-reason';
 export * from './location-closures/index';
 export * from './appointments/index';
+export * from './staff-blocks/index';
 export * from './calendar/index';
 export * from './location';
 export * from './platform-terms';

package/src/api/staff-blocks/index.ts

@@ -0,0 +1,2 @@
+export * from './staff-block.dto';
+export * from './staff-block.request';

package/src/api/staff-blocks/staff-block.dto.ts

@@ -0,0 +1,26 @@
+import type { AuditActor } from '../audit';
+
+/**
+ * Time a staff member is unavailable for reasons other than an appointment (break,
+ * training, personal). The held time itself lives on a schedule occupancy, so blocks
+ * and appointments contend for the same slots through the same exclusion constraints.
+ */
+export interface StaffBlockDto {
+  id: string;
+  locationId: string;
+  staffId: string;
+  staffName: string | null;
+  title: string;
+  notes: string | null;
+  /** When true the slot stays bookable online; the block is internal-only. */
+  allowsOnlineBooking: boolean;
+  startAt: string;
+  endAt: string;
+  /** The occupancy holding the time. Calendar events are keyed off this. */
+  occupancyId: string;
+  createdAt: string;
+  updatedAt: string | null;
+  createdBy: AuditActor | null;
+  updatedBy: AuditActor | null;
+  deletedBy: AuditActor | null;
+}

package/src/api/staff-blocks/staff-block.request.ts

@@ -0,0 +1,26 @@
+export interface CreateStaffBlockRequest {
+  locationId: string;
+  staffId: string;
+  title: string;
+  notes?: string | null;
+  /** Defaults to false: a block normally closes the slot to online booking too. */
+  allowsOnlineBooking?: boolean;
+  startAt: string;
+  endAt: string;
+  /**
+   * Set once the user has seen a clash and chosen to overlap anyway. Without it the
+   * exclusion constraints reject the overlap with a 409.
+   */
+  allowOverlap?: boolean;
+}
+
+/** Also carries drag/resize on the calendar, which sends only `startAt`/`endAt`/`staffId`. */
+export interface UpdateStaffBlockRequest {
+  staffId?: string;
+  title?: string;
+  notes?: string | null;
+  allowsOnlineBooking?: boolean;
+  startAt?: string;
+  endAt?: string;
+  allowOverlap?: boolean;
+}