wiil-core-js 0.0.82

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

@@ -0,0 +1,219 @@
+import z from "zod";
+import { InventoryUnit } from "../../type-definitions";
+/**
+ * @fileoverview Product variant schema definitions for SKU-level variants.
+ * @module business-mgt/product-variant
+ *
+ * Product variants represent individual SKU-level items with axis value selections
+ * (e.g., size, color). Variants can override parent product attributes for pricing,
+ * inventory, and physical properties.
+ */
+/**
+ * Product variant channel mapping schema.
+ * Maps variants to external platform identifiers for multi-channel synchronization.
+ *
+ * @typedef {Object} ProductVariantChannelMapping
+ * @property {string} channelId - Platform identifier (e.g., "shopify", "amazon")
+ * @property {string} externalVariantId - Variant ID in external platform
+ * @property {string} [externalProductId] - Parent product ID in external platform
+ */
+export declare const ProductVariantChannelMappingSchema: z.ZodObject<{
+    channelId: z.ZodString;
+    externalVariantId: z.ZodString;
+    externalProductId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+}, z.core.$strip>;
+/**
+ * Product variant schema.
+ * Represents an individual SKU-level variant with axis value selections.
+ * Variants can override parent product attributes for pricing, inventory, and physical properties.
+ *
+ * @typedef {Object} ProductVariant
+ * @property {string} [productRevisionId] - Version control for product changes
+ * @property {string} productId - Parent product ID
+ * @property {Object} axisValues - Map of axisId to selected valueId
+ * @property {string} [sku] - Stock Keeping Unit identifier (overrides parent)
+ * @property {string} [barcode] - Product barcode (overrides parent)
+ * @property {string} [partNumber] - Manufacturer part number
+ * @property {string} [globalTradeItemNumber] - GTIN identifier
+ * @property {number} [price] - Variant price (overrides parent)
+ * @property {number} [cost] - Variant cost
+ * @property {number} [compareAtPrice] - Compare-at price for sale displays
+ * @property {number} [stockQuantity] - Variant stock quantity
+ * @property {number} [lowStockThreshold] - Low stock alert threshold
+ * @property {string} [unitDefinitionId] - Inventory unit definition reference
+ * @property {string} [inventoryUnit] - Inventory unit type
+ * @property {number} [weight] - Variant weight (overrides parent)
+ * @property {Object} [dimensions] - Variant dimensions (overrides parent)
+ * @property {string} [imageId] - Primary variant image ID
+ * @property {Array} [imageIds] - Variant gallery image IDs
+ * @property {Array} [channelMappings] - Per-channel external variant ID mappings
+ * @property {boolean} isActive - Whether variant is available for sale
+ * @property {boolean} isDefault - Whether this is the default variant
+ * @property {number} [orderCount] - Total orders for this variant (all time)
+ * @property {number} [recentOrderCount] - Orders in last 30 days
+ * @property {number} [lastOrderedAt] - Unix timestamp of last order
+ */
+export declare const ProductVariantSchema: z.ZodObject<{
+    id: z.ZodString;
+    createdAt: z.ZodOptional<z.ZodNumber>;
+    updatedAt: z.ZodOptional<z.ZodNumber>;
+    productRevisionId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    productId: z.ZodString;
+    axisValues: z.ZodRecord<z.ZodString, z.ZodString>;
+    sku: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    barcode: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    partNumber: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    globalTradeItemNumber: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    price: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    cost: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    compareAtPrice: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    stockQuantity: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    lowStockThreshold: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    unitDefinitionId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    inventoryUnit: z.ZodOptional<z.ZodNullable<z.ZodEnum<typeof InventoryUnit>>>;
+    weight: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    dimensions: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+        length: z.ZodNumber;
+        width: z.ZodNumber;
+        height: z.ZodNumber;
+        unit: z.ZodDefault<z.ZodEnum<{
+            cm: "cm";
+            inches: "inches";
+        }>>;
+    }, z.core.$strip>>>;
+    imageId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    imageIds: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodString>>>;
+    channelMappings: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodObject<{
+        channelId: z.ZodString;
+        externalVariantId: z.ZodString;
+        externalProductId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    }, z.core.$strip>>>>;
+    isActive: z.ZodDefault<z.ZodBoolean>;
+    isDefault: z.ZodDefault<z.ZodBoolean>;
+    orderCount: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    recentOrderCount: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    lastOrderedAt: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+}, z.core.$strip>;
+/**
+ * Schema for creating a new product variant.
+ * Omits auto-generated fields and analytics (view model only).
+ */
+export declare const CreateProductVariantSchema: z.ZodObject<{
+    isDefault: z.ZodDefault<z.ZodBoolean>;
+    isActive: z.ZodDefault<z.ZodBoolean>;
+    price: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    channelMappings: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodObject<{
+        channelId: z.ZodString;
+        externalVariantId: z.ZodString;
+        externalProductId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    }, z.core.$strip>>>>;
+    productRevisionId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    productId: z.ZodString;
+    axisValues: z.ZodRecord<z.ZodString, z.ZodString>;
+    sku: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    barcode: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    partNumber: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    globalTradeItemNumber: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    cost: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    compareAtPrice: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    stockQuantity: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    lowStockThreshold: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    unitDefinitionId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    inventoryUnit: z.ZodOptional<z.ZodNullable<z.ZodEnum<typeof InventoryUnit>>>;
+    weight: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    dimensions: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+        length: z.ZodNumber;
+        width: z.ZodNumber;
+        height: z.ZodNumber;
+        unit: z.ZodDefault<z.ZodEnum<{
+            cm: "cm";
+            inches: "inches";
+        }>>;
+    }, z.core.$strip>>>;
+    imageId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    imageIds: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodString>>>;
+}, z.core.$strip>;
+/**
+ * Schema for updating an existing product variant.
+ * All fields optional except id (required).
+ */
+export declare const UpdateProductVariantSchema: z.ZodObject<{
+    isDefault: z.ZodOptional<z.ZodDefault<z.ZodBoolean>>;
+    isActive: z.ZodOptional<z.ZodDefault<z.ZodBoolean>>;
+    price: z.ZodOptional<z.ZodOptional<z.ZodNullable<z.ZodNumber>>>;
+    channelMappings: z.ZodOptional<z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodObject<{
+        channelId: z.ZodString;
+        externalVariantId: z.ZodString;
+        externalProductId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    }, z.core.$strip>>>>>;
+    productRevisionId: z.ZodOptional<z.ZodOptional<z.ZodNullable<z.ZodString>>>;
+    productId: z.ZodOptional<z.ZodString>;
+    axisValues: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+    sku: z.ZodOptional<z.ZodOptional<z.ZodNullable<z.ZodString>>>;
+    barcode: z.ZodOptional<z.ZodOptional<z.ZodNullable<z.ZodString>>>;
+    partNumber: z.ZodOptional<z.ZodOptional<z.ZodNullable<z.ZodString>>>;
+    globalTradeItemNumber: z.ZodOptional<z.ZodOptional<z.ZodNullable<z.ZodString>>>;
+    cost: z.ZodOptional<z.ZodOptional<z.ZodNullable<z.ZodNumber>>>;
+    compareAtPrice: z.ZodOptional<z.ZodOptional<z.ZodNullable<z.ZodNumber>>>;
+    stockQuantity: z.ZodOptional<z.ZodOptional<z.ZodNullable<z.ZodNumber>>>;
+    lowStockThreshold: z.ZodOptional<z.ZodOptional<z.ZodNullable<z.ZodNumber>>>;
+    unitDefinitionId: z.ZodOptional<z.ZodOptional<z.ZodNullable<z.ZodString>>>;
+    inventoryUnit: z.ZodOptional<z.ZodOptional<z.ZodNullable<z.ZodEnum<typeof InventoryUnit>>>>;
+    weight: z.ZodOptional<z.ZodOptional<z.ZodNullable<z.ZodNumber>>>;
+    dimensions: z.ZodOptional<z.ZodOptional<z.ZodNullable<z.ZodObject<{
+        length: z.ZodNumber;
+        width: z.ZodNumber;
+        height: z.ZodNumber;
+        unit: z.ZodDefault<z.ZodEnum<{
+            cm: "cm";
+            inches: "inches";
+        }>>;
+    }, z.core.$strip>>>>;
+    imageId: z.ZodOptional<z.ZodOptional<z.ZodNullable<z.ZodString>>>;
+    imageIds: z.ZodOptional<z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodString>>>>;
+    id: z.ZodString;
+}, z.core.$strip>;
+export type ProductVariantChannelMapping = z.infer<typeof ProductVariantChannelMappingSchema>;
+export type ProductVariant = z.infer<typeof ProductVariantSchema>;
+export type CreateProductVariant = z.infer<typeof CreateProductVariantSchema>;
+export type UpdateProductVariant = z.infer<typeof UpdateProductVariantSchema>;
+/**
+ * Product variant filter options.
+ * @interface ProductVariantFilters
+ */
+export interface ProductVariantFilters {
+    /** Filter by parent product ID */
+    productId?: string;
+    /** Filter by axis value ID */
+    axisValueId?: string;
+    /** Filter by SKU */
+    sku?: string;
+    /** Filter by active status */
+    isActive?: boolean;
+    /** Filter by stock availability */
+    inStock?: boolean;
+}
+/**
+ * Product variant sorting options.
+ * @interface ProductVariantSorting
+ */
+export interface ProductVariantSorting {
+    /** Field to sort by */
+    field: 'sku' | 'price' | 'stockQuantity' | 'createdAt';
+    /** Sort direction */
+    direction: 'asc' | 'desc';
+}
+/**
+ * Product variant query options.
+ * @interface ProductVariantQueryOptions
+ */
+export interface ProductVariantQueryOptions {
+    /** Page number (1-indexed) */
+    page: number;
+    /** Items per page */
+    pageSize: number;
+    /** Optional filters */
+    filters?: ProductVariantFilters;
+    /** Optional sorting */
+    sorting?: ProductVariantSorting;
+}

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

