ebay-mcp 1.4.3

package/build/utils/communication/feedback.d.ts

@@ -0,0 +1,152 @@
+import { z } from 'zod';
+/**
+ * Schema for getAwaitingFeedback method
+ * Endpoint: GET /awaiting_feedback
+ * Params: GetAwaitingFeedbackParams - filter, limit, offset, sort
+ */
+export declare const getAwaitingFeedbackSchema: z.ZodObject<{
+    filter: z.ZodOptional<z.ZodString>;
+    limit: z.ZodOptional<z.ZodString>;
+    offset: z.ZodOptional<z.ZodString>;
+    sort: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    sort?: string | undefined;
+    filter?: string | undefined;
+    limit?: string | undefined;
+    offset?: string | undefined;
+}, {
+    sort?: string | undefined;
+    filter?: string | undefined;
+    limit?: string | undefined;
+    offset?: string | undefined;
+}>;
+/**
+ * Schema for getFeedback method
+ * Endpoint: GET /feedback
+ * Params: GetFeedbackParams - user_id (required), feedback_type (required), feedback_id, filter, limit, listing_id, offset, order_line_item_id, sort, transaction_id
+ */
+export declare const getFeedbackSchema: z.ZodObject<{
+    user_id: z.ZodString;
+    feedback_type: z.ZodString;
+    feedback_id: z.ZodOptional<z.ZodString>;
+    filter: z.ZodOptional<z.ZodString>;
+    limit: z.ZodOptional<z.ZodString>;
+    listing_id: z.ZodOptional<z.ZodString>;
+    offset: z.ZodOptional<z.ZodString>;
+    order_line_item_id: z.ZodOptional<z.ZodString>;
+    sort: z.ZodOptional<z.ZodString>;
+    transaction_id: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    user_id: string;
+    feedback_type: string;
+    sort?: string | undefined;
+    filter?: string | undefined;
+    limit?: string | undefined;
+    offset?: string | undefined;
+    transaction_id?: string | undefined;
+    listing_id?: string | undefined;
+    feedback_id?: string | undefined;
+    order_line_item_id?: string | undefined;
+}, {
+    user_id: string;
+    feedback_type: string;
+    sort?: string | undefined;
+    filter?: string | undefined;
+    limit?: string | undefined;
+    offset?: string | undefined;
+    transaction_id?: string | undefined;
+    listing_id?: string | undefined;
+    feedback_id?: string | undefined;
+    order_line_item_id?: string | undefined;
+}>;
+/**
+ * Schema for getFeedbackRatingSummary method
+ * Endpoint: GET /feedback_rating_summary
+ * Params: GetFeedbackRatingSummaryParams - user_id (required), filter (required)
+ */
+export declare const getFeedbackRatingSummarySchema: z.ZodObject<{
+    user_id: z.ZodString;
+    filter: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    filter: string;
+    user_id: string;
+}, {
+    filter: string;
+    user_id: string;
+}>;
+/**
+ * Schema for leaveFeedbackForBuyer method
+ * Endpoint: POST /feedback
+ * Body: LeaveFeedbackRequest - commentText, commentType, images, listingId, orderLineItemId, sellerRatings, transactionId
+ */
+export declare const leaveFeedbackForBuyerSchema: z.ZodObject<{
+    comment_text: z.ZodOptional<z.ZodString>;
+    comment_type: z.ZodOptional<z.ZodString>;
+    images: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        url: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        url?: string | undefined;
+    }, {
+        url?: string | undefined;
+    }>, "many">>;
+    listing_id: z.ZodOptional<z.ZodString>;
+    order_line_item_id: z.ZodOptional<z.ZodString>;
+    seller_ratings: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        key: z.ZodOptional<z.ZodString>;
+        value: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        value?: string | undefined;
+        key?: string | undefined;
+    }, {
+        value?: string | undefined;
+        key?: string | undefined;
+    }>, "many">>;
+    transaction_id: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    transaction_id?: string | undefined;
+    listing_id?: string | undefined;
+    order_line_item_id?: string | undefined;
+    comment_text?: string | undefined;
+    comment_type?: string | undefined;
+    images?: {
+        url?: string | undefined;
+    }[] | undefined;
+    seller_ratings?: {
+        value?: string | undefined;
+        key?: string | undefined;
+    }[] | undefined;
+}, {
+    transaction_id?: string | undefined;
+    listing_id?: string | undefined;
+    order_line_item_id?: string | undefined;
+    comment_text?: string | undefined;
+    comment_type?: string | undefined;
+    images?: {
+        url?: string | undefined;
+    }[] | undefined;
+    seller_ratings?: {
+        value?: string | undefined;
+        key?: string | undefined;
+    }[] | undefined;
+}>;
+/**
+ * Schema for respondToFeedback method
+ * Endpoint: POST /respond_to_feedback
+ * Body: RespondToFeedbackRequest - feedbackId, recipientUserId, responseText, responseType
+ */
+export declare const respondToFeedbackSchema: z.ZodObject<{
+    feedback_id: z.ZodOptional<z.ZodString>;
+    recipient_user_id: z.ZodOptional<z.ZodString>;
+    response_text: z.ZodOptional<z.ZodString>;
+    response_type: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    response_type?: string | undefined;
+    feedback_id?: string | undefined;
+    recipient_user_id?: string | undefined;
+    response_text?: string | undefined;
+}, {
+    response_type?: string | undefined;
+    feedback_id?: string | undefined;
+    recipient_user_id?: string | undefined;
+    response_text?: string | undefined;
+}>;

