wiil-core-js 0.0.82

package/dist/core/business-mgt/menu-management/modifier.schema.js

@@ -0,0 +1,341 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.UpdateItemModifierBindingSchema = exports.UpdateModifierGroupSchema = exports.UpdateModifierOptionSchema = exports.CreateItemModifierBindingSchema = exports.CreateModifierGroupSchema = exports.CreateModifierGroupOptionSchema = exports.CreateModifierOptionSchema = exports.ModifierGroupViewSchema = exports.ModifierOptionViewSchema = exports.AppliedModifierSchema = exports.ItemModifierBindingSchema = exports.ModifierOptionOverrideSchema = exports.ModifierGroupSchema = exports.ModifierOptionSchema = exports.ModifierOptionChannelMappingSchema = exports.ModifierGroupChannelMappingSchema = void 0;
+const zod_1 = require("zod");
+const base_schema_1 = require("../../base.schema");
+/**
+ * @fileoverview Modifier schema definitions for business management.
+ * @module business-mgt/modifier
+ *
+ * Includes modifier groups, options, bindings, and applied modifiers
+ * for menu item customization (e.g., sizes, add-ons, toppings).
+ */
+// ============================================================================
+// CHANNEL MAPPING SCHEMAS
+// ============================================================================
+/**
+ * Modifier group channel mapping schema.
+ * Maps modifier groups to external platform identifiers.
+ *
+ * @typedef {Object} ModifierGroupChannelMapping
+ * @property {string} channelId - Channel identifier (e.g., doordash, uber-eats)
+ * @property {string} externalModifierGroupId - External modifier group ID for synchronization
+ */
+exports.ModifierGroupChannelMappingSchema = zod_1.z.object({
+    channelId: zod_1.z.string().describe("Channel ID (e.g., doordash, uber-eats)"),
+    externalModifierGroupId: zod_1.z.string().describe("External modifier group ID for this specific channel"),
+}).describe("Per-channel external modifier group ID mapping");
+/**
+ * Modifier option channel mapping schema.
+ * Maps modifier options to external platform identifiers.
+ *
+ * @typedef {Object} ModifierOptionChannelMapping
+ * @property {string} channelId - Channel identifier (e.g., doordash, uber-eats)
+ * @property {string} externalModifierOptionId - External modifier option ID for synchronization
+ * @property {string} [externalModifierGroupId] - Optional external parent modifier group ID
+ */
+exports.ModifierOptionChannelMappingSchema = zod_1.z.object({
+    channelId: zod_1.z.string().describe("Channel ID (e.g., doordash, uber-eats)"),
+    externalModifierOptionId: zod_1.z.string().describe("External modifier option ID for this specific channel"),
+    externalModifierGroupId: zod_1.z.string().nullable().optional().describe("Optional external parent modifier group ID in this channel"),
+}).describe("Per-channel external modifier option ID mapping");
+// ============================================================================
+// MODIFIER OPTION SCHEMA
+// ============================================================================
+/**
+ * Modifier option schema.
+ * Individual option within a modifier group.
+ *
+ * @typedef {Object} ModifierOption
+ * @property {string} [modifierRevisionId] - Modifier revision ID for version-scoped data
+ * @property {string} [locationId] - Location ID for location-specific modifiers
+ * @property {string} modifierGroupId - Parent modifier group ID
+ * @property {string} name - Modifier option name (e.g., Large, Extra Cheese)
+ * @property {string} [description] - Modifier option description
+ * @property {number} priceDelta - Price adjustment for selecting this option
+ * @property {boolean} isDefault - Whether this is the default option
+ * @property {number} displayOrder - Display order within the group
+ * @property {ModifierOptionChannelMapping[]} [channelMappings] - Per-channel mappings
+ * @property {boolean} isActive - Whether this option is active
+ */
+exports.ModifierOptionSchema = base_schema_1.BaseModelSchema.safeExtend({
+    modifierRevisionId: zod_1.z.string().nullable().optional().describe("Optional modifier revision ID for version-scoped data"),
+    locationId: zod_1.z.string().nullable().optional().describe("Location ID for location-specific modifiers"),
+    modifierGroupId: zod_1.z.string().describe("Parent modifier group ID"),
+    name: zod_1.z.string().min(1).describe("Modifier option name (e.g., Large, Extra Cheese)"),
+    description: zod_1.z.string().nullable().optional().describe("Modifier option description"),
+    priceDelta: zod_1.z.number().default(0).describe("Price adjustment for selecting this option"),
+    isDefault: zod_1.z.boolean().default(false).describe("Whether this is the default option"),
+    displayOrder: zod_1.z.number().int().nonnegative().default(0).describe("Display order within the group"),
+    channelMappings: zod_1.z.array(exports.ModifierOptionChannelMappingSchema).nullable().optional().describe("Per-channel modifier option ID mappings"),
+    isActive: zod_1.z.boolean().default(true).describe("Whether this option is active"),
+});
+// ============================================================================
+// MODIFIER GROUP SCHEMA
+// ============================================================================
+/**
+ * Modifier group schema.
+ * Group of related modifier options (e.g., Size, Add-ons, Toppings).
+ *
+ * @typedef {Object} ModifierGroup
+ * @property {string} [modifierRevisionId] - Modifier revision ID for version-scoped data
+ * @property {string} [locationId] - Location ID for location-specific modifiers
+ * @property {string} name - Modifier group name (e.g., Size, Add-ons)
+ * @property {string} [description] - Modifier group description
+ * @property {ModifierOption[]} options - Modifier options within this group
+ * @property {number} minSelection - Minimum number of options that must be selected
+ * @property {number} [maxSelection] - Maximum number of options that can be selected
+ * @property {boolean} isRequired - Whether selection from this group is required
+ * @property {number} displayOrder - Display order in the menu
+ * @property {ModifierGroupChannelMapping[]} [channelMappings] - Per-channel mappings
+ * @property {boolean} isActive - Whether this group is active
+ */
+exports.ModifierGroupSchema = base_schema_1.BaseModelSchema.safeExtend({
+    modifierRevisionId: zod_1.z.string().nullable().optional().describe("Optional modifier revision ID for version-scoped data"),
+    locationId: zod_1.z.string().nullable().optional().describe("Location ID for location-specific modifiers"),
+    name: zod_1.z.string().min(1).describe("Modifier group name (e.g., Size, Add-ons)"),
+    description: zod_1.z.string().nullable().optional().describe("Modifier group description"),
+    options: zod_1.z.array(exports.ModifierOptionSchema).min(1, "At least one modifier option is required").describe("Modifier options within this group"),
+    minSelection: zod_1.z.number().int().nonnegative().default(0).describe("Minimum number of options that must be selected"),
+    maxSelection: zod_1.z.number().int().positive().nullable().optional().describe("Maximum number of options that can be selected"),
+    isRequired: zod_1.z.boolean().default(false).describe("Whether selection from this group is required"),
+    displayOrder: zod_1.z.number().int().nonnegative().default(0).describe("Display order in the menu"),
+    channelMappings: zod_1.z.array(exports.ModifierGroupChannelMappingSchema).nullable().optional().describe("Per-channel modifier group ID mappings"),
+    isActive: zod_1.z.boolean().default(true).describe("Whether this group is active"),
+}).superRefine((data, ctx) => {
+    if (data.maxSelection !== undefined && data.maxSelection !== null && data.maxSelection < data.minSelection) {
+        ctx.addIssue({
+            code: "custom",
+            path: ["maxSelection"],
+            message: "maxSelection must be greater than or equal to minSelection",
+        });
+    }
+});
+// ============================================================================
+// BINDING SCHEMAS
+// ============================================================================
+/**
+ * Modifier option override schema.
+ * Per-option override within a binding.
+ *
+ * @typedef {Object} ModifierOptionOverride
+ * @property {string} modifierOptionId - Target modifier option ID
+ * @property {number} [priceDeltaOverride] - Override price delta
+ * @property {boolean} [isDefaultOverride] - Override default selection
+ * @property {number} [displayOrderOverride] - Override display order
+ */
+exports.ModifierOptionOverrideSchema = zod_1.z.object({
+    modifierOptionId: zod_1.z.string().describe("Target modifier option ID"),
+    priceDeltaOverride: zod_1.z.number().nullable().optional().describe("Override price delta"),
+    isDefaultOverride: zod_1.z.boolean().nullable().optional().describe("Override default selection"),
+    displayOrderOverride: zod_1.z.number().int().nullable().optional().describe("Override display order"),
+}).describe("Per-option override within a binding");
+/**
+ * Item modifier binding schema.
+ * Links modifier groups to menu items or sets.
+ *
+ * @typedef {Object} ItemModifierBinding
+ * @property {string} [modifierRevisionId] - Modifier revision ID for version-scoped data
+ * @property {string} [locationId] - Location ID for location-specific bindings
+ * @property {string} [menuItemId] - Menu item ID target
+ * @property {string} [menuItemVariantId] - Menu item variant ID target
+ * @property {string} [menuSetId] - Menu set ID target
+ * @property {string} modifierGroupId - Modifier group ID to bind
+ * @property {boolean} [isRequiredOverride] - Override isRequired from modifier group
+ * @property {number} [minSelectionOverride] - Override minSelection
+ * @property {number} [maxSelectionOverride] - Override maxSelection
+ * @property {string[]} [excludedOptionIds] - Option IDs to exclude from this binding
+ * @property {ModifierOptionOverride[]} [optionOverrides] - Per-option overrides
+ * @property {number} displayOrder - Display order
+ * @property {boolean} isActive - Whether this binding is active
+ */
+exports.ItemModifierBindingSchema = base_schema_1.BaseModelSchema.safeExtend({
+    modifierRevisionId: zod_1.z.string().nullable().optional().describe("Optional modifier revision ID for version-scoped data"),
+    locationId: zod_1.z.string().nullable().optional().describe("Location ID for location-specific bindings"),
+    menuItemId: zod_1.z.string().nullable().optional().describe("Menu item ID target"),
+    menuItemVariantId: zod_1.z.string().nullable().optional().describe("Optional menu item variant ID target"),
+    menuSetId: zod_1.z.string().nullable().optional().describe("Optional menu set ID target"),
+    modifierGroupId: zod_1.z.string().describe("Modifier group ID to bind"),
+    isRequiredOverride: zod_1.z.boolean().nullable().optional().describe("Override isRequired from modifier group"),
+    minSelectionOverride: zod_1.z.number().int().nonnegative().nullable().optional().describe("Override minSelection"),
+    maxSelectionOverride: zod_1.z.number().int().positive().nullable().optional().describe("Override maxSelection"),
+    excludedOptionIds: zod_1.z.array(zod_1.z.string()).nullable().optional().describe("Option IDs to exclude from this binding"),
+    optionOverrides: zod_1.z.array(exports.ModifierOptionOverrideSchema).nullable().optional().describe("Per-option overrides for this binding"),
+    displayOrder: zod_1.z.number().int().nonnegative().default(0).describe("Display order"),
+    isActive: zod_1.z.boolean().default(true).describe("Whether this binding is active"),
+}).superRefine((data, ctx) => {
+    if (data.minSelectionOverride !== undefined &&
+        data.minSelectionOverride !== null &&
+        data.maxSelectionOverride !== undefined &&
+        data.maxSelectionOverride !== null &&
+        data.maxSelectionOverride < data.minSelectionOverride) {
+        ctx.addIssue({
+            code: "custom",
+            path: ["maxSelectionOverride"],
+            message: "maxSelectionOverride must be greater than or equal to minSelectionOverride",
+        });
+    }
+    const hasMenuItemTarget = !!data.menuItemId;
+    const hasMenuSetTarget = !!data.menuSetId;
+    if (hasMenuItemTarget === hasMenuSetTarget) {
+        ctx.addIssue({
+            code: "custom",
+            path: ["menuItemId"],
+            message: "Exactly one of menuItemId or menuSetId is required",
+        });
+    }
+    if (data.menuItemVariantId && !hasMenuItemTarget) {
+        ctx.addIssue({
+            code: "custom",
+            path: ["menuItemVariantId"],
+            message: "menuItemVariantId can only be provided when menuItemId is set",
+        });
+    }
+});
+// ============================================================================
+// APPLIED MODIFIER SCHEMA
+// ============================================================================
+/**
+ * Applied modifier schema.
+ * Modifier selected on an order item.
+ *
+ * @typedef {Object} AppliedModifier
+ * @property {string} [modifierGroupId] - Internal modifier group ID
+ * @property {string} [modifierOptionId] - Internal modifier option ID
+ * @property {string} [externalModifierGroupId] - External modifier group ID
+ * @property {string} [externalModifierOptionId] - External modifier option ID
+ * @property {string} groupName - Modifier group name
+ * @property {string} optionName - Modifier option name
+ * @property {number} quantity - Quantity of this modifier
+ * @property {number} priceDelta - Price adjustment for this modifier
+ */
+exports.AppliedModifierSchema = zod_1.z.object({
+    modifierGroupId: zod_1.z.string().nullable().optional().describe("Internal modifier group ID"),
+    modifierOptionId: zod_1.z.string().nullable().optional().describe("Internal modifier option ID"),
+    externalModifierGroupId: zod_1.z.string().nullable().optional().describe("External modifier group ID"),
+    externalModifierOptionId: zod_1.z.string().nullable().optional().describe("External modifier option ID"),
+    groupName: zod_1.z.string().min(1).describe("Modifier group name"),
+    optionName: zod_1.z.string().min(1).describe("Modifier option name"),
+    quantity: zod_1.z.number().int().positive().default(1).describe("Quantity of this modifier"),
+    priceDelta: zod_1.z.number().default(0).describe("Price adjustment for this modifier"),
+});
+// ============================================================================
+// VIEW SCHEMAS
+// ============================================================================
+/**
+ * Modifier option view schema.
+ * Simplified view for display purposes.
+ *
+ * @typedef {Object} ModifierOptionView
+ * @property {string} id - Modifier option ID
+ * @property {string} name - Option name
+ * @property {string} [description] - Option description
+ * @property {number} priceDelta - Price adjustment
+ * @property {boolean} isDefault - Whether this is the default option
+ * @property {number} displayOrder - Display order
+ * @property {ModifierOptionChannelMapping[]} [channelMappings] - Channel mappings
+ * @property {boolean} isActive - Whether active
+ */
+exports.ModifierOptionViewSchema = zod_1.z.object({
+    id: zod_1.z.string().describe("Modifier option ID"),
+    name: zod_1.z.string().min(1).describe("Option name"),
+    description: zod_1.z.string().nullable().optional().describe("Option description"),
+    priceDelta: zod_1.z.number().default(0).describe("Price adjustment"),
+    isDefault: zod_1.z.boolean().default(false).describe("Whether this is the default option"),
+    displayOrder: zod_1.z.number().int().nonnegative().default(0).describe("Display order"),
+    channelMappings: zod_1.z.array(exports.ModifierOptionChannelMappingSchema).nullable().optional().describe("Channel mappings"),
+    isActive: zod_1.z.boolean().default(true).describe("Whether active"),
+});
+/**
+ * Modifier group view schema.
+ * Simplified view for display purposes.
+ *
+ * @typedef {Object} ModifierGroupView
+ * @property {string} id - Modifier group ID
+ * @property {string} name - Group name
+ * @property {string} [description] - Group description
+ * @property {number} displayOrder - Display order
+ * @property {ModifierGroupChannelMapping[]} [channelMappings] - Channel mappings
+ * @property {boolean} isActive - Whether active
+ * @property {boolean} isRequired - Whether required
+ * @property {number} minSelection - Minimum selections
+ * @property {number} [maxSelection] - Maximum selections
+ * @property {ModifierOptionView[]} options - Options in this group
+ */
+exports.ModifierGroupViewSchema = zod_1.z.object({
+    id: zod_1.z.string().describe("Modifier group ID"),
+    name: zod_1.z.string().min(1).describe("Group name"),
+    description: zod_1.z.string().nullable().optional().describe("Group description"),
+    displayOrder: zod_1.z.number().int().nonnegative().default(0).describe("Display order"),
+    channelMappings: zod_1.z.array(exports.ModifierGroupChannelMappingSchema).nullable().optional().describe("Channel mappings"),
+    isActive: zod_1.z.boolean().default(true).describe("Whether active"),
+    isRequired: zod_1.z.boolean().default(false).describe("Whether required"),
+    minSelection: zod_1.z.number().int().nonnegative().default(0).describe("Minimum selections"),
+    maxSelection: zod_1.z.number().int().positive().nullable().optional().describe("Maximum selections"),
+    options: zod_1.z.array(exports.ModifierOptionViewSchema).default([]).describe("Options in this group"),
+});
+// ============================================================================
+// CREATE/UPDATE SCHEMAS
+// ============================================================================
+/**
+ * Schema for creating a new modifier option.
+ * Omits auto-generated fields.
+ */
+exports.CreateModifierOptionSchema = exports.ModifierOptionSchema.omit({
+    id: true,
+    createdAt: true,
+    updatedAt: true,
+});
+exports.CreateModifierGroupOptionSchema = exports.CreateModifierOptionSchema.omit({
+    modifierGroupId: true,
+});
+/**
+ * Schema for creating a new modifier group.
+ * Omits auto-generated fields.
+ */
+exports.CreateModifierGroupSchema = exports.ModifierGroupSchema.omit({
+    id: true,
+    createdAt: true,
+    updatedAt: true,
+    options: true,
+}).safeExtend({
+    options: zod_1.z.array(exports.CreateModifierGroupOptionSchema).min(1, "At least one modifier option is required").describe("Modifier options within this group"),
+}).superRefine((data, ctx) => {
+    if (data.maxSelection !== undefined && data.maxSelection !== null && data.maxSelection > data.options.length) {
+        ctx.addIssue({
+            code: "custom",
+            path: ["maxSelection"],
+            message: "maxSelection cannot exceed the number of provided options",
+        });
+    }
+});
+/**
+ * Schema for creating a new item modifier binding.
+ * Omits auto-generated fields.
+ */
+exports.CreateItemModifierBindingSchema = exports.ItemModifierBindingSchema.omit({
+    id: true,
+    createdAt: true,
+    updatedAt: true,
+});
+/**
+ * Schema for updating an existing modifier option.
+ * All fields optional except id (required).
+ */
+exports.UpdateModifierOptionSchema = exports.CreateModifierOptionSchema.partial().safeExtend({
+    id: zod_1.z.string(),
+});
+/**
+ * Schema for updating an existing modifier group.
+ * All fields optional except id (required).
+ */
+exports.UpdateModifierGroupSchema = exports.CreateModifierGroupSchema.partial().safeExtend({
+    id: zod_1.z.string(),
+});
+/**
+ * Schema for updating an existing item modifier binding.
+ * All fields optional except id (required).
+ */
+exports.UpdateItemModifierBindingSchema = exports.CreateItemModifierBindingSchema.partial().safeExtend({
+    id: zod_1.z.string(),
+});

