@unchainedshop/api 4.8.0 → 4.8.1

package/lib/mcp/tools/product/schemas.js

@@ -1,7 +1,7 @@
-import { z } from 'zod';
+import { z } from 'zod/v4-mini';
 import { SortDirection } from '@unchainedshop/utils';
 import { ProductType, ProductVariationType } from '@unchainedshop/core-products';
-import { PaginationSchema, SortingSchema, SearchSchema, LocalizationTextSchema, } from "../../utils/sharedSchemas.js";
+import { PaginationSchema, SortingSchema, SearchSchema, LocalizationTextSchema, createManagementSchemaFromValidators, } from "../../utils/sharedSchemas.js";
 export const productTypeKeys = Object.keys(ProductType);
 export const productVariationTypeKeys = Object.keys(ProductVariationType);
 export const sortDirectionKeys = Object.keys(SortDirection);
@@ -14,395 +14,299 @@ export const ProductPlanConfigurationIntervalEnum = z.enum([
     'YEARS',
 ]);
 export const UpdateProductPlanInputSchema = z.object({
-    usageCalculationType: ProductPlanUsageCalculationTypeEnum.describe('The billing usage calculation method'),
-    billingInterval: ProductPlanConfigurationIntervalEnum.describe('The interval unit for billing cycles'),
-    billingIntervalCount: z.number().int().positive().describe('Number of billing intervals per cycle'),
-    trialInterval: ProductPlanConfigurationIntervalEnum.optional().describe('Optional trial period interval'),
-    trialIntervalCount: z.number().int().positive().optional().describe('Number of trial intervals'),
+    usageCalculationType: ProductPlanUsageCalculationTypeEnum.check(z.describe('The billing usage calculation method')),
+    billingInterval: ProductPlanConfigurationIntervalEnum.check(z.describe('The interval unit for billing cycles')),
+    billingIntervalCount: z.int().check(z.positive(), z.describe('Number of billing intervals per cycle')),
+    trialInterval: z
+        .optional(ProductPlanConfigurationIntervalEnum)
+        .check(z.describe('Optional trial period interval')),
+    trialIntervalCount: z
+        .optional(z.int().check(z.positive()))
+        .check(z.describe('Number of trial intervals')),
 });
