wiil-core-js 0.0.82

package/dist/core/business-mgt/property-management/property-inquiry.schema.js

@@ -0,0 +1,131 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.UpdatePropertyInquiryStatusSchema = exports.UpdatePropertyInquirySchema = exports.CreatePropertyInquirySchema = exports.PropertyInquirySchema = void 0;
+const zod_1 = __importDefault(require("zod"));
+const base_schema_1 = require("../../base.schema");
+const type_definitions_1 = require("../../type-definitions");
+const customer_schema_1 = require("../customer-management/customer.schema");
+/**
+ * @fileoverview Property Inquiry schema definitions for property management.
+ * @module business-mgt/property-inquiry
+ *
+ * Property inquiries track leads and customer interest in properties,
+ * including viewing scheduling, follow-ups, and conversion tracking.
+ */
+// ============================================================================
+// PROPERTY INQUIRY SCHEMA
+// ============================================================================
+/**
+ * Property Inquiry schema.
+ * Tracks customer inquiries about properties with viewing and follow-up management.
+ *
+ * @typedef {Object} PropertyInquiry
+ * @property {string} propertyId - ID of the property being inquired about
+ * @property {string} [customerId] - ID of existing contact in system
+ * @property {Object} [customer] - Contact details of the inquirer
+ * @property {PropertyInquiryType} inquiryType - Type of inquiry
+ * @property {string} [message] - Inquiry message from the contact
+ * @property {string} source - Source of the inquiry
+ * @property {PropertyInquiryStatus} status - Current status of the inquiry
+ * @property {number} [preferredViewingDate] - Contact's preferred viewing date
+ * @property {string} [preferredViewingTime] - Contact's preferred viewing time
+ * @property {number} [scheduledViewingDate] - Scheduled viewing date
+ * @property {boolean} viewingCompleted - Whether the viewing has been completed
+ * @property {string} [viewingNotes] - Notes from the viewing
+ * @property {number} [followUpDate] - Next follow-up date
+ * @property {string} [followUpNotes] - Notes for follow-up
+ * @property {string} [assignedAgentId] - ID of the assigned agent
+ * @property {boolean} convertedToTransaction - Whether inquiry converted to a transaction
+ * @property {string} [transactionId] - ID of the resulting transaction
+ * @property {string} [transactionType] - Type of transaction (purchase or lease)
+ * @property {boolean} interestedInBuying - Whether contact is interested in buying
+ * @property {boolean} interestedInRenting - Whether contact is interested in renting
+ * @property {number} [budgetMin] - Minimum budget
+ * @property {number} [budgetMax] - Maximum budget
+ * @property {string} [notes] - Internal notes about the inquiry
+ * @property {string} [appointmentRecordId] - Linked appointment record ID
+ * @property {string} [cancelReason] - Reason for cancellation
+ * @property {string} [serviceConversationConfigId] - Service conversation config ID
+ */
+exports.PropertyInquirySchema = base_schema_1.BaseModelSchema.safeExtend({
+    propertyId: zod_1.default.string().describe("ID of the property being inquired about"),
+    // Contact Information
+    customerId: zod_1.default.string().nullable().optional().describe("ID of existing contact in system"),
+    customer: customer_schema_1.CustomerSchema.nullable().optional().describe("Contact details of the inquirer"),
+    // Inquiry Details
+    inquiryType: zod_1.default.enum(type_definitions_1.PropertyInquiryType).describe("Type of inquiry"),
+    message: zod_1.default.string().nullable().optional().describe("Inquiry message from the contact"),
+    source: zod_1.default.string().default('direct').describe("Source of the inquiry (website, referral, agent, etc.)"),
+    // Status
+    status: zod_1.default.enum(type_definitions_1.PropertyInquiryStatus).default(type_definitions_1.PropertyInquiryStatus.NEW).describe("Current status of the inquiry"),
+    // Scheduling
+    preferredViewingDate: zod_1.default.number().nullable().optional().describe("Contact's preferred viewing date (timestamp)"),
+    preferredViewingTime: zod_1.default.string().nullable().optional().describe("Contact's preferred viewing time"),
+    scheduledViewingDate: zod_1.default.number().nullable().optional().describe("Scheduled viewing date (timestamp)"),
+    viewingCompleted: zod_1.default.boolean().default(false).describe("Whether the viewing has been completed"),
+    viewingNotes: zod_1.default.string().nullable().optional().describe("Notes from the viewing"),
+    // Follow-up
+    followUpDate: zod_1.default.number().nullable().optional().describe("Next follow-up date (timestamp)"),
+    followUpNotes: zod_1.default.string().nullable().optional().describe("Notes for follow-up"),
+    assignedAgentId: zod_1.default.string().nullable().optional().describe("ID of the assigned agent"),
+    // Conversion Tracking
+    convertedToTransaction: zod_1.default.boolean().default(false).describe("Whether inquiry converted to a transaction"),
+    transactionId: zod_1.default.string().nullable().optional().describe("ID of the resulting transaction"),
+    transactionType: zod_1.default.enum(['purchase', 'lease']).nullable().optional().describe("Type of transaction (purchase or lease)"),
+    // Interest Details
+    interestedInBuying: zod_1.default.boolean().default(false).describe("Whether contact is interested in buying"),
+    interestedInRenting: zod_1.default.boolean().default(false).describe("Whether contact is interested in renting"),
+    budgetMin: zod_1.default.number().nonnegative().nullable().optional().describe("Minimum budget"),
+    budgetMax: zod_1.default.number().nonnegative().nullable().optional().describe("Maximum budget"),
+    // Notes
+    notes: zod_1.default.string().nullable().optional().describe("Internal notes about the inquiry"),
+    // Calendar Integration
+    appointmentRecordId: zod_1.default.string().nullable().optional().describe("Linked appointment record ID for scheduled viewings"),
+    cancelReason: zod_1.default.string().nullable().optional().describe("Reason for cancellation, if applicable"),
+    serviceConversationConfigId: zod_1.default.string().nullable().optional().describe("Configuration ID for service conversation"),
+});
+// ============================================================================
+// CREATE/UPDATE SCHEMAS
+// ============================================================================
+/**
+ * Schema for creating a new property inquiry.
+ */
+exports.CreatePropertyInquirySchema = exports.PropertyInquirySchema.omit({
+    id: true,
+    createdAt: true,
+    updatedAt: true,
+    customer: true,
+});
+/**
+ * Schema for updating an existing property inquiry.
+ *
+ * @remarks
+ * Fields that carry a `.default()` on the base schema are re-declared here as plain
+ * `.optional()` (without defaults). In Zod, `.partial()` does not strip defaults, so a
+ * partial update would otherwise inject those defaults (e.g., `status`, `source`) on
+ * `.parse()` and submit values the caller never set.
+ */
+exports.UpdatePropertyInquirySchema = exports.CreatePropertyInquirySchema.partial().safeExtend({
+    id: zod_1.default.string().describe("Unique identifier of the PropertyInquiry to update"),
+    source: zod_1.default.string().optional().describe("Source of the inquiry (website, referral, agent, etc.)"),
+    status: zod_1.default.enum(type_definitions_1.PropertyInquiryStatus).optional().describe("Current status of the inquiry"),
+    viewingCompleted: zod_1.default.boolean().optional().describe("Whether the viewing has been completed"),
+    convertedToTransaction: zod_1.default.boolean().optional().describe("Whether inquiry converted to a transaction"),
+    interestedInBuying: zod_1.default.boolean().optional().describe("Whether contact is interested in buying"),
+    interestedInRenting: zod_1.default.boolean().optional().describe("Whether contact is interested in renting"),
+});
+/**
+ * Schema for quick status update on property inquiry.
+ */
+exports.UpdatePropertyInquiryStatusSchema = zod_1.default.object({
+    id: zod_1.default.string().describe("Inquiry ID"),
+    status: zod_1.default.enum(type_definitions_1.PropertyInquiryStatus).describe("New status"),
+    scheduledViewingDate: zod_1.default.number().nullable().optional().describe("Scheduled viewing date"),
+    viewingCompleted: zod_1.default.boolean().optional().describe("Whether viewing is completed"),
+    viewingNotes: zod_1.default.string().nullable().optional().describe("Viewing notes"),
+    followUpDate: zod_1.default.number().nullable().optional().describe("Follow-up date"),
+    followUpNotes: zod_1.default.string().nullable().optional().describe("Follow-up notes"),
+});