@@ -0,0 +1,130 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.UpdateProductVariantSchema = exports.CreateProductVariantSchema = exports.ProductVariantSchema = exports.ProductVariantChannelMappingSchema = void 0;
+const zod_1 = __importDefault(require("zod"));
+const base_schema_1 = require("../../base.schema");
+const type_definitions_1 = require("../../type-definitions");
+/**
+ * @fileoverview Product variant schema definitions for SKU-level variants.
+ * @module business-mgt/product-variant
+ *
+ * Product variants represent individual SKU-level items with axis value selections
+ * (e.g., size, color). Variants can override parent product attributes for pricing,
+ * inventory, and physical properties.
+ */
+// ============================================================================
+// VARIANT CHANNEL MAPPING SCHEMA
+// ============================================================================
+/**
+ * Product variant channel mapping schema.
+ * Maps variants to external platform identifiers for multi-channel synchronization.
+ *
+ * @typedef {Object} ProductVariantChannelMapping
+ * @property {string} channelId - Platform identifier (e.g., "shopify", "amazon")
+ * @property {string} externalVariantId - Variant ID in external platform
+ * @property {string} [externalProductId] - Parent product ID in external platform
+ */
+exports.ProductVariantChannelMappingSchema = zod_1.default.object({
+    channelId: zod_1.default.string().describe("Channel ID (e.g., doordash, uber-eats)"),
+    externalVariantId: zod_1.default.string().describe("External variant ID for this specific channel"),
+    externalProductId: zod_1.default.string().nullable().optional().describe("Optional external parent product ID in this channel"),
+}).describe("Per-channel external variant ID mapping");
+// ============================================================================
+// PRODUCT VARIANT SCHEMA
+// Individual SKU-level variants with axis value selections
+// ============================================================================
+/**
+ * Product variant schema.
+ * Represents an individual SKU-level variant with axis value selections.
+ * Variants can override parent product attributes for pricing, inventory, and physical properties.
+ *
+ * @typedef {Object} ProductVariant
+ * @property {string} [productRevisionId] - Version control for product changes
+ * @property {string} productId - Parent product ID
+ * @property {Object} axisValues - Map of axisId to selected valueId
+ * @property {string} [sku] - Stock Keeping Unit identifier (overrides parent)
+ * @property {string} [barcode] - Product barcode (overrides parent)
+ * @property {string} [partNumber] - Manufacturer part number
+ * @property {string} [globalTradeItemNumber] - GTIN identifier
+ * @property {number} [price] - Variant price (overrides parent)
+ * @property {number} [cost] - Variant cost
+ * @property {number} [compareAtPrice] - Compare-at price for sale displays
+ * @property {number} [stockQuantity] - Variant stock quantity
+ * @property {number} [lowStockThreshold] - Low stock alert threshold
+ * @property {string} [unitDefinitionId] - Inventory unit definition reference
+ * @property {string} [inventoryUnit] - Inventory unit type
+ * @property {number} [weight] - Variant weight (overrides parent)
+ * @property {Object} [dimensions] - Variant dimensions (overrides parent)
+ * @property {string} [imageId] - Primary variant image ID
+ * @property {Array} [imageIds] - Variant gallery image IDs
+ * @property {Array} [channelMappings] - Per-channel external variant ID mappings
+ * @property {boolean} isActive - Whether variant is available for sale
+ * @property {boolean} isDefault - Whether this is the default variant
+ * @property {number} [orderCount] - Total orders for this variant (all time)
+ * @property {number} [recentOrderCount] - Orders in last 30 days
+ * @property {number} [lastOrderedAt] - Unix timestamp of last order
+ */
+exports.ProductVariantSchema = base_schema_1.BaseModelSchema.safeExtend({
+    productRevisionId: zod_1.default.string().nullable().optional().describe("Optional product revision ID for version-scoped data"),
+    productId: zod_1.default.string().describe("Parent product ID"),
+    // Axis value selections (e.g., { "axis_size": "value_large", "axis_color": "value_red" })
+    axisValues: zod_1.default.record(zod_1.default.string(), zod_1.default.string()).describe("Map of axisId to selected valueId"),
+    // Override-capable fields (null = inherit from parent product)
+    sku: zod_1.default.string().nullable().optional().describe("Stock Keeping Unit identifier"),
+    barcode: zod_1.default.string().nullable().optional().describe("Product barcode (EAN-13, UPC-A, etc.)"),
+    partNumber: zod_1.default.string().nullable().optional().describe("Manufacturer part number"),
+    globalTradeItemNumber: zod_1.default.string().nullable().optional().describe("Global Trade Item Number (GTIN)"),
+    price: zod_1.default.number().nonnegative().nullable().optional().describe("Variant price"),
+    cost: zod_1.default.number().nonnegative().nullable().optional().describe("Variant cost"),
+    compareAtPrice: zod_1.default.number().nonnegative().nullable().optional().describe("Variant compare-at price"),
+    // Inventory (variant-level tracking)
+    stockQuantity: zod_1.default.number().int().nonnegative().nullable().optional().describe("Variant stock quantity"),
+    lowStockThreshold: zod_1.default.number().int().nonnegative().nullable().optional().describe("Variant low stock threshold"),
+    unitDefinitionId: zod_1.default.string().nullable().optional().describe("Optional inventory unit definition snapshot pointer for this variant"),
+    inventoryUnit: zod_1.default.enum(type_definitions_1.InventoryUnit).nullable().optional().describe("Inventory unit for this variant"),
+    // Physical attributes (overrides)
+    weight: zod_1.default.number().positive().nullable().optional().describe("Variant weight (overrides parent)"),
+    dimensions: zod_1.default.object({
+        length: zod_1.default.number().positive().describe("Length dimension"),
+        width: zod_1.default.number().positive().describe("Width dimension"),
+        height: zod_1.default.number().positive().describe("Height dimension"),
+        unit: zod_1.default.enum(['inches', 'cm']).default('inches').describe("Measurement unit"),
+    }).nullable().optional().describe("Variant dimensions (overrides parent)"),
+    // Media
+    imageId: zod_1.default.string().nullable().optional().describe("Primary variant image ID"),
+    imageIds: zod_1.default.array(zod_1.default.string()).nullable().optional().describe("Variant gallery image IDs"),
+    channelMappings: zod_1.default.array(exports.ProductVariantChannelMappingSchema).nullable().optional().describe("Per-channel external variant ID mappings"),
+    // Status
+    isActive: zod_1.default.boolean().default(true).describe("Whether this variant is available for sale"),
+    isDefault: zod_1.default.boolean().default(false).describe("Whether this is the default variant for the product"),
+    // Ordering analytics
+    orderCount: zod_1.default.number().int().nonnegative().nullable().optional().describe("Total orders for this variant (all time)"),
+    recentOrderCount: zod_1.default.number().int().nonnegative().nullable().optional().describe("Orders for this variant in the last 30 days"),
+    lastOrderedAt: zod_1.default.number().int().positive().nullable().optional().describe("Unix timestamp of the last order for this variant"),
+});
+// ============================================================================
+// CREATE/UPDATE SCHEMAS
+// ============================================================================
+/**
+ * Schema for creating a new product variant.
+ * Omits auto-generated fields and analytics (view model only).
+ */
+exports.CreateProductVariantSchema = exports.ProductVariantSchema.omit({
+    id: true,
+    createdAt: true,
+    updatedAt: true,
+    // Omit analytics fields (view model only)
+    orderCount: true,
+    recentOrderCount: true,
+    lastOrderedAt: true,
+});
+/**
+ * Schema for updating an existing product variant.
+ * All fields optional except id (required).
+ */
+exports.UpdateProductVariantSchema = exports.CreateProductVariantSchema.partial().safeExtend({
+    id: zod_1.default.string().describe("Unique identifier of the ProductVariant to update"),
+});

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

