wiil-core-js 0.0.82

package/dist/core/business-mgt/discount-rule.schema.d.ts

@@ -0,0 +1,183 @@
+import { z } from "zod";
+import { DiscountCatalogScope, DiscountScope, DiscountType } from "../type-definitions";
+/**
+ * @fileoverview Discount rule schema definitions for order pricing.
+ * @module business-mgt/discount-rule
+ */
+/**
+ * Discount rule schema.
+ * Defines discount configurations for orders including percentage and fixed amount discounts.
+ *
+ * @typedef {Object} DiscountRule
+ * @property {string} [locationId] - Business location where this discount applies
+ * @property {string} name - Discount display name
+ * @property {string} [code] - Discount code for promo codes
+ * @property {DiscountScope} scope - Discount scope (order, item, category)
+ * @property {DiscountType} type - Discount type (percentage, fixed)
+ * @property {number} value - Discount value (percentage or fixed amount)
+ * @property {string} currency - Currency code for fixed discounts
+ * @property {DiscountCatalogScope} catalogScope - Catalog scope for item-level discounts
+ * @property {string} [externalDiscountId] - External system discount ID
+ * @property {number} [minSubtotal] - Minimum order subtotal required
+ * @property {string} [customerSegment] - Target customer segment
+ * @property {boolean} firstOrderOnly - Whether discount is for first orders only
+ * @property {number} [maxUses] - Maximum total uses allowed
+ * @property {number} [maxUsesPerCustomer] - Maximum uses per customer
+ * @property {boolean} isStackable - Whether discount can stack with others
+ * @property {number} priority - Priority for discount application order
+ * @property {number} [effectiveFrom] - Start timestamp for discount validity
+ * @property {number} [effectiveTo] - End timestamp for discount validity
+ * @property {boolean} isActive - Whether discount is currently active
+ */
+export declare const DiscountRuleSchema: 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;
+    code: z.ZodOptional<z.ZodString>;
+    scope: z.ZodDefault<z.ZodEnum<typeof DiscountScope>>;
+    type: z.ZodDefault<z.ZodEnum<typeof DiscountType>>;
+    value: z.ZodNumber;
+    currency: z.ZodDefault<z.ZodString>;
+    catalogScope: z.ZodDefault<z.ZodEnum<typeof DiscountCatalogScope>>;
+    externalDiscountId: z.ZodOptional<z.ZodString>;
+    minSubtotal: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    customerSegment: z.ZodOptional<z.ZodString>;
+    firstOrderOnly: z.ZodDefault<z.ZodBoolean>;
+    maxUses: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    maxUsesPerCustomer: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    isStackable: z.ZodDefault<z.ZodBoolean>;
+    priority: z.ZodDefault<z.ZodNumber>;
+    effectiveFrom: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    effectiveTo: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    isActive: z.ZodDefault<z.ZodBoolean>;
+}, z.core.$strip>;
+/**
+ * Schema for creating a new discount rule.
+ * Omits auto-generated fields.
+ */
+export declare const CreateDiscountRuleSchema: z.ZodObject<{
+    type: z.ZodDefault<z.ZodEnum<typeof DiscountType>>;
+    value: z.ZodNumber;
+    code: z.ZodOptional<z.ZodString>;
+    name: z.ZodString;
+    isActive: z.ZodDefault<z.ZodBoolean>;
+    currency: z.ZodDefault<z.ZodString>;
+    locationId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    scope: z.ZodDefault<z.ZodEnum<typeof DiscountScope>>;
+    catalogScope: z.ZodDefault<z.ZodEnum<typeof DiscountCatalogScope>>;
+    externalDiscountId: z.ZodOptional<z.ZodString>;
+    minSubtotal: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    customerSegment: z.ZodOptional<z.ZodString>;
+    firstOrderOnly: z.ZodDefault<z.ZodBoolean>;
+    maxUses: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    maxUsesPerCustomer: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    isStackable: z.ZodDefault<z.ZodBoolean>;
+    priority: z.ZodDefault<z.ZodNumber>;
+    effectiveFrom: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    effectiveTo: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    placement: z.ZodOptional<z.ZodObject<{
+        placementIntent: z.ZodObject<{
+            mode: z.ZodEnum<{
+                BEGINNING: "BEGINNING";
+                END: "END";
+                KEEP_CURRENT: "KEEP_CURRENT";
+                BEFORE_ITEM: "BEFORE_ITEM";
+                AFTER_ITEM: "AFTER_ITEM";
+                ABSOLUTE_INDEX: "ABSOLUTE_INDEX";
+            }>;
+        }, z.core.$strip>;
+        anchorItemId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        absoluteIndex: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+/**
+ * Schema for updating an existing discount rule.
+ * All fields optional except id.
+ */
+export declare const UpdateDiscountRuleSchema: z.ZodObject<{
+    value: z.ZodOptional<z.ZodNumber>;
+    code: z.ZodOptional<z.ZodOptional<z.ZodString>>;
+    name: z.ZodOptional<z.ZodString>;
+    locationId: z.ZodOptional<z.ZodOptional<z.ZodNullable<z.ZodString>>>;
+    externalDiscountId: z.ZodOptional<z.ZodOptional<z.ZodString>>;
+    minSubtotal: z.ZodOptional<z.ZodOptional<z.ZodNullable<z.ZodNumber>>>;
+    customerSegment: z.ZodOptional<z.ZodOptional<z.ZodString>>;
+    maxUses: z.ZodOptional<z.ZodOptional<z.ZodNullable<z.ZodNumber>>>;
+    maxUsesPerCustomer: z.ZodOptional<z.ZodOptional<z.ZodNullable<z.ZodNumber>>>;
+    effectiveFrom: z.ZodOptional<z.ZodOptional<z.ZodNullable<z.ZodNumber>>>;
+    effectiveTo: z.ZodOptional<z.ZodOptional<z.ZodNullable<z.ZodNumber>>>;
+    placement: z.ZodOptional<z.ZodOptional<z.ZodObject<{
+        placementIntent: z.ZodObject<{
+            mode: z.ZodEnum<{
+                BEGINNING: "BEGINNING";
+                END: "END";
+                KEEP_CURRENT: "KEEP_CURRENT";
+                BEFORE_ITEM: "BEFORE_ITEM";
+                AFTER_ITEM: "AFTER_ITEM";
+                ABSOLUTE_INDEX: "ABSOLUTE_INDEX";
+            }>;
+        }, z.core.$strip>;
+        anchorItemId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        absoluteIndex: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    }, z.core.$strip>>>;
+    id: z.ZodString;
+    scope: z.ZodOptional<z.ZodNullable<z.ZodEnum<typeof DiscountScope>>>;
+    type: z.ZodOptional<z.ZodNullable<z.ZodEnum<typeof DiscountType>>>;
+    currency: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    catalogScope: z.ZodOptional<z.ZodNullable<z.ZodEnum<typeof DiscountCatalogScope>>>;
+    firstOrderOnly: z.ZodOptional<z.ZodNullable<z.ZodBoolean>>;
+    isStackable: z.ZodOptional<z.ZodNullable<z.ZodBoolean>>;
+    priority: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    isActive: z.ZodOptional<z.ZodNullable<z.ZodBoolean>>;
+}, z.core.$strip>;
+export type DiscountRule = z.infer<typeof DiscountRuleSchema>;
+export type CreateDiscountRule = z.infer<typeof CreateDiscountRuleSchema>;
+export type UpdateDiscountRule = z.infer<typeof UpdateDiscountRuleSchema>;
+/**
+ * Discount rule filter options.
+ * @interface DiscountRuleFilters
+ */
+export interface DiscountRuleFilters {
+    /** Text search across discount name and code */
+    search?: string;
+    /** Filter by business location ID */
+    locationId?: string;
+    /** Filter by discount code */
+    code?: string;
+    /** Filter by discount scope */
+    scope?: DiscountScope;
+    /** Filter by discount type */
+    type?: DiscountType;
+    /** Filter by catalog scope */
+    catalogScope?: DiscountCatalogScope;
+    /** Filter by stackable status */
+    isStackable?: boolean;
+    /** Filter by active status */
+    isActive?: boolean;
+}
+/**
+ * Discount rule sorting options.
+ * @interface DiscountRuleSorting
+ */
+export interface DiscountRuleSorting {
+    /** Field to sort by */
+    field: "name" | "priority" | "value" | "createdAt";
+    /** Sort direction */
+    direction: "asc" | "desc";
+}
+/**
+ * Discount rule query options.
+ * @interface DiscountRuleQueryOptions
+ */
+export interface DiscountRuleQueryOptions {
+    /** Page number (1-indexed) */
+    page: number;
+    /** Items per page */
+    pageSize: number;
+    /** Optional filters */
+    filters?: DiscountRuleFilters;
+    /** Optional sorting */
+    sorting?: DiscountRuleSorting;
+}

package/dist/core/business-mgt/discount-rule.schema.js

@@ -0,0 +1,108 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.UpdateDiscountRuleSchema = exports.CreateDiscountRuleSchema = exports.DiscountRuleSchema = void 0;
+const zod_1 = require("zod");
+const base_schema_1 = require("../base.schema");
+const display_order_1 = require("../type-definitions/display-order");
+const type_definitions_1 = require("../type-definitions");
+/**
+ * @fileoverview Discount rule schema definitions for order pricing.
+ * @module business-mgt/discount-rule
+ */
+// ============================================================================
+// DISCOUNT RULE SCHEMA
+// ============================================================================
+/**
+ * Discount rule schema.
+ * Defines discount configurations for orders including percentage and fixed amount discounts.
+ *
+ * @typedef {Object} DiscountRule
+ * @property {string} [locationId] - Business location where this discount applies
+ * @property {string} name - Discount display name
+ * @property {string} [code] - Discount code for promo codes
+ * @property {DiscountScope} scope - Discount scope (order, item, category)
+ * @property {DiscountType} type - Discount type (percentage, fixed)
+ * @property {number} value - Discount value (percentage or fixed amount)
+ * @property {string} currency - Currency code for fixed discounts
+ * @property {DiscountCatalogScope} catalogScope - Catalog scope for item-level discounts
+ * @property {string} [externalDiscountId] - External system discount ID
+ * @property {number} [minSubtotal] - Minimum order subtotal required
+ * @property {string} [customerSegment] - Target customer segment
+ * @property {boolean} firstOrderOnly - Whether discount is for first orders only
+ * @property {number} [maxUses] - Maximum total uses allowed
+ * @property {number} [maxUsesPerCustomer] - Maximum uses per customer
+ * @property {boolean} isStackable - Whether discount can stack with others
+ * @property {number} priority - Priority for discount application order
+ * @property {number} [effectiveFrom] - Start timestamp for discount validity
+ * @property {number} [effectiveTo] - End timestamp for discount validity
+ * @property {boolean} isActive - Whether discount is currently active
+ */
+exports.DiscountRuleSchema = base_schema_1.BaseModelSchema.safeExtend({
+    locationId: zod_1.z.string().nullable().optional(),
+    name: zod_1.z.string().min(1).max(100),
+    code: zod_1.z.string().optional(),
+    scope: zod_1.z.enum(type_definitions_1.DiscountScope).default(type_definitions_1.DiscountScope.ORDER),
+    type: zod_1.z.enum(type_definitions_1.DiscountType).default(type_definitions_1.DiscountType.PERCENTAGE),
+    value: zod_1.z.number().nonnegative(),
+    currency: zod_1.z.string().length(3).default("USD"),
+    catalogScope: zod_1.z.enum(type_definitions_1.DiscountCatalogScope).default(type_definitions_1.DiscountCatalogScope.ALL),
+    externalDiscountId: zod_1.z.string().optional(),
+    minSubtotal: zod_1.z.number().nonnegative().nullable().optional(),
+    customerSegment: zod_1.z.string().optional(),
+    firstOrderOnly: zod_1.z.boolean().default(false),
+    maxUses: zod_1.z.number().int().positive().nullable().optional(),
+    maxUsesPerCustomer: zod_1.z.number().int().positive().nullable().optional(),
+    isStackable: zod_1.z.boolean().default(true),
+    priority: zod_1.z.number().int().nonnegative().default(0),
+    effectiveFrom: zod_1.z.number().int().nonnegative().nullable().optional(),
+    effectiveTo: zod_1.z.number().int().nonnegative().nullable().optional(),
+    isActive: zod_1.z.boolean().default(true),
+}).superRefine((data, ctx) => {
+    if (data.type === type_definitions_1.DiscountType.PERCENTAGE && data.value > 100) {
+        ctx.addIssue({
+            code: "custom",
+            path: ["value"],
+            message: "value cannot exceed 100 for percentage discounts",
+        });
+    }
+    if (data.effectiveFrom !== null &&
+        data.effectiveFrom !== undefined &&
+        data.effectiveTo !== null &&
+        data.effectiveTo !== undefined &&
+        data.effectiveTo < data.effectiveFrom) {
+        ctx.addIssue({
+            code: "custom",
+            path: ["effectiveTo"],
+            message: "effectiveTo must be greater than or equal to effectiveFrom",
+        });
+    }
+});
+// ============================================================================
+// CREATE/UPDATE SCHEMAS
+// ============================================================================
+/**
+ * Schema for creating a new discount rule.
+ * Omits auto-generated fields.
+ */
+exports.CreateDiscountRuleSchema = exports.DiscountRuleSchema.omit({
+    id: true,
+    createdAt: true,
+    updatedAt: true,
+}).safeExtend({
+    placement: display_order_1.CreateDisplayOrderPlacementSchema.optional(),
+});
+/**
+ * Schema for updating an existing discount rule.
+ * All fields optional except id.
+ */
+exports.UpdateDiscountRuleSchema = exports.CreateDiscountRuleSchema.partial().extend({
+    id: zod_1.z.string().describe("Unique identifier of the discount rule to update"),
+    scope: zod_1.z.enum(type_definitions_1.DiscountScope).nullable().optional(),
+    type: zod_1.z.enum(type_definitions_1.DiscountType).nullable().optional(),
+    currency: zod_1.z.string().length(3).nullable().optional(),
+    catalogScope: zod_1.z.enum(type_definitions_1.DiscountCatalogScope).nullable().optional(),
+    firstOrderOnly: zod_1.z.boolean().nullable().optional(),
+    isStackable: zod_1.z.boolean().nullable().optional(),
+    priority: zod_1.z.number().int().nonnegative().nullable().optional(),
+    isActive: zod_1.z.boolean().nullable().optional(),
+});

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

@@ -0,0 +1,16 @@
+/**
+ * @fileoverview Central export point for business management schemas.
+ * @module business-mgt
+ */
+export * from './bookings.shared.schema';
+export * from './business-location.schema';
+export * from './discount-rule.schema';
+export * from './order.schema';
+export * from './pricing-rule.shared.schema';
+export * from './tax-rule.schema';
+export * from './customer-management';
+export * from './menu-management';
+export * from './product-management';
+export * from './property-management';
+export * from './reservation-mgt';
+export * from './service-management';

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

@@ -0,0 +1,38 @@
+"use strict";
+/**
+ * @fileoverview Central export point for business management schemas.
+ * @module business-mgt
+ */
+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 });
+// ============================================================================
+// SHARED SCHEMAS
+// ============================================================================
+__exportStar(require("./bookings.shared.schema"), exports);
+__exportStar(require("./business-location.schema"), exports);
+__exportStar(require("./discount-rule.schema"), exports);
+__exportStar(require("./order.schema"), exports);
+__exportStar(require("./pricing-rule.shared.schema"), exports);
+__exportStar(require("./tax-rule.schema"), exports);
+// ============================================================================
+// DOMAIN MODULES
+// ============================================================================
+__exportStar(require("./customer-management"), exports);
+__exportStar(require("./menu-management"), exports);
+__exportStar(require("./product-management"), exports);
+__exportStar(require("./property-management"), exports);
+__exportStar(require("./reservation-mgt"), exports);
+__exportStar(require("./service-management"), exports);

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

