wiil-core-js 0.0.82

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

@@ -0,0 +1,273 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ProductSetDisplaySchema = exports.ProductSetItemDisplaySchema = exports.UpdateProductSetSchema = exports.CreateProductSetSchema = exports.ProductSetSchema = exports.ProductSetSelectorSchema = exports.ProductSetItemSchema = exports.ProductSetChannelMappingSchema = exports.ProductSetTargetingMode = exports.ProductSetPricingMode = void 0;
+const zod_1 = __importDefault(require("zod"));
+const base_schema_1 = require("../../base.schema");
+const product_config_schema_1 = require("./product-config.schema");
+/**
+ * @fileoverview Product set schema definitions for bundled products.
+ * @module business-mgt/product-set
+ *
+ * Product sets enable bundling products into packages with flexible pricing
+ * and targeting strategies. Sets can use fixed pricing or sum of component prices.
+ */
+// ============================================================================
+// ENUMS
+// ============================================================================
+/**
+ * Product set pricing mode.
+ * Determines how the set price is calculated.
+ *
+ * @enum {string}
+ * @property {string} FIXED - Set has a fixed price regardless of component prices
+ * @property {string} SUM_OF_ITEMS - Set price is sum of included product prices
+ */
+var ProductSetPricingMode;
+(function (ProductSetPricingMode) {
+    /** Set has a fixed price regardless of component prices */
+    ProductSetPricingMode["FIXED"] = "FIXED";
+    /** Set price is sum of included product prices */
+    ProductSetPricingMode["SUM_OF_ITEMS"] = "SUM_OF_ITEMS";
+})(ProductSetPricingMode || (exports.ProductSetPricingMode = ProductSetPricingMode = {}));
+/**
+ * Product set targeting mode.
+ * Determines how products are selected for the set.
+ *
+ * @enum {string}
+ * @property {string} EXPLICIT - Set includes explicitly listed products
+ * @property {string} SELECTOR - Set includes products matching selector criteria
+ */
+var ProductSetTargetingMode;
+(function (ProductSetTargetingMode) {
+    /** Set includes explicitly listed products */
+    ProductSetTargetingMode["EXPLICIT"] = "EXPLICIT";
+    /** Set includes products matching selector criteria */
+    ProductSetTargetingMode["SELECTOR"] = "SELECTOR";
+})(ProductSetTargetingMode || (exports.ProductSetTargetingMode = ProductSetTargetingMode = {}));
+// ============================================================================
+// CHANNEL MAPPING SCHEMA
+// ============================================================================
+/**
+ * Product set channel mapping schema.
+ * Maps product sets to external platform identifiers.
+ *
+ * @typedef {Object} ProductSetChannelMapping
+ * @property {string} channelId - Platform identifier (e.g., "shopify", "amazon")
+ * @property {string} externalProductSetId - Set ID in external platform
+ */
+exports.ProductSetChannelMappingSchema = zod_1.default.object({
+    channelId: zod_1.default.string().describe("Platform identifier (e.g., 'shopify', 'amazon'). Used for external system synchronization."),
+    externalProductSetId: zod_1.default.string().describe("Product set ID in the external platform. Enables cross-platform order reconciliation."),
+}).describe("Per-channel external product set ID mapping for platform synchronization");
+// ============================================================================
+// PRODUCT SET ITEM SCHEMA
+// ============================================================================
+/**
+ * Product set item schema.
+ * Represents a product included in a set with quantity and requirement specifications.
+ *
+ * @typedef {Object} ProductSetItem
+ * @property {string} productId - Product ID included in set
+ * @property {string} [productVariantId] - Specific variant ID if applicable
+ * @property {number} quantity - Quantity of this product in set
+ * @property {boolean} isRequired - Whether item is required in set
+ * @property {number} [displayOrder] - Display order inside set
+ */
+exports.ProductSetItemSchema = zod_1.default.object({
+    productId: zod_1.default.string().describe("References BusinessProduct included in this set. Links to product catalog for pricing and availability."),
+    productVariantId: zod_1.default.string().nullable().optional().describe("Specific ProductVariant ID when set requires particular variant. Null allows any variant."),
+    quantity: zod_1.default.number().int().positive().describe("Quantity of this product required in the set. Must be positive integer."),
+    isRequired: zod_1.default.boolean().default(true).describe("Whether this item is required for set validity. Optional items can be excluded by customer."),
+    displayOrder: zod_1.default.number().int().optional().describe("Display order within the set. Lower numbers appear first."),
+}).describe("Product included in a product set with quantity and requirement specifications");
+// ============================================================================
+// PRODUCT SET SELECTOR SCHEMA
+// ============================================================================
+/**
+ * Product set selector schema.
+ * Defines criteria for dynamically selecting products to include in a set.
+ *
+ * @typedef {Object} ProductSetSelector
+ * @property {Array} productIdsAny - Products where any match satisfies
+ * @property {Array} productIdsAll - Products where all must match
+ * @property {boolean} allProducts - Include all catalog products
+ * @property {number} [quantityExact] - Exact quantity required
+ * @property {number} [quantityMin] - Minimum quantity required
+ * @property {number} [quantityMax] - Maximum quantity allowed
+ */
+exports.ProductSetSelectorSchema = zod_1.default.object({
+    productIdsAny: zod_1.default.array(zod_1.default.string()).max(5000).default([]).describe("Any matching catalog product IDs"),
+    productIdsAll: zod_1.default.array(zod_1.default.string()).max(5000).default([]).describe("All required catalog product IDs"),
+    allProducts: zod_1.default.boolean().default(false).describe("Includes all catalog products"),
+    quantityExact: zod_1.default.number().int().positive().optional().describe("Requires exact matched quantity"),
+    quantityMin: zod_1.default.number().int().nonnegative().optional().describe("Requires minimum matched quantity"),
+    quantityMax: zod_1.default.number().int().positive().optional().describe("Caps maximum matched quantity"),
+}).superRefine((data, ctx) => {
+    const selectorModes = [
+        data.productIdsAny.length > 0,
+        data.productIdsAll.length > 0,
+        data.allProducts,
+    ].filter(Boolean).length;
+    if (selectorModes !== 1) {
+        ctx.addIssue({
+            code: "custom",
+            path: ["productIdsAny"],
+            message: "Exactly one of productIdsAny, productIdsAll, or allProducts must be set",
+        });
+    }
+    if (data.quantityExact !== undefined && (data.quantityMin !== undefined || data.quantityMax !== undefined)) {
+        ctx.addIssue({
+            code: "custom",
+            path: ["quantityExact"],
+            message: "quantityExact cannot be combined with quantityMin or quantityMax",
+        });
+    }
+    if (data.quantityMin !== undefined &&
+        data.quantityMax !== undefined &&
+        data.quantityMax < data.quantityMin) {
+        ctx.addIssue({
+            code: "custom",
+            path: ["quantityMax"],
+            message: "quantityMax must be greater than or equal to quantityMin",
+        });
+    }
+});
+// ============================================================================
+// PRODUCT SET SCHEMA
+// ============================================================================
+/**
+ * Product set schema.
+ * Represents a bundle or set of products with configurable pricing and targeting.
+ *
+ * @typedef {Object} ProductSet
+ * @property {string} [productRevisionId] - Version control for product changes
+ * @property {string} [code] - Stable internal code for integration matching
+ * @property {string} name - Product set name
+ * @property {string} [description] - Product set description
+ * @property {Array} [channelMappings] - Per-channel external set ID mappings
+ * @property {ProductSetTargetingMode} targetingMode - How set selects members
+ * @property {ProductSetPricingMode} pricingMode - How pricing is calculated
+ * @property {number} [fixedPrice] - Set price when pricingMode is FIXED
+ * @property {Array} [items] - Explicit product members
+ * @property {Object} [selector] - Selector definition for dynamic targeting
+ * @property {boolean} isActive - Whether product set is active
+ * @property {string} [imageUrl] - Public image URL for the set
+ * @property {Array} [imageUrls] - Multiple image URLs
+ * @property {number} [displayOrder] - Display order in catalog
+ */
+exports.ProductSetSchema = base_schema_1.BaseModelSchema.safeExtend({
+    productRevisionId: zod_1.default.string().nullable().optional().describe("Optional product revision ID for version-scoped catalog targeting. Ensures set applies to specific catalog version."),
+    code: zod_1.default.string().min(1).nullable().optional().describe("Stable internal code for idempotent integration matching"),
+    name: zod_1.default.string().min(1, "Product set name is required").describe("Product set name"),
+    description: zod_1.default.string().nullable().optional().describe("Product set description"),
+    channelMappings: zod_1.default.array(exports.ProductSetChannelMappingSchema).nullable().optional().describe("Per-channel product set ID mappings"),
+    targetingMode: zod_1.default.enum(ProductSetTargetingMode).default(ProductSetTargetingMode.EXPLICIT).describe("How this set selects its members"),
+    pricingMode: zod_1.default.enum(ProductSetPricingMode).default(ProductSetPricingMode.SUM_OF_ITEMS).describe("How set pricing is resolved"),
+    fixedPrice: zod_1.default.number().nonnegative().nullable().optional().describe("Set price when pricing mode is FIXED"),
+    items: zod_1.default.array(exports.ProductSetItemSchema).nullable().optional().describe("Explicit product members for EXPLICIT targeting"),
+    selector: exports.ProductSetSelectorSchema.nullable().optional().describe("Selector definition for SELECTOR targeting"),
+    isActive: zod_1.default.boolean().default(true).describe("Whether this product set is active"),
+    imageUrl: zod_1.default.string().nullable().optional().describe("Public image URL for the product set"),
+    imageUrls: zod_1.default.array(zod_1.default.string()).nullable().optional().describe("Public image URLs for the product set"),
+    displayOrder: zod_1.default.number().int().nullable().optional().describe("Display order in catalog"),
+}).superRefine((data, ctx) => {
+    if (data.pricingMode === ProductSetPricingMode.FIXED && (data.fixedPrice === undefined || data.fixedPrice === null)) {
+        ctx.addIssue({
+            code: "custom",
+            path: ["fixedPrice"],
+            message: "fixedPrice is required when pricingMode is FIXED",
+        });
+    }
+    if (data.pricingMode === ProductSetPricingMode.SUM_OF_ITEMS && data.fixedPrice != null) {
+        ctx.addIssue({
+            code: "custom",
+            path: ["fixedPrice"],
+            message: "fixedPrice must be null or omitted when pricingMode is SUM_OF_ITEMS",
+        });
+    }
+    if (data.targetingMode === ProductSetTargetingMode.EXPLICIT) {
+        if (!data.items || data.items.length === 0) {
+            ctx.addIssue({
+                code: "custom",
+                path: ["items"],
+                message: "items is required when targetingMode is EXPLICIT",
+            });
+        }
+        if (data.selector != null) {
+            ctx.addIssue({
+                code: "custom",
+                path: ["selector"],
+                message: "selector must be null or omitted when targetingMode is EXPLICIT",
+            });
+        }
+    }
+    if (data.targetingMode === ProductSetTargetingMode.SELECTOR) {
+        if (data.selector == null) {
+            ctx.addIssue({
+                code: "custom",
+                path: ["selector"],
+                message: "selector is required when targetingMode is SELECTOR",
+            });
+        }
+        if (data.items && data.items.length > 0) {
+            ctx.addIssue({
+                code: "custom",
+                path: ["items"],
+                message: "items must be empty when targetingMode is SELECTOR",
+            });
+        }
+    }
+    if (!data.items || data.items.length === 0) {
+        return;
+    }
+    const seenItemKeys = new Set();
+    for (const [index, item] of data.items.entries()) {
+        const itemKey = `${item.productId}::${item.productVariantId ?? "*"}`;
+        if (seenItemKeys.has(itemKey)) {
+            ctx.addIssue({
+                code: "custom",
+                path: ["items", index],
+                message: "Duplicate productId + productVariantId combination is not allowed in a product set",
+            });
+        }
+        seenItemKeys.add(itemKey);
+    }
+});
+exports.CreateProductSetSchema = exports.ProductSetSchema.omit({
+    id: true,
+    createdAt: true,
+    updatedAt: true,
+});
+exports.UpdateProductSetSchema = exports.CreateProductSetSchema.partial().safeExtend({
+    id: zod_1.default.string(),
+});
+// ============================================================================
+// DISPLAY SCHEMAS (read-optimized for catalog rendering)
+// ============================================================================
+/**
+ * Product set item display schema.
+ * Extended item schema with resolved product data for UI rendering.
+ *
+ * @typedef {Object} ProductSetItemDisplay
+ * @property {Object} [product] - Resolved BusinessProduct snapshot
+ */
+exports.ProductSetItemDisplaySchema = exports.ProductSetItemSchema.safeExtend({
+    product: product_config_schema_1.BusinessProductSchema.optional().describe("Resolved BusinessProduct snapshot for display. Populated server-side for UI rendering."),
+}).describe("Product set item with resolved product data for catalog display");
+/**
+ * Product set display schema.
+ * Extended set schema with resolved items and computed pricing for UI rendering.
+ *
+ * @typedef {Object} ProductSetDisplay
+ * @property {Array} items - ProductSetItemDisplay array with resolved data
+ * @property {number} [resolvedPrice] - Computed display price for the set
+ */
+exports.ProductSetDisplaySchema = exports.ProductSetSchema.omit({
+    items: true,
+}).safeExtend({
+    items: zod_1.default.array(exports.ProductSetItemDisplaySchema).nullable().optional().describe("Set items with resolved product snapshots for display"),
+    resolvedPrice: zod_1.default.number().nonnegative().nullable().optional().describe("Computed display price for the set. For SUM_OF_ITEMS: sum of item prices × quantities. For FIXED: the fixedPrice value."),
+}).describe("Product set with resolved items and computed pricing for catalog display");

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