-export const ProductTextInputSchema = LocalizationTextSchema.extend({
-    slug: z.string().optional().describe('URL slug'),
-    description: z.string().optional().describe('Markdown description'),
-    vendor: z.string().optional().describe('Vendor name'),
-    brand: z.string().optional().describe('Brand name'),
-    labels: z.array(z.string()).optional().describe('Labels or tags'),
-}).describe('Product localized text data');
-export const ProductVariationTextInputSchema = LocalizationTextSchema.describe('Product variation localized text data');
-export const ProductMediaTextInputSchema = LocalizationTextSchema.describe('Product media localized text data');
+export const ProductTextInputSchema = z
+    .extend(LocalizationTextSchema, {
+    slug: z.optional(z.string()).check(z.describe('URL slug')),
+    description: z.optional(z.string()).check(z.describe('Markdown description')),
+    vendor: z.optional(z.string()).check(z.describe('Vendor name')),
+    brand: z.optional(z.string()).check(z.describe('Brand name')),
+    labels: z.optional(z.array(z.string())).check(z.describe('Labels or tags')),
+})
+    .check(z.describe('Product localized text data'));
+export const ProductVariationTextInputSchema = LocalizationTextSchema.check(z.describe('Product variation localized text data'));
+export const ProductMediaTextInputSchema = LocalizationTextSchema.check(z.describe('Product media localized text data'));
 export const ProductAssignmentVectorSchema = z.object({
-    key: z.string().min(1).describe('Attribute key (e.g., "Color", "Size")'),
-    value: z.string().min(1).describe('Attribute value (e.g., "Red", "M")'),
+    key: z.string().check(z.minLength(1), z.describe('Attribute key (e.g., "Color", "Size")')),
+    value: z.string().check(z.minLength(1), z.describe('Attribute value (e.g., "Red", "M")')),
 });
 export const ProductSchema = z.object({
-    type: z.enum(productTypeKeys).optional().describe('Product type (required for CREATE)'),
-    tags: z.array(z.string().min(1).toLowerCase()).optional().describe('Tags (lowercased strings)'),
-    sequence: z.number().int().optional().describe('Sorting sequence'),
-    meta: z.record(z.any(), z.any()).optional().describe('Custom metadata as key-value pairs'),
-    plan: UpdateProductPlanInputSchema.optional().describe('Plan configuration - ONLY for PLAN_PRODUCT'),
+    type: z.optional(z.enum(productTypeKeys)).check(z.describe('Product type (required for CREATE)')),
+    tags: z
+        .optional(z.array(z.string().check(z.minLength(1), z.toLowerCase())))
+        .check(z.describe('Tags (lowercased strings)')),
+    sequence: z.optional(z.int()).check(z.describe('Sorting sequence')),
+    meta: z.optional(z.record(z.any(), z.any())).check(z.describe('Custom metadata as key-value pairs')),
+    plan: z
+        .optional(UpdateProductPlanInputSchema)
+        .check(z.describe('Plan configuration - ONLY for PLAN_PRODUCT')),
     warehousing: z
-        .object({
-        sku: z.string().min(1).optional().describe('Stock keeping unit'),
-        baseUnit: z.string().min(1).optional().describe('Base unit (e.g., "piece", "kg")'),
-    })
-        .optional()
-        .describe('Warehousing details - ONLY for SIMPLE_PRODUCT'),
+        .optional(z.object({
+        sku: z.optional(z.string().check(z.minLength(1))).check(z.describe('Stock keeping unit')),
+        baseUnit: z
+            .optional(z.string().check(z.minLength(1)))
+            .check(z.describe('Base unit (e.g., "piece", "kg")')),
+    }))
+        .check(z.describe('Warehousing details - ONLY for SIMPLE_PRODUCT')),
     supply: z
-        .object({
-        weightInGram: z.number().int().positive().optional().describe('Weight in grams'),
-        heightInMillimeters: z.number().int().positive().optional().describe('Height in millimeters'),
-        lengthInMillimeters: z.number().int().positive().optional().describe('Length in millimeters'),
-        widthInMillimeters: z.number().int().positive().optional().describe('Width in millimeters'),
-    })
-        .optional()
-        .describe('Supply attributes - ONLY for SIMPLE_PRODUCT'),
+        .optional(z.object({
+        weightInGram: z.optional(z.int().check(z.positive())).check(z.describe('Weight in grams')),
+        heightInMillimeters: z
+            .optional(z.int().check(z.positive()))
+            .check(z.describe('Height in millimeters')),
+        lengthInMillimeters: z
+            .optional(z.int().check(z.positive()))
+            .check(z.describe('Length in millimeters')),
+        widthInMillimeters: z
+            .optional(z.int().check(z.positive()))
+            .check(z.describe('Width in millimeters')),
+    }))
+        .check(z.describe('Supply attributes - ONLY for SIMPLE_PRODUCT')),
     tokenization: z
-        .object({
-        contractAddress: z.string().min(1).describe('Blockchain contract address'),
-        contractStandard: z.string().describe('Smart contract standard (e.g., ERC-721)'),
-        tokenId: z.string().min(1).describe('Unique token identifier'),
-        supply: z.number().int().positive().describe('Total supply of the token'),
+        .optional(z.object({
+        contractAddress: z.string().check(z.minLength(1), z.describe('Blockchain contract address')),
+        contractStandard: z.string().check(z.describe('Smart contract standard (e.g., ERC-721)')),
+        tokenId: z.string().check(z.minLength(1), z.describe('Unique token identifier')),
+        supply: z.int().check(z.positive(), z.describe('Total supply of the token')),
         ercMetadataProperties: z
-            .record(z.any(), z.any())
-            .optional()
-            .describe('Optional ERC metadata properties'),
-    })
-        .optional()
-        .describe('Tokenization details - ONLY for TOKENIZED_PRODUCT'),
+            .optional(z.record(z.any(), z.any()))
+            .check(z.describe('Optional ERC metadata properties')),
+    }))
+        .check(z.describe('Tokenization details - ONLY for TOKENIZED_PRODUCT')),
     commerce: z
-        .object({
+        .optional(z.object({
         pricing: z
             .array(z.object({
-            amount: z.number().int().describe('Price amount in smallest currency unit.'),
+            amount: z.int().check(z.describe('Price amount in smallest currency unit.')),
             maxQuantity: z
-                .number()
-                .int()
-                .optional()
-                .describe('Optional maximum quantity for this price tier'),
-            isTaxable: z.boolean().optional().describe('Whether tax applies to this price'),
-            isNetPrice: z.boolean().optional().describe('Whether this is a net price (without tax)'),
+                .optional(z.int())
+                .check(z.describe('Optional maximum quantity for this price tier')),
+            isTaxable: z.optional(z.boolean()).check(z.describe('Whether tax applies to this price')),
+            isNetPrice: z
+                .optional(z.boolean())
+                .check(z.describe('Whether this is a net price (without tax)')),
             currencyCode: z
                 .string()
-                .min(3)
-                .max(3)
-                .describe('ISO currency code (e.g., USD, EUR). Must match an available currency from the shop currencies resource. If it does not exist, prompt the user to add the currency. NEVER add it automatically unless explicitly specified by the user.'),
+                .check(z.minLength(3), z.maxLength(3), z.describe('ISO currency code (e.g., USD, EUR). Must match an available currency from the shop currencies resource. If it does not exist, prompt the user to add the currency. NEVER add it automatically unless explicitly specified by the user.')),
             countryCode: z
                 .string()
-                .min(2)
-                .max(2)
-                .describe('ISO country code (e.g., US, DE). Must match an available country from the shop countries resource. If it does not exist, prompt the user to add the country. NEVER add it automatically unless explicitly specified by the user.'),
+                .check(z.minLength(2), z.maxLength(2), z.describe('ISO country code (e.g., US, DE). Must match an available country from the shop countries resource. If it does not exist, prompt the user to add the country. NEVER add it automatically unless explicitly specified by the user.')),
         }))
-            .nonempty()
-            .describe('List of price configurations. Use only countryCode and currencyCode values from the shop resources.'),
-    })
-        .optional()
-        .describe('Commerce info - Available for ALL except CONFIGURABLE_PRODUCT. Use only registered countries and currencies from shop resources.'),
+            .check(z.minLength(1), z.describe('List of price configurations. Use only countryCode and currencyCode values from the shop resources.')),
+    }))
+        .check(z.describe('Commerce info - Available for ALL except CONFIGURABLE_PRODUCT. Use only registered countries and currencies from shop resources.')),
 });
 export const actionValidators = {
     CREATE: z.object({
-        product: ProductSchema.extend({
-            type: z.enum(productTypeKeys).describe('Product type (required for CREATE)'),
-        }).describe('Product data with type required'),
-        texts: z.array(ProductTextInputSchema).optional().describe('Localized product text entries'),
+        product: z
+            .extend(ProductSchema, {
+            type: z.enum(productTypeKeys).check(z.describe('Product type (required for CREATE)')),
+        })
+            .check(z.describe('Product data with type required')),
+        texts: z
+            .optional(z.array(ProductTextInputSchema))
+            .check(z.describe('Localized product text entries')),
     }),
     UPDATE: z.object({
-        productId: z.string().min(1).describe('Product ID'),
-        product: ProductSchema.describe('Product data to update'),
+        productId: z.string().check(z.minLength(1), z.describe('Product ID')),
+        product: ProductSchema.check(z.describe('Product data to update')),
     }),
     REMOVE: z.object({
         productId: z
             .string()
-            .min(1)
-            .describe('Product ID, (the product status to remove must be inactive or in DRAFT state other wise it will throw error) so if it is active please unpublish it first before removing the product'),
+            .check(z.minLength(1), z.describe('Product ID, (the product status to remove must be inactive or in DRAFT state other wise it will throw error) so if it is active please unpublish it first before removing the product')),
     }),
     GET: z
         .object({
-        productId: z.string().min(1).optional().describe('Product ID'),
-        slug: z.string().optional().describe('Product slug'),
-        sku: z.string().optional().describe('Product SKU'),
+        productId: z.optional(z.string().check(z.minLength(1))).check(z.describe('Product ID')),
+        slug: z.optional(z.string()).check(z.describe('Product slug')),
+        sku: z.optional(z.string()).check(z.describe('Product SKU')),
     })
-        .refine((data) => data.productId || data.slug || data.sku, {
+        .check(z.refine((data) => data.productId || data.slug || data.sku, {
         message: 'Either productId, slug, or sku is required',
-    }),
+    })),
     LIST: z.object({
         ...PaginationSchema,
         ...SortingSchema,
         ...SearchSchema,
-        tags: z.array(z.string().min(1).toLowerCase()).optional().describe('Filter by tags'),
-        slugs: z.array(z.string().min(1)).optional().describe('Filter by product slugs'),
-        includeDrafts: z.boolean().optional().describe('Include draft/unpublished products'),
+        tags: z
+            .optional(z.array(z.string().check(z.minLength(1), z.toLowerCase())))
+            .check(z.describe('Filter by tags')),
+        slugs: z
+            .optional(z.array(z.string().check(z.minLength(1))))
+            .check(z.describe('Filter by product slugs')),
+        includeDrafts: z.optional(z.boolean()).check(z.describe('Include draft/unpublished products')),
     }),
     COUNT: z.object({
         ...SearchSchema,
-        tags: z.array(z.string().min(1).toLowerCase()).optional().describe('Filter by tags'),
-        slugs: z.array(z.string().min(1)).optional().describe('Filter by product slugs'),
-        includeDrafts: z.boolean().optional().describe('Include draft/unpublished products'),
+        tags: z
+            .optional(z.array(z.string().check(z.minLength(1), z.toLowerCase())))
+            .check(z.describe('Filter by tags')),
+        slugs: z
+            .optional(z.array(z.string().check(z.minLength(1))))
+            .check(z.describe('Filter by product slugs')),
+        includeDrafts: z.optional(z.boolean()).check(z.describe('Include draft/unpublished products')),
     }),
     UPDATE_STATUS: z.object({
-        productId: z.string().min(1).describe('Product ID'),
-        statusAction: z.enum(['PUBLISH', 'UNPUBLISH']).describe('Status action'),
+        productId: z.string().check(z.minLength(1), z.describe('Product ID')),
+        statusAction: z.enum(['PUBLISH', 'UNPUBLISH']).check(z.describe('Status action')),
     }),
     ADD_MEDIA: z.object({
-        productId: z.string().min(1).describe('Product ID'),
-        mediaName: z.string().min(1).describe('Media file name'),
-        url: z.string().url().describe('Media URL'),
+        productId: z.string().check(z.minLength(1), z.describe('Product ID')),
+        mediaName: z.string().check(z.minLength(1), z.describe('Media file name')),
+        url: z.url().check(z.describe('Media URL')),
     }),
     REMOVE_MEDIA: z.object({
-        productMediaId: z.string().min(1).describe('Product media ID'),
+        productMediaId: z.string().check(z.minLength(1), z.describe('Product media ID')),
     }),
     REORDER_MEDIA: z.object({
         sortKeys: z
             .array(z.object({
-            productMediaId: z.string().min(1).describe('Media asset ID'),
-            sortKey: z.number().int().describe('New sort position'),
+            productMediaId: z.string().check(z.minLength(1), z.describe('Media asset ID')),
+            sortKey: z.int().check(z.describe('New sort position')),
         }))
-            .nonempty()
-            .describe('Sort keys'),
+            .check(z.minLength(1), z.describe('Sort keys')),
     }),
     GET_MEDIA: z.object({
-        productId: z.string().min(1).describe('Product ID'),
-        tags: z.array(z.string().min(1).toLowerCase()).optional().describe('Filter by tags'),
+        productId: z.string().check(z.minLength(1), z.describe('Product ID')),
+        tags: z
+            .optional(z.array(z.string().check(z.minLength(1), z.toLowerCase())))
+            .check(z.describe('Filter by tags')),
         ...PaginationSchema,
     }),
     UPDATE_MEDIA_TEXTS: z.object({
-        productMediaId: z.string().min(1).describe('Product media ID'),
-        mediaTexts: z.array(ProductMediaTextInputSchema).describe('Media texts'),
+        productMediaId: z.string().check(z.minLength(1), z.describe('Product media ID')),
+        mediaTexts: z.array(ProductMediaTextInputSchema).check(z.describe('Media texts')),
     }),
     CREATE_VARIATION: z.object({
-        productId: z.string().min(1).describe('Product ID'),
+        productId: z.string().check(z.minLength(1), z.describe('Product ID')),
         variation: z
             .object({
-            key: z.string().min(1).describe('Unique variation key (e.g., "Color", "Size")'),
-            type: z.enum(productVariationTypeKeys).describe('Variation type'),
+            key: z
+                .string()
+                .check(z.minLength(1), z.describe('Unique variation key (e.g., "Color", "Size")')),
+            type: z.enum(productVariationTypeKeys).check(z.describe('Variation type')),
         })
-            .describe('Variation definition'),
-        variationTexts: z.array(ProductVariationTextInputSchema).optional().describe('Variation texts'),
+            .check(z.describe('Variation definition')),
+        variationTexts: z
+            .optional(z.array(ProductVariationTextInputSchema))
+            .check(z.describe('Variation texts')),
     }),
     REMOVE_VARIATION: z.object({
-        productVariationId: z.string().min(1).describe('Product variation ID'),
+        productVariationId: z.string().check(z.minLength(1), z.describe('Product variation ID')),
     }),
     ADD_VARIATION_OPTION: z.object({
-        productVariationId: z.string().min(1).describe('Product variation ID'),
-        option: z.string().min(1).describe('Option value'),
-        variationTexts: z.array(ProductVariationTextInputSchema).optional().describe('Variation texts'),
+        productVariationId: z.string().check(z.minLength(1), z.describe('Product variation ID')),
+        option: z.string().check(z.minLength(1), z.describe('Option value')),
+        variationTexts: z
+            .optional(z.array(ProductVariationTextInputSchema))
+            .check(z.describe('Variation texts')),
     }),
     REMOVE_VARIATION_OPTION: z.object({
-        productVariationId: z.string().min(1).describe('Product variation ID'),
-        productVariationOptionValue: z.string().min(1).describe('Option value'),
+        productVariationId: z.string().check(z.minLength(1), z.describe('Product variation ID')),
+        productVariationOptionValue: z.string().check(z.minLength(1), z.describe('Option value')),
     }),
     UPDATE_VARIATION_TEXTS: z.object({
-        productVariationId: z.string().min(1).describe('Product variation ID'),
-        variationTexts: z.array(ProductVariationTextInputSchema).describe('Variation texts'),
-        productVariationOptionValue: z.string().min(1).optional().describe('Option value'),
+        productVariationId: z.string().check(z.minLength(1), z.describe('Product variation ID')),
+        variationTexts: z.array(ProductVariationTextInputSchema).check(z.describe('Variation texts')),
+        productVariationOptionValue: z
+            .optional(z.string().check(z.minLength(1)))
+            .check(z.describe('Option value')),
     }),
     GET_VARIATION_PRODUCTS: z.object({
-        productId: z.string().min(1).describe('Product ID'),
-        vectors: z.array(ProductAssignmentVectorSchema).describe('Variation vectors'),
-        includeInactive: z.boolean().optional().default(true).describe('Include inactive products'),
+        productId: z.string().check(z.minLength(1), z.describe('Product ID')),
+        vectors: z.array(ProductAssignmentVectorSchema).check(z.describe('Variation vectors')),
+        includeInactive: z._default(z.boolean(), true).check(z.describe('Include inactive products')),
     }),
     GET_ASSIGNMENTS: z.object({
-        productId: z.string().min(1).describe('Product ID'),
-        includeInactive: z.boolean().optional().describe('Include inactive assignments'),
+        productId: z.string().check(z.minLength(1), z.describe('Product ID')),
+        includeInactive: z.optional(z.boolean()).check(z.describe('Include inactive assignments')),
     }),
     ADD_ASSIGNMENT: z.object({
-        proxyId: z.string().min(1).describe('Proxy product ID'),
-        assignProductId: z.string().min(1).describe('Product to assign'),
-        vectors: z.array(ProductAssignmentVectorSchema).describe('Variation vectors'),
+        proxyId: z.string().check(z.minLength(1), z.describe('Proxy product ID')),
+        assignProductId: z.string().check(z.minLength(1), z.describe('Product to assign')),
+        vectors: z.array(ProductAssignmentVectorSchema).check(z.describe('Variation vectors')),
     }),
     REMOVE_ASSIGNMENT: z.object({
-        proxyId: z.string().min(1).describe('Proxy product ID'),
-        vectors: z.array(ProductAssignmentVectorSchema).describe('Variation vectors'),
+        proxyId: z.string().check(z.minLength(1), z.describe('Proxy product ID')),
+        vectors: z.array(ProductAssignmentVectorSchema).check(z.describe('Variation vectors')),
     }),
     ADD_BUNDLE_ITEM: z.object({
-        bundleId: z.string().min(1).describe('Bundle product ID'),
-        bundleProductId: z.string().min(1).describe('Product to add to bundle'),
-        quantity: z.number().int().positive().default(1).describe('Quantity'),
+        bundleId: z.string().check(z.minLength(1), z.describe('Bundle product ID')),
+        bundleProductId: z.string().check(z.minLength(1), z.describe('Product to add to bundle')),
+        quantity: z._default(z.int().check(z.positive()), 1).check(z.describe('Quantity')),
     }),
     REMOVE_BUNDLE_ITEM: z.object({
-        bundleId: z.string().min(1).describe('Bundle product ID'),
-        index: z.number().int().min(0).describe('Bundle item index'),
+        bundleId: z.string().check(z.minLength(1), z.describe('Bundle product ID')),
+        index: z.int().check(z.gte(0), z.describe('Bundle item index')),
     }),
     GET_BUNDLE_ITEMS: z.object({
-        bundleId: z.string().min(1).describe('Bundle product ID'),
+        bundleId: z.string().check(z.minLength(1), z.describe('Bundle product ID')),
     }),
     GET_CATALOG_PRICE: z.object({
-        productId: z.string().min(1).describe('Product ID'),
-        quantity: z.number().int().positive().optional().describe('Quantity'),
-        currencyCode: z.string().min(3).max(3).optional().describe('ISO currency code'),
+        productId: z.string().check(z.minLength(1), z.describe('Product ID')),
+        quantity: z.optional(z.int().check(z.positive())).check(z.describe('Quantity')),
+        currencyCode: z
+            .optional(z.string().check(z.minLength(3), z.maxLength(3)))
+            .check(z.describe('ISO currency code')),
     }),
     SIMULATE_PRICE: z.object({
-        productId: z.string().min(1).describe('Product ID'),
-        vectors: z.array(ProductAssignmentVectorSchema).optional().describe('Variation vectors'),
-        quantity: z.number().int().positive().optional().describe('Quantity'),
-        currencyCode: z.string().min(3).max(3).optional().describe('ISO currency code'),
-        useNetPrice: z.boolean().optional().describe('Whether to use net price'),
+        productId: z.string().check(z.minLength(1), z.describe('Product ID')),
+        vectors: z.optional(z.array(ProductAssignmentVectorSchema)).check(z.describe('Variation vectors')),
+        quantity: z.optional(z.int().check(z.positive())).check(z.describe('Quantity')),
+        currencyCode: z
+            .optional(z.string().check(z.minLength(3), z.maxLength(3)))
+            .check(z.describe('ISO currency code')),
+        useNetPrice: z.optional(z.boolean()).check(z.describe('Whether to use net price')),
     }),
     SIMULATE_PRICE_RANGE: z.object({
-        productId: z.string().min(1).describe('Product ID'),
-        vectors: z.array(ProductAssignmentVectorSchema).optional().describe('Variation vectors'),
-        quantity: z.number().int().positive().optional().describe('Quantity'),
-        currencyCode: z.string().min(3).max(3).optional().describe('ISO currency code'),
-        useNetPrice: z.boolean().optional().describe('Whether to use net price'),
+        productId: z.string().check(z.minLength(1), z.describe('Product ID')),
+        vectors: z.optional(z.array(ProductAssignmentVectorSchema)).check(z.describe('Variation vectors')),
+        quantity: z.optional(z.int().check(z.positive())).check(z.describe('Quantity')),
+        currencyCode: z
+            .optional(z.string().check(z.minLength(3), z.maxLength(3)))
+            .check(z.describe('ISO currency code')),
+        useNetPrice: z.optional(z.boolean()).check(z.describe('Whether to use net price')),
     }),
     GET_PRODUCT_TEXTS: z.object({
-        productId: z.string().min(1).describe('Product ID'),
+        productId: z.string().check(z.minLength(1), z.describe('Product ID')),
     }),
     GET_VARIATION_TEXTS: z.object({
-        productVariationId: z.string().min(1).describe('Product variation ID'),
-        productVariationOptionValue: z.string().min(1).optional().describe('Option value'),
+        productVariationId: z.string().check(z.minLength(1), z.describe('Product variation ID')),
+        productVariationOptionValue: z
+            .optional(z.string().check(z.minLength(1)))
+            .check(z.describe('Option value')),
     }),
     GET_MEDIA_TEXTS: z.object({
-        productMediaId: z.string().min(1).describe('Product media ID'),
+        productMediaId: z.string().check(z.minLength(1), z.describe('Product media ID')),
     }),
     GET_REVIEWS: z.object({
-        productId: z.string().min(1).describe('Product ID'),
+        productId: z.string().check(z.minLength(1), z.describe('Product ID')),
         ...PaginationSchema,
         ...SortingSchema,
         ...SearchSchema,
     }),
     COUNT_REVIEWS: z.object({
-        productId: z.string().min(1).describe('Product ID'),
+        productId: z.string().check(z.minLength(1), z.describe('Product ID')),
         ...SearchSchema,
     }),
     GET_SIBLINGS: z.object({
-        productId: z.string().min(1).describe('Product ID'),
-        assortmentId: z.string().optional().describe('Assortment ID'),
-        includeInactive: z.boolean().optional().describe('Include inactive products'),
+        productId: z.string().check(z.minLength(1), z.describe('Product ID')),
+        assortmentId: z.optional(z.string()).check(z.describe('Assortment ID')),
+        includeInactive: z.optional(z.boolean()).check(z.describe('Include inactive products')),
     }),
     UPDATE_PRODUCT_TEXTS: z.object({
-        productId: z.string().min(1).describe('Product ID'),
-        texts: z.array(ProductTextInputSchema).describe('Product texts to update'),
+        productId: z.string().check(z.minLength(1), z.describe('Product ID')),
+        texts: z.array(ProductTextInputSchema).check(z.describe('Product texts to update')),
     }),
 };
