@unchainedshop/api 4.8.0 → 4.8.2

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

@@ -1,261 +1,140 @@
-import { z } from 'zod';
-import { PaginationSchema, SortingSchema, SearchSchema, DateRangeSchema, } from "../../utils/sharedSchemas.js";
+import { z } from 'zod/v4-mini';
+import { PaginationSchema, SortingSchema, SearchSchema, DateRangeSchema, createManagementSchemaFromValidators, } from "../../utils/sharedSchemas.js";
 import { WorkStatus } from '@unchainedshop/core-worker';
 export const WorkStatusKeys = Object.keys(WorkStatus);
 export const ActiveWorkTypesSchema = z.object({});
 export const actionValidators = {
     SHOP_INFO: z
         .object({})
-        .describe('Get shop configuration including default locale settings. No parameters expected - returns system-wide defaults.'),
+        .check(z.describe('Get shop configuration including default locale settings. No parameters expected - returns system-wide defaults.')),
     WORKER_ADD: z.object({
         type: z
             .string()
-            .min(1)
-            .describe('Work type key that determines which worker/handler will process the job. Must match a registered worker type in the system.'),
+            .check(z.minLength(1), z.describe('Work type key that determines which worker/handler will process the job. Must match a registered worker type in the system.')),
         priority: z
-            .number()
-            .int()
-            .default(0)
-            .describe('Job priority for queue ordering. Higher values are processed first. Default is 0. Negative values allowed for lower priority.'),
+            ._default(z.int(), 0)
+            .check(z.describe('Job priority for queue ordering. Higher values are processed first. Default is 0. Negative values allowed for lower priority.')),
         input: z
-            .any()
-            .optional()
-            .describe('Arbitrary JSON payload passed to the worker. The structure depends on the work type and should be validated by the worker implementation.'),
+            .optional(z.any())
+            .check(z.describe('Arbitrary JSON payload passed to the worker. The structure depends on the work type and should be validated by the worker implementation.')),
         originalWorkId: z
-            .string()
-            .optional()
-            .describe('Reference to the original work item ID. Useful for tracking retries, parent-child relationships, or audit trails.'),
+            .optional(z.string())
+            .check(z.describe('Reference to the original work item ID. Useful for tracking retries, parent-child relationships, or audit trails.')),
         scheduled: z
-            .string()
-            .datetime()
-            .optional()
-            .describe('ISO 8601 timestamp when the job should be executed. If omitted, the job is immediately available for processing.'),
+            .optional(z.iso.datetime())
+            .check(z.describe('ISO 8601 timestamp when the job should be executed. If omitted, the job is immediately available for processing.')),
         retries: z
-            .number()
-            .int()
-            .min(0)
-            .max(1000)
-            .default(20)
-            .describe('Maximum number of retry attempts allowed for this job. Default: 20.'),
+            ._default(z.int().check(z.gte(0), z.lte(1000)), 20)
+            .check(z.describe('Maximum number of retry attempts allowed for this job. Default: 20.')),
         worker: z
-            .string()
-            .optional()
-            .describe('Specific worker identifier to assign this job to. If provided, only that worker can process this job.'),
+            .optional(z.string())
+            .check(z.describe('Specific worker identifier to assign this job to. If provided, only that worker can process this job.')),
     }),
-    WORKER_ACTIVE_WORK_TYPES: ActiveWorkTypesSchema.describe('Current active work types in the system. This includes all registered worker types that can process jobs. The list is dynamically generated based on the workers currently available. No parameters expected.'),
+    WORKER_ACTIVE_WORK_TYPES: ActiveWorkTypesSchema.check(z.describe('Current active work types in the system. This includes all registered worker types that can process jobs. The list is dynamically generated based on the workers currently available. No parameters expected.')),
     WORKER_ALLOCATE: z.object({
         types: z
-            .array(z.string())
-            .nonempty()
-            .optional()
-            .describe('Must match a registered worker type in the system,  When provided, the worker will take precedence in the queue and be allocated'),
+            .optional(z.array(z.string()).check(z.minLength(1)))
+            .check(z.describe('Must match a registered worker type in the system,  When provided, the worker will take precedence in the queue and be allocated')),
         worker: z
-            .string()
-            .optional()
-            .describe('Worker identifier that will process the allocated task. Used for tracking and locking the work item to this worker.'),
+            .optional(z.string())
+            .check(z.describe('Worker identifier that will process the allocated task. Used for tracking and locking the work item to this worker.')),
     }),
     WORKER_REMOVE: z.object({
         workId: z
             .string()
-            .describe('Unique identifier of the work item to remove from the queue. only NEW worker that is not deleted, allocated or finished'),
+            .check(z.describe('Unique identifier of the work item to remove from the queue. only NEW worker that is not deleted, allocated or finished')),
     }),
     WORKER_GET: z.object({
-        workId: z.string().min(1).describe('Unique identifier of the work item to retrieve'),
+        workId: z
+            .string()
+            .check(z.minLength(1), z.describe('Unique identifier of the work item to retrieve')),
     }),
     WORKER_LIST: z.object({
         ...PaginationSchema,
         ...SortingSchema,
         ...SearchSchema,
         created: z
-            .object(DateRangeSchema)
-            .optional()
-            .describe('Date range filter for when work items were created'),
+            .optional(z.object(DateRangeSchema))
+            .check(z.describe('Date range filter for when work items were created')),
         status: z
-            .array(z.enum(WorkStatusKeys))
-            .optional()
-            .describe('Filter by work item status (NEW, ALLOCATED, SUCCESS, FAILED, DELETED)'),
-        types: z.array(z.string()).optional().describe('Filter by specific work types'),
+            .optional(z.array(z.enum(WorkStatusKeys)))
+            .check(z.describe('Filter by work item status (NEW, ALLOCATED, SUCCESS, FAILED, DELETED)')),
+        types: z.optional(z.array(z.string())).check(z.describe('Filter by specific work types')),
     }),
     WORKER_COUNT: z.object({
         ...SearchSchema,
         created: z
-            .object(DateRangeSchema)
-            .optional()
-            .describe('Date range filter for when work items were created'),
+            .optional(z.object(DateRangeSchema))
+            .check(z.describe('Date range filter for when work items were created')),
         status: z
-            .array(z.enum(WorkStatusKeys))
-            .optional()
-            .describe('Filter by work item status (NEW, ALLOCATED, SUCCESS, FAILED, DELETED)'),
-        types: z.array(z.string()).optional().describe('Filter by specific work types'),
+            .optional(z.array(z.enum(WorkStatusKeys)))
+            .check(z.describe('Filter by work item status (NEW, ALLOCATED, SUCCESS, FAILED, DELETED)')),
+        types: z.optional(z.array(z.string())).check(z.describe('Filter by specific work types')),
     }),
     WORKER_FINISH_WORK: z.object({
-        workId: z.string().describe('Unique identifier of the work item to mark as completed.'),
+        workId: z.string().check(z.describe('Unique identifier of the work item to mark as completed.')),
         result: z
-            .any()
-            .optional()
-            .describe('JSON result data produced by the work execution. Can be any valid JSON value.'),
+            .optional(z.any())
+            .check(z.describe('JSON result data produced by the work execution. Can be any valid JSON value.')),
         error: z
-            .any()
-            .optional()
-            .describe('Error information if the work failed. Can be an error message, stack trace, or error object.'),
+            .optional(z.any())
+            .check(z.describe('Error information if the work failed. Can be an error message, stack trace, or error object.')),
         success: z
             .boolean()
-            .describe('Whether the work completed successfully. Required to mark work as finished.'),
+            .check(z.describe('Whether the work completed successfully. Required to mark work as finished.')),
         worker: z
-            .string()
-            .optional()
-            .describe('Identifier of the worker that completed the task. Used for logging and tracking purposes.'),
+            .optional(z.string())
+            .check(z.describe('Identifier of the worker that completed the task. Used for logging and tracking purposes.')),
         started: z
-            .string()
-            .datetime()
-            .optional()
-            .describe('ISO 8601 timestamp when the worker began executing this work item.'),
+            .optional(z.iso.datetime())
+            .check(z.describe('ISO 8601 timestamp when the worker began executing this work item.')),
         finished: z
-            .string()
-            .datetime()
-            .optional()
-            .describe('ISO 8601 timestamp when the work execution completed (success or failure).'),
+            .optional(z.iso.datetime())
+            .check(z.describe('ISO 8601 timestamp when the work execution completed (success or failure).')),
     }),
     WORKER_PROCESS_NEXT: z.object({
         worker: z
-            .string()
-            .optional()
-            .describe('Worker identifier for task allocation. If provided, assigns the next available task to this specific worker.'),
+            .optional(z.string())
+            .check(z.describe('Worker identifier for task allocation. If provided, assigns the next available task to this specific worker.')),
     }),
     WORKER_STATISTICS: z.object({
-        types: z.array(z.string()).optional().describe('Filter statistics by specific work types'),
-        dateRange: z.object(DateRangeSchema).optional().describe('Date range to filter work statistics'),
+        types: z.optional(z.array(z.string())).check(z.describe('Filter statistics by specific work types')),
+        dateRange: z
+            .optional(z.object(DateRangeSchema))
+            .check(z.describe('Date range to filter work statistics')),
     }),
     EVENT_GET: z.object({
         eventId: z
             .string()
-            .min(1)
-            .describe('Unique identifier of the event to retrieve from the event history'),
+            .check(z.minLength(1), z.describe('Unique identifier of the event to retrieve from the event history')),
     }),
     EVENT_LIST: z.object({
         ...PaginationSchema,
         ...SortingSchema,
         ...SearchSchema,
         types: z
-            .array(z.string())
-            .optional()
-            .describe('Filter events by specific event types (e.g., USER_CREATED, ORDER_PLACED)'),
+            .optional(z.array(z.string()))
+            .check(z.describe('Filter events by specific event types (e.g., USER_CREATED, ORDER_PLACED)')),
         created: z
-            .object(DateRangeSchema)
-            .optional()
-            .describe('Date range filter for when events are emitted/created'),
+            .optional(z.object(DateRangeSchema))
+            .check(z.describe('Date range filter for when events are emitted/created')),
     }),
     EVENT_COUNT: z.object({
         ...SearchSchema,
         types: z
-            .array(z.string())
-            .optional()
-            .describe('Filter events by specific event types (e.g., USER_CREATED, ORDER_PLACED)'),
+            .optional(z.array(z.string()))
+            .check(z.describe('Filter events by specific event types (e.g., USER_CREATED, ORDER_PLACED)')),
         created: z
-            .object(DateRangeSchema)
-            .optional()
-            .describe('Date range filter for when events are emitted/created'),
+            .optional(z.object(DateRangeSchema))
+            .check(z.describe('Date range filter for when events are emitted/created')),
     }),
     EVENT_STATISTICS: z.object({
         types: z
-            .array(z.string())
-            .optional()
-            .describe('Filter statistics by specific event types. If not provided, includes all event types'),
+            .optional(z.array(z.string()))
+            .check(z.describe('Filter statistics by specific event types. If not provided, includes all event types')),
         dateRange: z
-            .object(DateRangeSchema)
-            .optional()
-            .describe('Date range to filter event statistics. Includes start and/or end dates'),
+            .optional(z.object(DateRangeSchema))
+            .check(z.describe('Date range to filter event statistics. Includes start and/or end dates')),
     }),
 };
