wiil-core-js 0.0.82

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

@@ -0,0 +1,72 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TableAssignmentSchema = exports.TableAssignmentStatus = exports.TableAssignmentType = void 0;
+const zod_1 = require("zod");
+const base_schema_1 = require("../../../base.schema");
+/**
+ * @fileoverview Table assignment schema definitions.
+ * @module business-mgt/reservation-mgt/assignment/table-assignment
+ */
+// ============================================================================
+// ENUMS
+// ============================================================================
+/**
+ * Table assignment lock type.
+ *
+ * @enum {string}
+ */
+var TableAssignmentType;
+(function (TableAssignmentType) {
+    TableAssignmentType["SOFT"] = "soft";
+    TableAssignmentType["HARD"] = "hard";
+})(TableAssignmentType || (exports.TableAssignmentType = TableAssignmentType = {}));
+/**
+ * Table assignment lifecycle status.
+ *
+ * @enum {string}
+ */
+var TableAssignmentStatus;
+(function (TableAssignmentStatus) {
+    TableAssignmentStatus["ASSIGNED"] = "assigned";
+    TableAssignmentStatus["REASSIGNED"] = "reassigned";
+    TableAssignmentStatus["RELEASED"] = "released";
+})(TableAssignmentStatus || (exports.TableAssignmentStatus = TableAssignmentStatus = {}));
+// ============================================================================
+// TABLE ASSIGNMENT SCHEMA
+// ============================================================================
+/**
+ * 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
+ */
+exports.TableAssignmentSchema = base_schema_1.BaseModelSchema.safeExtend({
+    locationId: zod_1.z.string().nullable().optional().describe("Business location ID where the assigned table is located."),
+    reservationId: zod_1.z.string().describe("TableReservation ID. This link is immutable after assignment creation."),
+    tableInstanceId: zod_1.z.string().describe("ResourceInstance ID for the physical table assigned to the reservation."),
+    floorPlanId: zod_1.z.string().describe("Floor plan ID captured at the time of assignment."),
+    floorPlanSectionId: zod_1.z.string().nullable().optional().describe("Floor plan section ID captured at the time of assignment."),
+    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(TableAssignmentType).default(TableAssignmentType.SOFT).describe("Assignment lock type. Soft assignments may be optimized; hard assignments are staff-locked."),
+    status: zod_1.z.enum(TableAssignmentStatus).default(TableAssignmentStatus.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."),
+    notes: zod_1.z.string().nullable().optional().describe("Operational note for staff about this table assignment."),
+});

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

@@ -0,0 +1,14 @@
+export * from "./reservation-table.schema";
+export * from "./reservation-room.schema";
+export * from "./reservation-rental.schema";
+export * from "./assignment";
+export * from "./resource/reservation-resource-category.schema";
+export * from "./resource/reservation-resource-instance.schema";
+export * from "./resource/reservation-resource.schema";
+export * from "./reservation-slot-query.schema";
+export * from "./reservation-maintenance-block.schema";
+export * from "./reservation-table-layout.schema";
+export * from "./reservation-section.schema";
+export * from "./reservation-floor-plan-definition.schema";
+export * from "./reservation-settings.schema";
+export * from "./resource/resource-versioning.schema";

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

@@ -0,0 +1,31 @@
+"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 });
+// export * from "./reservation.schema";
+__exportStar(require("./reservation-table.schema"), exports);
+__exportStar(require("./reservation-room.schema"), exports);
+__exportStar(require("./reservation-rental.schema"), exports);
+__exportStar(require("./assignment"), exports);
+__exportStar(require("./resource/reservation-resource-category.schema"), exports);
+__exportStar(require("./resource/reservation-resource-instance.schema"), exports);
+__exportStar(require("./resource/reservation-resource.schema"), exports);
+__exportStar(require("./reservation-slot-query.schema"), exports);
+__exportStar(require("./reservation-maintenance-block.schema"), exports);
+__exportStar(require("./reservation-table-layout.schema"), exports);
+__exportStar(require("./reservation-section.schema"), exports);
+__exportStar(require("./reservation-floor-plan-definition.schema"), exports);
+__exportStar(require("./reservation-settings.schema"), exports);
+__exportStar(require("./resource/resource-versioning.schema"), exports);

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

@@ -0,0 +1,180 @@
+import { z } from "zod";
+import { TableShape } from "./reservation-section.schema";
+/**
+ * @fileoverview Aggregate floor plan definition schemas.
+ * @module business-mgt/reservation-mgt/floor-plan-definition
+ *
+ * Composes the floor plan, its sections, and nested table placements into a single
+ * graph. The Create* variants support atomic creation of a floor plan together with
+ * its sections and tables in one payload, while the response variant returns the
+ * fully hydrated graph.
+ */
+export declare const CreateFloorPlanTablePlacementInputSchema: z.ZodObject<{
+    number: z.ZodString;
+    x: z.ZodNumber;
+    y: z.ZodNumber;
+    width: z.ZodNumber;
+    height: z.ZodNumber;
+    shape: z.ZodEnum<typeof TableShape>;
+    rotation: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    minParty: z.ZodNumber;
+    maxParty: z.ZodNumber;
+    combinableWith: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    serverSectionId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+}, z.core.$strip>;
+export declare const CreateFloorPlanSectionInputSchema: z.ZodObject<{
+    name: z.ZodString;
+    capacity: z.ZodNumber;
+    color: z.ZodString;
+    isActive: z.ZodDefault<z.ZodBoolean>;
+    sortOrder: z.ZodDefault<z.ZodNumber>;
+    geometry: z.ZodOptional<z.ZodNullable<z.ZodDiscriminatedUnion<[z.ZodObject<{
+        kind: z.ZodLiteral<"auto">;
+    }, z.core.$strip>, z.ZodObject<{
+        kind: z.ZodLiteral<"rect">;
+        x: z.ZodNumber;
+        y: z.ZodNumber;
+        width: z.ZodNumber;
+        height: z.ZodNumber;
+        rotation: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>, z.ZodObject<{
+        kind: z.ZodLiteral<"polygon">;
+        points: z.ZodArray<z.ZodObject<{
+            x: z.ZodNumber;
+            y: z.ZodNumber;
+        }, z.core.$strip>>;
+        rotation: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>], "kind">>>;
+    tables: z.ZodArray<z.ZodObject<{
+        number: z.ZodString;
+        x: z.ZodNumber;
+        y: z.ZodNumber;
+        width: z.ZodNumber;
+        height: z.ZodNumber;
+        shape: z.ZodEnum<typeof TableShape>;
+        rotation: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+        minParty: z.ZodNumber;
+        maxParty: z.ZodNumber;
+        combinableWith: z.ZodDefault<z.ZodArray<z.ZodString>>;
+        serverSectionId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export declare const CreateFloorPlanDefinitionSchema: z.ZodObject<{
+    capacity: z.ZodNumber;
+    metadata: z.ZodOptional<z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodAny>>>;
+    name: z.ZodString;
+    description: z.ZodString;
+    isActive: z.ZodDefault<z.ZodBoolean>;
+    locationId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    imageUrls: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodURL>>>;
+    canvasDimensions: z.ZodObject<{
+        width: z.ZodNumber;
+        height: z.ZodNumber;
+        unit: z.ZodDefault<z.ZodEnum<typeof import("./reservation-table-layout.schema").CanvasUnit>>;
+    }, z.core.$strip>;
+    sections: z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        capacity: z.ZodNumber;
+        color: z.ZodString;
+        isActive: z.ZodDefault<z.ZodBoolean>;
+        sortOrder: z.ZodDefault<z.ZodNumber>;
+        geometry: z.ZodOptional<z.ZodNullable<z.ZodDiscriminatedUnion<[z.ZodObject<{
+            kind: z.ZodLiteral<"auto">;
+        }, z.core.$strip>, z.ZodObject<{
+            kind: z.ZodLiteral<"rect">;
+            x: z.ZodNumber;
+            y: z.ZodNumber;
+            width: z.ZodNumber;
+            height: z.ZodNumber;
+            rotation: z.ZodOptional<z.ZodNumber>;
+        }, z.core.$strip>, z.ZodObject<{
+            kind: z.ZodLiteral<"polygon">;
+            points: z.ZodArray<z.ZodObject<{
+                x: z.ZodNumber;
+                y: z.ZodNumber;
+            }, z.core.$strip>>;
+            rotation: z.ZodOptional<z.ZodNumber>;
+        }, z.core.$strip>], "kind">>>;
+        tables: z.ZodArray<z.ZodObject<{
+            number: z.ZodString;
+            x: z.ZodNumber;
+            y: z.ZodNumber;
+            width: z.ZodNumber;
+            height: z.ZodNumber;
+            shape: z.ZodEnum<typeof TableShape>;
+            rotation: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+            minParty: z.ZodNumber;
+            maxParty: z.ZodNumber;
+            combinableWith: z.ZodDefault<z.ZodArray<z.ZodString>>;
+            serverSectionId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        }, z.core.$strip>>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export type CreateFloorPlanTablePlacementInput = z.infer<typeof CreateFloorPlanTablePlacementInputSchema>;
+export type CreateFloorPlanSectionInput = z.infer<typeof CreateFloorPlanSectionInputSchema>;
+export type CreateFloorPlanDefinition = z.infer<typeof CreateFloorPlanDefinitionSchema>;
+export declare const FloorPlanDefinitionSchema: z.ZodObject<{
+    id: z.ZodString;
+    createdAt: z.ZodOptional<z.ZodNumber>;
+    updatedAt: z.ZodOptional<z.ZodNumber>;
+    locationId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    name: z.ZodString;
+    description: z.ZodString;
+    imageUrls: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodURL>>>;
+    isActive: z.ZodDefault<z.ZodBoolean>;
+    canvasDimensions: z.ZodObject<{
+        width: z.ZodNumber;
+        height: z.ZodNumber;
+        unit: z.ZodDefault<z.ZodEnum<typeof import("./reservation-table-layout.schema").CanvasUnit>>;
+    }, z.core.$strip>;
+    capacity: z.ZodNumber;
+    metadata: z.ZodOptional<z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodAny>>>;
+    sections: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        createdAt: z.ZodOptional<z.ZodNumber>;
+        updatedAt: z.ZodOptional<z.ZodNumber>;
+        locationId: z.ZodString;
+        floorPlanId: z.ZodString;
+        name: z.ZodString;
+        capacity: z.ZodNumber;
+        color: z.ZodString;
+        isActive: z.ZodDefault<z.ZodBoolean>;
+        sortOrder: z.ZodDefault<z.ZodNumber>;
+        tables: z.ZodDefault<z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            createdAt: z.ZodOptional<z.ZodNumber>;
+            updatedAt: z.ZodOptional<z.ZodNumber>;
+            tableResourceId: z.ZodString;
+            floorPlanSectionId: z.ZodString;
+            number: z.ZodString;
+            x: z.ZodNumber;
+            y: z.ZodNumber;
+            width: z.ZodNumber;
+            height: z.ZodNumber;
+            shape: z.ZodEnum<typeof TableShape>;
+            rotation: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+            minParty: z.ZodNumber;
+            maxParty: z.ZodNumber;
+            combinableWith: z.ZodDefault<z.ZodArray<z.ZodString>>;
+            serverSectionId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        }, z.core.$strip>>>;
+        geometry: z.ZodOptional<z.ZodNullable<z.ZodDiscriminatedUnion<[z.ZodObject<{
+            kind: z.ZodLiteral<"auto">;
+        }, z.core.$strip>, z.ZodObject<{
+            kind: z.ZodLiteral<"rect">;
+            x: z.ZodNumber;
+            y: z.ZodNumber;
+            width: z.ZodNumber;
+            height: z.ZodNumber;
+            rotation: z.ZodOptional<z.ZodNumber>;
+        }, z.core.$strip>, z.ZodObject<{
+            kind: z.ZodLiteral<"polygon">;
+            points: z.ZodArray<z.ZodObject<{
+                x: z.ZodNumber;
+                y: z.ZodNumber;
+            }, z.core.$strip>>;
+            rotation: z.ZodOptional<z.ZodNumber>;
+        }, z.core.$strip>], "kind">>>;
+    }, z.core.$strip>>>;
+}, z.core.$strip>;
+export type FloorPlanDefinition = z.infer<typeof FloorPlanDefinitionSchema>;

package/dist/core/business-mgt/reservation-mgt/reservation-floor-plan-definition.schema.js

@@ -0,0 +1,75 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FloorPlanDefinitionSchema = exports.CreateFloorPlanDefinitionSchema = exports.CreateFloorPlanSectionInputSchema = exports.CreateFloorPlanTablePlacementInputSchema = void 0;
+const zod_1 = require("zod");
+const reservation_table_layout_schema_1 = require("./reservation-table-layout.schema");
+const reservation_section_schema_1 = require("./reservation-section.schema");
+/**
+ * @fileoverview Aggregate floor plan definition schemas.
+ * @module business-mgt/reservation-mgt/floor-plan-definition
+ *
+ * Composes the floor plan, its sections, and nested table placements into a single
+ * graph. The Create* variants support atomic creation of a floor plan together with
+ * its sections and tables in one payload, while the response variant returns the
+ * fully hydrated graph.
+ */
+// === CreateFloorPlanDefinition: Atomic creation of floor plan with nested sections and tables ===
+exports.CreateFloorPlanTablePlacementInputSchema = zod_1.z.object({
+    number: zod_1.z.string().describe("Human-readable table number"),
+    x: zod_1.z.number().describe("Table x position in layout coordinate space"),
+    y: zod_1.z.number().describe("Table y position in layout coordinate space"),
+    width: zod_1.z.number().positive().describe("Table width in layout units"),
+    height: zod_1.z.number().positive().describe("Table height in layout units"),
+    shape: zod_1.z.enum(reservation_section_schema_1.TableShape).describe("Rendered table shape"),
+    rotation: zod_1.z.number().nullable().optional().describe("Optional table rotation in degrees"),
+    minParty: zod_1.z.number().int().positive().describe("Minimum supported party size"),
+    maxParty: zod_1.z.number().int().positive().describe("Maximum supported party size"),
+    combinableWith: zod_1.z.array(zod_1.z.string()).default([]).describe("Table numbers that can be combined with this table"),
+    serverSectionId: zod_1.z.string().nullable().optional().describe("Server section assignment"),
+}).superRefine((data, ctx) => {
+    if (data.maxParty < data.minParty) {
+        ctx.addIssue({
+            code: "custom",
+            path: ["maxParty"],
+            message: "maxParty must be greater than or equal to minParty",
+        });
+    }
+});
+exports.CreateFloorPlanSectionInputSchema = zod_1.z.object({
+    name: zod_1.z.string().min(1).describe("Section name (e.g., Patio, Main Dining, Bar)"),
+    capacity: zod_1.z.number().int().positive().describe("Total seating capacity of the section"),
+    color: zod_1.z.string().regex(/^#[0-9A-Fa-f]{6}$/).describe("Hex color for floor plan rendering"),
+    isActive: zod_1.z.boolean().default(true).describe("Whether section is currently active"),
+    sortOrder: zod_1.z.number().int().nonnegative().default(0).describe("Display order in lists"),
+    geometry: reservation_section_schema_1.SectionGeometrySchema.nullable().optional(),
+    tables: zod_1.z.array(exports.CreateFloorPlanTablePlacementInputSchema).min(1, "Each section must have at least one table").describe("Tables in this section"),
+}).superRefine((data, ctx) => {
+    if (!Array.isArray(data.tables) || data.tables.length === 0)
+        return;
+    const tablesMaxPartySum = data.tables.reduce((sum, table) => sum + (table?.maxParty ?? 0), 0);
+    if (tablesMaxPartySum !== data.capacity) {
+        ctx.addIssue({
+            code: "custom",
+            path: ["capacity"],
+            message: `Section capacity (${data.capacity}) must equal the sum of its table maxParty values (${tablesMaxPartySum})`,
+        });
+    }
+});
+exports.CreateFloorPlanDefinitionSchema = reservation_table_layout_schema_1.CreateFloorPlanSchema.extend({
+    sections: zod_1.z.array(exports.CreateFloorPlanSectionInputSchema).min(1, "At least one section must be defined").describe("Sections with nested table placements"),
+}).superRefine((data, ctx) => {
+    if (!Array.isArray(data.sections) || data.sections.length === 0)
+        return;
+    const sectionsCapacitySum = data.sections.reduce((sum, section) => sum + (section?.capacity ?? 0), 0);
+    if (sectionsCapacitySum !== data.capacity) {
+        ctx.addIssue({
+            code: "custom",
+            path: ["capacity"],
+            message: `Floor plan capacity (${data.capacity}) must equal the sum of its section capacities (${sectionsCapacitySum})`,
+        });
+    }
+});
+// === FloorPlanDefinition: Graph response with nested sections and tables ===
+exports.FloorPlanDefinitionSchema = reservation_table_layout_schema_1.FloorPlanSchema.extend({
+    sections: zod_1.z.array(reservation_section_schema_1.SectionSchema).default([]).describe("Sections with nested table placements"),
+});

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

@@ -0,0 +1,91 @@
+import { z } from "zod";
+/**
+ * @fileoverview Reservation maintenance block schema definitions.
+ * @module business-mgt/reservation-mgt/maintenance-block
+ */
+/**
+ * Maintenance block schema.
+ * Represents a time period when a reservable resource instance is unavailable.
+ *
+ * @typedef {Object} MaintenanceBlock
+ * @property {string} [locationId] - Business location where maintenance applies
+ * @property {string} resourceInstanceId - Physical resource instance under maintenance
+ * @property {number} startDate - Maintenance block start as Unix epoch seconds
+ * @property {number} endDate - Maintenance block end as Unix epoch seconds
+ * @property {string} [reason] - Operational reason for the maintenance block
+ */
+export declare const MaintenanceBlockSchema: z.ZodObject<{
+    id: z.ZodString;
+    createdAt: z.ZodOptional<z.ZodNumber>;
+    updatedAt: z.ZodOptional<z.ZodNumber>;
+    locationId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    resourceInstanceId: z.ZodString;
+    startDate: z.ZodNumber;
+    endDate: z.ZodNumber;
+    reason: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+}, z.core.$strip>;
+/**
+ * Schema for creating a new maintenance block.
+ * Omits auto-generated fields.
+ */
+export declare const CreateMaintenanceBlockSchema: z.ZodObject<{
+    reason: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    locationId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    resourceInstanceId: z.ZodString;
+    startDate: z.ZodNumber;
+    endDate: z.ZodNumber;
+}, z.core.$strip>;
+/**
+ * Schema for updating an existing maintenance block.
+ * All fields optional except id.
+ */
+export declare const UpdateMaintenanceBlockSchema: z.ZodObject<{
+    reason: z.ZodOptional<z.ZodOptional<z.ZodNullable<z.ZodString>>>;
+    locationId: z.ZodOptional<z.ZodOptional<z.ZodNullable<z.ZodString>>>;
+    resourceInstanceId: z.ZodOptional<z.ZodString>;
+    startDate: z.ZodOptional<z.ZodNumber>;
+    endDate: z.ZodOptional<z.ZodNumber>;
+    id: z.ZodString;
+}, z.core.$strip>;
+export type MaintenanceBlock = z.infer<typeof MaintenanceBlockSchema>;
+export type CreateMaintenanceBlock = z.infer<typeof CreateMaintenanceBlockSchema>;
+export type UpdateMaintenanceBlock = z.infer<typeof UpdateMaintenanceBlockSchema>;
+/**
+ * Maintenance block filter options.
+ * @interface MaintenanceBlockFilters
+ */
+export interface MaintenanceBlockFilters {
+    /** Filter by maintained resource instance ID */
+    resourceInstanceId?: string;
+    /** Filter by business location ID */
+    locationId?: string;
+    /** Filter by maintenance date range (Unix epoch seconds) */
+    dateRange?: {
+        start?: number;
+        end?: number;
+    };
+}
+/**
+ * Maintenance block sorting options.
+ * @interface MaintenanceBlockSorting
+ */
+export interface MaintenanceBlockSorting {
+    /** Field to sort by */
+    field: "startDate" | "endDate" | "createdAt";
+    /** Sort direction */
+    direction: "asc" | "desc";
+}
+/**
+ * Maintenance block query options.
+ * @interface MaintenanceBlockQueryOptions
+ */
+export interface MaintenanceBlockQueryOptions {
+    /** Page number (1-indexed) */
+    page: number;
+    /** Items per page */
+    pageSize: number;
+    /** Optional filters */
+    filters?: MaintenanceBlockFilters;
+    /** Optional sorting */
+    sorting?: MaintenanceBlockSorting;
+}

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

@@ -0,0 +1,57 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.UpdateMaintenanceBlockSchema = exports.CreateMaintenanceBlockSchema = exports.MaintenanceBlockSchema = void 0;
+const zod_1 = require("zod");
+const base_schema_1 = require("../../base.schema");
+/**
+ * @fileoverview Reservation maintenance block schema definitions.
+ * @module business-mgt/reservation-mgt/maintenance-block
+ */
+// ============================================================================
+// MAINTENANCE BLOCK SCHEMA
+// ============================================================================
+/**
+ * Maintenance block schema.
+ * Represents a time period when a reservable resource instance is unavailable.
+ *
+ * @typedef {Object} MaintenanceBlock
+ * @property {string} [locationId] - Business location where maintenance applies
+ * @property {string} resourceInstanceId - Physical resource instance under maintenance
+ * @property {number} startDate - Maintenance block start as Unix epoch seconds
+ * @property {number} endDate - Maintenance block end as Unix epoch seconds
+ * @property {string} [reason] - Operational reason for the maintenance block
+ */
+exports.MaintenanceBlockSchema = base_schema_1.BaseModelSchema.safeExtend({
+    locationId: zod_1.z.string().nullable().optional().describe("Business location ID where the maintenance block applies. Null applies when the resource is not location-specific."),
+    resourceInstanceId: zod_1.z.string().describe("Room/resource ID under maintenance"),
+    startDate: zod_1.z.number().describe("Maintenance block start as Unix epoch seconds"),
+    endDate: zod_1.z.number().describe("Maintenance block end as Unix epoch seconds"),
+    reason: zod_1.z.string().nullable().optional().describe("Reason for maintenance block"),
+}).superRefine((data, ctx) => {
+    if (data.endDate < data.startDate) {
+        ctx.addIssue({
+            code: "custom",
+            path: ["endDate"],
+            message: "endDate must be greater than or equal to startDate",
+        });
+    }
+});
+// ============================================================================
+// CREATE/UPDATE SCHEMAS
+// ============================================================================
+/**
+ * Schema for creating a new maintenance block.
+ * Omits auto-generated fields.
+ */
+exports.CreateMaintenanceBlockSchema = exports.MaintenanceBlockSchema.omit({
+    id: true,
+    createdAt: true,
+    updatedAt: true,
+});
+/**
+ * Schema for updating an existing maintenance block.
+ * All fields optional except id.
+ */
+exports.UpdateMaintenanceBlockSchema = exports.CreateMaintenanceBlockSchema.partial().safeExtend({
+    id: zod_1.z.string().describe("Unique identifier of the maintenance block to update."),
+});