@unchainedshop/api 4.0.0-rc.2 → 4.0.0-rc.21

package/lib/mcp/tools/order/schemas.d.ts

@@ -0,0 +1,384 @@
+import { z } from 'zod';
+export declare const OrderStatusEnum: z.ZodEnum<["PENDING", "CONFIRMED", "SHIPPED", "DELIVERED", "CANCELLED"]>;
+export declare const PaymentProviderTypeEnum: z.ZodEnum<["CARD", "INVOICE", "GENERIC"]>;
+export declare const DeliveryProviderTypeEnum: z.ZodEnum<["PICKUP", "SHIPPING", "LOCAL"]>;
+export declare const SortDirectionEnum: z.ZodEnum<["ASC", "DESC"]>;
+export declare const SortOptionInput: z.ZodObject<{
+    key: z.ZodString;
+    value: z.ZodEnum<["ASC", "DESC"]>;
+}, "strict", z.ZodTypeAny, {
+    key: string;
+    value: "ASC" | "DESC";
+}, {
+    key: string;
+    value: "ASC" | "DESC";
+}>;
+export declare const DateFilterInput: z.ZodObject<{
+    from: z.ZodOptional<z.ZodString>;
+    to: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    from?: string | undefined;
+    to?: string | undefined;
+}, {
+    from?: string | undefined;
+    to?: string | undefined;
+}>;
+export declare const actionValidators: {
+    readonly LIST: z.ZodObject<{
+        includeCarts: z.ZodOptional<z.ZodBoolean>;
+        paymentProviderTypes: z.ZodOptional<z.ZodArray<z.ZodEnum<["CARD", "INVOICE", "GENERIC"]>, "many">>;
+        deliveryProviderTypes: z.ZodOptional<z.ZodArray<z.ZodEnum<["PICKUP", "SHIPPING", "LOCAL"]>, "many">>;
+        dateRange: z.ZodOptional<z.ZodObject<{
+            from: z.ZodOptional<z.ZodString>;
+            to: z.ZodOptional<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            from?: string | undefined;
+            to?: string | undefined;
+        }, {
+            from?: string | undefined;
+            to?: string | undefined;
+        }>>;
+        paymentProviderIds: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        deliveryProviderIds: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        status: z.ZodOptional<z.ZodArray<z.ZodEnum<["PENDING", "CONFIRMED", "SHIPPED", "DELIVERED", "CANCELLED"]>, "many">>;
+        queryString: z.ZodOptional<z.ZodString>;
+        includeInactive: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+        sort: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            key: z.ZodString;
+            value: z.ZodEnum<[string, ...string[]]>;
+        }, "strip", z.ZodTypeAny, {
+            key: string;
+            value: string;
+        }, {
+            key: string;
+            value: string;
+        }>, "many">>;
+        limit: z.ZodOptional<z.ZodNumber>;
+        offset: z.ZodOptional<z.ZodNumber>;
+    }, "strip", z.ZodTypeAny, {
+        includeInactive: boolean;
+        sort?: {
+            key: string;
+            value: string;
+        }[] | undefined;
+        status?: ("PENDING" | "CONFIRMED" | "SHIPPED" | "DELIVERED" | "CANCELLED")[] | undefined;
+        queryString?: string | undefined;
+        limit?: number | undefined;
+        offset?: number | undefined;
+        paymentProviderIds?: string[] | undefined;
+        deliveryProviderIds?: string[] | undefined;
+        includeCarts?: boolean | undefined;
+        dateRange?: {
+            from?: string | undefined;
+            to?: string | undefined;
+        } | undefined;
+        paymentProviderTypes?: ("INVOICE" | "CARD" | "GENERIC")[] | undefined;
+        deliveryProviderTypes?: ("SHIPPING" | "PICKUP" | "LOCAL")[] | undefined;
+    }, {
+        sort?: {
+            key: string;
+            value: string;
+        }[] | undefined;
+        status?: ("PENDING" | "CONFIRMED" | "SHIPPED" | "DELIVERED" | "CANCELLED")[] | undefined;
+        includeInactive?: boolean | undefined;
+        queryString?: string | undefined;
+        limit?: number | undefined;
+        offset?: number | undefined;
+        paymentProviderIds?: string[] | undefined;
+        deliveryProviderIds?: string[] | undefined;
+        includeCarts?: boolean | undefined;
+        dateRange?: {
+            from?: string | undefined;
+            to?: string | undefined;
+        } | undefined;
+        paymentProviderTypes?: ("INVOICE" | "CARD" | "GENERIC")[] | undefined;
+        deliveryProviderTypes?: ("SHIPPING" | "PICKUP" | "LOCAL")[] | undefined;
+    }>;
+    readonly SALES_SUMMARY: z.ZodObject<{
+        days: z.ZodOptional<z.ZodNumber>;
+        paymentProviderIds: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        deliveryProviderIds: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        status: z.ZodOptional<z.ZodArray<z.ZodEnum<["PENDING", "CONFIRMED", "SHIPPED", "DELIVERED", "CANCELLED"]>, "many">>;
+        from: z.ZodOptional<z.ZodString>;
+        to: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        status?: ("PENDING" | "CONFIRMED" | "SHIPPED" | "DELIVERED" | "CANCELLED")[] | undefined;
+        paymentProviderIds?: string[] | undefined;
+        deliveryProviderIds?: string[] | undefined;
+        from?: string | undefined;
+        to?: string | undefined;
+        days?: number | undefined;
+    }, {
+        status?: ("PENDING" | "CONFIRMED" | "SHIPPED" | "DELIVERED" | "CANCELLED")[] | undefined;
+        paymentProviderIds?: string[] | undefined;
+        deliveryProviderIds?: string[] | undefined;
+        from?: string | undefined;
+        to?: string | undefined;
+        days?: number | undefined;
+    }>;
+    readonly MONTHLY_BREAKDOWN: z.ZodObject<{
+        paymentProviderIds: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        deliveryProviderIds: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        status: z.ZodOptional<z.ZodArray<z.ZodEnum<["PENDING", "CONFIRMED", "SHIPPED", "DELIVERED", "CANCELLED"]>, "many">>;
+        from: z.ZodOptional<z.ZodString>;
+        to: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        status?: ("PENDING" | "CONFIRMED" | "SHIPPED" | "DELIVERED" | "CANCELLED")[] | undefined;
+        paymentProviderIds?: string[] | undefined;
+        deliveryProviderIds?: string[] | undefined;
+        from?: string | undefined;
+        to?: string | undefined;
+    }, {
+        status?: ("PENDING" | "CONFIRMED" | "SHIPPED" | "DELIVERED" | "CANCELLED")[] | undefined;
+        paymentProviderIds?: string[] | undefined;
+        deliveryProviderIds?: string[] | undefined;
+        from?: string | undefined;
+        to?: string | undefined;
+    }>;
+    readonly TOP_CUSTOMERS: z.ZodObject<{
+        customerStatus: z.ZodOptional<z.ZodString>;
+        from: z.ZodOptional<z.ZodString>;
+        to: z.ZodOptional<z.ZodString>;
+        limit: z.ZodOptional<z.ZodNumber>;
+        offset: z.ZodOptional<z.ZodNumber>;
+    }, "strip", z.ZodTypeAny, {
+        limit?: number | undefined;
+        offset?: number | undefined;
+        from?: string | undefined;
+        to?: string | undefined;
+        customerStatus?: string | undefined;
+    }, {
+        limit?: number | undefined;
+        offset?: number | undefined;
+        from?: string | undefined;
+        to?: string | undefined;
+        customerStatus?: string | undefined;
+    }>;
+    readonly TOP_PRODUCTS: z.ZodObject<{
+        from: z.ZodOptional<z.ZodString>;
+        to: z.ZodOptional<z.ZodString>;
+        limit: z.ZodOptional<z.ZodNumber>;
+        offset: z.ZodOptional<z.ZodNumber>;
+    }, "strip", z.ZodTypeAny, {
+        limit?: number | undefined;
+        offset?: number | undefined;
+        from?: string | undefined;
+        to?: string | undefined;
+    }, {
+        limit?: number | undefined;
+        offset?: number | undefined;
+        from?: string | undefined;
+        to?: string | undefined;
+    }>;
+    readonly GET_CART: z.ZodObject<{
+        userId: z.ZodString;
+        orderNumber: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        userId: string;
+        orderNumber?: string | undefined;
+    }, {
+        userId: string;
+        orderNumber?: string | undefined;
+    }>;
+    readonly GET: z.ZodEffects<z.ZodObject<{
+        orderId: z.ZodOptional<z.ZodString>;
+        orderNumber: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        orderId?: string | undefined;
+        orderNumber?: string | undefined;
+    }, {
+        orderId?: string | undefined;
+        orderNumber?: string | undefined;
+    }>, {
+        orderId?: string | undefined;
+        orderNumber?: string | undefined;
+    }, {
+        orderId?: string | undefined;
+        orderNumber?: string | undefined;
+    }>;
+    readonly PAY_ORDER: z.ZodObject<{
+        orderId: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        orderId: string;
+    }, {
+        orderId: string;
+    }>;
+    readonly DELIVER_ORDER: z.ZodObject<{
+        orderId: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        orderId: string;
+    }, {
+        orderId: string;
+    }>;
+    readonly CONFIRM_ORDER: z.ZodObject<{
+        orderId: z.ZodString;
+        paymentContext: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;
+        deliveryContext: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;
+        comment: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        orderId: string;
+        comment?: string | undefined;
+        paymentContext?: Record<string, any> | undefined;
+        deliveryContext?: Record<string, any> | undefined;
+    }, {
+        orderId: string;
+        comment?: string | undefined;
+        paymentContext?: Record<string, any> | undefined;
+        deliveryContext?: Record<string, any> | undefined;
+    }>;
+    readonly REJECT_ORDER: z.ZodObject<{
+        orderId: z.ZodString;
+        paymentContext: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;
+        deliveryContext: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;
+        comment: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        orderId: string;
+        comment?: string | undefined;
+        paymentContext?: Record<string, any> | undefined;
+        deliveryContext?: Record<string, any> | undefined;
+    }, {
+        orderId: string;
+        comment?: string | undefined;
+        paymentContext?: Record<string, any> | undefined;
+        deliveryContext?: Record<string, any> | undefined;
+    }>;
+};
+export declare const OrderManagementSchema: {
+    includeCarts: z.ZodOptional<z.ZodBoolean>;
+    paymentProviderTypes: z.ZodOptional<z.ZodArray<z.ZodEnum<["CARD", "INVOICE", "GENERIC"]>, "many">>;
+    deliveryProviderTypes: z.ZodOptional<z.ZodArray<z.ZodEnum<["PICKUP", "SHIPPING", "LOCAL"]>, "many">>;
+    dateRange: z.ZodOptional<z.ZodObject<{
+        from: z.ZodOptional<z.ZodString>;
+        to: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        from?: string | undefined;
+        to?: string | undefined;
+    }, {
+        from?: string | undefined;
+        to?: string | undefined;
+    }>>;
+    days: z.ZodOptional<z.ZodNumber>;
+    customerStatus: z.ZodOptional<z.ZodString>;
+    orderId: z.ZodOptional<z.ZodString>;
+    orderNumber: z.ZodOptional<z.ZodString>;
+    userId: z.ZodOptional<z.ZodString>;
+    paymentProviderIds: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    deliveryProviderIds: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    status: z.ZodOptional<z.ZodArray<z.ZodEnum<["PENDING", "CONFIRMED", "SHIPPED", "DELIVERED", "CANCELLED"]>, "many">>;
+    from: z.ZodOptional<z.ZodString>;
+    to: z.ZodOptional<z.ZodString>;
+    queryString: z.ZodOptional<z.ZodString>;
+    includeInactive: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+    sort: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        key: z.ZodString;
+        value: z.ZodEnum<[string, ...string[]]>;
+    }, "strip", z.ZodTypeAny, {
+        key: string;
+        value: string;
+    }, {
+        key: string;
+        value: string;
+    }>, "many">>;
+    limit: z.ZodOptional<z.ZodNumber>;
+    offset: z.ZodOptional<z.ZodNumber>;
+    action: z.ZodEnum<["LIST", "SALES_SUMMARY", "MONTHLY_BREAKDOWN", "TOP_CUSTOMERS", "TOP_PRODUCTS", "GET_CART", "GET", "PAY_ORDER", "DELIVER_ORDER", "CONFIRM_ORDER", "REJECT_ORDER"]>;
+};
+export declare const OrderManagementZodSchema: z.ZodObject<{
+    includeCarts: z.ZodOptional<z.ZodBoolean>;
+    paymentProviderTypes: z.ZodOptional<z.ZodArray<z.ZodEnum<["CARD", "INVOICE", "GENERIC"]>, "many">>;
+    deliveryProviderTypes: z.ZodOptional<z.ZodArray<z.ZodEnum<["PICKUP", "SHIPPING", "LOCAL"]>, "many">>;
+    dateRange: z.ZodOptional<z.ZodObject<{
+        from: z.ZodOptional<z.ZodString>;
+        to: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        from?: string | undefined;
+        to?: string | undefined;
+    }, {
+        from?: string | undefined;
+        to?: string | undefined;
+    }>>;
+    days: z.ZodOptional<z.ZodNumber>;
+    customerStatus: z.ZodOptional<z.ZodString>;
+    orderId: z.ZodOptional<z.ZodString>;
+    orderNumber: z.ZodOptional<z.ZodString>;
+    userId: z.ZodOptional<z.ZodString>;
+    paymentProviderIds: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    deliveryProviderIds: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    status: z.ZodOptional<z.ZodArray<z.ZodEnum<["PENDING", "CONFIRMED", "SHIPPED", "DELIVERED", "CANCELLED"]>, "many">>;
+    from: z.ZodOptional<z.ZodString>;
+    to: z.ZodOptional<z.ZodString>;
+    queryString: z.ZodOptional<z.ZodString>;
+    includeInactive: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+    sort: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        key: z.ZodString;
+        value: z.ZodEnum<[string, ...string[]]>;
+    }, "strip", z.ZodTypeAny, {
+        key: string;
+        value: string;
+    }, {
+        key: string;
+        value: string;
+    }>, "many">>;
+    limit: z.ZodOptional<z.ZodNumber>;
+    offset: z.ZodOptional<z.ZodNumber>;
+    action: z.ZodEnum<["LIST", "SALES_SUMMARY", "MONTHLY_BREAKDOWN", "TOP_CUSTOMERS", "TOP_PRODUCTS", "GET_CART", "GET", "PAY_ORDER", "DELIVER_ORDER", "CONFIRM_ORDER", "REJECT_ORDER"]>;
+}, "strip", z.ZodTypeAny, {
+    includeInactive: boolean;
+    action: "GET" | "LIST" | "SALES_SUMMARY" | "MONTHLY_BREAKDOWN" | "TOP_CUSTOMERS" | "TOP_PRODUCTS" | "GET_CART" | "PAY_ORDER" | "DELIVER_ORDER" | "CONFIRM_ORDER" | "REJECT_ORDER";
+    sort?: {
+        key: string;
+        value: string;
+    }[] | undefined;
+    status?: ("PENDING" | "CONFIRMED" | "SHIPPED" | "DELIVERED" | "CANCELLED")[] | undefined;
+    userId?: string | undefined;
+    orderId?: string | undefined;
+    orderNumber?: string | undefined;
+    queryString?: string | undefined;
+    limit?: number | undefined;
+    offset?: number | undefined;
+    paymentProviderIds?: string[] | undefined;
+    deliveryProviderIds?: string[] | undefined;
+    includeCarts?: boolean | undefined;
+    dateRange?: {
+        from?: string | undefined;
+        to?: string | undefined;
+    } | undefined;
+    from?: string | undefined;
+    to?: string | undefined;
+    paymentProviderTypes?: ("INVOICE" | "CARD" | "GENERIC")[] | undefined;
+    deliveryProviderTypes?: ("SHIPPING" | "PICKUP" | "LOCAL")[] | undefined;
+    days?: number | undefined;
+    customerStatus?: string | undefined;
+}, {
+    action: "GET" | "LIST" | "SALES_SUMMARY" | "MONTHLY_BREAKDOWN" | "TOP_CUSTOMERS" | "TOP_PRODUCTS" | "GET_CART" | "PAY_ORDER" | "DELIVER_ORDER" | "CONFIRM_ORDER" | "REJECT_ORDER";
+    sort?: {
+        key: string;
+        value: string;
+    }[] | undefined;
+    status?: ("PENDING" | "CONFIRMED" | "SHIPPED" | "DELIVERED" | "CANCELLED")[] | undefined;
+    includeInactive?: boolean | undefined;
+    userId?: string | undefined;
+    orderId?: string | undefined;
+    orderNumber?: string | undefined;
+    queryString?: string | undefined;
+    limit?: number | undefined;
+    offset?: number | undefined;
+    paymentProviderIds?: string[] | undefined;
+    deliveryProviderIds?: string[] | undefined;
+    includeCarts?: boolean | undefined;
+    dateRange?: {
+        from?: string | undefined;
+        to?: string | undefined;
+    } | undefined;
+    from?: string | undefined;
+    to?: string | undefined;
+    paymentProviderTypes?: ("INVOICE" | "CARD" | "GENERIC")[] | undefined;
+    deliveryProviderTypes?: ("SHIPPING" | "PICKUP" | "LOCAL")[] | undefined;
+    days?: number | undefined;
+    customerStatus?: string | undefined;
+}>;
+export type OrderManagementParams = z.infer<typeof OrderManagementZodSchema>;
+export type ActionName = keyof typeof actionValidators;
+export type Params<T extends ActionName> = z.infer<(typeof actionValidators)[T]>;
+export type Handler<T extends ActionName> = (orderModule: any, params: Params<T>) => Promise<unknown>;
+//# sourceMappingURL=schemas.d.ts.map