package/dist/core/business-mgt/reservation-mgt/assignment/index.d.ts

@@ -0,0 +1,3 @@
+export * from "./reservation-table-assignment.schema";
+export * from "./reservation-room-assignment.schema";
+export * from "./reservation-rental-assignment.schema";

package/dist/core/business-mgt/reservation-mgt/assignment/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("./reservation-table-assignment.schema"), exports);
+__exportStar(require("./reservation-room-assignment.schema"), exports);
+__exportStar(require("./reservation-rental-assignment.schema"), exports);

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

@@ -0,0 +1,139 @@
+import { z } from "zod";
+/**
+ * @fileoverview Rental assignment schema definitions.
+ * @module business-mgt/reservation-mgt/assignment/rental-assignment
+ */
+/**
+ * Rental assignment lifecycle status.
+ *
+ * @enum {string}
+ */
+export declare enum RentalAssignmentStatus {
+    ASSIGNED = "assigned",
+    REASSIGNED = "reassigned",
+    RELEASED = "released"
+}
+/**
+ * Rental assignment lock type.
+ *
+ * @enum {string}
+ */
+export declare enum RentalAssignmentType {
+    SOFT = "soft",
+    HARD = "hard"
+}
+/**
+ * Rental unit condition schema.
+ * Captures a condition inspection snapshot at pickup or return.
+ *
+ * @typedef {Object} RentalUnitCondition
+ * @property {number} recordedAt - Condition recording timestamp
+ * @property {string} recordedBy - Staff user ID that recorded the condition
+ * @property {string} [notes] - Condition notes
+ * @property {boolean} damageReported - Whether damage was reported
+ * @property {string[]} [imageUrls] - Condition photo URLs
+ */
+export declare const RentalUnitConditionSchema: z.ZodObject<{
+    recordedAt: z.ZodNumber;
+    recordedBy: z.ZodString;
+    notes: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    damageReported: z.ZodDefault<z.ZodBoolean>;
+    imageUrls: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodURL>>>;
+}, z.core.$strip>;
+/**
+ * Rental assignment schema.
+ * Records the physical rental unit assigned to a rental reservation.
+ *
+ * @typedef {Object} RentalAssignment
+ * @property {string} [locationId] - Business location where the rental unit is assigned
+ * @property {string} reservationId - Rental reservation ID
+ * @property {string} rentalInstanceId - Physical rental resource instance ID
+ * @property {number} slotStart - Reservation slot start, copied from reservation at assignment time
+ * @property {number} slotEnd - Reservation slot end, copied from reservation at assignment time
+ * @property {RentalAssignmentType} assignmentType - Assignment lock type
+ * @property {RentalAssignmentStatus} status - Current assignment status
+ * @property {number} assignedAt - Assignment timestamp
+ * @property {string} [assignedBy] - Staff user ID that made the assignment
+ * @property {number} [releasedAt] - Release timestamp
+ * @property {string} [releasedBy] - Staff user ID that released the assignment
+ * @property {RentalUnitCondition} [conditionAtPickup] - Pickup condition snapshot
+ * @property {RentalUnitCondition} [conditionAtReturn] - Return condition snapshot
+ * @property {string} [notes] - Operational staff notes
+ */
+export declare const RentalAssignmentSchema: z.ZodObject<{
+    id: z.ZodString;
+    createdAt: z.ZodOptional<z.ZodNumber>;
+    updatedAt: z.ZodOptional<z.ZodNumber>;
+    locationId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    reservationId: z.ZodString;
+    rentalInstanceId: z.ZodString;
+    slotStart: z.ZodNumber;
+    slotEnd: z.ZodNumber;
+    assignmentType: z.ZodDefault<z.ZodEnum<typeof RentalAssignmentType>>;
+    status: z.ZodDefault<z.ZodEnum<typeof RentalAssignmentStatus>>;
+    assignedAt: z.ZodNumber;
+    assignedBy: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    releasedAt: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    releasedBy: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    conditionAtPickup: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+        recordedAt: z.ZodNumber;
+        recordedBy: z.ZodString;
+        notes: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        damageReported: z.ZodDefault<z.ZodBoolean>;
+        imageUrls: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodURL>>>;
+    }, z.core.$strip>>>;
+    conditionAtReturn: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+        recordedAt: z.ZodNumber;
+        recordedBy: z.ZodString;
+        notes: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        damageReported: z.ZodDefault<z.ZodBoolean>;
+        imageUrls: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodURL>>>;
+    }, z.core.$strip>>>;
+    notes: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+}, z.core.$strip>;
+export type RentalUnitCondition = z.infer<typeof RentalUnitConditionSchema>;
+export type RentalAssignment = z.infer<typeof RentalAssignmentSchema>;
+/**
+ * Rental assignment filter options.
+ * @interface RentalAssignmentFilters
+ */
+export interface RentalAssignmentFilters {
+    /** Filter by rental reservation ID */
+    reservationId?: string;
+    /** Filter by rental resource instance ID */
+    rentalInstanceId?: string;
+    /** Filter by assignment statuses */
+    status?: RentalAssignmentStatus[];
+    /** Filter by assignment lock type */
+    assignmentType?: RentalAssignmentType;
+    /** Filter by assigning staff user ID */
+    assignedBy?: string;
+    /** Filter by business location ID */
+    locationId?: string;
+    /** Filter assignments where damage was reported */
+    damageReported?: boolean;
+}
+/**
+ * Rental assignment sorting options.
+ * @interface RentalAssignmentSorting
+ */
+export interface RentalAssignmentSorting {
+    /** Field to sort by */
+    field: "assignedAt" | "releasedAt" | "createdAt";
+    /** Sort direction */
+    direction: "asc" | "desc";
+}
+/**
+ * Rental assignment query options.
+ * @interface RentalAssignmentQueryOptions
+ */
+export interface RentalAssignmentQueryOptions {
+    /** Page number (1-indexed) */
+    page: number;
+    /** Items per page */
+    pageSize: number;
+    /** Optional filters */
+    filters?: RentalAssignmentFilters;
+    /** Optional sorting */
+    sorting?: RentalAssignmentSorting;
+}

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