package/dist/core/business-mgt/menu.order.schema.d.ts

@@ -0,0 +1,335 @@
+import z from "zod";
+import { MenuOrderType, OrderStatus, PaymentStatus } from "../type-definitions";
+/**
+ * @fileoverview Menu order schema definitions for restaurant/food service.
+ * @module business-mgt/menu-order
+ */
+/**
+ * Base menu order item schema (without IDs for creation).
+ *
+ * @typedef {Object} MenuOrderItemBase
+ * @property {string} menuItemId - Menu item ID being ordered
+ * @property {string} itemName - Name of the menu item
+ * @property {number} quantity - Quantity ordered
+ * @property {number} unitPrice - Price per unit
+ * @property {number} totalPrice - Total price for this item
+ * @property {string} [specialInstructions] - Special preparation instructions
+ * @property {Array} [customizations] - Item customizations with additional costs
+ * @property {string} status - Item status
+ * @property {number} [preparationTime] - Estimated prep time in minutes
+ * @property {string} [notes] - Additional notes
+ */
+export declare const MenuOrderItemBaseSchema: z.ZodObject<{
+    menuItemId: z.ZodString;
+    itemName: z.ZodString;
+    quantity: z.ZodNumber;
+    unitPrice: z.ZodNumber;
+    totalPrice: z.ZodNumber;
+    specialInstructions: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+    customizations: z.ZodDefault<z.ZodNullable<z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        value: z.ZodString;
+        additionalCost: z.ZodDefault<z.ZodNumber>;
+    }, z.core.$strip>>>>;
+    status: z.ZodDefault<z.ZodEnum<typeof OrderStatus>>;
+    preparationTime: z.ZodDefault<z.ZodNullable<z.ZodNumber>>;
+    notes: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+}, z.core.$strip>;
+/**
+ * Menu order item schema with IDs (for existing items).
+ */
+export declare const MenuOrderItemSchema: z.ZodObject<{
+    menuItemId: z.ZodString;
+    itemName: z.ZodString;
+    quantity: z.ZodNumber;
+    unitPrice: z.ZodNumber;
+    totalPrice: z.ZodNumber;
+    specialInstructions: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+    customizations: z.ZodDefault<z.ZodNullable<z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        value: z.ZodString;
+        additionalCost: z.ZodDefault<z.ZodNumber>;
+    }, z.core.$strip>>>>;
+    status: z.ZodDefault<z.ZodEnum<typeof OrderStatus>>;
+    preparationTime: z.ZodDefault<z.ZodNullable<z.ZodNumber>>;
+    notes: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+    id: z.ZodString;
+    menuOrderId: z.ZodString;
+}, z.core.$strip>;
+/**
+ * Menu order schema - for restaurants/food service.
+ *
+ * @typedef {Object} MenuOrder
+ * @property {string} [orderNumber] - Human-readable order number
+ * @property {string} type - Order type (dine-in, takeout, delivery)
+ * @property {string} status - Current order status
+ * @property {Array} items - Items in the order
+ * @property {string} customerId - ID of the customer placing the order
+ * @property {Object} [customer] - Customer information
+ * @property {Object} pricing - Pricing details
+ * @property {string} paymentStatus - Payment status
+ * @property {string} [paymentMethod] - Payment method used
+ * @property {string} [paymentReference] - Payment reference number
+ * @property {number} orderDate - Order date as Unix timestamp
+ * @property {number} [requestedTime] - Requested pickup/delivery time
+ * @property {number} [estimatedReadyTime] - Estimated ready time
+ * @property {number} [actualReadyTime] - Actual ready time
+ * @property {string} [specialInstructions] - Special instructions
+ * @property {string[]} [allergies] - Customer allergies
+ * @property {string} [tableNumber] - Table number for dine-in
+ * @property {string} [externalOrderId] - External order ID for integrations
+ * @property {string} source - Order source
+ * @property {string} [cancelReason] - Reason for cancellation
+ * @property {string} [notes] - Additional notes
+ * @property {string} [serviceConversationConfigId] - Service conversation config ID
+ * @property {Object} [deliveryAddress] - Delivery address if applicable
+ * @property {number} [tip] - Tip amount for the order
+ */
+export declare const MenuOrderSchema: z.ZodObject<{
+    id: z.ZodString;
+    createdAt: z.ZodOptional<z.ZodNumber>;
+    updatedAt: z.ZodOptional<z.ZodNumber>;
+    orderNumber: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+    type: z.ZodEnum<typeof MenuOrderType>;
+    status: z.ZodDefault<z.ZodEnum<typeof OrderStatus>>;
+    items: z.ZodArray<z.ZodObject<{
+        menuItemId: z.ZodString;
+        itemName: z.ZodString;
+        quantity: z.ZodNumber;
+        unitPrice: z.ZodNumber;
+        totalPrice: z.ZodNumber;
+        specialInstructions: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+        customizations: z.ZodDefault<z.ZodNullable<z.ZodArray<z.ZodObject<{
+            name: z.ZodString;
+            value: z.ZodString;
+            additionalCost: z.ZodDefault<z.ZodNumber>;
+        }, z.core.$strip>>>>;
+        status: z.ZodDefault<z.ZodEnum<typeof OrderStatus>>;
+        preparationTime: z.ZodDefault<z.ZodNullable<z.ZodNumber>>;
+        notes: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+        id: z.ZodString;
+        menuOrderId: z.ZodString;
+    }, z.core.$strip>>;
+    customerId: z.ZodString;
+    customer: z.ZodDefault<z.ZodNullable<z.ZodObject<{
+        customerId: z.ZodOptional<z.ZodString>;
+        name: z.ZodString;
+        phone: z.ZodOptional<z.ZodString>;
+        email: z.ZodOptional<z.ZodEmail>;
+        address: z.ZodOptional<z.ZodObject<{
+            street: z.ZodString;
+            street2: z.ZodOptional<z.ZodString>;
+            city: z.ZodString;
+            state: z.ZodString;
+            postalCode: z.ZodString;
+            country: z.ZodString;
+            deliveryInstructions: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>;
+    }, z.core.$strip>>>;
+    pricing: z.ZodObject<{
+        subtotal: z.ZodNumber;
+        tax: z.ZodDefault<z.ZodNumber>;
+        tip: z.ZodDefault<z.ZodNumber>;
+        shippingAmount: z.ZodDefault<z.ZodNumber>;
+        discount: z.ZodDefault<z.ZodNumber>;
+        total: z.ZodNumber;
+        currency: z.ZodDefault<z.ZodString>;
+    }, z.core.$strip>;
+    paymentStatus: z.ZodDefault<z.ZodEnum<typeof PaymentStatus>>;
+    paymentMethod: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+    paymentReference: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+    orderDate: z.ZodNumber;
+    requestedTime: z.ZodDefault<z.ZodNullable<z.ZodNumber>>;
+    estimatedReadyTime: z.ZodDefault<z.ZodNullable<z.ZodNumber>>;
+    actualReadyTime: z.ZodDefault<z.ZodNullable<z.ZodNumber>>;
+    specialInstructions: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+    allergies: z.ZodDefault<z.ZodNullable<z.ZodArray<z.ZodString>>>;
+    tableNumber: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+    externalOrderId: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+    source: z.ZodDefault<z.ZodString>;
+    cancelReason: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+    notes: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+    serviceConversationConfigId: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+    deliveryAddress: z.ZodDefault<z.ZodNullable<z.ZodObject<{
+        street: z.ZodString;
+        city: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+        postalCode: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+    }, z.core.$strip>>>;
+    tip: z.ZodDefault<z.ZodNullable<z.ZodNumber>>;
+}, z.core.$strip>;
+/**
+ * Schema for creating a new menu order.
+ * Omits auto-generated fields and uses base items without IDs.
+ */
+export declare const CreateMenuOrderSchema: z.ZodObject<{
+    type: z.ZodEnum<typeof MenuOrderType>;
+    status: z.ZodDefault<z.ZodEnum<typeof OrderStatus>>;
+    customerId: z.ZodString;
+    notes: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+    tableNumber: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+    tip: z.ZodDefault<z.ZodNullable<z.ZodNumber>>;
+    specialInstructions: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+    customer: z.ZodDefault<z.ZodNullable<z.ZodObject<{
+        customerId: z.ZodOptional<z.ZodString>;
+        name: z.ZodString;
+        phone: z.ZodOptional<z.ZodString>;
+        email: z.ZodOptional<z.ZodEmail>;
+        address: z.ZodOptional<z.ZodObject<{
+            street: z.ZodString;
+            street2: z.ZodOptional<z.ZodString>;
+            city: z.ZodString;
+            state: z.ZodString;
+            postalCode: z.ZodString;
+            country: z.ZodString;
+            deliveryInstructions: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>;
+    }, z.core.$strip>>>;
+    pricing: z.ZodObject<{
+        subtotal: z.ZodNumber;
+        tax: z.ZodDefault<z.ZodNumber>;
+        tip: z.ZodDefault<z.ZodNumber>;
+        shippingAmount: z.ZodDefault<z.ZodNumber>;
+        discount: z.ZodDefault<z.ZodNumber>;
+        total: z.ZodNumber;
+        currency: z.ZodDefault<z.ZodString>;
+    }, z.core.$strip>;
+    paymentStatus: z.ZodDefault<z.ZodEnum<typeof PaymentStatus>>;
+    paymentMethod: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+    paymentReference: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+    orderDate: z.ZodNumber;
+    requestedTime: z.ZodDefault<z.ZodNullable<z.ZodNumber>>;
+    estimatedReadyTime: z.ZodDefault<z.ZodNullable<z.ZodNumber>>;
+    allergies: z.ZodDefault<z.ZodNullable<z.ZodArray<z.ZodString>>>;
+    externalOrderId: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+    source: z.ZodDefault<z.ZodString>;
+    deliveryAddress: z.ZodDefault<z.ZodNullable<z.ZodObject<{
+        street: z.ZodString;
+        city: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+        postalCode: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+    }, z.core.$strip>>>;
+    items: z.ZodArray<z.ZodObject<{
+        menuItemId: z.ZodString;
+        itemName: z.ZodString;
+        quantity: z.ZodNumber;
+        unitPrice: z.ZodNumber;
+        totalPrice: z.ZodNumber;
+        specialInstructions: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+        customizations: z.ZodDefault<z.ZodNullable<z.ZodArray<z.ZodObject<{
+            name: z.ZodString;
+            value: z.ZodString;
+            additionalCost: z.ZodDefault<z.ZodNumber>;
+        }, z.core.$strip>>>>;
+        status: z.ZodDefault<z.ZodEnum<typeof OrderStatus>>;
+        preparationTime: z.ZodDefault<z.ZodNullable<z.ZodNumber>>;
+        notes: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+    }, z.core.$strip>>;
+    cancelReason: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+}, z.core.$strip>;
+/**
+ * Schema for updating an existing menu order.
+ * All fields are optional except id.
+ */
+export declare const UpdateMenuOrderSchema: z.ZodObject<{
+    type: z.ZodOptional<z.ZodEnum<typeof MenuOrderType>>;
+    status: z.ZodOptional<z.ZodDefault<z.ZodEnum<typeof OrderStatus>>>;
+    customerId: z.ZodOptional<z.ZodString>;
+    notes: z.ZodOptional<z.ZodDefault<z.ZodNullable<z.ZodString>>>;
+    tableNumber: z.ZodOptional<z.ZodDefault<z.ZodNullable<z.ZodString>>>;
+    tip: z.ZodOptional<z.ZodDefault<z.ZodNullable<z.ZodNumber>>>;
+    specialInstructions: z.ZodOptional<z.ZodDefault<z.ZodNullable<z.ZodString>>>;
+    customer: z.ZodOptional<z.ZodDefault<z.ZodNullable<z.ZodObject<{
+        customerId: z.ZodOptional<z.ZodString>;
+        name: z.ZodString;
+        phone: z.ZodOptional<z.ZodString>;
+        email: z.ZodOptional<z.ZodEmail>;
+        address: z.ZodOptional<z.ZodObject<{
+            street: z.ZodString;
+            street2: z.ZodOptional<z.ZodString>;
+            city: z.ZodString;
+            state: z.ZodString;
+            postalCode: z.ZodString;
+            country: z.ZodString;
+            deliveryInstructions: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>;
+    }, z.core.$strip>>>>;
+    pricing: z.ZodOptional<z.ZodObject<{
+        subtotal: z.ZodNumber;
+        tax: z.ZodDefault<z.ZodNumber>;
+        tip: z.ZodDefault<z.ZodNumber>;
+        shippingAmount: z.ZodDefault<z.ZodNumber>;
+        discount: z.ZodDefault<z.ZodNumber>;
+        total: z.ZodNumber;
+        currency: z.ZodDefault<z.ZodString>;
+    }, z.core.$strip>>;
+    paymentStatus: z.ZodOptional<z.ZodDefault<z.ZodEnum<typeof PaymentStatus>>>;
+    paymentMethod: z.ZodOptional<z.ZodDefault<z.ZodNullable<z.ZodString>>>;
+    paymentReference: z.ZodOptional<z.ZodDefault<z.ZodNullable<z.ZodString>>>;
+    orderDate: z.ZodOptional<z.ZodNumber>;
+    requestedTime: z.ZodOptional<z.ZodDefault<z.ZodNullable<z.ZodNumber>>>;
+    estimatedReadyTime: z.ZodOptional<z.ZodDefault<z.ZodNullable<z.ZodNumber>>>;
+    allergies: z.ZodOptional<z.ZodDefault<z.ZodNullable<z.ZodArray<z.ZodString>>>>;
+    externalOrderId: z.ZodOptional<z.ZodDefault<z.ZodNullable<z.ZodString>>>;
+    source: z.ZodOptional<z.ZodDefault<z.ZodString>>;
+    deliveryAddress: z.ZodOptional<z.ZodDefault<z.ZodNullable<z.ZodObject<{
+        street: z.ZodString;
+        city: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+        postalCode: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+    }, z.core.$strip>>>>;
+    items: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        menuItemId: z.ZodString;
+        itemName: z.ZodString;
+        quantity: z.ZodNumber;
+        unitPrice: z.ZodNumber;
+        totalPrice: z.ZodNumber;
+        specialInstructions: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+        customizations: z.ZodDefault<z.ZodNullable<z.ZodArray<z.ZodObject<{
+            name: z.ZodString;
+            value: z.ZodString;
+            additionalCost: z.ZodDefault<z.ZodNumber>;
+        }, z.core.$strip>>>>;
+        status: z.ZodDefault<z.ZodEnum<typeof OrderStatus>>;
+        preparationTime: z.ZodDefault<z.ZodNullable<z.ZodNumber>>;
+        notes: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+    }, z.core.$strip>>>;
+    cancelReason: z.ZodOptional<z.ZodDefault<z.ZodNullable<z.ZodString>>>;
+    id: z.ZodString;
+}, z.core.$strip>;
+/**
+ * Quick status update schema for menu orders.
+ */
+export declare const UpdateMenuOrderStatusSchema: z.ZodObject<{
+    id: z.ZodString;
+    status: z.ZodEnum<typeof OrderStatus>;
+    estimatedReadyTime: z.ZodDefault<z.ZodNullable<z.ZodNumber>>;
+    actualReadyTime: z.ZodDefault<z.ZodNullable<z.ZodNumber>>;
+}, z.core.$strip>;
+export type MenuOrderItemBase = z.infer<typeof MenuOrderItemBaseSchema>;
+export type MenuOrderItem = z.infer<typeof MenuOrderItemSchema>;
+export type MenuOrder = z.infer<typeof MenuOrderSchema>;
+export type CreateMenuOrder = z.infer<typeof CreateMenuOrderSchema>;
+export type UpdateMenuOrder = z.infer<typeof UpdateMenuOrderSchema>;
+export type UpdateMenuOrderStatus = z.infer<typeof UpdateMenuOrderStatusSchema>;
+export type CreateMenuOrderItem = z.infer<typeof MenuOrderItemBaseSchema>;
+export interface MenuOrderFilters {
+    search?: string;
+    type?: MenuOrderType[];
+    status?: OrderStatus[];
+    paymentStatus?: PaymentStatus[];
+    customerId?: string;
+    tableNumber?: string;
+    source?: string;
+    dateRange?: {
+        start?: number;
+        end?: number;
+    };
+}
+export interface MenuOrderSorting {
+    field: 'orderDate' | 'createdAt' | 'totalAmount';
+    direction: 'asc' | 'desc';
+}
+export interface MenuOrderQueryOptions {
+    page: number;
+    pageSize: number;
+    filters?: MenuOrderFilters;
+    sorting?: MenuOrderSorting;
+}