package/lib/mcp/tools/order/schemas.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schemas.d.ts","sourceRoot":"","sources":["../../../../src/mcp/tools/order/schemas.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AASxB,eAAO,MAAM,eAAe,0EAAwE,CAAC;AACrG,eAAO,MAAM,uBAAuB,2CAAyC,CAAC;AAC9E,eAAO,MAAM,wBAAwB,4CAA0C,CAAC;AAChF,eAAO,MAAM,iBAAiB,4BAA0B,CAAC;AAEzD,eAAO,MAAM,eAAe;;;;;;;;;EAKjB,CAAC;AAEZ,eAAO,MAAM,eAAe;;;;;;;;;EAA4B,CAAC;AAEzD,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAgJnB,CAAC;AAEX,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAsDjC,CAAC;AAEF,eAAO,MAAM,wBAAwB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAAkC,CAAC;AACxE,MAAM,MAAM,qBAAqB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAC;AAE7E,MAAM,MAAM,UAAU,GAAG,MAAM,OAAO,gBAAgB,CAAC;AACvD,MAAM,MAAM,MAAM,CAAC,CAAC,SAAS,UAAU,IAAI,CAAC,CAAC,KAAK,CAAC,CAAC,OAAO,gBAAgB,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AACjF,MAAM,MAAM,OAAO,CAAC,CAAC,SAAS,UAAU,IAAI,CAAC,WAAW,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC"}

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