@@ -0,0 +1,90 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RentalAssignmentSchema = exports.RentalUnitConditionSchema = exports.RentalAssignmentType = exports.RentalAssignmentStatus = void 0;
+const zod_1 = require("zod");
+const base_schema_1 = require("../../../base.schema");
+/**
+ * @fileoverview Rental assignment schema definitions.
+ * @module business-mgt/reservation-mgt/assignment/rental-assignment
+ */
+// ============================================================================
+// ENUMS
+// ============================================================================
+/**
+ * Rental assignment lifecycle status.
+ *
+ * @enum {string}
+ */
+var RentalAssignmentStatus;
+(function (RentalAssignmentStatus) {
+    RentalAssignmentStatus["ASSIGNED"] = "assigned";
+    RentalAssignmentStatus["REASSIGNED"] = "reassigned";
+    RentalAssignmentStatus["RELEASED"] = "released";
+})(RentalAssignmentStatus || (exports.RentalAssignmentStatus = RentalAssignmentStatus = {}));
+/**
+ * Rental assignment lock type.
+ *
+ * @enum {string}
+ */
+var RentalAssignmentType;
+(function (RentalAssignmentType) {
+    RentalAssignmentType["SOFT"] = "soft";
+    RentalAssignmentType["HARD"] = "hard";
+})(RentalAssignmentType || (exports.RentalAssignmentType = RentalAssignmentType = {}));
+// ============================================================================
+// RENTAL ASSIGNMENT SCHEMAS
+// ============================================================================
+/**
+ * Rental unit condition schema.
+ * Captures a condition inspection snapshot at pickup or return.
+ *
+ * @typedef {Object} RentalUnitCondition
+ * @property {number} recordedAt - Condition recording timestamp
+ * @property {string} recordedBy - Staff user ID that recorded the condition
+ * @property {string} [notes] - Condition notes
+ * @property {boolean} damageReported - Whether damage was reported
+ * @property {string[]} [imageUrls] - Condition photo URLs
+ */
+exports.RentalUnitConditionSchema = zod_1.z.object({
+    recordedAt: zod_1.z.number().int().positive().describe("Unix timestamp when the condition was recorded."),
+    recordedBy: zod_1.z.string().describe("Staff user ID who recorded the condition."),
+    notes: zod_1.z.string().nullable().optional().describe("Condition notes recorded during inspection."),
+    damageReported: zod_1.z.boolean().default(false).describe("Whether damage was reported during this inspection."),
+    imageUrls: zod_1.z.array(zod_1.z.url()).nullable().optional().describe("Condition photo URLs captured during inspection."),
+}).describe("Condition snapshot recorded at pickup or return");
+/**
+ * Rental assignment schema.
+ * Records the physical rental unit assigned to a rental reservation.
+ *
+ * @typedef {Object} RentalAssignment
+ * @property {string} [locationId] - Business location where the rental unit is assigned
+ * @property {string} reservationId - Rental reservation ID
+ * @property {string} rentalInstanceId - Physical rental resource instance ID
+ * @property {number} slotStart - Reservation slot start, copied from reservation at assignment time
+ * @property {number} slotEnd - Reservation slot end, copied from reservation at assignment time
+ * @property {RentalAssignmentType} assignmentType - Assignment lock type
+ * @property {RentalAssignmentStatus} status - Current assignment status
+ * @property {number} assignedAt - Assignment timestamp
+ * @property {string} [assignedBy] - Staff user ID that made the assignment
+ * @property {number} [releasedAt] - Release timestamp
+ * @property {string} [releasedBy] - Staff user ID that released the assignment
+ * @property {RentalUnitCondition} [conditionAtPickup] - Pickup condition snapshot
+ * @property {RentalUnitCondition} [conditionAtReturn] - Return condition snapshot
+ * @property {string} [notes] - Operational staff notes
+ */
+exports.RentalAssignmentSchema = base_schema_1.BaseModelSchema.safeExtend({
+    locationId: zod_1.z.string().nullable().optional().describe("Business location ID where the assigned rental unit is located."),
+    reservationId: zod_1.z.string().describe("RentalReservation ID. This link is immutable after assignment creation."),
+    rentalInstanceId: zod_1.z.string().describe("ResourceInstance ID for the specific rental unit assigned to the reservation."),
+    slotStart: zod_1.z.number().int().positive().describe("Reservation slot start — copied from reservation at assignment time"),
+    slotEnd: zod_1.z.number().int().positive().describe("Reservation slot end — copied from reservation at assignment time"),
+    assignmentType: zod_1.z.enum(RentalAssignmentType).default(RentalAssignmentType.SOFT).describe("Assignment lock type. Soft assignments may be substituted; hard assignments are customer or staff locked."),
+    status: zod_1.z.enum(RentalAssignmentStatus).default(RentalAssignmentStatus.ASSIGNED).describe("Current assignment lifecycle status."),
+    assignedAt: zod_1.z.number().int().positive().describe("Unix timestamp when this assignment was made."),
+    assignedBy: zod_1.z.string().nullable().optional().describe("Staff user ID who made the assignment."),
+    releasedAt: zod_1.z.number().int().positive().nullable().optional().describe("Unix timestamp when this assignment was released or superseded."),
+    releasedBy: zod_1.z.string().nullable().optional().describe("Staff user ID who released the assignment."),
+    conditionAtPickup: exports.RentalUnitConditionSchema.nullable().optional().describe("Unit condition recorded at customer pickup."),
+    conditionAtReturn: exports.RentalUnitConditionSchema.nullable().optional().describe("Unit condition recorded at customer return."),
+    notes: zod_1.z.string().nullable().optional().describe("Operational note for staff about this rental assignment."),
+});

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