@@ -0,0 +1,156 @@
+import z from "zod";
+import { VariantAxisType } from "../../type-definitions";
+/**
+ * @fileoverview Variant axis schema definitions for product variant configuration.
+ * @module business-mgt/product-variant-axis
+ *
+ * Variant axes define the dimensions along which products can vary (e.g., Size, Color).
+ * Each axis contains a set of values that can be selected when creating product variants.
+ */
+/**
+ * Variant axis value schema.
+ * Represents a single selectable value within a variant axis.
+ *
+ * @typedef {Object} VariantAxisValue
+ * @property {string} id - Unique axis value ID
+ * @property {string} label - Display label for the value
+ * @property {string} [swatchColor] - Hex color code for swatch type
+ * @property {string} [imageId] - Image ID for image type
+ * @property {number} [numericValue] - Numeric value for numeric type
+ * @property {number} sortOrder - Display order within axis
+ */
+export declare const VariantAxisValueSchema: z.ZodObject<{
+    id: z.ZodString;
+    label: z.ZodString;
+    swatchColor: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    imageId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    numericValue: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    sortOrder: z.ZodDefault<z.ZodNumber>;
+}, z.core.$strip>;
+/**
+ * Variant axis schema.
+ * Defines a dimension along which products can vary (e.g., Size, Color, Material).
+ *
+ * @typedef {Object} VariantAxis
+ * @property {string} name - Axis name (e.g., 'Size', 'Color')
+ * @property {VariantAxisType} type - Axis rendering type
+ * @property {Array} values - Available values for this axis
+ * @property {boolean} isActive - Whether axis is active
+ */
+export declare const VariantAxisSchema: z.ZodObject<{
+    id: z.ZodString;
+    createdAt: z.ZodOptional<z.ZodNumber>;
+    updatedAt: z.ZodOptional<z.ZodNumber>;
+    name: z.ZodString;
+    type: z.ZodEnum<typeof VariantAxisType>;
+    values: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        label: z.ZodString;
+        swatchColor: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        imageId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        numericValue: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+        sortOrder: z.ZodDefault<z.ZodNumber>;
+    }, z.core.$strip>>;
+    isActive: z.ZodDefault<z.ZodBoolean>;
+}, z.core.$strip>;
+/**
+ * Schema for creating a new variant axis.
+ * Omits auto-generated fields.
+ */
+export declare const CreateVariantAxisSchema: z.ZodObject<{
+    type: z.ZodEnum<typeof VariantAxisType>;
+    values: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        label: z.ZodString;
+        swatchColor: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        imageId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        numericValue: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+        sortOrder: z.ZodDefault<z.ZodNumber>;
+    }, z.core.$strip>>;
+    name: z.ZodString;
+    isActive: z.ZodDefault<z.ZodBoolean>;
+}, z.core.$strip>;
+/**
+ * Schema for updating an existing variant axis.
+ * All fields optional except id (required).
+ */
+export declare const UpdateVariantAxisSchema: z.ZodObject<{
+    type: z.ZodOptional<z.ZodEnum<typeof VariantAxisType>>;
+    values: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        label: z.ZodString;
+        swatchColor: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        imageId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        numericValue: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+        sortOrder: z.ZodDefault<z.ZodNumber>;
+    }, z.core.$strip>>>;
+    name: z.ZodOptional<z.ZodString>;
+    isActive: z.ZodOptional<z.ZodDefault<z.ZodBoolean>>;
+    id: z.ZodString;
+}, z.core.$strip>;
+/**
+ * Variant axis display schema.
+ * Optimized schema for UI rendering with display order.
+ *
+ * @typedef {Object} VariantAxisDisplay
+ * @property {string} id - Axis ID
+ * @property {string} name - Axis name
+ * @property {VariantAxisType} type - Axis rendering type
+ * @property {Array} values - Axis values
+ * @property {number} displayOrder - Display order for this axis
+ */
+export declare const VariantAxisDisplaySchema: z.ZodObject<{
+    id: z.ZodString;
+    name: z.ZodString;
+    type: z.ZodEnum<typeof VariantAxisType>;
+    values: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        label: z.ZodString;
+        swatchColor: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        imageId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        numericValue: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+        sortOrder: z.ZodDefault<z.ZodNumber>;
+    }, z.core.$strip>>;
+    displayOrder: z.ZodDefault<z.ZodNumber>;
+}, z.core.$strip>;
+export type VariantAxisValue = z.infer<typeof VariantAxisValueSchema>;
+export type VariantAxis = z.infer<typeof VariantAxisSchema>;
+export type CreateVariantAxis = z.infer<typeof CreateVariantAxisSchema>;
+export type UpdateVariantAxis = z.infer<typeof UpdateVariantAxisSchema>;
+export type VariantAxisDisplay = z.infer<typeof VariantAxisDisplaySchema>;
+/**
+ * Variant axis filter options.
+ * @interface VariantAxisFilters
+ */
+export interface VariantAxisFilters {
+    /** Text search across axis name */
+    search?: string;
+    /** Filter by axis type */
+    type?: VariantAxisType;
+    /** Filter by active status */
+    isActive?: boolean;
+}
+/**
+ * Variant axis sorting options.
+ * @interface VariantAxisSorting
+ */
+export interface VariantAxisSorting {
+    /** Field to sort by */
+    field: "name" | "createdAt";
+    /** Sort direction */
+    direction: "asc" | "desc";
+}
+/**
+ * Variant axis query options.
+ * @interface VariantAxisQueryOptions
+ */
+export interface VariantAxisQueryOptions {
+    /** Page number (1-indexed) */
+    page: number;
+    /** Items per page */
+    pageSize: number;
+    /** Optional filters */
+    filters?: VariantAxisFilters;
+    /** Optional sorting */
+    sorting?: VariantAxisSorting;
+}

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

