types-salon-management 1.0.49 → 1.0.50

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

@@ -24,4 +24,13 @@ export declare const OccupancyStaffRole: {
     readonly ASSISTANT: "assistant";
 };
 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.
+ */
+export declare const SchedulingWarningCode: {
+    readonly STAFF_DAY_OFF: "staff_day_off";
+    readonly STAFF_OUTSIDE_WORKING_HOURS: "staff_outside_working_hours";
+};
+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;;;GAGG;AACH,eAAO,MAAM,qBAAqB;;;CAGxB,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,12 @@ exports.OccupancyStaffRole = {
     PRIMARY: 'primary',
     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.
+ */
+exports.SchedulingWarningCode = {
+    STAFF_DAY_OFF: 'staff_day_off',
+    STAFF_OUTSIDE_WORKING_HOURS: 'staff_outside_working_hours',
+};
 //# 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;;;GAGG;AACU,QAAA,qBAAqB,GAAG;IACnC,aAAa,EAAE,eAAe;IAC9B,2BAA2B,EAAE,6BAA6B;CAClD,CAAC"}

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

@@ -0,0 +1,26 @@
+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;
+    startAt: string;
+    endAt?: string;
+}
+export interface CheckSchedulingRequest {
+    locationId: string;
+    slots: CheckSchedulingSlotRequest[];
+}
+export interface SchedulingWarningDto {
+    code: SchedulingWarningCode;
+    /** Ready-to-display sentence; the server owns the wording. */
+    message: string;
+    staffId: string;
+    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,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"}

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

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

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

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

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

@@ -0,0 +1,29 @@
+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;
+  startAt: string;
+  endAt?: string;
+}
+
+export interface CheckSchedulingRequest {
+  locationId: string;
+  slots: CheckSchedulingSlotRequest[];
+}
+
+export interface SchedulingWarningDto {
+  code: SchedulingWarningCode;
+  /** Ready-to-display sentence; the server owns the wording. */
+  message: string;
+  staffId: string;
+  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';