@@ -0,0 +1,104 @@
+import { z } from "zod";
+/**
+ * @fileoverview Room assignment schema definitions.
+ * @module business-mgt/reservation-mgt/assignment/room-assignment
+ */
+/**
+ * Room assignment lifecycle status.
+ *
+ * @enum {string}
+ */
+export declare enum RoomAssignmentStatus {
+    ASSIGNED = "assigned",
+    REASSIGNED = "reassigned",
+    RELEASED = "released"
+}
+/**
+ * Room assignment lock type.
+ *
+ * @enum {string}
+ */
+export declare enum RoomAssignmentType {
+    SOFT = "soft",
+    HARD = "hard"
+}
+/**
+ * Room assignment schema.
+ * Records the physical room instance assigned to a room reservation.
+ *
+ * @typedef {Object} RoomAssignment
+ * @property {string} [locationId] - Business location where the room is assigned
+ * @property {string} reservationId - Room reservation ID
+ * @property {string} roomInstanceId - Physical room resource instance ID
+ * @property {number} slotStart - Reservation slot start, copied from reservation at assignment time
+ * @property {number} slotEnd - Reservation slot end, copied from reservation at assignment time
+ * @property {RoomAssignmentType} assignmentType - Assignment lock type
+ * @property {RoomAssignmentStatus} status - Current assignment status
+ * @property {number} assignedAt - Assignment timestamp
+ * @property {string} [assignedBy] - Staff user ID that made the assignment
+ * @property {number} [releasedAt] - Release timestamp
+ * @property {string} [releasedBy] - Staff user ID that released the assignment
+ * @property {string} [housekeepingNotes] - Housekeeping handoff notes
+ * @property {string} [notes] - Operational staff notes
+ */
+export declare const RoomAssignmentSchema: z.ZodObject<{
+    id: z.ZodString;
+    createdAt: z.ZodOptional<z.ZodNumber>;
+    updatedAt: z.ZodOptional<z.ZodNumber>;
+    locationId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    reservationId: z.ZodString;
+    roomInstanceId: z.ZodString;
+    slotStart: z.ZodNumber;
+    slotEnd: z.ZodNumber;
+    assignmentType: z.ZodDefault<z.ZodEnum<typeof RoomAssignmentType>>;
+    status: z.ZodDefault<z.ZodEnum<typeof RoomAssignmentStatus>>;
+    assignedAt: z.ZodNumber;
+    assignedBy: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    releasedAt: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    releasedBy: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    housekeepingNotes: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    notes: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+}, z.core.$strip>;
+export type RoomAssignment = z.infer<typeof RoomAssignmentSchema>;
+/**
+ * Room assignment filter options.
+ * @interface RoomAssignmentFilters
+ */
+export interface RoomAssignmentFilters {
+    /** Filter by room reservation ID */
+    reservationId?: string;
+    /** Filter by room resource instance ID */
+    roomInstanceId?: string;
+    /** Filter by assignment statuses */
+    status?: RoomAssignmentStatus[];
+    /** Filter by assignment lock type */
+    assignmentType?: RoomAssignmentType;
+    /** Filter by assigning staff user ID */
+    assignedBy?: string;
+    /** Filter by business location ID */
+    locationId?: string;
+}
+/**
+ * Room assignment sorting options.
+ * @interface RoomAssignmentSorting
+ */
+export interface RoomAssignmentSorting {
+    /** Field to sort by */
+    field: "assignedAt" | "releasedAt" | "createdAt";
+    /** Sort direction */
+    direction: "asc" | "desc";
+}
+/**
+ * Room assignment query options.
+ * @interface RoomAssignmentQueryOptions
+ */
+export interface RoomAssignmentQueryOptions {
+    /** Page number (1-indexed) */
+    page: number;
+    /** Items per page */
+    pageSize: number;
+    /** Optional filters */
+    filters?: RoomAssignmentFilters;
+    /** Optional sorting */
+    sorting?: RoomAssignmentSorting;
+}

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