@@ -0,0 +1,197 @@
+import { z } from 'zod';
+import { PaginationSchema, SortingSchema, SearchSchema, DateRangeSchema, OrderFilterSchema, } from '../../utils/sharedSchemas.js';
+export const OrderStatusEnum = z.enum(['PENDING', 'CONFIRMED', 'SHIPPED', 'DELIVERED', 'CANCELLED']);
+export const PaymentProviderTypeEnum = z.enum(['CARD', 'INVOICE', 'GENERIC']);
+export const DeliveryProviderTypeEnum = z.enum(['PICKUP', 'SHIPPING', 'LOCAL']);
+export const SortDirectionEnum = z.enum(['ASC', 'DESC']);
+export const SortOptionInput = z
+    .object({
+    key: z.string().min(1).describe('Field to sort by'),
+    value: SortDirectionEnum.describe('Sort direction'),
+})
+    .strict();
+export const DateFilterInput = z.object(DateRangeSchema);
+export const actionValidators = {
+    LIST: z.object({
+        ...PaginationSchema,
+        ...SortingSchema,
+        ...SearchSchema,
+        ...OrderFilterSchema,
+        includeCarts: z.boolean().optional().describe('Include cart orders in results'),
+        paymentProviderTypes: z
+            .array(PaymentProviderTypeEnum)
+            .optional()
+            .describe('Filter by payment provider types'),
+        deliveryProviderTypes: z
+            .array(DeliveryProviderTypeEnum)
+            .optional()
+            .describe('Filter by delivery provider types'),
+        dateRange: DateFilterInput.optional().describe('Date range filter'),
+    }),
+    SALES_SUMMARY: z.object({
+        ...DateRangeSchema,
+        ...OrderFilterSchema,
+        days: z
+            .number()
+            .int()
+            .min(1)
+            .max(365)
+            .optional()
+            .describe('Number of days for daily breakdown (default: 30)'),
+    }),
+    MONTHLY_BREAKDOWN: z.object({
+        ...DateRangeSchema,
+        ...OrderFilterSchema,
+    }),
+    TOP_CUSTOMERS: z.object({
+        ...PaginationSchema,
+        ...DateRangeSchema,
+        customerStatus: z.string().optional().describe('Order status for customer analysis'),
+    }),
+    TOP_PRODUCTS: z.object({
+        ...PaginationSchema,
+        ...DateRangeSchema,
+    }),
+    GET_CART: z.object({
+        userId: z.string().describe('User ID to get cart for'),
+        orderNumber: z.string().optional().describe('Optional orderNumber if known to get user cart'),
+    }),
+    GET: z
+        .object({
+        orderId: z.string().optional().describe('Order ID of the order'),
+        orderNumber: z.string().optional().describe('Optional orderNumber if known to get user cart'),
+    })
+        .superRefine((data, ctx) => {
+        if (!data?.orderId && !data?.orderNumber) {
+            ctx.addIssue({
+                code: z.ZodIssueCode.custom,
+                message: 'Either orderId or orderNumber is required',
+                path: ['GET'],
+            });
+        }
+    }),
+    PAY_ORDER: z
+        .object({
+        orderId: z
+            .string({
+            required_error: 'orderId is required to pay an order',
+            invalid_type_error: 'orderId must be a string',
+        })
+            .min(1, 'orderId cannot be empty')
+            .describe('The unique identifier of the order to mark as PAID'),
+    })
+        .describe("This operation is used for manually marking an order's payment as PAID. " +
+        'The following conditions must be met:\n' +
+        '- The order must already exist and must not be in OPEN (cart) status.\n' +
+        '- The order must have a valid payment record.\n' +
+        '- The payment status of the order must currently be OPEN.\n' +
+        'If these conditions are not met, an appropriate error will be thrown.'),
+    DELIVER_ORDER: z
+        .object({
+        orderId: z
+            .string({
+            required_error: 'orderId is required to mark an order as delivered',
+            invalid_type_error: 'orderId must be a string',
+        })
+            .min(1, 'orderId cannot be empty')
+            .describe('The unique identifier of the order to mark as DELIVERED'),
+    })
+        .describe("This operation is used for manually marking an order's delivery as DELIVERED. " +
+        'The following conditions must be met:\n' +
+        '- The order must exist and must not be in OPEN (cart) status.\n' +
+        '- The order must have a valid delivery record.\n' +
+        '- The delivery status of the order must currently be OPEN, if the order is confirmed.\n' +
+        'If these conditions are not satisfied, an appropriate error will be thrown.'),
+    CONFIRM_ORDER: z
+        .object({
+        orderId: z.string({ required_error: 'orderId is required' }).min(1, 'orderId cannot be empty'),
+        paymentContext: z
+            .record(z.any())
+            .optional()
+            .describe('Optional JSON context related to payment (e.g., transaction details).'),
+        deliveryContext: z
+            .record(z.any())
+            .optional()
+            .describe('Optional JSON context related to delivery (e.g., shipping info).'),
+        comment: z
+            .string()
+            .optional()
+            .describe('Optional comment or note to attach to the order confirmation.'),
+    })
+        .describe('Confirms an order. Requirements:\n' +
+        '- The order must exist.\n' +
+        '- The order status must be PENDING.\n' +
+        '- paymentContext, deliveryContext, and comment are optional additional inputs.'),
+    REJECT_ORDER: z
+        .object({
+        orderId: z
+            .string({ required_error: 'orderId is required' })
+            .min(1, 'orderId cannot be empty')
+            .describe('The unique identifier of the order to reject.'),
+        paymentContext: z
+            .record(z.any())
+            .optional()
+            .describe('Optional JSON context related to payment, e.g., transaction adjustments.'),
+        deliveryContext: z
+            .record(z.any())
+            .optional()
+            .describe('Optional JSON context related to delivery, e.g., shipment adjustments.'),
+        comment: z
+            .string()
+            .optional()
+            .describe('Optional comment explaining the reason for rejecting the order.'),
+    })
+        .describe('Manually rejects an order which is currently PENDING. ' +
+        'All additional properties (paymentContext, deliveryContext, comment) are forwarded to services.orders.rejectOrder.'),
+};
+export const OrderManagementSchema = {
+    action: z
+        .enum([
+        'LIST',
+        'SALES_SUMMARY',
+        'MONTHLY_BREAKDOWN',
+        'TOP_CUSTOMERS',
+        'TOP_PRODUCTS',
+        'GET_CART',
+        'GET',
+        'PAY_ORDER',
+        'DELIVER_ORDER',
+        'CONFIRM_ORDER',
+        'REJECT_ORDER',
+    ])
+        .describe('Order action: LIST (get orders with filters), SALES_SUMMARY (daily sales analytics), MONTHLY_BREAKDOWN (12-month sales analysis), TOP_CUSTOMERS (highest spending customers), TOP_PRODUCTS (best-selling products), GET_CART (user cart), GET (single order), PAY_ORDER (mark single order as PAID), DELIVER_ORDER (mark single order as DELIVERED), CONFIRM_ORDER (manually mark order as CONFIRMED), REJECT_ORDER (reject order that is in progress)'),
+    ...PaginationSchema,
+    ...SortingSchema,
+    ...SearchSchema,
+    ...DateRangeSchema,
+    ...OrderFilterSchema,
+    includeCarts: z.boolean().optional().describe('Include cart orders in results (LIST only)'),
+    paymentProviderTypes: z
+        .array(PaymentProviderTypeEnum)
+        .optional()
+        .describe('Filter by payment provider types'),
+    deliveryProviderTypes: z
+        .array(DeliveryProviderTypeEnum)
+        .optional()
+        .describe('Filter by delivery provider types'),
+    dateRange: DateFilterInput.optional().describe('Date range filter'),
+    days: z
+        .number()
+        .int()
+        .min(1)
+        .max(365)
+        .optional()
+        .describe('Number of days for daily breakdown (SALES_SUMMARY only, default: 30)'),
+    customerStatus: z
+        .string()
+        .optional()
+        .describe('Order status for customer analysis (TOP_CUSTOMERS only)'),
+    orderId: z
+        .string()
+        .optional()
+        .describe('Optional ID of order, to get user cart (GET, PAY_ORDER & DELIVERY_ORDER, CONFIRM_ORDER & REJECT_ORDER only)'),
+    orderNumber: z.string().optional().describe('Optional orderNumber oof a order (GET_CART & GET only)'),
+    userId: z.string().optional().describe('User ID to get cart for (GET_CART only)'),
+};
+export const OrderManagementZodSchema = z.object(OrderManagementSchema);
+//# sourceMappingURL=schemas.js.map