package/build/utils/communication/feedback.js

@@ -0,0 +1,216 @@
+import { z } from 'zod';
+/**
+ * Zod schemas for Feedback API input validation
+ * Based on: src/api/communication/feedback.ts
+ * OpenAPI spec: docs/sell-apps/communication/commerce_feedback_v1_beta_oas3.json
+ * Types from: src/types/commerce_feedback_v1_beta_oas3.ts
+ */
+// Reusable schema for filter parameter
+const filterSchema = z
+    .string({
+    message: 'Filter must be a string',
+    invalid_type_error: 'filter must be a string',
+    description: 'Filter criteria for the query',
+})
+    .optional();
+// Reusable schema for limit parameter (string in API, converted to number)
+const limitSchema = z
+    .string({
+    invalid_type_error: 'limit must be a string',
+    description: 'Maximum number of items to return per page (25-200)',
+})
+    .optional();
+// Reusable schema for offset parameter (string in API, converted to number)
+const offsetSchema = z
+    .string({
+    invalid_type_error: 'offset must be a string',
+    description: 'Number of items to skip',
+})
+    .optional();
+// Reusable schema for sort parameter
+const sortSchema = z
+    .string({
+    invalid_type_error: 'sort must be a string',
+    description: 'Sort order for results',
+})
+    .optional();
+/**
+ * Schema for getAwaitingFeedback method
+ * Endpoint: GET /awaiting_feedback
+ * Params: GetAwaitingFeedbackParams - filter, limit, offset, sort
+ */
+export const getAwaitingFeedbackSchema = z.object({
+    filter: filterSchema,
+    limit: limitSchema,
+    offset: offsetSchema,
+    sort: sortSchema,
+});
+/**
+ * Schema for getFeedback method
+ * Endpoint: GET /feedback
+ * Params: GetFeedbackParams - user_id (required), feedback_type (required), feedback_id, filter, limit, listing_id, offset, order_line_item_id, sort, transaction_id
+ */
+export const getFeedbackSchema = z.object({
+    user_id: z.string({
+        message: 'User ID is required',
+        required_error: 'user_id is required',
+        invalid_type_error: 'user_id must be a string',
+        description: 'The unique identifier (eBay username) of the user',
+    }),
+    feedback_type: z.string({
+        message: 'Feedback type is required',
+        required_error: 'feedback_type is required',
+        invalid_type_error: 'feedback_type must be a string',
+        description: 'Type of feedback (FEEDBACK_RECEIVED or FEEDBACK_SENT)',
+    }),
+    feedback_id: z
+        .string({
+        invalid_type_error: 'feedback_id must be a string',
+        description: 'Filter by specific feedback ID',
+    })
+        .optional(),
+    filter: filterSchema,
+    limit: limitSchema,
+    listing_id: z
+        .string({
+        invalid_type_error: 'listing_id must be a string',
+        description: 'Filter by listing ID',
+    })
+        .optional(),
+    offset: offsetSchema,
+    order_line_item_id: z
+        .string({
+        invalid_type_error: 'order_line_item_id must be a string',
+        description: 'Filter by order line item ID',
+    })
+        .optional(),
+    sort: sortSchema,
+    transaction_id: z
+        .string({
+        invalid_type_error: 'transaction_id must be a string',
+        description: 'Filter by transaction ID',
+    })
+        .optional(),
+});
+/**
+ * Schema for getFeedbackRatingSummary method
+ * Endpoint: GET /feedback_rating_summary
+ * Params: GetFeedbackRatingSummaryParams - user_id (required), filter (required)
+ */
+export const getFeedbackRatingSummarySchema = z.object({
+    user_id: z.string({
+        message: 'User ID is required',
+        required_error: 'user_id is required',
+        invalid_type_error: 'user_id must be a string',
+        description: 'The unique identifier of the eBay user',
+    }),
+    filter: z.string({
+        message: 'Filter is required (must include ratingType)',
+        required_error: 'filter is required',
+        invalid_type_error: 'filter must be a string',
+        description: 'Filter with required ratingType parameter',
+    }),
+});
+/**
+ * Schema for leaveFeedbackForBuyer method
+ * Endpoint: POST /feedback
+ * Body: LeaveFeedbackRequest - commentText, commentType, images, listingId, orderLineItemId, sellerRatings, transactionId
+ */
+export const leaveFeedbackForBuyerSchema = z.object({
+    comment_text: z
+        .string({
+        invalid_type_error: 'comment_text must be a string',
+        description: 'The feedback comment text (max 500 characters)',
+    })
+        .max(500, 'comment_text must be 500 characters or less')
+        .optional(),
+    comment_type: z
+        .string({
+        invalid_type_error: 'comment_type must be a string',
+        description: 'Overall rating: POSITIVE, NEUTRAL, or NEGATIVE',
+    })
+        .optional(),
+    images: z
+        .array(z.object({
+        url: z
+            .string({
+            invalid_type_error: 'image url must be a string',
+            description: 'URL of the image',
+        })
+            .optional(),
+    }), {
+        invalid_type_error: 'images must be an array',
+        description: 'Array of up to 5 images',
+    })
+        .max(5, 'Maximum 5 images allowed')
+        .optional(),
+    listing_id: z
+        .string({
+        invalid_type_error: 'listing_id must be a string',
+        description: 'The listing ID related to the transaction',
+    })
+        .optional(),
+    order_line_item_id: z
+        .string({
+        invalid_type_error: 'order_line_item_id must be a string',
+        description: 'The unique identifier of the line item',
+    })
+        .optional(),
+    seller_ratings: z
+        .array(z.object({
+        key: z
+            .string({
+            invalid_type_error: 'seller rating key must be a string',
+            description: 'Rating category (e.g., ON_TIME_DELIVERY, ITEM_AS_DESCRIBED)',
+        })
+            .optional(),
+        value: z
+            .string({
+            invalid_type_error: 'seller rating value must be a string',
+            description: 'Rating value (1-5)',
+        })
+            .optional(),
+    }), {
+        invalid_type_error: 'seller_ratings must be an array',
+        description: 'Array of seller performance ratings',
+    })
+        .optional(),
+    transaction_id: z
+        .string({
+        invalid_type_error: 'transaction_id must be a string',
+        description: 'The unique identifier of the transaction',
+    })
+        .optional(),
+});
+/**
+ * Schema for respondToFeedback method
+ * Endpoint: POST /respond_to_feedback
+ * Body: RespondToFeedbackRequest - feedbackId, recipientUserId, responseText, responseType
+ */
+export const respondToFeedbackSchema = z.object({
+    feedback_id: z
+        .string({
+        invalid_type_error: 'feedback_id must be a string',
+        description: 'The unique identifier of the feedback being responded to',
+    })
+        .optional(),
+    recipient_user_id: z
+        .string({
+        invalid_type_error: 'recipient_user_id must be a string',
+        description: 'The user ID of the feedback provider',
+    })
+        .optional(),
+    response_text: z
+        .string({
+        invalid_type_error: 'response_text must be a string',
+        description: 'The text content of the response (max 500 characters)',
+    })
+        .max(500, 'response_text must be 500 characters or less')
+        .optional(),
+    response_type: z
+        .string({
+        invalid_type_error: 'response_type must be a string',
+        description: 'The type of response: REPLY or FOLLOW_UP',
+    })
+        .optional(),
+});