@@ -0,0 +1,70 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RoomAssignmentSchema = exports.RoomAssignmentType = exports.RoomAssignmentStatus = void 0;
+const zod_1 = require("zod");
+const base_schema_1 = require("../../../base.schema");
+/**
+ * @fileoverview Room assignment schema definitions.
+ * @module business-mgt/reservation-mgt/assignment/room-assignment
+ */
+// ============================================================================
+// ENUMS
+// ============================================================================
+/**
+ * Room assignment lifecycle status.
+ *
+ * @enum {string}
+ */
+var RoomAssignmentStatus;
+(function (RoomAssignmentStatus) {
+    RoomAssignmentStatus["ASSIGNED"] = "assigned";
+    RoomAssignmentStatus["REASSIGNED"] = "reassigned";
+    RoomAssignmentStatus["RELEASED"] = "released";
+})(RoomAssignmentStatus || (exports.RoomAssignmentStatus = RoomAssignmentStatus = {}));
+/**
+ * Room assignment lock type.
+ *
+ * @enum {string}
+ */
+var RoomAssignmentType;
+(function (RoomAssignmentType) {
+    RoomAssignmentType["SOFT"] = "soft";
+    RoomAssignmentType["HARD"] = "hard";
+})(RoomAssignmentType || (exports.RoomAssignmentType = RoomAssignmentType = {}));
+// ============================================================================
+// ROOM ASSIGNMENT SCHEMA
+// ============================================================================
+/**
+ * Room assignment schema.
+ * Records the physical room instance assigned to a room reservation.
+ *
+ * @typedef {Object} RoomAssignment
+ * @property {string} [locationId] - Business location where the room is assigned
+ * @property {string} reservationId - Room reservation ID
+ * @property {string} roomInstanceId - Physical room resource instance ID
+ * @property {number} slotStart - Reservation slot start, copied from reservation at assignment time
+ * @property {number} slotEnd - Reservation slot end, copied from reservation at assignment time
+ * @property {RoomAssignmentType} assignmentType - Assignment lock type
+ * @property {RoomAssignmentStatus} status - Current assignment status
+ * @property {number} assignedAt - Assignment timestamp
+ * @property {string} [assignedBy] - Staff user ID that made the assignment
+ * @property {number} [releasedAt] - Release timestamp
+ * @property {string} [releasedBy] - Staff user ID that released the assignment
+ * @property {string} [housekeepingNotes] - Housekeeping handoff notes
+ * @property {string} [notes] - Operational staff notes
+ */
+exports.RoomAssignmentSchema = base_schema_1.BaseModelSchema.safeExtend({
+    locationId: zod_1.z.string().nullable().optional().describe("Business location ID where the assigned room is located."),
+    reservationId: zod_1.z.string().describe("RoomReservation ID. This link is immutable after assignment creation."),
+    roomInstanceId: zod_1.z.string().describe("ResourceInstance ID for the physical room assigned to the reservation."),
+    slotStart: zod_1.z.number().int().positive().describe("Reservation slot start — copied from reservation at assignment time"),
+    slotEnd: zod_1.z.number().int().positive().describe("Reservation slot end — copied from reservation at assignment time"),
+    assignmentType: zod_1.z.enum(RoomAssignmentType).default(RoomAssignmentType.SOFT).describe("Assignment lock type. Soft assignments may be optimized; hard assignments are staff-locked."),
+    status: zod_1.z.enum(RoomAssignmentStatus).default(RoomAssignmentStatus.ASSIGNED).describe("Current assignment lifecycle status."),
+    assignedAt: zod_1.z.number().int().positive().describe("Unix timestamp when this assignment was made."),
+    assignedBy: zod_1.z.string().nullable().optional().describe("Staff user ID who made the assignment."),
+    releasedAt: zod_1.z.number().int().positive().nullable().optional().describe("Unix timestamp when this assignment was released or superseded."),
+    releasedBy: zod_1.z.string().nullable().optional().describe("Staff user ID who released the assignment."),
+    housekeepingNotes: zod_1.z.string().nullable().optional().describe("Housekeeping handoff notes for this room and guest pairing."),
+    notes: zod_1.z.string().nullable().optional().describe("Operational note for staff about this room assignment."),
+});

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

