@unchainedshop/api 4.8.4 → 5.0.0-alpha.1

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

@@ -1,187 +1,270 @@
-import { z } from 'zod/v4-mini';
+import { z } from 'zod';
 import { SortDirection } from '@unchainedshop/utils';
-import { PaginationSchema, SortingSchema, SearchSchema, LocalizationTextSchema, createManagementSchemaFromValidators, } from "../../utils/sharedSchemas.js";
+import { PaginationSchema, SortingSchema, SearchSchema, LocalizationTextSchema, } from "../../utils/sharedSchemas.js";
 export const sortDirectionKeys = Object.keys(SortDirection);
-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 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 AssortmentSchema = z.object({
-    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')),
+    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'),
 });
 export const actionValidators = {
     CREATE: z.object({
-        assortment: AssortmentSchema.check(z.describe('Assortment data')),
-        texts: z
-            .optional(z.array(AssortmentTextInputSchema))
-            .check(z.describe('Localized assortment text entries')),
+        assortment: AssortmentSchema.describe('Assortment data'),
+        texts: z.array(AssortmentTextInputSchema).optional().describe('Localized assortment text entries'),
     }),
     UPDATE: z.object({
-        assortmentId: z.string().check(z.minLength(1), z.describe('Assortment ID')),
-        assortment: AssortmentSchema.check(z.describe('Assortment data to update')),
+        assortmentId: z.string().min(1).describe('Assortment ID'),
+        assortment: AssortmentSchema.describe('Assortment data to update'),
     }),
     REMOVE: z.object({
-        assortmentId: z.string().check(z.minLength(1), z.describe('Assortment ID')),
+        assortmentId: z.string().min(1).describe('Assortment ID'),
     }),
     GET: z
         .object({
-        assortmentId: z.optional(z.string().check(z.minLength(1))).check(z.describe('Assortment ID')),
-        slug: z.optional(z.string()).check(z.describe('Assortment slug')),
+        assortmentId: z.string().min(1).optional().describe('Assortment ID'),
+        slug: z.string().optional().describe('Assortment slug'),
     })
-        .check(z.refine((data) => data.assortmentId || data.slug, {
+        .refine((data) => data.assortmentId || data.slug, {
         message: 'Either assortmentId or slug is required',
-    })),
+    }),
     LIST: z.object({
         ...PaginationSchema,
         ...SortingSchema,
         ...SearchSchema,
-        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')),
+        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'),
     }),
     COUNT: z.object({
         ...SearchSchema,
-        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')),
+        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'),
     }),
     UPDATE_STATUS: z.object({
-        assortmentId: z.string().check(z.minLength(1), z.describe('Assortment ID')),
-        statusAction: z.enum(['ACTIVATE', 'DEACTIVATE']).check(z.describe('Status action')),
+        assortmentId: z.string().min(1).describe('Assortment ID'),
+        statusAction: z.enum(['ACTIVATE', 'DEACTIVATE']).describe('Status action'),
     }),
     ADD_MEDIA: z.object({
-        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')),
+        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'),
     }),
     REMOVE_MEDIA: z.object({
-        mediaId: z.string().check(z.minLength(1), z.describe('Media ID')),
+        mediaId: z.string().min(1).describe('Media ID'),
     }),
     REORDER_MEDIA: z.object({
         sortKeys: z
             .array(z.object({
-            assortmentMediaId: z.string().check(z.minLength(1), z.describe('Assortment Media asset ID')),
-            sortKey: z.int().check(z.describe('New sort position')),
+            assortmentMediaId: z.string().min(1).describe('Assortment Media asset ID'),
+            sortKey: z.number().int().describe('New sort position'),
         }))
-            .check(z.minLength(1), z.describe('Sort keys')),
+            .nonempty()
+            .describe('Sort keys'),
     }),
     GET_MEDIA: z.object({
-        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')),
+        assortmentId: z.string().min(1).describe('Assortment ID'),
+        tags: z.array(z.string().min(1).toLowerCase()).optional().describe('Filter by tags'),
         ...PaginationSchema,
     }),
     UPDATE_MEDIA_TEXTS: z.object({
-        assortmentMediaId: z.string().check(z.minLength(1), z.describe('Assortment media ID')),
-        mediaTexts: z.array(AssortmentMediaTextInputSchema).check(z.describe('Media texts')),
+        assortmentMediaId: z.string().min(1).describe('Assortment media ID'),
+        mediaTexts: z.array(AssortmentMediaTextInputSchema).describe('Media texts'),
     }),
     ADD_PRODUCT: z.object({
-        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')),
+        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'),
     }),
     REMOVE_PRODUCT: z.object({
         assortmentProductId: z
             .string()
-            .check(z.minLength(1), z.describe('Assortment Product ID (from assortment product relationship, _id of assortment product)')),
+            .min(1)
+            .describe('Assortment Product ID (from assortment product relationship, _id of assortment product)'),
     }),
     GET_PRODUCTS: z.object({
-        assortmentId: z.string().check(z.minLength(1), z.describe('Assortment ID')),
+        assortmentId: z.string().min(1).describe('Assortment ID'),
     }),
     REORDER_PRODUCTS: z.object({
         sortKeys: z
             .array(z.object({
             assortmentProductId: z
                 .string()
-                .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')),
+                .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('Sort keys')),
+            .nonempty()
+            .describe('Sort keys'),
     }),
     ADD_FILTER: z.object({
-        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')),
+        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'),
     }),
     REMOVE_FILTER: z.object({
         assortmentFilterId: z
             .string()
-            .check(z.minLength(1), z.describe('Assortment Filter ID (from assortment filter relationship)')),
+            .min(1)
+            .describe('Assortment Filter ID (from assortment filter relationship)'),
     }),
     GET_FILTERS: z.object({
-        assortmentId: z.string().check(z.minLength(1), z.describe('Assortment ID')),
+        assortmentId: z.string().min(1).describe('Assortment ID'),
     }),
     REORDER_FILTERS: z.object({
         sortKeys: z
             .array(z.object({
             assortmentFilterId: z
                 .string()
-                .check(z.minLength(1), z.describe('Assortment filter ID (from assortment filter relationship)')),
-            sortKey: z.int().check(z.describe('New sort position')),
+                .min(1)
+                .describe('Assortment filter ID (from assortment filter relationship)'),
+            sortKey: z.number().int().describe('New sort position'),
         }))
-            .check(z.minLength(1), z.describe('Sort keys')),
+            .nonempty()
+            .describe('Sort keys'),
     }),
     ADD_LINK: z.object({
-        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')),
+        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'),
     }),
     REMOVE_LINK: z.object({
-        assortmentLinkId: z.string().check(z.minLength(1), z.describe('Assortment link ID')),
+        assortmentLinkId: z.string().min(1).describe('Assortment link ID'),
     }),
     GET_LINKS: z.object({
-        assortmentId: z.string().check(z.minLength(1), z.describe('Assortment ID')),
+        assortmentId: z.string().min(1).describe('Assortment ID'),
     }),
     REORDER_LINKS: z.object({
         sortKeys: z
             .array(z.object({
-            assortmentLinkId: z.string().check(z.minLength(1), z.describe('Assortment link ID')),
-            sortKey: z.int().check(z.describe('New sort position')),
+            assortmentLinkId: z.string().min(1).describe('Assortment link ID'),
+            sortKey: z.number().int().describe('New sort position'),
         }))
-            .check(z.minLength(1), z.describe('Sort keys')),
+            .nonempty()
+            .describe('Sort keys'),
     }),
     GET_CHILDREN: z.object({
-        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')),
+        assortmentId: z.string().min(1).describe('Assortment ID (optional for root-level)'),
+        includeInactive: z.boolean().optional().describe('Include inactive children'),
     }),
     SEARCH_PRODUCTS: z.object({
-        assortmentId: z.string().check(z.minLength(1), z.describe('Assortment ID')),
+        assortmentId: z.string().min(1).describe('Assortment ID'),
         ...PaginationSchema,
         ...SearchSchema,
     }),
     GET_TEXTS: z.object({
-        assortmentId: z.string().check(z.minLength(1), z.describe('Assortment ID')),
+        assortmentId: z.string().min(1).describe('Assortment ID'),
     }),
     GET_MEDIA_TEXTS: z.object({
-        assortmentMediaId: z.string().check(z.minLength(1), z.describe('Assortment media ID')),
+        assortmentMediaId: z.string().min(1).describe('Assortment media ID'),
     }),
 };
-export const AssortmentManagementSchema = createManagementSchemaFromValidators(actionValidators);
+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);

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

@@ -1,6 +1,6 @@
 import type { Context } from '../../../context.ts';
-import { FilterManagementSchema, type FilterManagementParams } from './schemas.ts';
-export { FilterManagementSchema };
+import { FilterManagementSchema, FilterManagementZodSchema, type FilterManagementParams } from './schemas.ts';
+export { FilterManagementSchema, FilterManagementZodSchema };
 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, } from "./schemas.js";
+import { actionValidators, FilterManagementSchema, FilterManagementZodSchema, } from "./schemas.js";
 import actionHandlers from "./handlers/index.js";
 import { createMcpResponse, createMcpErrorResponse } from "../../utils/sharedSchemas.js";
-export { FilterManagementSchema };
+export { FilterManagementSchema, FilterManagementZodSchema };
 export async function filterManagement(context, params) {
     const { action, ...actionParams } = params;
     log('MCP handler filterManagement ', { userId: context.userId, params });