wiil-core-js 0.0.82

package/dist/core/business-mgt/reservation-resource.schema.d.ts

@@ -0,0 +1,154 @@
+import { z } from "zod";
+import { ResourceReservationDurationUnit, ResourceType } from "../type-definitions";
+/**
+ * @fileoverview Reservation resource schema definitions for various resource types.
+ * @module business-mgt/reservation-resource
+ */
+/**
+ * Room resource schema for hotel/accommodation bookings.
+ *
+ * @typedef {Object} RoomResource
+ * @property {string} roomNumber - Room number or identifier
+ * @property {string} roomType - Type of room (e.g., Standard Queen, Deluxe King)
+ * @property {number} pricePerNight - Price per night for the room
+ * @property {string} [view] - Room view (e.g., City View, Ocean View)
+ * @property {string} [bedType] - Type of bed (e.g., Queen, King, Twin)
+ * @property {boolean} isSmoking - Whether smoking is allowed
+ * @property {string} [accessibilityFeatures] - Accessibility features available
+ */
+export declare const RoomResourceSchema: z.ZodObject<{
+    roomNumber: z.ZodString;
+    roomType: z.ZodString;
+    pricePerNight: z.ZodNumber;
+    view: z.ZodOptional<z.ZodString>;
+    bedType: z.ZodOptional<z.ZodString>;
+    isSmoking: z.ZodDefault<z.ZodBoolean>;
+    accessibilityFeatures: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+/**
+ * Rental resource schema for hourly rentals.
+ *
+ * @typedef {Object} RentalResource
+ * @property {string} itemType - Type of rental item (e.g., Game Room, Conference Room)
+ * @property {number} pricePerHour - Hourly rate for this rental
+ */
+export declare const RentalResourceSchema: z.ZodObject<{
+    itemType: z.ZodString;
+    pricePerHour: z.ZodNumber;
+}, z.core.$strip>;
+/**
+ * Main resource schema for managing reservable resources.
+ *
+ * @typedef {Object} Resource
+ * @property {string} resourceType - Type of resource
+ * @property {string} name - Name of the resource (table, room, etc.)
+ * @property {string} [description] - Description of the resource
+ * @property {number} [capacity] - Maximum capacity (e.g., number of people)
+ * @property {boolean} isAvailable - Whether the resource is available for reservation
+ * @property {string} [location] - Physical location of the resource
+ * @property {string[]} amenities - Available amenities
+ * @property {number} [reservationDuration] - Default reservation duration
+ * @property {string} [reservationDurationUnit] - Unit of the default reservation duration
+ * @property {string} [calendarId] - Calendar ID for availability sync
+ * @property {boolean} syncEnabled - Whether calendar sync is enabled
+ * @property {number} [lastSyncAt] - Last sync timestamp
+ * @property {Object} [roomResource] - Room-specific fields
+ * @property {Object} [rentalResource] - Rental-specific fields
+ * @property {Object} [metadata] - Additional metadata for other resource types
+ */
+export declare const ResourceSchema: z.ZodObject<{
+    id: z.ZodString;
+    createdAt: z.ZodOptional<z.ZodNumber>;
+    updatedAt: z.ZodOptional<z.ZodNumber>;
+    resourceType: z.ZodEnum<typeof ResourceType>;
+    name: z.ZodString;
+    description: z.ZodOptional<z.ZodString>;
+    capacity: z.ZodOptional<z.ZodNumber>;
+    isAvailable: z.ZodDefault<z.ZodBoolean>;
+    location: z.ZodOptional<z.ZodString>;
+    amenities: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    reservationDuration: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    reservationDurationUnit: z.ZodNullable<z.ZodOptional<z.ZodEnum<typeof ResourceReservationDurationUnit>>>;
+    calendarId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    syncEnabled: z.ZodDefault<z.ZodOptional<z.ZodNullable<z.ZodBoolean>>>;
+    lastSyncAt: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    roomResource: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+        roomNumber: z.ZodString;
+        roomType: z.ZodString;
+        pricePerNight: z.ZodNumber;
+        view: z.ZodOptional<z.ZodString>;
+        bedType: z.ZodOptional<z.ZodString>;
+        isSmoking: z.ZodDefault<z.ZodBoolean>;
+        accessibilityFeatures: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>>;
+    rentalResource: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+        itemType: z.ZodString;
+        pricePerHour: z.ZodNumber;
+    }, z.core.$strip>>>;
+    metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;
+}, z.core.$strip>;
+/**
+ * Schema for creating a new resource.
+ * Omits auto-generated fields.
+ */
+export declare const CreateResourceSchema: z.ZodObject<{
+    capacity: z.ZodOptional<z.ZodNumber>;
+    metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;
+    name: z.ZodString;
+    description: z.ZodOptional<z.ZodString>;
+    isAvailable: z.ZodDefault<z.ZodBoolean>;
+    amenities: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    calendarId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    resourceType: z.ZodEnum<typeof ResourceType>;
+    location: z.ZodOptional<z.ZodString>;
+    reservationDuration: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    reservationDurationUnit: z.ZodNullable<z.ZodOptional<z.ZodEnum<typeof ResourceReservationDurationUnit>>>;
+    roomResource: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+        roomNumber: z.ZodString;
+        roomType: z.ZodString;
+        pricePerNight: z.ZodNumber;
+        view: z.ZodOptional<z.ZodString>;
+        bedType: z.ZodOptional<z.ZodString>;
+        isSmoking: z.ZodDefault<z.ZodBoolean>;
+        accessibilityFeatures: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>>;
+    rentalResource: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+        itemType: z.ZodString;
+        pricePerHour: z.ZodNumber;
+    }, z.core.$strip>>>;
+}, z.core.$strip>;
+/**
+ * Schema for updating an existing resource.
+ * All fields are optional except id.
+ */
+export declare const UpdateResourceSchema: z.ZodObject<{
+    capacity: z.ZodOptional<z.ZodOptional<z.ZodNumber>>;
+    metadata: z.ZodOptional<z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>>;
+    name: z.ZodOptional<z.ZodString>;
+    description: z.ZodOptional<z.ZodOptional<z.ZodString>>;
+    isAvailable: z.ZodOptional<z.ZodDefault<z.ZodBoolean>>;
+    amenities: z.ZodOptional<z.ZodDefault<z.ZodArray<z.ZodString>>>;
+    calendarId: z.ZodOptional<z.ZodOptional<z.ZodNullable<z.ZodString>>>;
+    resourceType: z.ZodOptional<z.ZodEnum<typeof ResourceType>>;
+    location: z.ZodOptional<z.ZodOptional<z.ZodString>>;
+    reservationDuration: z.ZodOptional<z.ZodOptional<z.ZodNullable<z.ZodNumber>>>;
+    reservationDurationUnit: z.ZodOptional<z.ZodNullable<z.ZodOptional<z.ZodEnum<typeof ResourceReservationDurationUnit>>>>;
+    roomResource: z.ZodOptional<z.ZodOptional<z.ZodNullable<z.ZodObject<{
+        roomNumber: z.ZodString;
+        roomType: z.ZodString;
+        pricePerNight: z.ZodNumber;
+        view: z.ZodOptional<z.ZodString>;
+        bedType: z.ZodOptional<z.ZodString>;
+        isSmoking: z.ZodDefault<z.ZodBoolean>;
+        accessibilityFeatures: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>>>;
+    rentalResource: z.ZodOptional<z.ZodOptional<z.ZodNullable<z.ZodObject<{
+        itemType: z.ZodString;
+        pricePerHour: z.ZodNumber;
+    }, z.core.$strip>>>>;
+    id: z.ZodString;
+    syncEnabled: z.ZodOptional<z.ZodNullable<z.ZodBoolean>>;
+}, z.core.$strip>;
+export type Resource = z.infer<typeof ResourceSchema>;
+export type CreateResource = z.infer<typeof CreateResourceSchema>;
+export type UpdateResource = z.infer<typeof UpdateResourceSchema>;

package/dist/core/business-mgt/reservation-resource.schema.js

@@ -0,0 +1,100 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.UpdateResourceSchema = exports.CreateResourceSchema = exports.ResourceSchema = exports.RentalResourceSchema = exports.RoomResourceSchema = void 0;
+const zod_1 = require("zod");
+const base_schema_1 = require("../base.schema");
+const type_definitions_1 = require("../type-definitions");
+/**
+ * @fileoverview Reservation resource schema definitions for various resource types.
+ * @module business-mgt/reservation-resource
+ */
+/**
+ * Room resource schema for hotel/accommodation bookings.
+ *
+ * @typedef {Object} RoomResource
+ * @property {string} roomNumber - Room number or identifier
+ * @property {string} roomType - Type of room (e.g., Standard Queen, Deluxe King)
+ * @property {number} pricePerNight - Price per night for the room
+ * @property {string} [view] - Room view (e.g., City View, Ocean View)
+ * @property {string} [bedType] - Type of bed (e.g., Queen, King, Twin)
+ * @property {boolean} isSmoking - Whether smoking is allowed
+ * @property {string} [accessibilityFeatures] - Accessibility features available
+ */
+exports.RoomResourceSchema = zod_1.z.object({
+    roomNumber: zod_1.z.string().describe("Unique room identifier or number (e.g., '101', 'Penthouse A'). Used for guest communication, housekeeping coordination, and reservation assignment."),
+    roomType: zod_1.z.string().describe("Room category or class (e.g., 'Standard Queen', 'Deluxe King', 'Executive Suite'). Used by AI Powered Services to match customer preferences with available room types."),
+    pricePerNight: zod_1.z.number().nonnegative().describe("Nightly rate for this room in the account's currency. Used for Reservation pricing calculations and dynamic rate management."),
+    view: zod_1.z.string().optional().describe("Room view classification (e.g., 'City View', 'Ocean View', 'Garden View'). Premium feature for upselling and guest preference matching."),
+    bedType: zod_1.z.string().optional().describe("Bed configuration (e.g., 'Queen', 'King', 'Twin', '2 Double'). Important for guest comfort and party size accommodation."),
+    isSmoking: zod_1.z.boolean().default(false).describe("Whether smoking is permitted in this room. Used for guest preference filtering and regulatory compliance. Defaults to false (non-smoking)."),
+    accessibilityFeatures: zod_1.z.string().optional().describe("ADA/accessibility accommodations available (e.g., 'Roll-in shower', 'Grab bars', 'Hearing accessible'). Critical for inclusive booking and regulatory compliance."),
+});
+/**
+ * Rental resource schema for hourly rentals.
+ *
+ * @typedef {Object} RentalResource
+ * @property {string} itemType - Type of rental item (e.g., Game Room, Conference Room)
+ * @property {number} pricePerHour - Hourly rate for this rental
+ */
+exports.RentalResourceSchema = zod_1.z.object({
+    itemType: zod_1.z.string().describe("Rental category or equipment type (e.g., 'Game Room', 'Conference Room', 'Sports Equipment'). Used by AI Powered Services to categorize and present rental options."),
+    pricePerHour: zod_1.z.number().nonnegative().describe("Hourly rental rate in the account's currency. Used for Reservation pricing calculations for time-based bookings."),
+});
+/**
+ * Main resource schema for managing reservable resources.
+ *
+ * @typedef {Object} Resource
+ * @property {string} resourceType - Type of resource
+ * @property {string} name - Name of the resource (table, room, etc.)
+ * @property {string} [description] - Description of the resource
+ * @property {number} [capacity] - Maximum capacity (e.g., number of people)
+ * @property {boolean} isAvailable - Whether the resource is available for reservation
+ * @property {string} [location] - Physical location of the resource
+ * @property {string[]} amenities - Available amenities
+ * @property {number} [reservationDuration] - Default reservation duration
+ * @property {string} [reservationDurationUnit] - Unit of the default reservation duration
+ * @property {string} [calendarId] - Calendar ID for availability sync
+ * @property {boolean} syncEnabled - Whether calendar sync is enabled
+ * @property {number} [lastSyncAt] - Last sync timestamp
+ * @property {Object} [roomResource] - Room-specific fields
+ * @property {Object} [rentalResource] - Rental-specific fields
+ * @property {Object} [metadata] - Additional metadata for other resource types
+ */
+exports.ResourceSchema = base_schema_1.BaseModelSchema.safeExtend({
+    resourceType: zod_1.z.enum(type_definitions_1.ResourceType).describe("Category of reservable resource: ROOM (hotel/accommodation), TABLE (restaurant seating), RENTAL (hourly equipment/space), or OTHER. Determines pricing model and booking workflow."),
+    name: zod_1.z.string().describe("Display name of the resource (e.g., 'Table 5', 'Conference Room A', 'Room 101'). Used by AI Powered Services when presenting reservation options to customers."),
+    description: zod_1.z.string().optional().describe("Detailed description of the resource including features, special characteristics, or usage guidelines. Helps customers make informed reservation decisions."),
+    capacity: zod_1.z.number().int().positive().optional().describe("Maximum occupancy or party size for this resource (e.g., table seats 4, room sleeps 2). Used by AI Powered Services to match customer group size with appropriate resources."),
+    isAvailable: zod_1.z.boolean().default(true).describe("Whether this resource is currently active and available for reservations. Disabled resources are hidden from customers and AI Powered Services. Defaults to true."),
+    location: zod_1.z.string().optional().describe("Physical location or placement (e.g., 'Window side', 'Third floor', 'Main dining area'). Helps with customer preferences and operational logistics."),
+    amenities: zod_1.z.array(zod_1.z.string()).default([]).describe("List of available features or amenities (e.g., ['WiFi', 'Projector', 'Whiteboard'] for conference room). Used for filtering and customer preference matching. Defaults to empty array."),
+    reservationDuration: zod_1.z.number().int().positive().nullable().optional().describe("Default or standard reservation length in specified units. Used for availability slot calculations and customer guidance in Reservation workflow."),
+    reservationDurationUnit: zod_1.z.enum(type_definitions_1.ResourceReservationDurationUnit).optional().nullable().describe("Time unit for reservationDuration: HOURS, DAYS, or MINUTES. Determines how reservation pricing and availability are calculated."),
+    // Calendar integration (optional)
+    calendarId: zod_1.z.string().nullable().optional().describe("External calendar system ID for real-time availability synchronization (Google Calendar, Outlook, etc.). Enables two-way booking sync."),
+    syncEnabled: zod_1.z.boolean().nullable().optional().default(false).describe("Whether automatic calendar synchronization is active for this resource. When true, availability updates from external calendar system. Defaults to false."),
+    lastSyncAt: zod_1.z.number().nullable().optional().describe("Unix timestamp of most recent calendar synchronization. Used for sync health monitoring and troubleshooting availability discrepancies."),
+    // Type-specific fields
+    roomResource: exports.RoomResourceSchema.nullable().optional().describe("Hotel/accommodation-specific fields (room number, bed type, view, etc.). Only populated when resourceType is ROOM."),
+    rentalResource: exports.RentalResourceSchema.nullable().optional().describe("Hourly rental-specific fields (item type, hourly rate). Only populated when resourceType is RENTAL."),
+    metadata: zod_1.z.record(zod_1.z.string(), zod_1.z.any()).optional().describe("Extensible key-value storage for custom resource attributes not covered by standard fields. Provides flexibility for unique business requirements."),
+});
+/**
+ * Schema for creating a new resource.
+ * Omits auto-generated fields.
+ */
+exports.CreateResourceSchema = exports.ResourceSchema.omit({
+    id: true,
+    createdAt: true,
+    updatedAt: true,
+    lastSyncAt: true,
+    syncEnabled: true,
+});
+/**
+ * Schema for updating an existing resource.
+ * All fields are optional except id.
+ */
+exports.UpdateResourceSchema = exports.CreateResourceSchema.partial().safeExtend({
+    id: zod_1.z.string(),
+    syncEnabled: zod_1.z.boolean().nullable().optional(),
+});

package/dist/core/business-mgt/reservation.schema.d.ts

@@ -0,0 +1,119 @@
+import { z } from "zod";
+import { AppointmentStatus, ReservationSettingType, ResourceReservationDurationUnit, ResourceType } from "../type-definitions";
+/**
+ * @fileoverview Reservation schema definitions for managing resource reservations.
+ * @module business-mgt/reservation
+ */
+/**
+ * Reservation settings schema.
+ *
+ * @typedef {Object} ReservationSettings
+ * @property {string} reservationType - Type of reservation (table, room, rentals, etc.)
+ * @property {string} settingType - Type of reservation setting
+ * @property {number} [defaultReservationDuration] - Default reservation duration
+ * @property {string} [defaultReservationDurationUnit] - Unit of the default reservation duration
+ * @property {boolean} isActive - Whether this reservation setting is active
+ */
+export declare const ReservationSettingsSchema: z.ZodObject<{
+    id: z.ZodString;
+    createdAt: z.ZodOptional<z.ZodNumber>;
+    updatedAt: z.ZodOptional<z.ZodNumber>;
+    reservationType: z.ZodEnum<typeof ResourceType>;
+    settingType: z.ZodEnum<typeof ReservationSettingType>;
+    defaultReservationDuration: z.ZodOptional<z.ZodDefault<z.ZodNumber>>;
+    defaultReservationDurationUnit: z.ZodDefault<z.ZodOptional<z.ZodEnum<typeof ResourceReservationDurationUnit>>>;
+    isActive: z.ZodDefault<z.ZodBoolean>;
+}, z.core.$strip>;
+/**
+ * Schema for updating existing reservation settings.
+ * All fields are optional except id.
+ */
+export declare const UpdateReservationSettingsSchema: z.ZodObject<{
+    createdAt: z.ZodOptional<z.ZodOptional<z.ZodNumber>>;
+    updatedAt: z.ZodOptional<z.ZodOptional<z.ZodNumber>>;
+    reservationType: z.ZodOptional<z.ZodEnum<typeof ResourceType>>;
+    settingType: z.ZodOptional<z.ZodEnum<typeof ReservationSettingType>>;
+    defaultReservationDuration: z.ZodOptional<z.ZodOptional<z.ZodDefault<z.ZodNumber>>>;
+    defaultReservationDurationUnit: z.ZodOptional<z.ZodDefault<z.ZodOptional<z.ZodEnum<typeof ResourceReservationDurationUnit>>>>;
+    isActive: z.ZodOptional<z.ZodDefault<z.ZodBoolean>>;
+    id: z.ZodString;
+}, z.core.$strip>;
+export type ReservationSettings = z.infer<typeof ReservationSettingsSchema>;
+export type UpdateReservationSettings = z.infer<typeof UpdateReservationSettingsSchema>;
+/**
+ * Reservation schema for managing bookings.
+ *
+ * @typedef {Object} Reservation
+ * @property {string} reservationType - Type of reservation
+ * @property {string} [resourceId] - ID of the reserved resource (table, room, etc.)
+ * @property {string} customerId - Customer ID if registered
+ * @property {number} startTime - Reservation start time as Unix timestamp
+ * @property {number} [endTime] - Reservation end time as Unix timestamp
+ * @property {number} [duration] - Duration based on resource type
+ * @property {number} [personsNumber] - Number of people for the reservation
+ * @property {number} [totalPrice] - Total price for the reservation
+ * @property {number} depositPaid - Deposit amount paid
+ * @property {string} status - Current reservation status
+ * @property {string} [notes] - Special requests or notes
+ * @property {string} [cancelReason] - Reason for cancellation, if applicable
+ * @property {boolean} isResourceReservation - Indicates if this reservation is for a specific resource
+ * @property {string} [serviceConversationConfigId] - Configuration ID for service conversation
+ */
+export declare const ReservationSchema: z.ZodObject<{
+    id: z.ZodString;
+    createdAt: z.ZodOptional<z.ZodNumber>;
+    updatedAt: z.ZodOptional<z.ZodNumber>;
+    reservationType: z.ZodEnum<typeof ResourceType>;
+    resourceId: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+    customerId: z.ZodString;
+    startTime: z.ZodNumber;
+    endTime: z.ZodOptional<z.ZodNumber>;
+    duration: z.ZodOptional<z.ZodNumber>;
+    personsNumber: z.ZodOptional<z.ZodNumber>;
+    totalPrice: z.ZodOptional<z.ZodNumber>;
+    depositPaid: z.ZodDefault<z.ZodNumber>;
+    status: z.ZodDefault<z.ZodEnum<typeof AppointmentStatus>>;
+    notes: z.ZodOptional<z.ZodString>;
+    cancelReason: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    isResourceReservation: z.ZodDefault<z.ZodBoolean>;
+    serviceConversationConfigId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+}, z.core.$strip>;
+/**
+ * Schema for creating a new reservation.
+ * Omits auto-generated fields.
+ */
+export declare const CreateReservationSchema: z.ZodObject<{
+    customerId: z.ZodString;
+    duration: z.ZodOptional<z.ZodNumber>;
+    notes: z.ZodOptional<z.ZodString>;
+    totalPrice: z.ZodOptional<z.ZodNumber>;
+    reservationType: z.ZodEnum<typeof ResourceType>;
+    resourceId: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+    startTime: z.ZodNumber;
+    endTime: z.ZodOptional<z.ZodNumber>;
+    personsNumber: z.ZodOptional<z.ZodNumber>;
+    depositPaid: z.ZodDefault<z.ZodNumber>;
+    isResourceReservation: z.ZodDefault<z.ZodBoolean>;
+}, z.core.$strip>;
+/**
+ * Schema for updating an existing reservation.
+ * All fields are optional except id.
+ */
+export declare const UpdateReservationSchema: z.ZodObject<{
+    customerId: z.ZodOptional<z.ZodString>;
+    duration: z.ZodOptional<z.ZodOptional<z.ZodNumber>>;
+    notes: z.ZodOptional<z.ZodOptional<z.ZodString>>;
+    totalPrice: z.ZodOptional<z.ZodOptional<z.ZodNumber>>;
+    reservationType: z.ZodOptional<z.ZodEnum<typeof ResourceType>>;
+    resourceId: z.ZodOptional<z.ZodNullable<z.ZodOptional<z.ZodString>>>;
+    startTime: z.ZodOptional<z.ZodNumber>;
+    endTime: z.ZodOptional<z.ZodOptional<z.ZodNumber>>;
+    personsNumber: z.ZodOptional<z.ZodOptional<z.ZodNumber>>;
+    depositPaid: z.ZodOptional<z.ZodDefault<z.ZodNumber>>;
+    isResourceReservation: z.ZodOptional<z.ZodDefault<z.ZodBoolean>>;
+    id: z.ZodString;
+    cancelReason: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+}, z.core.$strip>;
+export type Reservation = z.infer<typeof ReservationSchema>;
+export type CreateReservation = z.infer<typeof CreateReservationSchema>;
+export type UpdateReservation = z.infer<typeof UpdateReservationSchema>;

package/dist/core/business-mgt/reservation.schema.js

@@ -0,0 +1,89 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.UpdateReservationSchema = exports.CreateReservationSchema = exports.ReservationSchema = exports.UpdateReservationSettingsSchema = exports.ReservationSettingsSchema = void 0;
+const zod_1 = require("zod");
+const base_schema_1 = require("../base.schema");
+const type_definitions_1 = require("../type-definitions");
+/**
+ * @fileoverview Reservation schema definitions for managing resource reservations.
+ * @module business-mgt/reservation
+ */
+/**
+ * Reservation settings schema.
+ *
+ * @typedef {Object} ReservationSettings
+ * @property {string} reservationType - Type of reservation (table, room, rentals, etc.)
+ * @property {string} settingType - Type of reservation setting
+ * @property {number} [defaultReservationDuration] - Default reservation duration
+ * @property {string} [defaultReservationDurationUnit] - Unit of the default reservation duration
+ * @property {boolean} isActive - Whether this reservation setting is active
+ */
+exports.ReservationSettingsSchema = base_schema_1.BaseModelSchema.safeExtend({
+    reservationType: zod_1.z.enum(type_definitions_1.ResourceType).describe("Resource type this setting applies to: ROOM, TABLE, RENTAL, or OTHER. Determines which resources inherit these default reservation parameters."),
+    settingType: zod_1.z.enum(type_definitions_1.ReservationSettingType).describe("Configuration category defining what aspect of reservations this setting controls. Enables flexible reservation policy management."),
+    defaultReservationDuration: zod_1.z.number().int().positive().default(1).optional().describe("Standard reservation length in specified units. Applied as default when customers make reservations via AI Powered Services. Defaults to 1."),
+    defaultReservationDurationUnit: zod_1.z.enum(type_definitions_1.ResourceReservationDurationUnit).optional().default(type_definitions_1.ResourceReservationDurationUnit.HOURS).describe("Time unit for defaultReservationDuration: HOURS (restaurant tables, rentals), DAYS (hotel rooms), or MINUTES (short-term use). Defaults to HOURS."),
+    isActive: zod_1.z.boolean().default(false).describe("Whether this configuration is currently active and applied to new reservations. Inactive settings are ignored. Defaults to false."),
+});
+/**
+ * Schema for updating existing reservation settings.
+ * All fields are optional except id.
+ */
+exports.UpdateReservationSettingsSchema = exports.ReservationSettingsSchema.partial().safeExtend({
+    id: zod_1.z.string(),
+});
+/**
+ * Reservation schema for managing bookings.
+ *
+ * @typedef {Object} Reservation
+ * @property {string} reservationType - Type of reservation
+ * @property {string} [resourceId] - ID of the reserved resource (table, room, etc.)
+ * @property {string} customerId - Customer ID if registered
+ * @property {number} startTime - Reservation start time as Unix timestamp
+ * @property {number} [endTime] - Reservation end time as Unix timestamp
+ * @property {number} [duration] - Duration based on resource type
+ * @property {number} [personsNumber] - Number of people for the reservation
+ * @property {number} [totalPrice] - Total price for the reservation
+ * @property {number} depositPaid - Deposit amount paid
+ * @property {string} status - Current reservation status
+ * @property {string} [notes] - Special requests or notes
+ * @property {string} [cancelReason] - Reason for cancellation, if applicable
+ * @property {boolean} isResourceReservation - Indicates if this reservation is for a specific resource
+ * @property {string} [serviceConversationConfigId] - Configuration ID for service conversation
+ */
+exports.ReservationSchema = base_schema_1.BaseModelSchema.safeExtend({
+    reservationType: zod_1.z.enum(type_definitions_1.ResourceType).describe("Category of reservation: ROOM (hotel stay), TABLE (restaurant seating), RENTAL (hourly/daily equipment/space), or OTHER. Determines pricing model and fulfillment workflow."),
+    resourceId: zod_1.z.string().optional().nullable().describe("References specific Resource from reservation-resource.schema being reserved (e.g., 'Table 5', 'Room 101'). Null for general availability reservations without specific resource assignment."),
+    customerId: zod_1.z.string().describe("References Customer who made this reservation. Links to customer profile for history, preferences, and communication."),
+    startTime: zod_1.z.number().describe("Unix timestamp for reservation start. Critical for availability management, customer notifications, and operational scheduling."),
+    endTime: zod_1.z.number().optional().describe("Unix timestamp for reservation end. Calculated from startTime + duration. Used for availability blocking and checkout management."),
+    duration: zod_1.z.number().nonnegative().optional().describe("Reservation length in units matching reservationType (hours for TABLE/RENTAL, days for ROOM). Used for pricing calculations and availability management."),
+    personsNumber: zod_1.z.number().int().nonnegative().optional().describe("Party size or occupancy count. Used to match customers with appropriately sized resources (table capacity, room occupancy). Critical for resource allocation."),
+    totalPrice: zod_1.z.number().nonnegative().optional().describe("Total reservation cost in account's currency. Calculated from duration, resource pricing, and any applicable fees. Used for payment processing."),
+    depositPaid: zod_1.z.number().nonnegative().default(0).describe("Deposit amount already paid to secure reservation. Used for payment tracking and no-show protection. Defaults to 0."),
+    status: zod_1.z.enum(type_definitions_1.AppointmentStatus).default(type_definitions_1.AppointmentStatus.PENDING).describe("Current reservation status tracking from booking through check-in to completion. Used for operational workflow and customer notifications. Defaults to PENDING."),
+    notes: zod_1.z.string().optional().describe("Customer's special requests or preferences (e.g., 'window table', 'early check-in', 'quiet room'). Communicated to staff for enhanced service delivery."),
+    cancelReason: zod_1.z.string().nullable().optional().describe("Reason provided when reservation is cancelled. Used for analytics, refund processing, and customer service improvement."),
+    isResourceReservation: zod_1.z.boolean().default(false).describe("Whether this is a specific resource reservation (true) or general availability booking (false). True when resourceId is assigned. Defaults to false."),
+    serviceConversationConfigId: zod_1.z.string().nullable().optional().describe("References the AI Powered Services conversation configuration that powered this reservation. Links reservation to deployment channel and conversation history."),
+});
+/**
+ * Schema for creating a new reservation.
+ * Omits auto-generated fields.
+ */
+exports.CreateReservationSchema = exports.ReservationSchema.omit({
+    id: true,
+    createdAt: true,
+    updatedAt: true,
+    status: true,
+    cancelReason: true,
+    serviceConversationConfigId: true,
+});
+/**
+ * Schema for updating an existing reservation.
+ * All fields are optional except id.
+ */
+exports.UpdateReservationSchema = exports.CreateReservationSchema.partial().safeExtend({
+    id: zod_1.z.string(),
+    cancelReason: zod_1.z.string().nullable().optional(),
+});

package/dist/core/business-mgt/service-appointment.schema.d.ts

@@ -0,0 +1,105 @@
+import z from "zod";
+import { AppointmentStatus, CalendarProvider, ResourceType } from "../type-definitions";
+/**
+ * @fileoverview Service appointment schema definitions for managing appointment bookings.
+ * @module business-mgt/service-appointment
+ */
+/**
+ * Service appointment schema.
+ *
+ * @typedef {Object} ServiceAppointment
+ * @property {string} businessServiceId - ID of the service being booked
+ * @property {string} customerId - Customer ID if registered
+ * @property {number} startTime - Appointment start time as Unix timestamp
+ * @property {number} [endTime] - Appointment end time as Unix timestamp
+ * @property {number} duration - Duration in minutes
+ * @property {number} totalPrice - Total price for the service
+ * @property {number} depositPaid - Deposit amount paid
+ * @property {string} status - Current appointment status
+ * @property {string} [assignedUserAccountId] - User account managing the appointment
+ * @property {string} [calendarId] - Calendar ID where appointment is stored
+ * @property {string} [calendarEventId] - External calendar event ID
+ * @property {string} [calendarProvider] - Calendar provider type
+ * @property {string} [cancelReason] - Reason for cancellation, if applicable
+ * @property {string} [serviceConversationConfigId] - Configuration ID for service conversation
+ */
+export declare const ServiceAppointmentSchema: z.ZodObject<{
+    id: z.ZodString;
+    createdAt: z.ZodOptional<z.ZodNumber>;
+    updatedAt: z.ZodOptional<z.ZodNumber>;
+    businessServiceId: z.ZodString;
+    customerId: z.ZodString;
+    startTime: z.ZodNumber;
+    endTime: z.ZodOptional<z.ZodNumber>;
+    duration: z.ZodOptional<z.ZodDefault<z.ZodNumber>>;
+    totalPrice: z.ZodOptional<z.ZodDefault<z.ZodNumber>>;
+    depositPaid: z.ZodDefault<z.ZodNumber>;
+    status: z.ZodDefault<z.ZodEnum<typeof AppointmentStatus>>;
+    assignedUserAccountId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    calendarId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    calendarEventId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    calendarProvider: z.ZodOptional<z.ZodNullable<z.ZodEnum<typeof CalendarProvider>>>;
+    cancelReason: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    serviceConversationConfigId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+}, z.core.$strip>;
+/**
+ * Schema for creating a new service appointment.
+ * Omits auto-generated fields.
+ */
+export declare const CreateServiceAppointmentSchema: z.ZodObject<{
+    businessServiceId: z.ZodString;
+    customerId: z.ZodString;
+    duration: z.ZodOptional<z.ZodDefault<z.ZodNumber>>;
+    totalPrice: z.ZodOptional<z.ZodDefault<z.ZodNumber>>;
+    assignedUserAccountId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    calendarId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    calendarEventId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    calendarProvider: z.ZodOptional<z.ZodNullable<z.ZodEnum<typeof CalendarProvider>>>;
+    startTime: z.ZodNumber;
+    endTime: z.ZodOptional<z.ZodNumber>;
+    depositPaid: z.ZodDefault<z.ZodNumber>;
+}, z.core.$strip>;
+/**
+ * Schema for updating an existing service appointment.
+ * All fields are optional except id.
+ */
+export declare const UpdateServiceAppointmentSchema: z.ZodObject<{
+    businessServiceId: z.ZodOptional<z.ZodString>;
+    customerId: z.ZodOptional<z.ZodString>;
+    duration: z.ZodOptional<z.ZodOptional<z.ZodDefault<z.ZodNumber>>>;
+    totalPrice: z.ZodOptional<z.ZodOptional<z.ZodDefault<z.ZodNumber>>>;
+    assignedUserAccountId: z.ZodOptional<z.ZodOptional<z.ZodNullable<z.ZodString>>>;
+    calendarId: z.ZodOptional<z.ZodOptional<z.ZodNullable<z.ZodString>>>;
+    calendarEventId: z.ZodOptional<z.ZodOptional<z.ZodNullable<z.ZodString>>>;
+    calendarProvider: z.ZodOptional<z.ZodOptional<z.ZodNullable<z.ZodEnum<typeof CalendarProvider>>>>;
+    startTime: z.ZodOptional<z.ZodNumber>;
+    endTime: z.ZodOptional<z.ZodOptional<z.ZodNumber>>;
+    depositPaid: z.ZodOptional<z.ZodDefault<z.ZodNumber>>;
+    id: z.ZodString;
+    cancelReason: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+}, z.core.$strip>;
+export type ServiceAppointment = z.infer<typeof ServiceAppointmentSchema>;
+export type CreateServiceAppointment = z.infer<typeof CreateServiceAppointmentSchema>;
+export type UpdateServiceAppointment = z.infer<typeof UpdateServiceAppointmentSchema>;
+export interface ReservationFilters {
+    search?: string;
+    status?: AppointmentStatus[];
+    reservationType?: ResourceType[];
+    resourceId?: string;
+    customerId?: string;
+    isResourceReservation?: boolean;
+    dateRange?: {
+        start?: number;
+        end?: number;
+    };
+}
+export interface ReservationSorting {
+    field: 'startTime' | 'endTime' | 'createdAt';
+    direction: 'asc' | 'desc';
+}
+export interface ReservationQueryOptions {
+    page: number;
+    pageSize: number;
+    filters?: ReservationFilters;
+    sorting?: ReservationSorting;
+}

package/dist/core/business-mgt/service-appointment.schema.js

@@ -0,0 +1,69 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.UpdateServiceAppointmentSchema = exports.CreateServiceAppointmentSchema = exports.ServiceAppointmentSchema = void 0;
+const zod_1 = __importDefault(require("zod"));
+const base_schema_1 = require("../base.schema");
+const type_definitions_1 = require("../type-definitions");
+/**
+ * @fileoverview Service appointment schema definitions for managing appointment bookings.
+ * @module business-mgt/service-appointment
+ */
+/**
+ * Service appointment schema.
+ *
+ * @typedef {Object} ServiceAppointment
+ * @property {string} businessServiceId - ID of the service being booked
+ * @property {string} customerId - Customer ID if registered
+ * @property {number} startTime - Appointment start time as Unix timestamp
+ * @property {number} [endTime] - Appointment end time as Unix timestamp
+ * @property {number} duration - Duration in minutes
+ * @property {number} totalPrice - Total price for the service
+ * @property {number} depositPaid - Deposit amount paid
+ * @property {string} status - Current appointment status
+ * @property {string} [assignedUserAccountId] - User account managing the appointment
+ * @property {string} [calendarId] - Calendar ID where appointment is stored
+ * @property {string} [calendarEventId] - External calendar event ID
+ * @property {string} [calendarProvider] - Calendar provider type
+ * @property {string} [cancelReason] - Reason for cancellation, if applicable
+ * @property {string} [serviceConversationConfigId] - Configuration ID for service conversation
+ */
+exports.ServiceAppointmentSchema = base_schema_1.BaseModelSchema.safeExtend({
+    businessServiceId: zod_1.default.string().describe("References Business Service from service-config.schema being booked. Links appointment to service catalog for pricing, duration, and service details."),
+    customerId: zod_1.default.string().describe("References Customer who booked this appointment. Links to customer profile for history, preferences, and communication."),
+    startTime: zod_1.default.number().describe("Unix timestamp for appointment start. Critical for Service Person scheduling, availability management, and customer notifications."),
+    endTime: zod_1.default.number().optional().describe("Unix timestamp for appointment end. Calculated from startTime + duration. Used for calendar blocking and scheduling next appointments."),
+    duration: zod_1.default.number().int().positive().default(30).optional().describe("Appointment length in minutes. Typically inherited from Business Service duration but can be customized per appointment. Defaults to 30 minutes."),
+    totalPrice: zod_1.default.number().nonnegative().default(0).optional().describe("Total service cost in account's currency. Typically inherited from Business Service price but may include customizations or discounts. Defaults to 0 for complimentary services."),
+    depositPaid: zod_1.default.number().nonnegative().default(0).describe("Deposit amount already paid to secure appointment. Used for payment tracking and no-show protection. Defaults to 0."),
+    status: zod_1.default.enum(type_definitions_1.AppointmentStatus).default(type_definitions_1.AppointmentStatus.PENDING).describe("Current appointment status tracking from booking through completion or cancellation. Used for operational workflow and customer notifications. Defaults to PENDING."),
+    // Calendar Integration
+    assignedUserAccountId: zod_1.default.string().nullable().optional().describe("References Service Person assigned to perform this service. Links to accountId from service-person.schema for provider scheduling and workload distribution."),
+    calendarId: zod_1.default.string().nullable().optional().describe("External calendar system ID where this appointment is synced (Google Calendar, Outlook, etc.). Enables two-way appointment synchronization."),
+    calendarEventId: zod_1.default.string().nullable().optional().describe("Event ID in external calendar system. Used to update or delete calendar events when appointment changes. Links WIIL appointment to calendar provider's event."),
+    calendarProvider: zod_1.default.enum(type_definitions_1.CalendarProvider).nullable().optional().describe("Calendar system type (GOOGLE, MICROSOFT, APPLE, etc.). Determines API endpoints and authentication for calendar sync operations."),
+    cancelReason: zod_1.default.string().nullable().optional().describe("Reason provided when appointment is cancelled. Used for analytics, refund processing, and service improvement."),
+    serviceConversationConfigId: zod_1.default.string().nullable().optional().describe("References the AI Powered Services conversation configuration that powered this appointment booking. Links appointment to deployment channel and conversation history."),
+});
+/**
+ * Schema for creating a new service appointment.
+ * Omits auto-generated fields.
+ */
+exports.CreateServiceAppointmentSchema = exports.ServiceAppointmentSchema.omit({
+    id: true,
+    createdAt: true,
+    updatedAt: true,
+    status: true,
+    cancelReason: true,
+    serviceConversationConfigId: true,
+});
+/**
+ * Schema for updating an existing service appointment.
+ * All fields are optional except id.
+ */
+exports.UpdateServiceAppointmentSchema = exports.CreateServiceAppointmentSchema.partial().safeExtend({
+    id: zod_1.default.string(),
+    cancelReason: zod_1.default.string().nullable().optional(),
+});