-export const ProductManagementSchema = {
-    action: z
-        .enum([
-        'CREATE',
-        'UPDATE',
-        'REMOVE',
-        'GET',
-        'LIST',
-        'COUNT',
-        'UPDATE_STATUS',
-        'ADD_MEDIA',
-        'REMOVE_MEDIA',
-        'REORDER_MEDIA',
-        'GET_MEDIA',
-        'UPDATE_MEDIA_TEXTS',
-        'CREATE_VARIATION',
-        'REMOVE_VARIATION',
-        'ADD_VARIATION_OPTION',
-        'REMOVE_VARIATION_OPTION',
-        'ADD_ASSIGNMENT',
-        'REMOVE_ASSIGNMENT',
-        'GET_ASSIGNMENTS',
-        'GET_VARIATION_PRODUCTS',
-        'UPDATE_VARIATION_TEXTS',
-        'ADD_BUNDLE_ITEM',
-        'REMOVE_BUNDLE_ITEM',
-        'GET_BUNDLE_ITEMS',
-        'SIMULATE_PRICE',
-        'SIMULATE_PRICE_RANGE',
-        'GET_CATALOG_PRICE',
-        'GET_PRODUCT_TEXTS',
-        'GET_MEDIA_TEXTS',
-        'GET_VARIATION_TEXTS',
-        'GET_REVIEWS',
-        'COUNT_REVIEWS',
-        'GET_SIBLINGS',
-        'UPDATE_PRODUCT_TEXTS',
-    ])
-        .describe('Product management action to perform'),
-    productId: z
-        .string()
-        .min(1)
-        .optional()
-        .describe('Product ID (required for most actions except CREATE, LIST, COUNT)'),
-    slug: z.string().optional().describe('Product slug (alternative to productId for GET action)'),
-    sku: z.string().optional().describe('Product SKU (alternative to productId for GET action)'),
-    productMediaId: z
-        .string()
-        .min(1)
-        .optional()
-        .describe('Product media ID (required for media-specific actions)'),
-    productVariationId: z
-        .string()
-        .min(1)
-        .optional()
-        .describe('Product variation ID (required for variation-specific actions)'),
-    product: ProductSchema.optional().describe('Product data object for CREATE/UPDATE actions'),
-    texts: z
-        .array(ProductTextInputSchema)
-        .optional()
-        .describe('Localized product text entries for CREATE action'),
-    statusAction: z
-        .enum(['PUBLISH', 'UNPUBLISH'])
-        .optional()
-        .describe('Status action for UPDATE_STATUS action'),
-    mediaName: z.string().min(1).optional().describe('Media file name for ADD_MEDIA action'),
-    url: z.string().url().optional().describe('Media URL for ADD_MEDIA action'),
-    sortKeys: z
-        .array(z.object({
-        productMediaId: z.string().min(1).describe('Media asset ID'),
-        sortKey: z.number().int().describe('New sort position'),
-    }))
-        .optional()
-        .describe('Sort keys for REORDER_MEDIA action'),
-    mediaTexts: z
-        .array(ProductMediaTextInputSchema)
-        .optional()
-        .describe('Media text updates for UPDATE_MEDIA_TEXTS action'),
-    tags: z.array(z.string()).optional().describe('Media tags filter for GET_MEDIA action'),
-    variation: z
-        .object({
-        key: z.string().min(1).describe('Unique variation key (e.g., "Color", "Size")'),
-        type: z.enum(productVariationTypeKeys).describe('Variation type from ProductVariationType enum'),
-    })
-        .optional()
-        .describe('Variation definition for CREATE_VARIATION action'),
-    option: z
-        .string()
-        .min(1)
-        .optional()
-        .describe('Option value for ADD_VARIATION_OPTION action (e.g., "Red", "Large")'),
-    productVariationOptionValue: z
-        .string()
-        .min(1)
-        .optional()
-        .describe('Option value for REMOVE_VARIATION_OPTION action'),
-    variationTexts: z
-        .array(ProductVariationTextInputSchema)
-        .optional()
-        .describe('Variation text updates for UPDATE_VARIATION_TEXTS action'),
-    assignProductId: z
-        .string()
-        .min(1)
-        .optional()
-        .describe('Product to assign (ADD_ASSIGNMENT/REMOVE_ASSIGNMENT actions)'),
-    proxyId: z.string().min(1).optional().describe('CONFIGURABLE_PRODUCT ID for assignments'),
-    vectors: z
-        .array(ProductAssignmentVectorSchema)
-        .optional()
-        .describe('Complete variation combination vectors'),
-    includeInactive: z.boolean().optional().describe('Include inactive variants in results'),
-    bundleId: z
-        .string()
-        .min(1)
-        .optional()
-        .describe('Bundle product ID for ADD_BUNDLE_ITEM/REMOVE_BUNDLE_ITEM actions'),
-    bundleProductId: z
-        .string()
-        .min(1)
-        .optional()
-        .describe('Product to add to bundle for ADD_BUNDLE_ITEM action'),
-    index: z.number().int().min(0).optional().describe('Bundle item index for REMOVE_BUNDLE_ITEM action'),
-    quantity: z.number().int().positive().optional().describe('Quantity for pricing calculations'),
-    currencyCode: z.string().min(3).max(3).optional().describe('ISO currency code for pricing'),
-    useNetPrice: z.boolean().optional().describe('Whether to use net price in calculations'),
-    ...PaginationSchema,
-    ...SortingSchema,
-    ...SearchSchema,
-    includeDrafts: z.boolean().optional().describe('Include draft products in results'),
-    productIds: z.array(z.string()).optional().describe('Filter by specific product IDs'),
-    assortmentId: z.string().optional().describe('Filter by assortment ID (for GET_SIBLINGS action)'),
-};
-export const ProductManagementZodSchema = z.object(ProductManagementSchema);
+export const ProductManagementSchema = createManagementSchemaFromValidators(actionValidators);

