wiil-core-js 0.0.82

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

@@ -0,0 +1,493 @@
+import z from "zod";
+import { OrderStatus, PaymentStatus } from "../../type-definitions";
+/**
+ * @fileoverview Product order schema definitions for retail/product sales.
+ * @module business-mgt/product-order
+ */
+/**
+ * Base product order item schema (without productOrderId for creation).
+ *
+ * @typedef {Object} ProductOrderItemBase
+ * @property {string} productId - Product ID being ordered
+ * @property {string} itemName - Name of the product
+ * @property {string} [sku] - Product SKU
+ * @property {number} quantity - Quantity ordered
+ * @property {number} unitPrice - Price per unit
+ * @property {number} totalPrice - Total price for this item
+ * @property {string} [selectedVariant] - Selected variant (size, color, etc.)
+ * @property {string} [warrantyInfo] - Warranty information
+ * @property {string} status - Item status
+ * @property {string} [notes] - Additional notes
+ */
+export declare const ProductOrderItemBaseSchema: z.ZodObject<{
+    productId: z.ZodString;
+    variantId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    itemName: z.ZodString;
+    sku: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    quantity: z.ZodNumber;
+    unitPrice: z.ZodNumber;
+    totalPrice: z.ZodNumber;
+    selectedVariant: z.ZodOptional<z.ZodString>;
+    warrantyInfo: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    status: z.ZodDefault<z.ZodEnum<typeof OrderStatus>>;
+    notes: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+}, z.core.$strip>;
+/**
+ * Product order item schema with IDs (for existing items).
+ */
+export declare const ProductOrderItemSchema: z.ZodObject<{
+    productId: z.ZodString;
+    variantId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    itemName: z.ZodString;
+    sku: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    quantity: z.ZodNumber;
+    unitPrice: z.ZodNumber;
+    totalPrice: z.ZodNumber;
+    selectedVariant: z.ZodOptional<z.ZodString>;
+    warrantyInfo: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    status: z.ZodDefault<z.ZodEnum<typeof OrderStatus>>;
+    notes: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    id: z.ZodString;
+    productOrderId: z.ZodString;
+}, z.core.$strip>;
+/**
+ * Product order schema - for retail/product sales.
+ *
+ * @typedef {Object} ProductOrder
+ * @property {string} [orderNumber] - Human-readable order number
+ * @property {string} status - Order status
+ * @property {Array} items - Items in the order
+ * @property {string} customerId - Customer ID
+ * @property {Object} [customer] - Customer information
+ * @property {Object} pricing - Pricing details
+ * @property {string} paymentStatus - Payment status
+ * @property {string} [paymentMethod] - Payment method
+ * @property {string} [paymentReference] - Payment reference
+ * @property {Object} [billingAddress] - Billing address
+ * @property {number} orderDate - Order date
+ * @property {number} [requestedDeliveryDate] - Requested delivery date
+ * @property {number} [shippedDate] - Shipped date
+ * @property {Object} [shippingAddress] - Shipping address
+ * @property {number} [deliveredDate] - Delivered date
+ * @property {string} [shippingMethod] - Shipping method
+ * @property {string} [trackingNumber] - Tracking number
+ * @property {string} [shippingCarrier] - Shipping carrier
+ * @property {string} [externalOrderId] - External order ID
+ * @property {string} source - Order source
+ * @property {string} [cancelReason] - Cancellation reason
+ * @property {string} [notes] - Additional notes
+ * @property {string} [serviceConversationConfigId] - Service conversation config ID
+ */
+export declare const ProductOrderSchema: z.ZodObject<{
+    id: z.ZodString;
+    createdAt: z.ZodOptional<z.ZodNumber>;
+    updatedAt: z.ZodOptional<z.ZodNumber>;
+    locationId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    channelId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    terminalId: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+    operatorId: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+    orderNumber: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+    status: z.ZodDefault<z.ZodEnum<typeof OrderStatus>>;
+    items: z.ZodArray<z.ZodObject<{
+        productId: z.ZodString;
+        variantId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        itemName: z.ZodString;
+        sku: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        quantity: z.ZodNumber;
+        unitPrice: z.ZodNumber;
+        totalPrice: z.ZodNumber;
+        selectedVariant: z.ZodOptional<z.ZodString>;
+        warrantyInfo: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        status: z.ZodDefault<z.ZodEnum<typeof OrderStatus>>;
+        notes: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        id: z.ZodString;
+        productOrderId: z.ZodString;
+    }, z.core.$strip>>;
+    customerId: z.ZodString;
+    pricing: z.ZodObject<{
+        subtotalBeforeTax: z.ZodOptional<z.ZodNumber>;
+        subtotal: z.ZodNumber;
+        appliedPricingRules: z.ZodDefault<z.ZodArray<z.ZodObject<{
+            pricingRuleId: z.ZodOptional<z.ZodString>;
+            externalPricingRuleId: z.ZodOptional<z.ZodString>;
+            name: z.ZodString;
+            applyLevel: z.ZodDefault<z.ZodEnum<typeof import("../../type-definitions").PricingRuleApplyLevel>>;
+            adjustmentType: z.ZodEnum<typeof import("../../type-definitions").PricingRuleAdjustmentType>;
+            adjustmentValue: z.ZodNumber;
+            baseAmount: z.ZodNumber;
+            adjustedAmount: z.ZodNumber;
+            deltaAmount: z.ZodNumber;
+            appliedAt: z.ZodOptional<z.ZodNumber>;
+        }, z.core.$strip>>>;
+        totalPricingAdjustmentAmount: z.ZodDefault<z.ZodNumber>;
+        subtotalAfterPricingRules: z.ZodOptional<z.ZodNumber>;
+        appliedDiscounts: z.ZodDefault<z.ZodArray<z.ZodObject<{
+            discountRuleId: z.ZodOptional<z.ZodString>;
+            externalDiscountId: z.ZodOptional<z.ZodString>;
+            name: z.ZodString;
+            code: z.ZodOptional<z.ZodString>;
+            scope: z.ZodDefault<z.ZodEnum<typeof import("../../type-definitions").DiscountScope>>;
+            type: z.ZodEnum<typeof import("../../type-definitions").DiscountType>;
+            value: z.ZodNumber;
+            discountableAmount: z.ZodNumber;
+            discountAmount: z.ZodNumber;
+            isStacked: z.ZodDefault<z.ZodBoolean>;
+        }, z.core.$strip>>>;
+        totalDiscountAmount: z.ZodDefault<z.ZodNumber>;
+        subtotalAfterDiscount: z.ZodOptional<z.ZodNumber>;
+        appliedTaxes: z.ZodDefault<z.ZodArray<z.ZodObject<{
+            taxRuleId: z.ZodOptional<z.ZodString>;
+            externalTaxId: z.ZodOptional<z.ZodString>;
+            name: z.ZodString;
+            scope: z.ZodDefault<z.ZodEnum<typeof import("../../type-definitions").TaxScope>>;
+            rateType: z.ZodEnum<typeof import("../../type-definitions").TaxRateType>;
+            rateValue: z.ZodNumber;
+            taxableAmount: z.ZodNumber;
+            taxAmount: z.ZodNumber;
+            isInclusive: z.ZodDefault<z.ZodBoolean>;
+        }, z.core.$strip>>>;
+        totalTaxAmount: z.ZodDefault<z.ZodNumber>;
+        tax: z.ZodDefault<z.ZodNumber>;
+        tip: z.ZodDefault<z.ZodNumber>;
+        shippingAmount: z.ZodDefault<z.ZodNumber>;
+        discount: z.ZodDefault<z.ZodNumber>;
+        subtotalAfterTax: z.ZodOptional<z.ZodNumber>;
+        total: z.ZodNumber;
+        currency: z.ZodDefault<z.ZodString>;
+    }, z.core.$strip>;
+    paymentStatus: z.ZodDefault<z.ZodEnum<typeof PaymentStatus>>;
+    paymentMethod: z.ZodOptional<z.ZodString>;
+    paymentReference: z.ZodOptional<z.ZodString>;
+    billingAddress: z.ZodOptional<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>>>;
+    orderDate: z.ZodNumber;
+    requestedDeliveryDate: z.ZodOptional<z.ZodNumber>;
+    shippedDate: z.ZodOptional<z.ZodNumber>;
+    shippingAddress: z.ZodOptional<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>>>;
+    deliveredDate: z.ZodOptional<z.ZodNumber>;
+    shippingMethod: z.ZodOptional<z.ZodString>;
+    trackingNumber: z.ZodOptional<z.ZodString>;
+    shippingCarrier: z.ZodOptional<z.ZodString>;
+    externalRef: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+        externalId: z.ZodString;
+        source: z.ZodString;
+        url: z.ZodOptional<z.ZodNullable<z.ZodURL>>;
+        syncedAt: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    }, z.core.$strip>>>;
+    source: z.ZodDefault<z.ZodString>;
+    cancelReason: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    notes: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    serviceConversationConfigId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+}, z.core.$strip>;
+/**
+ * Schema for creating a new product order.
+ * Omits auto-generated fields and uses base items without IDs.
+ */
+export declare const CreateProductOrderSchema: z.ZodObject<{
+    source: z.ZodDefault<z.ZodString>;
+    status: z.ZodDefault<z.ZodEnum<typeof OrderStatus>>;
+    locationId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    customerId: z.ZodString;
+    channelId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    notes: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    terminalId: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+    operatorId: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+    pricing: z.ZodObject<{
+        subtotalBeforeTax: z.ZodOptional<z.ZodNumber>;
+        subtotal: z.ZodNumber;
+        appliedPricingRules: z.ZodDefault<z.ZodArray<z.ZodObject<{
+            pricingRuleId: z.ZodOptional<z.ZodString>;
+            externalPricingRuleId: z.ZodOptional<z.ZodString>;
+            name: z.ZodString;
+            applyLevel: z.ZodDefault<z.ZodEnum<typeof import("../../type-definitions").PricingRuleApplyLevel>>;
+            adjustmentType: z.ZodEnum<typeof import("../../type-definitions").PricingRuleAdjustmentType>;
+            adjustmentValue: z.ZodNumber;
+            baseAmount: z.ZodNumber;
+            adjustedAmount: z.ZodNumber;
+            deltaAmount: z.ZodNumber;
+            appliedAt: z.ZodOptional<z.ZodNumber>;
+        }, z.core.$strip>>>;
+        totalPricingAdjustmentAmount: z.ZodDefault<z.ZodNumber>;
+        subtotalAfterPricingRules: z.ZodOptional<z.ZodNumber>;
+        appliedDiscounts: z.ZodDefault<z.ZodArray<z.ZodObject<{
+            discountRuleId: z.ZodOptional<z.ZodString>;
+            externalDiscountId: z.ZodOptional<z.ZodString>;
+            name: z.ZodString;
+            code: z.ZodOptional<z.ZodString>;
+            scope: z.ZodDefault<z.ZodEnum<typeof import("../../type-definitions").DiscountScope>>;
+            type: z.ZodEnum<typeof import("../../type-definitions").DiscountType>;
+            value: z.ZodNumber;
+            discountableAmount: z.ZodNumber;
+            discountAmount: z.ZodNumber;
+            isStacked: z.ZodDefault<z.ZodBoolean>;
+        }, z.core.$strip>>>;
+        totalDiscountAmount: z.ZodDefault<z.ZodNumber>;
+        subtotalAfterDiscount: z.ZodOptional<z.ZodNumber>;
+        appliedTaxes: z.ZodDefault<z.ZodArray<z.ZodObject<{
+            taxRuleId: z.ZodOptional<z.ZodString>;
+            externalTaxId: z.ZodOptional<z.ZodString>;
+            name: z.ZodString;
+            scope: z.ZodDefault<z.ZodEnum<typeof import("../../type-definitions").TaxScope>>;
+            rateType: z.ZodEnum<typeof import("../../type-definitions").TaxRateType>;
+            rateValue: z.ZodNumber;
+            taxableAmount: z.ZodNumber;
+            taxAmount: z.ZodNumber;
+            isInclusive: z.ZodDefault<z.ZodBoolean>;
+        }, z.core.$strip>>>;
+        totalTaxAmount: z.ZodDefault<z.ZodNumber>;
+        tax: z.ZodDefault<z.ZodNumber>;
+        tip: z.ZodDefault<z.ZodNumber>;
+        shippingAmount: z.ZodDefault<z.ZodNumber>;
+        discount: z.ZodDefault<z.ZodNumber>;
+        subtotalAfterTax: z.ZodOptional<z.ZodNumber>;
+        total: z.ZodNumber;
+        currency: z.ZodDefault<z.ZodString>;
+    }, z.core.$strip>;
+    paymentStatus: z.ZodDefault<z.ZodEnum<typeof PaymentStatus>>;
+    paymentMethod: z.ZodOptional<z.ZodString>;
+    paymentReference: z.ZodOptional<z.ZodString>;
+    orderDate: z.ZodNumber;
+    externalRef: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+        externalId: z.ZodString;
+        source: z.ZodString;
+        url: z.ZodOptional<z.ZodNullable<z.ZodURL>>;
+        syncedAt: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    }, z.core.$strip>>>;
+    billingAddress: z.ZodOptional<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>>>;
+    requestedDeliveryDate: z.ZodOptional<z.ZodNumber>;
+    shippingAddress: z.ZodOptional<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>>>;
+    shippingMethod: z.ZodOptional<z.ZodString>;
+    trackingNumber: z.ZodOptional<z.ZodString>;
+    shippingCarrier: z.ZodOptional<z.ZodString>;
+    items: z.ZodArray<z.ZodObject<{
+        productId: z.ZodString;
+        variantId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        itemName: z.ZodString;
+        sku: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        quantity: z.ZodNumber;
+        unitPrice: z.ZodNumber;
+        totalPrice: z.ZodNumber;
+        selectedVariant: z.ZodOptional<z.ZodString>;
+        warrantyInfo: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        status: z.ZodDefault<z.ZodEnum<typeof OrderStatus>>;
+        notes: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    }, z.core.$strip>>;
+    cancelReason: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+}, z.core.$strip>;
+/**
+ * Schema for updating an existing product order.
+ * All fields are optional except id.
+ */
+export declare const UpdateProductOrderSchema: z.ZodObject<{
+    source: z.ZodOptional<z.ZodDefault<z.ZodString>>;
+    status: z.ZodOptional<z.ZodDefault<z.ZodEnum<typeof OrderStatus>>>;
+    locationId: z.ZodOptional<z.ZodOptional<z.ZodNullable<z.ZodString>>>;
+    customerId: z.ZodOptional<z.ZodString>;
+    channelId: z.ZodOptional<z.ZodOptional<z.ZodNullable<z.ZodString>>>;
+    notes: z.ZodOptional<z.ZodOptional<z.ZodNullable<z.ZodString>>>;
+    terminalId: z.ZodOptional<z.ZodDefault<z.ZodNullable<z.ZodString>>>;
+    operatorId: z.ZodOptional<z.ZodDefault<z.ZodNullable<z.ZodString>>>;
+    pricing: z.ZodOptional<z.ZodObject<{
+        subtotalBeforeTax: z.ZodOptional<z.ZodNumber>;
+        subtotal: z.ZodNumber;
+        appliedPricingRules: z.ZodDefault<z.ZodArray<z.ZodObject<{
+            pricingRuleId: z.ZodOptional<z.ZodString>;
+            externalPricingRuleId: z.ZodOptional<z.ZodString>;
+            name: z.ZodString;
+            applyLevel: z.ZodDefault<z.ZodEnum<typeof import("../../type-definitions").PricingRuleApplyLevel>>;
+            adjustmentType: z.ZodEnum<typeof import("../../type-definitions").PricingRuleAdjustmentType>;
+            adjustmentValue: z.ZodNumber;
+            baseAmount: z.ZodNumber;
+            adjustedAmount: z.ZodNumber;
+            deltaAmount: z.ZodNumber;
+            appliedAt: z.ZodOptional<z.ZodNumber>;
+        }, z.core.$strip>>>;
+        totalPricingAdjustmentAmount: z.ZodDefault<z.ZodNumber>;
+        subtotalAfterPricingRules: z.ZodOptional<z.ZodNumber>;
+        appliedDiscounts: z.ZodDefault<z.ZodArray<z.ZodObject<{
+            discountRuleId: z.ZodOptional<z.ZodString>;
+            externalDiscountId: z.ZodOptional<z.ZodString>;
+            name: z.ZodString;
+            code: z.ZodOptional<z.ZodString>;
+            scope: z.ZodDefault<z.ZodEnum<typeof import("../../type-definitions").DiscountScope>>;
+            type: z.ZodEnum<typeof import("../../type-definitions").DiscountType>;
+            value: z.ZodNumber;
+            discountableAmount: z.ZodNumber;
+            discountAmount: z.ZodNumber;
+            isStacked: z.ZodDefault<z.ZodBoolean>;
+        }, z.core.$strip>>>;
+        totalDiscountAmount: z.ZodDefault<z.ZodNumber>;
+        subtotalAfterDiscount: z.ZodOptional<z.ZodNumber>;
+        appliedTaxes: z.ZodDefault<z.ZodArray<z.ZodObject<{
+            taxRuleId: z.ZodOptional<z.ZodString>;
+            externalTaxId: z.ZodOptional<z.ZodString>;
+            name: z.ZodString;
+            scope: z.ZodDefault<z.ZodEnum<typeof import("../../type-definitions").TaxScope>>;
+            rateType: z.ZodEnum<typeof import("../../type-definitions").TaxRateType>;
+            rateValue: z.ZodNumber;
+            taxableAmount: z.ZodNumber;
+            taxAmount: z.ZodNumber;
+            isInclusive: z.ZodDefault<z.ZodBoolean>;
+        }, z.core.$strip>>>;
+        totalTaxAmount: z.ZodDefault<z.ZodNumber>;
+        tax: z.ZodDefault<z.ZodNumber>;
+        tip: z.ZodDefault<z.ZodNumber>;
+        shippingAmount: z.ZodDefault<z.ZodNumber>;
+        discount: z.ZodDefault<z.ZodNumber>;
+        subtotalAfterTax: z.ZodOptional<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.ZodOptional<z.ZodString>>;
+    paymentReference: z.ZodOptional<z.ZodOptional<z.ZodString>>;
+    orderDate: z.ZodOptional<z.ZodNumber>;
+    externalRef: z.ZodOptional<z.ZodOptional<z.ZodNullable<z.ZodObject<{
+        externalId: z.ZodString;
+        source: z.ZodString;
+        url: z.ZodOptional<z.ZodNullable<z.ZodURL>>;
+        syncedAt: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    }, z.core.$strip>>>>;
+    billingAddress: z.ZodOptional<z.ZodOptional<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>>>>;
+    requestedDeliveryDate: z.ZodOptional<z.ZodOptional<z.ZodNumber>>;
+    shippingAddress: z.ZodOptional<z.ZodOptional<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>>>>;
+    shippingMethod: z.ZodOptional<z.ZodOptional<z.ZodString>>;
+    trackingNumber: z.ZodOptional<z.ZodOptional<z.ZodString>>;
+    shippingCarrier: z.ZodOptional<z.ZodOptional<z.ZodString>>;
+    items: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        productId: z.ZodString;
+        variantId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        itemName: z.ZodString;
+        sku: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        quantity: z.ZodNumber;
+        unitPrice: z.ZodNumber;
+        totalPrice: z.ZodNumber;
+        selectedVariant: z.ZodOptional<z.ZodString>;
+        warrantyInfo: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        status: z.ZodDefault<z.ZodEnum<typeof OrderStatus>>;
+        notes: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    }, z.core.$strip>>>;
+    id: z.ZodString;
+    cancelReason: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+}, z.core.$strip>;
+/**
+ * Quick status update schema for product orders.
+ */
+export declare const UpdateProductOrderStatusSchema: z.ZodObject<{
+    id: z.ZodString;
+    status: z.ZodEnum<typeof OrderStatus>;
+    shippedDate: z.ZodOptional<z.ZodNumber>;
+    deliveredDate: z.ZodOptional<z.ZodNumber>;
+    trackingNumber: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type ProductOrderItemBase = z.infer<typeof ProductOrderItemBaseSchema>;
+export type ProductOrderItem = z.infer<typeof ProductOrderItemSchema>;
+export type ProductOrder = z.infer<typeof ProductOrderSchema>;
+export type CreateProductOrder = z.infer<typeof CreateProductOrderSchema>;
+export type UpdateProductOrder = z.infer<typeof UpdateProductOrderSchema>;
+export type UpdateProductOrderStatus = z.infer<typeof UpdateProductOrderStatusSchema>;
+export type CreateProductOrderItem = z.infer<typeof ProductOrderItemBaseSchema>;
+/**
+ * Product order filter options.
+ * @interface ProductOrderFilters
+ */
+export interface ProductOrderFilters {
+    /** Text search across order fields */
+    search?: string;
+    /** Filter by location ID */
+    locationId?: string;
+    /** Filter by channel ID */
+    channelId?: string;
+    /** Filter by terminal ID */
+    terminalId?: string;
+    /** Filter by operator ID */
+    operatorId?: string;
+    /** Filter by order statuses */
+    status?: OrderStatus[];
+    /** Filter by payment statuses */
+    paymentStatus?: PaymentStatus[];
+    /** Filter by customer ID */
+    customerId?: string;
+    /** Filter by shipping method */
+    shippingMethod?: string;
+    /** Filter by order source */
+    source?: string;
+    /** Filter by external source platform */
+    externalSource?: string;
+    /** Filter by date range */
+    dateRange?: {
+        start?: number;
+        end?: number;
+    };
+}
+/**
+ * Product order sorting options.
+ * @interface ProductOrderSorting
+ */
+export interface ProductOrderSorting {
+    /** Field to sort by */
+    field: 'orderDate' | 'createdAt' | 'totalAmount';
+    /** Sort direction */
+    direction: 'asc' | 'desc';
+}
+/**
+ * Product order query options.
+ * @interface ProductOrderQueryOptions
+ */
+export interface ProductOrderQueryOptions {
+    /** Page number (1-indexed) */
+    page: number;
+    /** Items per page */
+    pageSize: number;
+    /** Optional filters */
+    filters?: ProductOrderFilters;
+    /** Optional sorting */
+    sorting?: ProductOrderSorting;
+}

package/dist/core/business-mgt/product-management/product-order.schema.js

@@ -0,0 +1,158 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.UpdateProductOrderStatusSchema = exports.UpdateProductOrderSchema = exports.CreateProductOrderSchema = exports.ProductOrderSchema = exports.ProductOrderItemSchema = exports.ProductOrderItemBaseSchema = void 0;
+const zod_1 = __importDefault(require("zod"));
+const base_schema_1 = require("../../base.schema");
+const order_schema_1 = require("../order.schema");
+const type_definitions_1 = require("../../type-definitions");
+/**
+ * @fileoverview Product order schema definitions for retail/product sales.
+ * @module business-mgt/product-order
+ */
+// ============================================================================
+// ORDER ITEM SCHEMAS
+// ============================================================================
+/**
+ * Base product order item schema (without productOrderId for creation).
+ *
+ * @typedef {Object} ProductOrderItemBase
+ * @property {string} productId - Product ID being ordered
+ * @property {string} itemName - Name of the product
+ * @property {string} [sku] - Product SKU
+ * @property {number} quantity - Quantity ordered
+ * @property {number} unitPrice - Price per unit
+ * @property {number} totalPrice - Total price for this item
+ * @property {string} [selectedVariant] - Selected variant (size, color, etc.)
+ * @property {string} [warrantyInfo] - Warranty information
+ * @property {string} status - Item status
+ * @property {string} [notes] - Additional notes
+ */
+exports.ProductOrderItemBaseSchema = zod_1.default.object({
+    productId: zod_1.default.string().describe("References Product from product-config.schema being ordered. Links order item to catalog for inventory tracking, fulfillment details, and product information."),
+    variantId: zod_1.default.string().nullable().optional().describe("Product variant ID being ordered. Links to specific SKU variant for accurate inventory tracking and pricing."),
+    itemName: zod_1.default.string().describe("Display name of the product captured at order time. Preserved even if catalog product is later renamed, ensuring historical order accuracy."),
+    sku: zod_1.default.string().nullable().optional().describe("Stock Keeping Unit identifier captured at order time for warehouse fulfillment and inventory systems. Links to product catalog SKU for picking and packing."),
+    quantity: zod_1.default.number().int().positive().describe("Number of units ordered for this product. Used for inventory deduction, pricing calculations, and fulfillment quantities."),
+    unitPrice: zod_1.default.number().nonnegative().describe("Price per unit at the time of order. Captures pricing snapshot for order integrity even if catalog prices change later."),
+    totalPrice: zod_1.default.number().nonnegative().describe("Total price for this line item: unitPrice × quantity. Used in order subtotal calculations."),
+    // Retail-specific
+    selectedVariant: zod_1.default.string().optional().describe("Selected product variant specification (e.g., 'Large/Blue', 'XL', '128GB'). Captured for fulfillment accuracy and inventory tracking of specific variants."),
+    warrantyInfo: zod_1.default.string().nullable().optional().describe("Warranty terms and coverage details captured at purchase time. Preserved for customer reference and service claim validation."),
+    status: zod_1.default.enum(type_definitions_1.OrderStatus).default(type_definitions_1.OrderStatus.PENDING).describe("Current fulfillment status of this individual item. Enables per-item tracking in warehouse workflow. Defaults to PENDING."),
+    notes: zod_1.default.string().nullable().optional().describe("Internal notes about this item for warehouse or fulfillment staff. Not visible to customers.")
+});
+/**
+ * Product order item schema with IDs (for existing items).
+ */
+exports.ProductOrderItemSchema = exports.ProductOrderItemBaseSchema.safeExtend({
+    id: zod_1.default.string().describe("Unique identifier for this product order item instance."),
+    productOrderId: zod_1.default.string().describe("References parent ProductOrder this item belongs to. Maintains order-item relationship for order management and fulfillment tracking."),
+});
+// ============================================================================
+// PRODUCT ORDER SCHEMA
+// ============================================================================
+/**
+ * Product order schema - for retail/product sales.
+ *
+ * @typedef {Object} ProductOrder
+ * @property {string} [orderNumber] - Human-readable order number
+ * @property {string} status - Order status
+ * @property {Array} items - Items in the order
+ * @property {string} customerId - Customer ID
+ * @property {Object} [customer] - Customer information
+ * @property {Object} pricing - Pricing details
+ * @property {string} paymentStatus - Payment status
+ * @property {string} [paymentMethod] - Payment method
+ * @property {string} [paymentReference] - Payment reference
+ * @property {Object} [billingAddress] - Billing address
+ * @property {number} orderDate - Order date
+ * @property {number} [requestedDeliveryDate] - Requested delivery date
+ * @property {number} [shippedDate] - Shipped date
+ * @property {Object} [shippingAddress] - Shipping address
+ * @property {number} [deliveredDate] - Delivered date
+ * @property {string} [shippingMethod] - Shipping method
+ * @property {string} [trackingNumber] - Tracking number
+ * @property {string} [shippingCarrier] - Shipping carrier
+ * @property {string} [externalOrderId] - External order ID
+ * @property {string} source - Order source
+ * @property {string} [cancelReason] - Cancellation reason
+ * @property {string} [notes] - Additional notes
+ * @property {string} [serviceConversationConfigId] - Service conversation config ID
+ */
+exports.ProductOrderSchema = base_schema_1.BaseModelSchema.safeExtend({
+    locationId: zod_1.default.string().nullable().optional().describe("Business location ID for multi-location businesses. Links order to specific warehouse/branch."),
+    channelId: zod_1.default.string().nullable().optional().describe("Channel ID for multi-channel orders (e.g., shopify, amazon, direct). Used for attribution and analytics."),
+    terminalId: zod_1.default.string().nullable().default(null).describe("Terminal/register ID that created the order. For POS integration and reconciliation."),
+    operatorId: zod_1.default.string().nullable().default(null).describe("Operator/staff user ID that created the order. For accountability and commission tracking."),
+    orderNumber: zod_1.default.string().nullable().default(null).describe("Human-readable order number displayed to customers and staff (e.g., 'ORD-12345', 'PO-2024-001'). Generated by Product Management for easy reference and communication."),
+    status: zod_1.default.enum(type_definitions_1.OrderStatus).default(type_definitions_1.OrderStatus.PENDING).describe("Current order status tracking progression from placement through fulfillment and delivery. Used by warehouse systems and customer notifications. Defaults to PENDING."),
+    items: zod_1.default.array(exports.ProductOrderItemSchema).min(1, "Order must have at least one item").describe("Products in this order with quantities, pricing, and variants. Minimum one item required for valid order."),
+    customerId: zod_1.default.string().describe("References Customer who placed this order. Links to customer profile for order history, preferences, and communication."),
+    pricing: order_schema_1.OrderPricingSchema.describe("Complete pricing breakdown including subtotal, tax, shipping fees, and discounts. From order.schema.ts for consistent pricing across order types."),
+    // Payment
+    paymentStatus: zod_1.default.enum(type_definitions_1.PaymentStatus).default(type_definitions_1.PaymentStatus.PENDING).describe("Payment processing status. Tracks whether order is paid, pending, failed, or refunded. Defaults to PENDING."),
+    paymentMethod: zod_1.default.string().optional().describe("Payment method used (e.g., 'credit_card', 'paypal', 'bank_transfer'). Captured for accounting and reconciliation."),
+    paymentReference: zod_1.default.string().optional().describe("External payment system reference or transaction ID. Used for payment verification and dispute resolution."),
+    billingAddress: order_schema_1.OrderAddress.optional().describe("Billing address for payment processing and invoicing. May differ from shipping address. Uses OrderAddress from order.schema.ts with delivery instructions support."),
+    // Retail-specific timing
+    orderDate: zod_1.default.number().describe("Unix timestamp when order was placed. Used for order history, analytics, and time-based reporting."),
+    requestedDeliveryDate: zod_1.default.number().optional().describe("Unix timestamp for customer's requested delivery date. Used for logistics planning and shipment scheduling."),
+    shippedDate: zod_1.default.number().optional().describe("Unix timestamp when order was shipped. Triggers customer shipment notifications via AI Powered Services."),
+    shippingAddress: order_schema_1.OrderAddress.optional().describe("Delivery address for shipment. Uses OrderAddress from order.schema.ts with delivery instructions field for courier guidance."),
+    deliveredDate: zod_1.default.number().optional().describe("Unix timestamp when order was delivered to customer. Used for order completion tracking and delivery performance metrics."),
+    // Shipping info
+    shippingMethod: zod_1.default.string().optional().describe("Shipping service level (e.g., 'Standard', 'Express', 'Overnight'). Determines delivery timeframe and shipping cost."),
+    trackingNumber: zod_1.default.string().optional().describe("Carrier tracking number for shipment monitoring. Enables customer self-service tracking and delivery status updates."),
+    shippingCarrier: zod_1.default.string().optional().describe("Shipping carrier name (e.g., 'UPS', 'FedEx', 'USPS'). Links tracking number to carrier's tracking system."),
+    // Integration
+    externalRef: type_definitions_1.ExternalRefSchema.nullable().optional().describe("External system reference when order is imported/synced from third-party platforms."),
+    source: zod_1.default.string().default('direct').describe("Order source channel (e.g., 'direct', 'web', 'marketplace', 'wholesale'). Used for attribution tracking and channel analytics. Defaults to 'direct'."),
+    cancelReason: zod_1.default.string().nullable().optional().describe("Reason provided when order is cancelled. Used for analytics, refund processing, and customer service follow-up."),
+    notes: zod_1.default.string().nullable().optional().describe("Internal operational notes about this order. Not visible to customers; used by warehouse and fulfillment staff for coordination."),
+    serviceConversationConfigId: zod_1.default.string().nullable().optional().describe("References the AI Powered Services conversation configuration that powered this order. Links order to deployment channel and conversation history."),
+});
+// ============================================================================
+// CREATE/UPDATE SCHEMAS
+// ============================================================================
+/**
+ * Schema for creating a new product order.
+ * Omits auto-generated fields and uses base items without IDs.
+ */
+exports.CreateProductOrderSchema = exports.ProductOrderSchema.omit({
+    id: true,
+    orderNumber: true,
+    createdAt: true,
+    updatedAt: true,
+    deliveredDate: true,
+    shippedDate: true,
+    items: true,
+    cancelReason: true,
+    serviceConversationConfigId: true,
+}).safeExtend({
+    items: zod_1.default.array(exports.ProductOrderItemBaseSchema).min(1, "Order must have at least one item"),
+    cancelReason: zod_1.default.string().nullable().default(null),
+});
+/**
+ * Schema for updating an existing product order.
+ * All fields are optional except id.
+ */
+exports.UpdateProductOrderSchema = exports.CreateProductOrderSchema.partial().safeExtend({
+    id: zod_1.default.string(),
+    cancelReason: zod_1.default.string().nullable().optional(),
+});
+// ============================================================================
+// STATUS UPDATE SCHEMA
+// ============================================================================
+/**
+ * Quick status update schema for product orders.
+ */
+exports.UpdateProductOrderStatusSchema = zod_1.default.object({
+    id: zod_1.default.string().describe("Unique identifier of the ProductOrder to update status for."),
+    status: zod_1.default.enum(type_definitions_1.OrderStatus).describe("New order status to transition to (e.g., from PENDING to PROCESSING to SHIPPED to DELIVERED). Validates against OrderStatus enum for workflow consistency."),
+    shippedDate: zod_1.default.number().optional().describe("Unix timestamp when order was shipped. Set when status transitions to SHIPPED; triggers customer notification."),
+    deliveredDate: zod_1.default.number().optional().describe("Unix timestamp when order was delivered. Set when status transitions to DELIVERED or COMPLETED; used for performance tracking."),
+    trackingNumber: zod_1.default.string().optional().describe("Carrier tracking number added when order ships. Enables customer shipment monitoring and delivery status updates."),
+});