package/lib/mcp/tools/order/schemas.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schemas.js","sourceRoot":"","sources":["../../../../src/mcp/tools/order/schemas.ts"],"names":[],"mappings":"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"}

package/lib/mcp/tools/product/handlers/addBundleItem.d.ts

@@ -0,0 +1,36 @@
+import { Context } from '../../../../context.js';
+import { Params } from '../schemas.js';
+export default function addBundleItem(context: Context, params: Params<'ADD_BUNDLE_ITEM'>): Promise<{
+    product: {
+        texts: import("@unchainedshop/core-products").ProductText;
+        media: {
+            mediaId: string;
+        }[] | ({
+            file: any;
+            mediaId: string;
+        } | null)[];
+        assignments: any;
+        variations: any;
+        bundleItems: any;
+        pricing: any;
+        reviews: import("@unchainedshop/core-products").ProductReview[];
+        _id: string;
+        commerce?: import("@unchainedshop/core-products").ProductCommerce;
+        meta?: any;
+        plan?: import("@unchainedshop/core-products").ProductPlan;
+        proxy?: import("@unchainedshop/core-products").ProductProxy;
+        published?: Date;
+        sequence: number;
+        slugs: string[];
+        status?: string | null;
+        supply?: import("@unchainedshop/core-products").ProductSupply;
+        tags: string[];
+        type: string;
+        warehousing?: import("@unchainedshop/core-products").ProductWarehousing;
+        tokenization?: import("@unchainedshop/core-products").ProductTokenization;
+        created: Date;
+        updated?: Date;
+        deleted?: Date | null;
+    } | null;
+}>;
+//# sourceMappingURL=addBundleItem.d.ts.map