@@ -0,0 +1,326 @@
+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;
+    itemName: z.ZodString;
+    sku: z.ZodOptional<z.ZodString>;
+    quantity: z.ZodNumber;
+    unitPrice: z.ZodNumber;
+    totalPrice: z.ZodNumber;
+    selectedVariant: z.ZodOptional<z.ZodString>;
+    warrantyInfo: z.ZodOptional<z.ZodString>;
+    status: z.ZodDefault<z.ZodEnum<typeof OrderStatus>>;
+    notes: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+/**
+ * Product order item schema with IDs (for existing items).
+ */
+export declare const ProductOrderItemSchema: z.ZodObject<{
+    productId: z.ZodString;
+    itemName: z.ZodString;
+    sku: z.ZodOptional<z.ZodString>;
+    quantity: z.ZodNumber;
+    unitPrice: z.ZodNumber;
+    totalPrice: z.ZodNumber;
+    selectedVariant: z.ZodOptional<z.ZodString>;
+    warrantyInfo: z.ZodOptional<z.ZodString>;
+    status: z.ZodDefault<z.ZodEnum<typeof OrderStatus>>;
+    notes: z.ZodOptional<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>;
+    orderNumber: z.ZodOptional<z.ZodString>;
+    status: z.ZodDefault<z.ZodEnum<typeof OrderStatus>>;
+    items: z.ZodArray<z.ZodObject<{
+        productId: z.ZodString;
+        itemName: z.ZodString;
+        sku: z.ZodOptional<z.ZodString>;
+        quantity: z.ZodNumber;
+        unitPrice: z.ZodNumber;
+        totalPrice: z.ZodNumber;
+        selectedVariant: z.ZodOptional<z.ZodString>;
+        warrantyInfo: z.ZodOptional<z.ZodString>;
+        status: z.ZodDefault<z.ZodEnum<typeof OrderStatus>>;
+        notes: z.ZodOptional<z.ZodString>;
+        id: z.ZodString;
+        productOrderId: z.ZodString;
+    }, z.core.$strip>>;
+    customerId: z.ZodString;
+    customer: z.ZodOptional<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.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>;
+    externalOrderId: z.ZodOptional<z.ZodString>;
+    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<{
+    status: z.ZodDefault<z.ZodEnum<typeof OrderStatus>>;
+    customerId: z.ZodString;
+    notes: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    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.ZodOptional<z.ZodString>;
+    paymentReference: z.ZodOptional<z.ZodString>;
+    orderDate: z.ZodNumber;
+    externalOrderId: z.ZodOptional<z.ZodString>;
+    source: z.ZodDefault<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>>>;
+    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;
+        itemName: z.ZodString;
+        sku: z.ZodOptional<z.ZodString>;
+        quantity: z.ZodNumber;
+        unitPrice: z.ZodNumber;
+        totalPrice: z.ZodNumber;
+        selectedVariant: z.ZodOptional<z.ZodString>;
+        warrantyInfo: z.ZodOptional<z.ZodString>;
+        status: z.ZodDefault<z.ZodEnum<typeof OrderStatus>>;
+        notes: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+/**
+ * Schema for updating an existing product order.
+ * All fields are optional except id.
+ */
+export declare const UpdateProductOrderSchema: z.ZodObject<{
+    status: z.ZodOptional<z.ZodDefault<z.ZodEnum<typeof OrderStatus>>>;
+    customerId: z.ZodOptional<z.ZodString>;
+    notes: z.ZodOptional<z.ZodOptional<z.ZodNullable<z.ZodString>>>;
+    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.ZodOptional<z.ZodString>>;
+    paymentReference: z.ZodOptional<z.ZodOptional<z.ZodString>>;
+    orderDate: z.ZodOptional<z.ZodNumber>;
+    externalOrderId: z.ZodOptional<z.ZodOptional<z.ZodString>>;
+    source: z.ZodOptional<z.ZodDefault<z.ZodString>>;
+    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;
+        itemName: z.ZodString;
+        sku: z.ZodOptional<z.ZodString>;
+        quantity: z.ZodNumber;
+        unitPrice: z.ZodNumber;
+        totalPrice: z.ZodNumber;
+        selectedVariant: z.ZodOptional<z.ZodString>;
+        warrantyInfo: z.ZodOptional<z.ZodString>;
+        status: z.ZodDefault<z.ZodEnum<typeof OrderStatus>>;
+        notes: z.ZodOptional<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>;
+/**
+ * Schema for inventory updates triggered by order fulfillment.
+ */
+export declare const OrderInventoryUpdateSchema: z.ZodObject<{
+    orderId: z.ZodString;
+    inventoryAdjustments: z.ZodArray<z.ZodObject<{
+        productId: z.ZodString;
+        quantityUsed: z.ZodNumber;
+        reason: z.ZodLiteral<"order_fulfillment">;
+    }, z.core.$strip>>;
+}, 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>;
+export type OrderInventoryUpdate = z.infer<typeof OrderInventoryUpdateSchema>;
+export interface ProductOrderFilters {
+    search?: string;
+    status?: OrderStatus[];
+    paymentStatus?: PaymentStatus[];
+    customerId?: string;
+    shippingMethod?: string;
+    source?: string;
+    dateRange?: {
+        start?: number;
+        end?: number;
+    };
+}
+export interface ProductOrderSorting {
+    field: 'orderDate' | 'createdAt' | 'totalAmount';
+    direction: 'asc' | 'desc';
+}
+export interface ProductOrderQueryOptions {
+    page: number;
+    pageSize: number;
+    filters?: ProductOrderFilters;
+    sorting?: ProductOrderSorting;
+}