package/build/utils/communication/message.d.ts

@@ -0,0 +1,174 @@
+import { z } from 'zod';
+/**
+ * Schema for bulkUpdateConversation method
+ * Endpoint: POST /bulk_update_conversation
+ * Body: BulkUpdateConversationsRequest - conversations array
+ */
+export declare const bulkUpdateConversationSchema: z.ZodObject<{
+    conversations: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        conversation_id: z.ZodOptional<z.ZodString>;
+        conversation_status: z.ZodOptional<z.ZodString>;
+        conversation_type: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        conversation_id?: string | undefined;
+        conversation_status?: string | undefined;
+        conversation_type?: string | undefined;
+    }, {
+        conversation_id?: string | undefined;
+        conversation_status?: string | undefined;
+        conversation_type?: string | undefined;
+    }>, "many">>;
+}, "strip", z.ZodTypeAny, {
+    conversations?: {
+        conversation_id?: string | undefined;
+        conversation_status?: string | undefined;
+        conversation_type?: string | undefined;
+    }[] | undefined;
+}, {
+    conversations?: {
+        conversation_id?: string | undefined;
+        conversation_status?: string | undefined;
+        conversation_type?: string | undefined;
+    }[] | undefined;
+}>;
+/**
+ * Schema for getConversations method
+ * Endpoint: GET /conversation
+ * Params: GetConversationsParams - conversation_type (required), conversation_status, end_time, limit, offset, other_party_username, reference_id, reference_type, start_time
+ */
+export declare const getConversationsSchema: z.ZodObject<{
+    conversation_type: z.ZodString;
+    conversation_status: z.ZodOptional<z.ZodString>;
+    end_time: z.ZodOptional<z.ZodString>;
+    limit: z.ZodOptional<z.ZodString>;
+    offset: z.ZodOptional<z.ZodString>;
+    other_party_username: z.ZodOptional<z.ZodString>;
+    reference_id: z.ZodOptional<z.ZodString>;
+    reference_type: z.ZodOptional<z.ZodString>;
+    start_time: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    conversation_type: string;
+    limit?: string | undefined;
+    offset?: string | undefined;
+    conversation_status?: string | undefined;
+    end_time?: string | undefined;
+    other_party_username?: string | undefined;
+    reference_id?: string | undefined;
+    reference_type?: string | undefined;
+    start_time?: string | undefined;
+}, {
+    conversation_type: string;
+    limit?: string | undefined;
+    offset?: string | undefined;
+    conversation_status?: string | undefined;
+    end_time?: string | undefined;
+    other_party_username?: string | undefined;
+    reference_id?: string | undefined;
+    reference_type?: string | undefined;
+    start_time?: string | undefined;
+}>;
+/**
+ * Schema for getConversation method
+ * Endpoint: GET /conversation/{conversation_id}
+ * Path: conversation_id (required)
+ * Query: conversation_type (required), limit, offset
+ */
+export declare const getConversationSchema: z.ZodObject<{
+    conversation_id: z.ZodString;
+    conversation_type: z.ZodString;
+    limit: z.ZodOptional<z.ZodString>;
+    offset: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    conversation_id: string;
+    conversation_type: string;
+    limit?: string | undefined;
+    offset?: string | undefined;
+}, {
+    conversation_id: string;
+    conversation_type: string;
+    limit?: string | undefined;
+    offset?: string | undefined;
+}>;
+/**
+ * Schema for sendMessage method
+ * Endpoint: POST /send_message
+ * Body: SendMessageRequest - conversationId, emailCopyToSender, messageMedia, messageText, otherPartyUsername, reference
+ */
+export declare const sendMessageSchema: z.ZodObject<{
+    conversation_id: z.ZodOptional<z.ZodString>;
+    email_copy_to_sender: z.ZodOptional<z.ZodBoolean>;
+    message_media: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        media_name: z.ZodOptional<z.ZodString>;
+        media_type: z.ZodOptional<z.ZodString>;
+        media_url: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        media_name?: string | undefined;
+        media_type?: string | undefined;
+        media_url?: string | undefined;
+    }, {
+        media_name?: string | undefined;
+        media_type?: string | undefined;
+        media_url?: string | undefined;
+    }>, "many">>;
+    message_text: z.ZodOptional<z.ZodString>;
+    other_party_username: z.ZodOptional<z.ZodString>;
+    reference: z.ZodOptional<z.ZodObject<{
+        reference_id: z.ZodOptional<z.ZodString>;
+        reference_type: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        reference_id?: string | undefined;
+        reference_type?: string | undefined;
+    }, {
+        reference_id?: string | undefined;
+        reference_type?: string | undefined;
+    }>>;
+}, "strip", z.ZodTypeAny, {
+    conversation_id?: string | undefined;
+    reference?: {
+        reference_id?: string | undefined;
+        reference_type?: string | undefined;
+    } | undefined;
+    other_party_username?: string | undefined;
+    email_copy_to_sender?: boolean | undefined;
+    message_media?: {
+        media_name?: string | undefined;
+        media_type?: string | undefined;
+        media_url?: string | undefined;
+    }[] | undefined;
+    message_text?: string | undefined;
+}, {
+    conversation_id?: string | undefined;
+    reference?: {
+        reference_id?: string | undefined;
+        reference_type?: string | undefined;
+    } | undefined;
+    other_party_username?: string | undefined;
+    email_copy_to_sender?: boolean | undefined;
+    message_media?: {
+        media_name?: string | undefined;
+        media_type?: string | undefined;
+        media_url?: string | undefined;
+    }[] | undefined;
+    message_text?: string | undefined;
+}>;
+/**
+ * Schema for updateConversation method
+ * Endpoint: POST /update_conversation
+ * Body: UpdateConversationRequest - conversationId, conversationStatus, conversationType, read
+ */
+export declare const updateConversationSchema: z.ZodObject<{
+    conversation_id: z.ZodOptional<z.ZodString>;
+    conversation_status: z.ZodOptional<z.ZodString>;
+    conversation_type: z.ZodOptional<z.ZodString>;
+    read: z.ZodOptional<z.ZodBoolean>;
+}, "strip", z.ZodTypeAny, {
+    conversation_id?: string | undefined;
+    conversation_status?: string | undefined;
+    conversation_type?: string | undefined;
+    read?: boolean | undefined;
+}, {
+    conversation_id?: string | undefined;
+    conversation_status?: string | undefined;
+    conversation_type?: string | undefined;
+    read?: boolean | undefined;
+}>;