package/lib/mcp/tools/product/handlers/addBundleItem.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"addBundleItem.d.ts","sourceRoot":"","sources":["../../../../../src/mcp/tools/product/handlers/addBundleItem.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,wBAAwB,CAAC;AAQjD,OAAO,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC;AAEvC,wBAA8B,aAAa,CAAC,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,iBAAiB,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4B9F"}

package/lib/mcp/tools/product/handlers/addBundleItem.js

@@ -0,0 +1,30 @@
+import { ProductTypes } from '@unchainedshop/core-products';
+import { CyclicProductBundlingNotSupportedError, ProductNotFoundError, ProductWrongTypeError, } from '../../../../errors.js';
+import { getNormalizedProductDetails } from '../../../utils/getNormalizedProductDetails.js';
+export default async function addBundleItem(context, params) {
+    const { modules } = context;
+    const { bundleId, bundleProductId, quantity } = params;
+    const product = await modules.products.findProduct({ productId: bundleId });
+    if (!product)
+        throw new ProductNotFoundError({ productId: bundleId });
+    if (product.type !== ProductTypes.BundleProduct)
+        throw new ProductWrongTypeError({
+            productId: bundleId,
+            received: product.type,
+            required: ProductTypes.BundleProduct,
+        });
+    const itemProduct = await modules.products.findProduct({ productId: bundleProductId });
+    if (!itemProduct)
+        throw new ProductNotFoundError({ productId: bundleProductId });
+    if (itemProduct._id === product._id)
+        throw new CyclicProductBundlingNotSupportedError({
+            productId: itemProduct._id,
+        });
+    await modules.products.bundleItems.addBundleItem(bundleId, {
+        productId: bundleProductId,
+        quantity,
+        configuration: [],
+    });
+    return { product: await getNormalizedProductDetails(bundleId, context) };
+}
+//# sourceMappingURL=addBundleItem.js.map