-export const SystemManagementSchema = {
-    action: z
-        .enum([
-        'SHOP_INFO',
-        'WORKER_ADD',
-        'WORKER_REMOVE',
-        'WORKER_COUNT',
-        'WORKER_GET',
-        'WORKER_LIST',
-        'WORKER_STATISTICS',
-        'WORKER_PROCESS_NEXT',
-        'WORKER_ALLOCATE',
-        'WORKER_FINISH_WORK',
-        'WORKER_ACTIVE_WORK_TYPES',
-        'EVENT_GET',
-        'EVENT_LIST',
-        'EVENT_COUNT',
-        'EVENT_STATISTICS',
-    ])
-        .describe('Action to perform on the system. System actions: SHOP_INFO (get shop configuration). Worker actions: WORKER_ADD (add work), WORKER_ALLOCATE (assign work), WORKER_REMOVE (delete work), WORKER_GET (retrieve work), WORKER_LIST (search work), WORKER_COUNT (count work), WORKER_FINISH_WORK (complete work), WORKER_PROCESS_NEXT (get next work), WORKER_STATISTICS (work stats), WORKER_ACTIVE_WORK_TYPES (get active work types). Event actions: EVENT_GET (retrieve event), EVENT_LIST (search events), EVENT_COUNT (count events), EVENT_STATISTICS (event stats).'),
-    type: z
-        .string()
-        .min(1)
-        .optional()
-        .describe('Work type key for WORKER_ADD action. Determines which worker/handler will process the job.'),
-    priority: z
-        .number()
-        .int()
-        .optional()
-        .describe('Job priority for WORKER_ADD action. Higher values processed first. Default: 0.'),
-    originalWorkId: z
-        .string()
-        .optional()
-        .describe('Reference to original work item ID for WORKER_ADD action. For tracking retries/relationships.'),
-    scheduled: z
-        .string()
-        .datetime()
-        .optional()
-        .describe('ISO 8601 timestamp for WORKER_ADD action. When job should be executed.'),
-    retries: z
-        .number()
-        .int()
-        .optional()
-        .describe('Maximum retry attempts for WORKER_ADD action. Default: 20.'),
-    worker: z
-        .string()
-        .optional()
-        .describe('Worker identifier. Used in WORKER_ADD, WORKER_ALLOCATE, WORKER_FINISH_WORK, WORKER_PROCESS_NEXT actions.'),
-    workId: z
-        .string()
-        .optional()
-        .describe('Unique work identifier. Required for WORKER_GET, WORKER_REMOVE, WORKER_FINISH_WORK actions.'),
-    success: z
-        .boolean()
-        .optional()
-        .describe('Success status for WORKER_FINISH_WORK action. Required to mark work as finished.'),
-    started: z
-        .string()
-        .datetime()
-        .optional()
-        .describe('ISO 8601 start timestamp for WORKER_FINISH_WORK action. When worker began execution.'),
-    finished: z
-        .string()
-        .datetime()
-        .optional()
-        .describe('ISO 8601 finish timestamp for WORKER_FINISH_WORK action. When work completed.'),
-    status: z
-        .array(z.enum(WorkStatusKeys))
-        .optional()
-        .describe('Status filter for WORKER_LIST/WORKER_COUNT actions. Work item statuses to include.'),
-    eventId: z
-        .string()
-        .optional()
-        .describe('Unique event identifier. Required for EVENT_GET action to retrieve a specific event.'),
-    created: z
-        .string()
-        .datetime()
-        .optional()
-        .describe('ISO 8601 timestamp filter for EVENT_LIST/EVENT_COUNT actions. Shows events created on or after this date/time.'),
-    types: z
-        .array(z.string())
-        .optional()
-        .describe('Filter by specific types. For worker actions: use in WORKER_LIST, WORKER_ALLOCATE work types. For event actions: event types (e.g., USER_CREATED, ORDER_PLACED).'),
-    ...PaginationSchema,
-    ...SortingSchema,
-    ...SearchSchema,
-    dateRange: z
-        .object(DateRangeSchema)
-        .optional()
-        .describe('Date range filter for WORKER_STATISTICS/EVENT_STATISTICS actions. Filter statistics by date range.'),
-};
-export const SystemManagementZodSchema = z.object(SystemManagementSchema);
+export const SystemManagementSchema = createManagementSchemaFromValidators(actionValidators);

package/lib/mcp/tools/system/systemManagement.d.ts

@@ -6,5 +6,5 @@ export declare function systemManagement(context: Context, params: SystemManagem
         text: string;
     }[];
 }>;
-export { SystemManagementSchema, SystemManagementZodSchema } from './schemas.ts';
+export { SystemManagementSchema } from './schemas.ts';
 export type { SystemManagementParams } from './schemas.ts';

package/lib/mcp/tools/system/systemManagement.js

@@ -20,4 +20,4 @@ export async function systemManagement(context, params) {
         return createMcpErrorResponse(action, error);
     }
 }
-export { SystemManagementSchema, SystemManagementZodSchema } from "./schemas.js";
+export { SystemManagementSchema } from "./schemas.js";