package/lib/mcp/tools/provider/providerManagement.d.ts

@@ -1,6 +1,6 @@
 import type { Context } from '../../../context.ts';
-import { ProviderManagementSchema, ProviderManagementZodSchema, type ProviderManagementParams } from './schemas.ts';
-export { ProviderManagementSchema, ProviderManagementZodSchema };
+import { ProviderManagementSchema, type ProviderManagementParams } from './schemas.ts';
+export { ProviderManagementSchema };
 export type { ProviderManagementParams };
 export declare function providerManagement(context: Context, params: ProviderManagementParams): Promise<{
     content: {

package/lib/mcp/tools/provider/providerManagement.js

@@ -1,8 +1,8 @@
 import { log } from '@unchainedshop/logger';
-import { actionValidators, ProviderManagementSchema, ProviderManagementZodSchema, } from "./schemas.js";
+import { actionValidators, ProviderManagementSchema, } from "./schemas.js";
 import actionHandlers from "./handlers/index.js";
 import { createMcpErrorResponse, createMcpResponse } from "../../utils/sharedSchemas.js";
-export { ProviderManagementSchema, ProviderManagementZodSchema };
+export { ProviderManagementSchema };
 export async function providerManagement(context, params) {
     const { action, ...actionParams } = params;
     log('MCP providerManagement', { userId: context.userId, params });