@@ -0,0 +1,98 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.VariantAxisDisplaySchema = exports.UpdateVariantAxisSchema = exports.CreateVariantAxisSchema = exports.VariantAxisSchema = exports.VariantAxisValueSchema = void 0;
+const zod_1 = __importDefault(require("zod"));
+const base_schema_1 = require("../../base.schema");
+const type_definitions_1 = require("../../type-definitions");
+/**
+ * @fileoverview Variant axis schema definitions for product variant configuration.
+ * @module business-mgt/product-variant-axis
+ *
+ * Variant axes define the dimensions along which products can vary (e.g., Size, Color).
+ * Each axis contains a set of values that can be selected when creating product variants.
+ */
+// ============================================================================
+// VARIANT AXIS VALUE SCHEMA
+// ============================================================================
+/**
+ * Variant axis value schema.
+ * Represents a single selectable value within a variant axis.
+ *
+ * @typedef {Object} VariantAxisValue
+ * @property {string} id - Unique axis value ID
+ * @property {string} label - Display label for the value
+ * @property {string} [swatchColor] - Hex color code for swatch type
+ * @property {string} [imageId] - Image ID for image type
+ * @property {number} [numericValue] - Numeric value for numeric type
+ * @property {number} sortOrder - Display order within axis
+ */
+exports.VariantAxisValueSchema = zod_1.default.object({
+    id: zod_1.default.string().describe("Unique identifier for this axis value. Used in ProductVariant.axisValues mapping."),
+    label: zod_1.default.string().min(1).describe("Display label shown to customers (e.g., 'Small', 'Red', '32'). Must be unique within the axis."),
+    swatchColor: zod_1.default.string().nullable().optional().describe("Hex color code for swatch rendering (e.g., '#FF0000'). Only used when axis type is SWATCH."),
+    imageId: zod_1.default.string().nullable().optional().describe("Image ID for visual representation. Only used when axis type is IMAGE."),
+    numericValue: zod_1.default.number().nullable().optional().describe("Numeric value for size/quantity axes. Only used when axis type is NUMERIC."),
+    sortOrder: zod_1.default.number().int().default(0).describe("Display order within the axis. Lower numbers appear first."),
+}).describe("Single selectable value within a variant axis");
+// ============================================================================
+// VARIANT AXIS SCHEMA
+// ============================================================================
+/**
+ * Variant axis schema.
+ * Defines a dimension along which products can vary (e.g., Size, Color, Material).
+ *
+ * @typedef {Object} VariantAxis
+ * @property {string} name - Axis name (e.g., 'Size', 'Color')
+ * @property {VariantAxisType} type - Axis rendering type
+ * @property {Array} values - Available values for this axis
+ * @property {boolean} isActive - Whether axis is active
+ */
+exports.VariantAxisSchema = base_schema_1.BaseModelSchema.safeExtend({
+    name: zod_1.default.string().min(1).describe("Axis name displayed to customers (e.g., 'Size', 'Color', 'Material'). Used in variant selection UI."),
+    type: zod_1.default.enum(type_definitions_1.VariantAxisType).describe("Rendering type determining how values are displayed (SWATCH for colors, TEXT for labels, IMAGE for visuals, NUMERIC for sizes)."),
+    values: zod_1.default.array(exports.VariantAxisValueSchema).min(1).describe("Available values for this axis. Minimum one value required."),
+    isActive: zod_1.default.boolean().default(true).describe("Whether this axis is active and available for product binding. Defaults to true."),
+}).describe("Variant axis defining a product variation dimension");
+// ============================================================================
+// CREATE/UPDATE SCHEMAS
+// ============================================================================
+/**
+ * Schema for creating a new variant axis.
+ * Omits auto-generated fields.
+ */
+exports.CreateVariantAxisSchema = exports.VariantAxisSchema.omit({
+    id: true,
+    createdAt: true,
+    updatedAt: true,
+});
+/**
+ * Schema for updating an existing variant axis.
+ * All fields optional except id (required).
+ */
+exports.UpdateVariantAxisSchema = exports.CreateVariantAxisSchema.partial().safeExtend({
+    id: zod_1.default.string().describe("Unique identifier of the VariantAxis to update"),
+});
+// ============================================================================
+// DISPLAY SCHEMAS
+// ============================================================================
+/**
+ * Variant axis display schema.
+ * Optimized schema for UI rendering with display order.
+ *
+ * @typedef {Object} VariantAxisDisplay
+ * @property {string} id - Axis ID
+ * @property {string} name - Axis name
+ * @property {VariantAxisType} type - Axis rendering type
+ * @property {Array} values - Axis values
+ * @property {number} displayOrder - Display order for this axis
+ */
+exports.VariantAxisDisplaySchema = zod_1.default.object({
+    id: zod_1.default.string().describe("Unique identifier for the variant axis"),
+    name: zod_1.default.string().describe("Axis name for display"),
+    type: zod_1.default.enum(type_definitions_1.VariantAxisType).describe("Axis rendering type"),
+    values: zod_1.default.array(exports.VariantAxisValueSchema).describe("Available values for selection"),
+    displayOrder: zod_1.default.number().int().default(0).describe("Display order when showing multiple axes. Lower numbers appear first."),
+}).describe("Variant axis optimized for UI display");