@@ -0,0 +1,104 @@
+import { z } from "zod";
+/**
+ * @fileoverview Table assignment schema definitions.
+ * @module business-mgt/reservation-mgt/assignment/table-assignment
+ */
+/**
+ * Table assignment lock type.
+ *
+ * @enum {string}
+ */
+export declare enum TableAssignmentType {
+    SOFT = "soft",
+    HARD = "hard"
+}
+/**
+ * Table assignment lifecycle status.
+ *
+ * @enum {string}
+ */
+export declare enum TableAssignmentStatus {
+    ASSIGNED = "assigned",
+    REASSIGNED = "reassigned",
+    RELEASED = "released"
+}
+/**
+ * Table assignment schema.
+ * Records the physical table instance assigned to a table reservation.
+ *
+ * @typedef {Object} TableAssignment
+ * @property {string} [locationId] - Business location where the table is assigned
+ * @property {string} reservationId - Table reservation ID
+ * @property {string} tableInstanceId - Physical table resource instance ID
+ * @property {string} floorPlanId - Floor plan ID captured at assignment time
+ * @property {string} [floorPlanSectionId] - Floor plan section ID captured at assignment time
+ * @property {number} slotStart - Reservation slot start, copied from reservation at assignment time
+ * @property {number} slotEnd - Reservation slot end, copied from reservation at assignment time
+ * @property {TableAssignmentType} assignmentType - Assignment lock type
+ * @property {TableAssignmentStatus} status - Current assignment status
+ * @property {number} assignedAt - Assignment timestamp
+ * @property {string} [assignedBy] - Staff user ID that made the assignment
+ * @property {number} [releasedAt] - Release timestamp
+ * @property {string} [releasedBy] - Staff user ID that released the assignment
+ * @property {string} [notes] - Operational staff notes
+ */
+export declare const TableAssignmentSchema: z.ZodObject<{
+    id: z.ZodString;
+    createdAt: z.ZodOptional<z.ZodNumber>;
+    updatedAt: z.ZodOptional<z.ZodNumber>;
+    locationId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    reservationId: z.ZodString;
+    tableInstanceId: z.ZodString;
+    floorPlanId: z.ZodString;
+    floorPlanSectionId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    slotStart: z.ZodNumber;
+    slotEnd: z.ZodNumber;
+    assignmentType: z.ZodDefault<z.ZodEnum<typeof TableAssignmentType>>;
+    status: z.ZodDefault<z.ZodEnum<typeof TableAssignmentStatus>>;
+    assignedAt: z.ZodNumber;
+    assignedBy: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    releasedAt: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    releasedBy: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    notes: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+}, z.core.$strip>;
+export type TableAssignment = z.infer<typeof TableAssignmentSchema>;
+/**
+ * Table assignment filter options.
+ * @interface TableAssignmentFilters
+ */
+export interface TableAssignmentFilters {
+    /** Filter by table reservation ID */
+    reservationId?: string;
+    /** Filter by table resource instance ID */
+    tableInstanceId?: string;
+    /** Filter by assignment statuses */
+    status?: TableAssignmentStatus[];
+    /** Filter by assigning staff user ID */
+    assignedBy?: string;
+    /** Filter by business location ID */
+    locationId?: string;
+}
+/**
+ * Table assignment sorting options.
+ * @interface TableAssignmentSorting
+ */
+export interface TableAssignmentSorting {
+    /** Field to sort by */
+    field: "assignedAt" | "releasedAt" | "createdAt";
+    /** Sort direction */
+    direction: "asc" | "desc";
+}
+/**
+ * Table assignment query options.
+ * @interface TableAssignmentQueryOptions
+ */
+export interface TableAssignmentQueryOptions {
+    /** Page number (1-indexed) */
+    page: number;
+    /** Items per page */
+    pageSize: number;
+    /** Optional filters */
+    filters?: TableAssignmentFilters;
+    /** Optional sorting */
+    sorting?: TableAssignmentSorting;
+}