types-salon-management 1.0.49 → 1.0.51

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

@@ -24,4 +24,16 @@ export declare const OccupancyStaffRole: {
     readonly ASSISTANT: "assistant";
 };
 export type OccupancyStaffRole = (typeof OccupancyStaffRole)[keyof typeof OccupancyStaffRole];
+/**
+ * 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";
+};
+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"}
+{"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;;;;;CAKxB,CAAC;AAEX,MAAM,MAAM,qBAAqB,GAC/B,CAAC,OAAO,qBAAqB,CAAC,CAAC,MAAM,OAAO,qBAAqB,CAAC,CAAC"}

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

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.OccupancyStaffRole = exports.AppointmentKind = exports.AppointmentClientType = exports.SchedulingAppointmentStatus = void 0;
+exports.SchedulingWarningCode = exports.OccupancyStaffRole = exports.AppointmentKind = exports.AppointmentClientType = exports.SchedulingAppointmentStatus = void 0;
 /** Postgres appointment header status — distinct from legacy Firestore `AppointmentStatus` enum. */
 exports.SchedulingAppointmentStatus = {
     NEW: 'new',
@@ -23,4 +23,15 @@ exports.OccupancyStaffRole = {
     PRIMARY: 'primary',
     ASSISTANT: 'assistant',
 };
+/**
+ * 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',
+};
 //# 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"}
+{"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;CACxC,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

@@ -0,0 +1,30 @@
+import type { SchedulingWarningCode } from './appointment.constants';
+/** One staff/time slot to evaluate. `endAt` is optional; omit it to derive from the variant. */
+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;
+}
+export interface SchedulingWarningDto {
+    code: SchedulingWarningCode;
+    /** Ready-to-display sentence; the server owns the wording. */
+    message: string;
+    /** Null for resource clashes, which aren't tied to a staff member. */
+    staffId: string | null;
+    staffName: string | null;
+    startAt: string;
+    endAt: string;
+}
+export interface CheckSchedulingResponse {
+    warnings: SchedulingWarningDto[];
+}
+//# sourceMappingURL=check-scheduling.request.d.ts.map

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

@@ -0,0 +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,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;CACnC;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/check-scheduling.request.js

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

package/dist/api/appointments/check-scheduling.request.js.map

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

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

@@ -1,5 +1,6 @@
 export * from './appointment.constants';
 export * from './appointment.dto';
 export * from './book-appointment.request';
+export * from './check-scheduling.request';
 export * from './reschedule-item.request';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/api/appointments/index.ts"],"names":[],"mappings":"AAAA,cAAc,yBAAyB,CAAC;AACxC,cAAc,mBAAmB,CAAC;AAClC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,2BAA2B,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/api/appointments/index.ts"],"names":[],"mappings":"AAAA,cAAc,yBAAyB,CAAC;AACxC,cAAc,mBAAmB,CAAC;AAClC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,4BAA4B,CAAC;AAC3C,cAAc,2BAA2B,CAAC"}

package/dist/api/appointments/index.js

@@ -17,5 +17,6 @@ Object.defineProperty(exports, "__esModule", { value: true });
 __exportStar(require("./appointment.constants"), exports);
 __exportStar(require("./appointment.dto"), exports);
 __exportStar(require("./book-appointment.request"), exports);
+__exportStar(require("./check-scheduling.request"), exports);
 __exportStar(require("./reschedule-item.request"), exports);
 //# sourceMappingURL=index.js.map

package/dist/api/appointments/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/api/appointments/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,0DAAwC;AACxC,oDAAkC;AAClC,6DAA2C;AAC3C,4DAA0C"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/api/appointments/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,0DAAwC;AACxC,oDAAkC;AAClC,6DAA2C;AAC3C,6DAA2C;AAC3C,4DAA0C"}

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/package.json

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

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

@@ -33,3 +33,18 @@ export const OccupancyStaffRole = {
 } as const;
 
 export type OccupancyStaffRole = (typeof OccupancyStaffRole)[keyof typeof OccupancyStaffRole];
+
+/**
+ * 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',
+} as const;
+
+export type SchedulingWarningCode =
+  (typeof SchedulingWarningCode)[keyof typeof 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

@@ -0,0 +1,33 @@
+import type { SchedulingWarningCode } from './appointment.constants';
+
+/** One staff/time slot to evaluate. `endAt` is optional; omit it to derive from the variant. */
+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;
+}
+
+export interface SchedulingWarningDto {
+  code: SchedulingWarningCode;
+  /** Ready-to-display sentence; the server owns the wording. */
+  message: string;
+  /** Null for resource clashes, which aren't tied to a staff member. */
+  staffId: string | null;
+  staffName: string | null;
+  startAt: string;
+  endAt: string;
+}
+
+export interface CheckSchedulingResponse {
+  warnings: SchedulingWarningDto[];
+}

package/src/api/appointments/index.ts

@@ -1,4 +1,5 @@
 export * from './appointment.constants';
 export * from './appointment.dto';
 export * from './book-appointment.request';
+export * from './check-scheduling.request';
 export * from './reschedule-item.request';

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;
 }