@@ -0,0 +1,165 @@
+import z from "zod";
+/**
+ * @fileoverview Business menu configuration schema definitions.
+ * @module business-mgt/business-menu-config
+ */
+export declare const MenuCategorySchema: z.ZodObject<{
+    id: z.ZodString;
+    createdAt: z.ZodOptional<z.ZodNumber>;
+    updatedAt: z.ZodOptional<z.ZodNumber>;
+    name: z.ZodString;
+    description: z.ZodOptional<z.ZodString>;
+    displayOrder: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>;
+export declare const BusinessMenuItemSchema: z.ZodObject<{
+    id: z.ZodString;
+    createdAt: z.ZodOptional<z.ZodNumber>;
+    updatedAt: z.ZodOptional<z.ZodNumber>;
+    name: z.ZodString;
+    description: z.ZodOptional<z.ZodString>;
+    price: z.ZodNumber;
+    categoryId: z.ZodString;
+    category: z.ZodOptional<z.ZodObject<{
+        id: z.ZodString;
+        createdAt: z.ZodOptional<z.ZodNumber>;
+        updatedAt: z.ZodOptional<z.ZodNumber>;
+        name: z.ZodString;
+        description: z.ZodOptional<z.ZodString>;
+        displayOrder: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>>;
+    ingredients: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    allergens: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    nutritionalInfo: z.ZodOptional<z.ZodObject<{
+        calories: z.ZodOptional<z.ZodNumber>;
+        protein: z.ZodOptional<z.ZodNumber>;
+        carbs: z.ZodOptional<z.ZodNumber>;
+        fat: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>>;
+    isAvailable: z.ZodDefault<z.ZodBoolean>;
+    preparationTime: z.ZodOptional<z.ZodNumber>;
+    isActive: z.ZodDefault<z.ZodBoolean>;
+    displayOrder: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>;
+export declare const MenuQRCodeSchema: z.ZodObject<{
+    id: z.ZodString;
+    menuUrl: z.ZodURL;
+    qrCodeImage: z.ZodOptional<z.ZodString>;
+    tableNumber: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+/**
+ * Zod schema for creating a new menu category.
+ *
+ * Omits auto-generated fields.
+ */
+export declare const CreateMenuCategorySchema: z.ZodObject<{
+    name: z.ZodString;
+    description: z.ZodOptional<z.ZodString>;
+    displayOrder: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>;
+/**
+ * Zod schema for creating a new business menu item.
+ *
+ * Omits auto-generated fields and allows optional category specification.
+ */
+export declare const CreateBusinessMenuItemSchema: z.ZodObject<{
+    name: z.ZodString;
+    description: z.ZodOptional<z.ZodString>;
+    isActive: z.ZodDefault<z.ZodBoolean>;
+    price: z.ZodNumber;
+    displayOrder: z.ZodOptional<z.ZodNumber>;
+    ingredients: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    allergens: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    nutritionalInfo: z.ZodOptional<z.ZodObject<{
+        calories: z.ZodOptional<z.ZodNumber>;
+        protein: z.ZodOptional<z.ZodNumber>;
+        carbs: z.ZodOptional<z.ZodNumber>;
+        fat: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>>;
+    isAvailable: z.ZodDefault<z.ZodBoolean>;
+    preparationTime: z.ZodOptional<z.ZodNumber>;
+    categoryId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+}, z.core.$strip>;
+/**
+ * Zod schema for updating an existing menu category.
+ *
+ * All fields are optional (partial) except id.
+ */
+export declare const UpdateMenuCategorySchema: z.ZodObject<{
+    name: z.ZodOptional<z.ZodString>;
+    description: z.ZodOptional<z.ZodOptional<z.ZodString>>;
+    displayOrder: z.ZodOptional<z.ZodOptional<z.ZodNumber>>;
+    id: z.ZodString;
+}, z.core.$strip>;
+/**
+ * Zod schema for updating an existing business menu item.
+ *
+ * All fields are optional (partial) except id.
+ */
+export declare const UpdateBusinessMenuItemSchema: z.ZodObject<{
+    name: z.ZodOptional<z.ZodString>;
+    description: z.ZodOptional<z.ZodOptional<z.ZodString>>;
+    isActive: z.ZodOptional<z.ZodDefault<z.ZodBoolean>>;
+    price: z.ZodOptional<z.ZodNumber>;
+    displayOrder: z.ZodOptional<z.ZodOptional<z.ZodNumber>>;
+    ingredients: z.ZodOptional<z.ZodOptional<z.ZodArray<z.ZodString>>>;
+    allergens: z.ZodOptional<z.ZodOptional<z.ZodArray<z.ZodString>>>;
+    nutritionalInfo: z.ZodOptional<z.ZodOptional<z.ZodObject<{
+        calories: z.ZodOptional<z.ZodNumber>;
+        protein: z.ZodOptional<z.ZodNumber>;
+        carbs: z.ZodOptional<z.ZodNumber>;
+        fat: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>>>;
+    isAvailable: z.ZodOptional<z.ZodDefault<z.ZodBoolean>>;
+    preparationTime: z.ZodOptional<z.ZodOptional<z.ZodNumber>>;
+    categoryId: z.ZodOptional<z.ZodOptional<z.ZodNullable<z.ZodString>>>;
+    id: z.ZodString;
+}, z.core.$strip>;
+/**
+ * Type definition for menu category.
+ */
+export type MenuCategory = z.infer<typeof MenuCategorySchema>;
+/**
+ * Type definition for business menu item.
+ */
+export type BusinessMenuItem = z.infer<typeof BusinessMenuItemSchema>;
+/**
+ * Type definition for menu QR code.
+ */
+export type MenuQRCode = z.infer<typeof MenuQRCodeSchema>;
+/**
+ * Type definition for creating a menu category.
+ */
+export type CreateMenuCategory = z.infer<typeof CreateMenuCategorySchema>;
+/**
+ * Type definition for creating a business menu item.
+ */
+export type CreateBusinessMenuItem = z.infer<typeof CreateBusinessMenuItemSchema>;
+/**
+ * Type definition for updating a menu category.
+ */
+export type UpdateMenuCategory = z.infer<typeof UpdateMenuCategorySchema>;
+/**
+ * Type definition for updating a business menu item.
+ */
+export type UpdateBusinessMenuItem = z.infer<typeof UpdateBusinessMenuItemSchema>;
+export interface BusinessMenuItemFilters {
+    search?: string;
+    categoryId?: string;
+    isActive?: boolean;
+    isAvailable?: boolean;
+    allergens?: string[];
+    priceRange?: {
+        min?: number;
+        max?: number;
+    };
+}
+export interface BusinessMenuItemSorting {
+    field: 'name' | 'price' | 'createdAt' | 'displayOrder';
+    direction: 'asc' | 'desc';
+}
+export interface BusinessMenuItemQueryOptions {
+    page: number;
+    pageSize: number;
+    filters?: BusinessMenuItemFilters;
+    sorting?: BusinessMenuItemSorting;
+}

package/dist/core/business-mgt/menu-config.schema.js

@@ -0,0 +1,86 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.UpdateBusinessMenuItemSchema = exports.UpdateMenuCategorySchema = exports.CreateBusinessMenuItemSchema = exports.CreateMenuCategorySchema = exports.MenuQRCodeSchema = exports.BusinessMenuItemSchema = exports.MenuCategorySchema = void 0;
+const zod_1 = __importDefault(require("zod"));
+const base_schema_1 = require("../base.schema");
+/**
+ * @fileoverview Business menu configuration schema definitions.
+ * @module business-mgt/business-menu-config
+ */
+exports.MenuCategorySchema = base_schema_1.BaseModelSchema.safeExtend({
+    name: zod_1.default.string().min(1, "Category name is required").describe("Category name for menu organization (e.g., Appetizers, Main Course, Desserts). Used by AI Powered Services when presenting menu options to customers."),
+    description: zod_1.default.string().optional().describe("Category description providing context about the type of items included. Helps customers navigate the menu."),
+    displayOrder: zod_1.default.number().int().optional().describe("Numeric order for category display in menu listings. Lower numbers appear first. Enables custom menu organization."),
+});
+exports.BusinessMenuItemSchema = base_schema_1.BaseModelSchema.safeExtend({
+    name: zod_1.default.string().min(1, "Menu item name is required").describe("Display name of the menu item shown to customers. Used by AI Powered Services in menu order conversations."),
+    description: zod_1.default.string().optional().describe("Detailed item description including preparation style, ingredients, or special features. Helps customers make informed selections."),
+    // Menu-specific fields
+    price: zod_1.default.number().nonnegative().describe("Base price for this menu item in the account's currency. Used for order pricing calculations."),
+    categoryId: zod_1.default.string().describe("References MenuCategory this item belongs to. Used for menu organization and AI-driven category-based browsing."),
+    category: exports.MenuCategorySchema.optional().describe("Populated MenuCategory object for convenient access. Not required during creation; managed by Menu Management."),
+    ingredients: zod_1.default.array(zod_1.default.string()).optional().describe("List of primary ingredients for dietary information and AI-powered ingredient-based searches (e.g., 'vegetarian options')."),
+    allergens: zod_1.default.array(zod_1.default.string()).optional().describe("Common allergens present (e.g., ['nuts', 'dairy', 'gluten']). Critical for customer safety and AI allergen filtering."),
+    nutritionalInfo: zod_1.default.object({
+        calories: zod_1.default.number().optional().describe("Caloric content per serving."),
+        protein: zod_1.default.number().optional().describe("Protein content in grams."),
+        carbs: zod_1.default.number().optional().describe("Carbohydrate content in grams."),
+        fat: zod_1.default.number().optional().describe("Fat content in grams."),
+    }).optional().describe("Optional nutritional information for health-conscious customers and dietary compliance."),
+    // Availability
+    isAvailable: zod_1.default.boolean().default(true).describe("Real-time availability status (e.g., sold out, temporarily unavailable). AI Powered Services only presents available items. Defaults to true."),
+    preparationTime: zod_1.default.number().int().positive().optional().describe("Estimated preparation time in minutes. Used for setting customer expectations and order timing in Menu Order workflow."),
+    // Business Management
+    isActive: zod_1.default.boolean().default(true).describe("Whether item is active in the menu catalog. Inactive items are hidden from customers. Defaults to true."),
+    displayOrder: zod_1.default.number().int().optional().describe("Display order within category. Lower numbers appear first. Enables strategic item positioning."),
+});
+// Simple QR code for menu
+exports.MenuQRCodeSchema = zod_1.default.object({
+    id: zod_1.default.string().describe("Unique identifier for this QR code instance."),
+    menuUrl: zod_1.default.url().describe("URL to the digital menu accessed by scanning this QR code. Links to menu browsing interface."),
+    qrCodeImage: zod_1.default.string().optional().describe("Base64 encoded QR code image for printing or digital display. Generated from menuUrl."),
+    tableNumber: zod_1.default.string().optional().describe("Optional table number for dine-in scenarios. Associates QR code with specific table for order attribution."),
+});
+/**
+ * Zod schema for creating a new menu category.
+ *
+ * Omits auto-generated fields.
+ */
+exports.CreateMenuCategorySchema = exports.MenuCategorySchema.omit({
+    id: true,
+    createdAt: true,
+    updatedAt: true,
+});
+/**
+ * Zod schema for creating a new business menu item.
+ *
+ * Omits auto-generated fields and allows optional category specification.
+ */
+exports.CreateBusinessMenuItemSchema = exports.BusinessMenuItemSchema.omit({
+    id: true,
+    createdAt: true,
+    updatedAt: true,
+    category: true,
+    categoryId: true,
+}).safeExtend({
+    categoryId: zod_1.default.string().nullable().optional(),
+});
+/**
+ * Zod schema for updating an existing menu category.
+ *
+ * All fields are optional (partial) except id.
+ */
+exports.UpdateMenuCategorySchema = exports.CreateMenuCategorySchema.partial().safeExtend({
+    id: zod_1.default.string(),
+});
+/**
+ * Zod schema for updating an existing business menu item.
+ *
+ * All fields are optional (partial) except id.
+ */
+exports.UpdateBusinessMenuItemSchema = exports.CreateBusinessMenuItemSchema.partial().safeExtend({
+    id: zod_1.default.string(),
+});

package/dist/core/business-mgt/menu-management/index.d.ts

@@ -0,0 +1,11 @@
+/**
+ * @fileoverview Central export point for menu management schemas.
+ * @module business-mgt/menu-management
+ */
+export * from './menu-config.schema';
+export * from './menu-item-variant.schema';
+export * from './modifier.schema';
+export * from './menu-catalog.schema';
+export * from './menu-set.schema';
+export * from './menu-pricing-rule.schema';
+export * from './menu.order.schema';

package/dist/core/business-mgt/menu-management/index.js

@@ -0,0 +1,27 @@
+"use strict";
+/**
+ * @fileoverview Central export point for menu management schemas.
+ * @module business-mgt/menu-management
+ */
+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("./menu-config.schema"), exports);
+__exportStar(require("./menu-item-variant.schema"), exports);
+__exportStar(require("./modifier.schema"), exports);
+__exportStar(require("./menu-catalog.schema"), exports);
+__exportStar(require("./menu-set.schema"), exports);
+__exportStar(require("./menu-pricing-rule.schema"), exports);
+__exportStar(require("./menu.order.schema"), exports);