@unchainedshop/api 4.7.2 → 4.8.1

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

@@ -1,270 +1,187 @@
-import { z } from 'zod';
+import { z } from 'zod/v4-mini';
 import { SortDirection } from '@unchainedshop/utils';
-import { PaginationSchema, SortingSchema, SearchSchema, LocalizationTextSchema, } from "../../utils/sharedSchemas.js";
+import { PaginationSchema, SortingSchema, SearchSchema, LocalizationTextSchema, createManagementSchemaFromValidators, } from "../../utils/sharedSchemas.js";
 export const sortDirectionKeys = Object.keys(SortDirection);
-export const AssortmentTextInputSchema = LocalizationTextSchema.extend({
-    slug: z.string().optional().describe('URL slug'),
-    description: z.string().optional().describe('Markdown description'),
-}).describe('Assortment localized text data');
-export const AssortmentMediaTextInputSchema = LocalizationTextSchema.describe('Assortment media localized text data');
+export const AssortmentTextInputSchema = z
+    .extend(LocalizationTextSchema, {
+    slug: z.optional(z.string()).check(z.describe('URL slug')),
+    description: z.optional(z.string()).check(z.describe('Markdown description')),
+})
+    .check(z.describe('Assortment localized text data'));
+export const AssortmentMediaTextInputSchema = LocalizationTextSchema.check(z.describe('Assortment media localized text data'));
 export const AssortmentSchema = z.object({
-    isRoot: z.boolean().optional().describe('Whether this is a root-level assortment'),
-    isActive: z.boolean().optional().describe('Whether this assortment is active'),
-    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'),
+    isRoot: z.optional(z.boolean()).check(z.describe('Whether this is a root-level assortment')),
+    isActive: z.optional(z.boolean()).check(z.describe('Whether this assortment is active')),
+    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')),
 });
 export const actionValidators = {
     CREATE: z.object({
-        assortment: AssortmentSchema.describe('Assortment data'),
-        texts: z.array(AssortmentTextInputSchema).optional().describe('Localized assortment text entries'),
+        assortment: AssortmentSchema.check(z.describe('Assortment data')),
+        texts: z
+            .optional(z.array(AssortmentTextInputSchema))
+            .check(z.describe('Localized assortment text entries')),
     }),
     UPDATE: z.object({
-        assortmentId: z.string().min(1).describe('Assortment ID'),
-        assortment: AssortmentSchema.describe('Assortment data to update'),
+        assortmentId: z.string().check(z.minLength(1), z.describe('Assortment ID')),
+        assortment: AssortmentSchema.check(z.describe('Assortment data to update')),
     }),
     REMOVE: z.object({
-        assortmentId: z.string().min(1).describe('Assortment ID'),
+        assortmentId: z.string().check(z.minLength(1), z.describe('Assortment ID')),
     }),
     GET: z
         .object({
-        assortmentId: z.string().min(1).optional().describe('Assortment ID'),
-        slug: z.string().optional().describe('Assortment slug'),
+        assortmentId: z.optional(z.string().check(z.minLength(1))).check(z.describe('Assortment ID')),
+        slug: z.optional(z.string()).check(z.describe('Assortment slug')),
     })
-        .refine((data) => data.assortmentId || data.slug, {
+        .check(z.refine((data) => data.assortmentId || data.slug, {
         message: 'Either assortmentId or slug 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 assortment slugs'),
-        includeLeaves: z.boolean().default(true).optional().describe('Include leaf-level assortments'),
+        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 assortment slugs')),
+        includeLeaves: z._default(z.boolean(), true).check(z.describe('Include leaf-level assortments')),
     }),
     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 assortment slugs'),
-        includeLeaves: z.boolean().optional().describe('Include leaf-level assortments'),
+        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 assortment slugs')),
+        includeLeaves: z.optional(z.boolean()).check(z.describe('Include leaf-level assortments')),
     }),
     UPDATE_STATUS: z.object({
-        assortmentId: z.string().min(1).describe('Assortment ID'),
-        statusAction: z.enum(['ACTIVATE', 'DEACTIVATE']).describe('Status action'),
+        assortmentId: z.string().check(z.minLength(1), z.describe('Assortment ID')),
+        statusAction: z.enum(['ACTIVATE', 'DEACTIVATE']).check(z.describe('Status action')),
     }),
     ADD_MEDIA: z.object({
-        assortmentId: z.string().min(1).describe('Assortment ID'),
-        mediaId: z.string().min(1).describe('Media ID'),
-        tags: z.array(z.string().min(1).toLowerCase()).optional().describe('Tags for media association'),
+        assortmentId: z.string().check(z.minLength(1), z.describe('Assortment ID')),
+        mediaId: z.string().check(z.minLength(1), z.describe('Media ID')),
+        tags: z
+            .optional(z.array(z.string().check(z.minLength(1), z.toLowerCase())))
+            .check(z.describe('Tags for media association')),
     }),
     REMOVE_MEDIA: z.object({
-        mediaId: z.string().min(1).describe('Media ID'),
+        mediaId: z.string().check(z.minLength(1), z.describe('Media ID')),
     }),
     REORDER_MEDIA: z.object({
         sortKeys: z
             .array(z.object({
-            assortmentMediaId: z.string().min(1).describe('Assortment Media asset ID'),
-            sortKey: z.number().int().describe('New sort position'),
+            assortmentMediaId: z.string().check(z.minLength(1), z.describe('Assortment 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({
-        assortmentId: z.string().min(1).describe('Assortment ID'),
-        tags: z.array(z.string().min(1).toLowerCase()).optional().describe('Filter by tags'),
+        assortmentId: z.string().check(z.minLength(1), z.describe('Assortment 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({
-        assortmentMediaId: z.string().min(1).describe('Assortment media ID'),
-        mediaTexts: z.array(AssortmentMediaTextInputSchema).describe('Media texts'),
+        assortmentMediaId: z.string().check(z.minLength(1), z.describe('Assortment media ID')),
+        mediaTexts: z.array(AssortmentMediaTextInputSchema).check(z.describe('Media texts')),
     }),
     ADD_PRODUCT: z.object({
-        assortmentId: z.string().min(1).describe('Assortment ID'),
-        productId: z.string().min(1).describe('Product ID'),
-        tags: z.array(z.string().min(1).toLowerCase()).optional().describe('Tags for product association'),
+        assortmentId: z.string().check(z.minLength(1), z.describe('Assortment ID')),
+        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('Tags for product association')),
     }),
     REMOVE_PRODUCT: z.object({
         assortmentProductId: z
             .string()
-            .min(1)
-            .describe('Assortment Product ID (from assortment product relationship, _id of assortment product)'),
+            .check(z.minLength(1), z.describe('Assortment Product ID (from assortment product relationship, _id of assortment product)')),
     }),
     GET_PRODUCTS: z.object({
-        assortmentId: z.string().min(1).describe('Assortment ID'),
+        assortmentId: z.string().check(z.minLength(1), z.describe('Assortment ID')),
     }),
     REORDER_PRODUCTS: z.object({
         sortKeys: z
             .array(z.object({
             assortmentProductId: z
                 .string()
-                .min(1)
-                .describe('Assortment product ID,(from assortment product relationship, _id of assortment product)'),
-            sortKey: z.number().int().describe('New sort position'),
+                .check(z.minLength(1), z.describe('Assortment product ID,(from assortment product relationship, _id of assortment product)')),
+            sortKey: z.int().check(z.describe('New sort position')),
         }))
-            .nonempty()
-            .describe('Sort keys'),
+            .check(z.minLength(1), z.describe('Sort keys')),
     }),
     ADD_FILTER: z.object({
-        assortmentId: z.string().min(1).describe('Assortment ID'),
-        filterId: z.string().min(1).describe('Filter ID'),
-        tags: z.array(z.string().min(1).toLowerCase()).optional().describe('Tags for filter association'),
+        assortmentId: z.string().check(z.minLength(1), z.describe('Assortment ID')),
+        filterId: z.string().check(z.minLength(1), z.describe('Filter ID')),
+        tags: z
+            .optional(z.array(z.string().check(z.minLength(1), z.toLowerCase())))
+            .check(z.describe('Tags for filter association')),
     }),
     REMOVE_FILTER: z.object({
         assortmentFilterId: z
             .string()
-            .min(1)
-            .describe('Assortment Filter ID (from assortment filter relationship)'),
+            .check(z.minLength(1), z.describe('Assortment Filter ID (from assortment filter relationship)')),
     }),
     GET_FILTERS: z.object({
-        assortmentId: z.string().min(1).describe('Assortment ID'),
+        assortmentId: z.string().check(z.minLength(1), z.describe('Assortment ID')),
     }),
     REORDER_FILTERS: z.object({
         sortKeys: z
             .array(z.object({
             assortmentFilterId: z
                 .string()
-                .min(1)
-                .describe('Assortment filter ID (from assortment filter relationship)'),
-            sortKey: z.number().int().describe('New sort position'),
+                .check(z.minLength(1), z.describe('Assortment filter ID (from assortment filter relationship)')),
+            sortKey: z.int().check(z.describe('New sort position')),
         }))
-            .nonempty()
-            .describe('Sort keys'),
+            .check(z.minLength(1), z.describe('Sort keys')),
     }),
     ADD_LINK: z.object({
-        parentAssortmentId: z.string().min(1).describe('Parent assortment ID'),
-        childAssortmentId: z.string().min(1).describe('Child assortment ID'),
-        tags: z.array(z.string().min(1).toLowerCase()).optional().describe('Tags for link association'),
+        parentAssortmentId: z.string().check(z.minLength(1), z.describe('Parent assortment ID')),
+        childAssortmentId: z.string().check(z.minLength(1), z.describe('Child assortment ID')),
+        tags: z
+            .optional(z.array(z.string().check(z.minLength(1), z.toLowerCase())))
+            .check(z.describe('Tags for link association')),
     }),
     REMOVE_LINK: z.object({
-        assortmentLinkId: z.string().min(1).describe('Assortment link ID'),
+        assortmentLinkId: z.string().check(z.minLength(1), z.describe('Assortment link ID')),
     }),
     GET_LINKS: z.object({
-        assortmentId: z.string().min(1).describe('Assortment ID'),
+        assortmentId: z.string().check(z.minLength(1), z.describe('Assortment ID')),
     }),
     REORDER_LINKS: z.object({
         sortKeys: z
             .array(z.object({
-            assortmentLinkId: z.string().min(1).describe('Assortment link ID'),
-            sortKey: z.number().int().describe('New sort position'),
+            assortmentLinkId: z.string().check(z.minLength(1), z.describe('Assortment link ID')),
+            sortKey: z.int().check(z.describe('New sort position')),
         }))
-            .nonempty()
-            .describe('Sort keys'),
+            .check(z.minLength(1), z.describe('Sort keys')),
     }),
     GET_CHILDREN: z.object({
-        assortmentId: z.string().min(1).describe('Assortment ID (optional for root-level)'),
-        includeInactive: z.boolean().optional().describe('Include inactive children'),
+        assortmentId: z
+            .string()
+            .check(z.minLength(1), z.describe('Assortment ID (optional for root-level)')),
+        includeInactive: z.optional(z.boolean()).check(z.describe('Include inactive children')),
     }),
     SEARCH_PRODUCTS: z.object({
-        assortmentId: z.string().min(1).describe('Assortment ID'),
+        assortmentId: z.string().check(z.minLength(1), z.describe('Assortment ID')),
         ...PaginationSchema,
         ...SearchSchema,
     }),
     GET_TEXTS: z.object({
-        assortmentId: z.string().min(1).describe('Assortment ID'),
+        assortmentId: z.string().check(z.minLength(1), z.describe('Assortment ID')),
     }),
     GET_MEDIA_TEXTS: z.object({
-        assortmentMediaId: z.string().min(1).describe('Assortment media ID'),
+        assortmentMediaId: z.string().check(z.minLength(1), z.describe('Assortment media ID')),
     }),
 };
-export const AssortmentManagementSchema = {
-    action: z
-        .enum([
-        'CREATE',
-        'UPDATE',
-        'REMOVE',
-        'GET',
-        'LIST',
-        'COUNT',
-        'UPDATE_STATUS',
-        'ADD_MEDIA',
-        'REMOVE_MEDIA',
-        'REORDER_MEDIA',
-        'GET_MEDIA',
-        'UPDATE_MEDIA_TEXTS',
-        'ADD_PRODUCT',
-        'REMOVE_PRODUCT',
-        'GET_PRODUCTS',
-        'REORDER_PRODUCTS',
-        'ADD_FILTER',
-        'REMOVE_FILTER',
-        'GET_FILTERS',
-        'REORDER_FILTERS',
-        'ADD_LINK',
-        'REMOVE_LINK',
-        'GET_LINKS',
-        'REORDER_LINKS',
-        'GET_CHILDREN',
-        'SEARCH_PRODUCTS',
-        'GET_TEXTS',
-        'GET_MEDIA_TEXTS',
-    ])
-        .describe('Assortment management action to perform'),
-    assortmentId: z
-        .string()
-        .min(1)
-        .optional()
-        .describe('Assortment ID (required for most actions except CREATE, LIST, COUNT)'),
-    slug: z.string().optional().describe('Assortment slug (alternative to assortmentId for GET action)'),
-    assortmentMediaId: z
-        .string()
-        .min(1)
-        .optional()
-        .describe('Assortment media ID (required for media-specific actions)'),
-    assortment: AssortmentSchema.optional().describe('Assortment data object for CREATE/UPDATE actions'),
-    texts: z
-        .array(AssortmentTextInputSchema)
-        .optional()
-        .describe('Localized assortment text entries for CREATE action'),
-    statusAction: z
-        .enum(['ACTIVATE', 'DEACTIVATE'])
-        .optional()
-        .describe('Status action for UPDATE_STATUS action'),
-    mediaId: z.string().min(1).optional().describe('Media ID for ADD_MEDIA action'),
-    sortKeys: z
-        .array(z.union([
-        z.object({
-            assortmentMediaId: z.string().min(1).describe('Media asset ID'),
-            sortKey: z.number().int().describe('New sort position'),
-        }),
-        z.object({
-            assortmentProductId: z.string().min(1).describe('_id of assortment product relationship ID'),
-            sortKey: z.number().int().describe('New sort position'),
-        }),
-        z.object({
-            assortmentFilterId: z.string().min(1).describe('Filter relationship ID'),
-            sortKey: z.number().int().describe('New sort position'),
-        }),
-        z.object({
-            assortmentLinkId: z.string().min(1).describe('Link relationship ID'),
-            sortKey: z.number().int().describe('New sort position'),
-        }),
-    ]))
-        .optional()
-        .describe('Sort keys for REORDER actions'),
-    mediaTexts: z
-        .array(AssortmentMediaTextInputSchema)
-        .optional()
-        .describe('Media text updates for UPDATE_MEDIA_TEXTS action'),
-    tags: z.array(z.string()).optional().describe('Tags filter or association tags'),
-    assortmentProductId: z
-        .string()
-        .min(1)
-        .optional()
-        .describe('Product ID for REORDER_PRODUCTS/REMOVE_PRODUCT actions'),
-    productId: z.string().min(1).optional().describe('Product ID for ADD_PRODUCT/REMOVE_PRODUCT actions'),
-    filterId: z.string().min(1).optional().describe('Filter ID for ADD_FILTER/REMOVE_FILTER actions'),
-    assortmentFilterId: z
-        .string()
-        .min(1)
-        .optional()
-        .describe('Filter ID for REORDER_FILTERS/REMOVE_FILTER actions'),
-    parentAssortmentId: z.string().min(1).optional().describe('Parent assortment ID for ADD_LINK action'),
-    childAssortmentId: z.string().min(1).optional().describe('Child assortment ID for ADD_LINK action'),
-    assortmentLinkId: z.string().min(1).optional().describe('Link ID for REMOVE_LINK action'),
-    ...PaginationSchema,
-    ...SortingSchema,
-    ...SearchSchema,
-    includeLeaves: z.boolean().optional().describe('Include leaf-level assortments in results'),
-    slugs: z.array(z.string()).optional().describe('Filter by specific slugs'),
-};
-export const AssortmentManagementZodSchema = z.object(AssortmentManagementSchema);
+export const AssortmentManagementSchema = createManagementSchemaFromValidators(actionValidators);

package/lib/mcp/tools/filter/filterManagement.d.ts

@@ -1,6 +1,6 @@
 import type { Context } from '../../../context.ts';
-import { FilterManagementSchema, FilterManagementZodSchema, type FilterManagementParams } from './schemas.ts';
-export { FilterManagementSchema, FilterManagementZodSchema };
+import { FilterManagementSchema, type FilterManagementParams } from './schemas.ts';
+export { FilterManagementSchema };
 export type { FilterManagementParams };
 export declare function filterManagement(context: Context, params: FilterManagementParams): Promise<{
     content: {

package/lib/mcp/tools/filter/filterManagement.js

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