ebay-mcp 1.4.3

package/build/utils/other/edelivery.js

@@ -0,0 +1,241 @@
+import { z } from 'zod';
+/**
+ * Zod schemas for eDelivery API input validation
+ * Based on: src/api/other/edelivery.ts
+ * OpenAPI spec: docs/sell-apps/other-apis/sell_edelivery_international_shipping_oas3.json
+ * Types from: src/types/sell_edelivery_international_shipping_oas3.ts
+ *
+ * Note: The eDelivery API is only available for Greater-China based sellers with an active eDIS account.
+ */
+// Reusable schema for ID parameters
+const idSchema = (name, description) => z.string({
+    message: `${name} is required`,
+    required_error: `${name.toLowerCase().replace(/\s+/g, '_')} is required`,
+    invalid_type_error: `${name.toLowerCase().replace(/\s+/g, '_')} must be a string`,
+    description,
+});
+// Reusable schema for query parameters
+const paramsSchema = z
+    .record(z.string(), {
+    description: 'Query parameters for the request',
+})
+    .optional();
+// Reusable schema for request body objects
+const requestBodySchema = (name) => z.record(z.unknown(), {
+    message: `${name} is required`,
+    required_error: `${name.toLowerCase().replace(/\s+/g, '_')} is required`,
+    invalid_type_error: `${name.toLowerCase().replace(/\s+/g, '_')} must be an object`,
+    description: `The ${name.toLowerCase()} containing required details`,
+});
+/**
+ * Schema for createShippingQuote method
+ * Endpoint: POST /shipping_quote
+ * Body: ShippingQuoteRequest - complex object with shipping details
+ */
+export const createShippingQuoteSchema = z.object({
+    shipping_quote_request: requestBodySchema('Shipping quote request'),
+});
+/**
+ * Schema for getShippingQuote method
+ * Endpoint: GET /shipping_quote/{shipping_quote_id}
+ * Path: shipping_quote_id (required)
+ */
+export const getShippingQuoteSchema = z.object({
+    shipping_quote_id: idSchema('Shipping quote ID', 'The unique identifier for the shipping quote'),
+});
+// ==================== Cost & Preferences ====================
+/**
+ * Schema for getActualCosts method
+ * Endpoint: GET /actual_costs
+ */
+export const getActualCostsSchema = z.object({
+    params: paramsSchema,
+});
+/**
+ * Schema for getAddressPreferences method
+ * Endpoint: GET /address_preference
+ */
+export const getAddressPreferencesSchema = z.object({});
+/**
+ * Schema for createAddressPreference method
+ * Endpoint: POST /address_preference
+ */
+export const createAddressPreferenceSchema = z.object({
+    address_preference: requestBodySchema('Address preference'),
+});
+/**
+ * Schema for getConsignPreferences method
+ * Endpoint: GET /consign_preference
+ */
+export const getConsignPreferencesSchema = z.object({});
+/**
+ * Schema for createConsignPreference method
+ * Endpoint: POST /consign_preference
+ */
+export const createConsignPreferenceSchema = z.object({
+    consign_preference: requestBodySchema('Consign preference'),
+});
+// ==================== Agents & Services ====================
+/**
+ * Schema for getAgents method
+ * Endpoint: GET /agents
+ */
+export const getAgentsSchema = z.object({
+    params: paramsSchema,
+});
+/**
+ * Schema for getBatteryQualifications method
+ * Endpoint: GET /battery_qualifications
+ */
+export const getBatteryQualificationsSchema = z.object({
+    params: paramsSchema,
+});
+/**
+ * Schema for getDropoffSites method
+ * Endpoint: GET /dropoff_sites
+ */
+export const getDropoffSitesSchema = z.object({
+    params: z.record(z.string(), {
+        description: 'Query parameters (postal_code, country, etc.)',
+    }),
+});
+/**
+ * Schema for getShippingServices method
+ * Endpoint: GET /services
+ */
+export const getShippingServicesSchema = z.object({
+    params: paramsSchema,
+});
+// ==================== Bundles ====================
+/**
+ * Schema for createBundle method
+ * Endpoint: POST /bundle
+ */
+export const createBundleSchema = z.object({
+    bundle_request: requestBodySchema('Bundle request'),
+});
+/**
+ * Schema for getBundle method
+ * Endpoint: GET /bundle/{bundle_id}
+ */
+export const getBundleSchema = z.object({
+    bundle_id: idSchema('Bundle ID', 'The unique identifier for the bundle'),
+});
+/**
+ * Schema for cancelBundle method
+ * Endpoint: POST /bundle/{bundle_id}/cancel
+ */
+export const cancelBundleSchema = z.object({
+    bundle_id: idSchema('Bundle ID', 'The unique identifier for the bundle to cancel'),
+});
+/**
+ * Schema for getBundleLabel method
+ * Endpoint: GET /bundle/{bundle_id}/label
+ */
+export const getBundleLabelSchema = z.object({
+    bundle_id: idSchema('Bundle ID', 'The unique identifier for the bundle'),
+});
+// ==================== Packages (Single) ====================
+/**
+ * Schema for createPackage method
+ * Endpoint: POST /package
+ */
+export const createPackageSchema = z.object({
+    package_request: requestBodySchema('Package request'),
+});
+/**
+ * Schema for getPackage method
+ * Endpoint: GET /package/{package_id}
+ */
+export const getPackageSchema = z.object({
+    package_id: idSchema('Package ID', 'The unique identifier for the package'),
+});
+/**
+ * Schema for deletePackage method
+ * Endpoint: DELETE /package/{package_id}
+ */
+export const deletePackageSchema = z.object({
+    package_id: idSchema('Package ID', 'The unique identifier for the package to delete'),
+});
+/**
+ * Schema for getPackageByOrderLineItem method
+ * Endpoint: GET /package/{order_line_item_id}/item
+ */
+export const getPackageByOrderLineItemSchema = z.object({
+    order_line_item_id: idSchema('Order line item ID', 'The order line item identifier'),
+});
+/**
+ * Schema for cancelPackage method
+ * Endpoint: POST /package/{package_id}/cancel
+ */
+export const cancelPackageSchema = z.object({
+    package_id: idSchema('Package ID', 'The unique identifier for the package to cancel'),
+});
+/**
+ * Schema for clonePackage method
+ * Endpoint: POST /package/{package_id}/clone
+ */
+export const clonePackageSchema = z.object({
+    package_id: idSchema('Package ID', 'The unique identifier for the package to clone'),
+});
+/**
+ * Schema for confirmPackage method
+ * Endpoint: POST /package/{package_id}/confirm
+ */
+export const confirmPackageSchema = z.object({
+    package_id: idSchema('Package ID', 'The unique identifier for the package to confirm'),
+});
+// ==================== Packages (Bulk) ====================
+/**
+ * Schema for bulkCancelPackages method
+ * Endpoint: POST /package/bulk_cancel_packages
+ */
+export const bulkCancelPackagesSchema = z.object({
+    bulk_cancel_request: requestBodySchema('Bulk cancel request'),
+});
+/**
+ * Schema for bulkConfirmPackages method
+ * Endpoint: POST /package/bulk_confirm_packages
+ */
+export const bulkConfirmPackagesSchema = z.object({
+    bulk_confirm_request: requestBodySchema('Bulk confirm request'),
+});
+/**
+ * Schema for bulkDeletePackages method
+ * Endpoint: POST /package/bulk_delete_packages
+ */
+export const bulkDeletePackagesSchema = z.object({
+    bulk_delete_request: requestBodySchema('Bulk delete request'),
+});
+// ==================== Labels & Tracking ====================
+/**
+ * Schema for getLabels method
+ * Endpoint: GET /labels
+ */
+export const getLabelsSchema = z.object({
+    params: paramsSchema,
+});
+/**
+ * Schema for getHandoverSheet method
+ * Endpoint: GET /handover_sheet
+ */
+export const getHandoverSheetSchema = z.object({
+    params: paramsSchema,
+});
+/**
+ * Schema for getTracking method
+ * Endpoint: GET /tracking
+ */
+export const getTrackingSchema = z.object({
+    params: z.record(z.string(), {
+        description: 'Query parameters (tracking_number required)',
+    }),
+});
+// ==================== Other ====================
+/**
+ * Schema for createComplaint method
+ * Endpoint: POST /complaint
+ */
+export const createComplaintSchema = z.object({
+    complaint_request: requestBodySchema('Complaint request'),
+});

package/build/utils/other/identity.d.ts

@@ -0,0 +1,13 @@
+import { z } from 'zod';
+/**
+ * Zod schemas for Identity API input validation
+ * Based on: src/api/other/identity.ts
+ * OpenAPI spec: docs/sell-apps/other-apis/commerce_identity_v1_oas3.json
+ * Types from: src/types/commerce_identity_v1_oas3.ts
+ */
+/**
+ * Schema for getUser method
+ * Endpoint: GET /user
+ * No parameters required - retrieves the authenticated user's account profile
+ */
+export declare const getUserSchema: z.ZodObject<{}, "strip", z.ZodTypeAny, {}, {}>;

package/build/utils/other/identity.js

@@ -0,0 +1,13 @@
+import { z } from 'zod';
+/**
+ * Zod schemas for Identity API input validation
+ * Based on: src/api/other/identity.ts
+ * OpenAPI spec: docs/sell-apps/other-apis/commerce_identity_v1_oas3.json
+ * Types from: src/types/commerce_identity_v1_oas3.ts
+ */
+/**
+ * Schema for getUser method
+ * Endpoint: GET /user
+ * No parameters required - retrieves the authenticated user's account profile
+ */
+export const getUserSchema = z.object({});

package/build/utils/other/translation.d.ts

@@ -0,0 +1,28 @@
+import { z } from 'zod';
+/**
+ * Zod schemas for Translation API input validation
+ * Based on: src/api/other/translation.ts
+ * OpenAPI spec: docs/sell-apps/other-apis/commerce_translation_v1_beta_oas3.json
+ * Types from: src/types/commerce_translation_v1_beta_oas3.ts
+ */
+/**
+ * Schema for translate method
+ * Endpoint: POST /translate
+ * Body: TranslateRequest - from, to, translationContext, text
+ */
+export declare const translateSchema: z.ZodObject<{
+    from: z.ZodOptional<z.ZodString>;
+    to: z.ZodOptional<z.ZodString>;
+    translation_context: z.ZodOptional<z.ZodString>;
+    text: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+}, "strip", z.ZodTypeAny, {
+    text?: string[] | undefined;
+    from?: string | undefined;
+    to?: string | undefined;
+    translation_context?: string | undefined;
+}, {
+    text?: string[] | undefined;
+    from?: string | undefined;
+    to?: string | undefined;
+    translation_context?: string | undefined;
+}>;

package/build/utils/other/translation.js

@@ -0,0 +1,41 @@
+import { z } from 'zod';
+/**
+ * Zod schemas for Translation API input validation
+ * Based on: src/api/other/translation.ts
+ * OpenAPI spec: docs/sell-apps/other-apis/commerce_translation_v1_beta_oas3.json
+ * Types from: src/types/commerce_translation_v1_beta_oas3.ts
+ */
+/**
+ * Schema for translate method
+ * Endpoint: POST /translate
+ * Body: TranslateRequest - from, to, translationContext, text
+ */
+export const translateSchema = z.object({
+    from: z
+        .string({
+        invalid_type_error: 'from must be a string',
+        description: 'The language of the input text to be translated (e.g., en_US, fr_FR, de_DE)',
+    })
+        .optional(),
+    to: z
+        .string({
+        invalid_type_error: 'to must be a string',
+        description: 'The target language for translation (e.g., en_US, fr_FR, de_DE)',
+    })
+        .optional(),
+    translation_context: z
+        .string({
+        invalid_type_error: 'translation_context must be a string',
+        description: 'The listing entity to translate (ITEM_TITLE or ITEM_DESCRIPTION)',
+    })
+        .optional(),
+    text: z
+        .array(z.string({
+        invalid_type_error: 'text array items must be strings',
+        description: 'Text string to translate',
+    }), {
+        invalid_type_error: 'text must be an array',
+        description: 'Array of text to translate (max 1000 chars for ITEM_TITLE, 20,000 for ITEM_DESCRIPTION)',
+    })
+        .optional(),
+});

package/build/utils/other/vero.d.ts

@@ -0,0 +1,61 @@
+import { z } from 'zod';
+/**
+ * Schema for createVeroReport method
+ * Endpoint: POST /vero_report
+ * Body: VeroReportItemsRequest - report data
+ */
+export declare const createVeroReportSchema: z.ZodObject<{
+    report_data: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+}, "strip", z.ZodTypeAny, {
+    report_data: Record<string, unknown>;
+}, {
+    report_data: Record<string, unknown>;
+}>;
+/**
+ * Schema for getVeroReport method
+ * Endpoint: GET /vero_report/{vero_report_id}
+ * Path: vero_report_id
+ */
+export declare const getVeroReportSchema: z.ZodObject<{
+    vero_report_id: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    vero_report_id: string;
+}, {
+    vero_report_id: string;
+}>;
+/**
+ * Schema for getVeroReportItems method
+ * Endpoint: GET /vero_report_items
+ * Query: filter, limit, offset
+ */
+export declare const getVeroReportItemsSchema: z.ZodObject<{
+    filter: z.ZodOptional<z.ZodString>;
+    limit: z.ZodOptional<z.ZodString>;
+    offset: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    filter?: string | undefined;
+    limit?: string | undefined;
+    offset?: string | undefined;
+}, {
+    filter?: string | undefined;
+    limit?: string | undefined;
+    offset?: string | undefined;
+}>;
+/**
+ * Schema for getVeroReasonCode method
+ * Endpoint: GET /vero_reason_code/{vero_reason_code_id}
+ * Path: vero_reason_code_id
+ */
+export declare const getVeroReasonCodeSchema: z.ZodObject<{
+    vero_reason_code_id: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    vero_reason_code_id: string;
+}, {
+    vero_reason_code_id: string;
+}>;
+/**
+ * Schema for getVeroReasonCodes method
+ * Endpoint: GET /vero_reason_code
+ * No parameters required
+ */
+export declare const getVeroReasonCodesSchema: z.ZodObject<{}, "strip", z.ZodTypeAny, {}, {}>;

package/build/utils/other/vero.js

@@ -0,0 +1,90 @@
+import { z } from 'zod';
+/**
+ * Zod schemas for VERO API input validation
+ * Based on: src/api/other/vero.ts
+ * OpenAPI spec: docs/sell-apps/other-apis/commerce_vero_v1_oas3.json
+ * Types from: src/types/commerce_vero_v1_oas3.ts
+ *
+ * Note: The VERO API is only available for members of the Verified Rights Owner (VeRO) Program
+ */
+// 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 (e.g., date range)',
+})
+    .optional();
+// Reusable schema for limit parameter (string in API)
+const limitSchema = z
+    .string({
+    invalid_type_error: 'limit must be a string',
+    description: 'Maximum number of items to return',
+})
+    .optional();
+// Reusable schema for offset parameter (string in API)
+const offsetSchema = z
+    .string({
+    invalid_type_error: 'offset must be a string',
+    description: 'Number of items to skip',
+})
+    .optional();
+/**
+ * Schema for createVeroReport method
+ * Endpoint: POST /vero_report
+ * Body: VeroReportItemsRequest - report data
+ */
+export const createVeroReportSchema = z.object({
+    report_data: z.record(z.unknown(), {
+        message: 'Report data is required',
+        required_error: 'report_data is required',
+        invalid_type_error: 'report_data must be an object',
+        description: 'The VeRO report data containing item details and intellectual property violation information',
+    }),
+});
+/**
+ * Schema for getVeroReport method
+ * Endpoint: GET /vero_report/{vero_report_id}
+ * Path: vero_report_id
+ */
+export const getVeroReportSchema = z.object({
+    vero_report_id: z
+        .string({
+        message: 'VERO report ID is required',
+        required_error: 'vero_report_id is required',
+        invalid_type_error: 'vero_report_id must be a string',
+        description: 'The unique identifier of the VERO report',
+    })
+        .min(1, 'VERO report ID cannot be empty'),
+});
+/**
+ * Schema for getVeroReportItems method
+ * Endpoint: GET /vero_report_items
+ * Query: filter, limit, offset
+ */
+export const getVeroReportItemsSchema = z.object({
+    filter: filterSchema,
+    limit: limitSchema,
+    offset: offsetSchema,
+});
+/**
+ * Schema for getVeroReasonCode method
+ * Endpoint: GET /vero_reason_code/{vero_reason_code_id}
+ * Path: vero_reason_code_id
+ */
+export const getVeroReasonCodeSchema = z.object({
+    vero_reason_code_id: z
+        .string({
+        message: 'VERO reason code ID is required',
+        required_error: 'vero_reason_code_id is required',
+        invalid_type_error: 'vero_reason_code_id must be a string',
+        description: 'The unique identifier of the VERO reason code',
+    })
+        .min(1, 'VERO reason code ID cannot be empty'),
+});
+/**
+ * Schema for getVeroReasonCodes method
+ * Endpoint: GET /vero_reason_code
+ * No parameters required
+ */
+export const getVeroReasonCodesSchema = z.object({});

package/build/utils/scope-helper.d.ts

@@ -0,0 +1,49 @@
+/**
+ * Scope Helper - Manages eBay OAuth scopes
+ */
+export interface ScopeCategory {
+    name: string;
+    description: string;
+    scopes: string[];
+    required: boolean;
+}
+/**
+ * Get all available scope categories
+ */
+export declare function getScopeCategories(): ScopeCategory[];
+/**
+ * Get recommended scopes for the environment
+ */
+export declare function getRecommendedScopes(environment: 'sandbox' | 'production'): string[];
+/**
+ * Display scope selection interface
+ */
+export declare function displayScopeCategories(): void;
+/**
+ * Verify if token has required scopes
+ */
+export declare function verifyScopesCoverage(tokenScopes: string[], requiredScopes: string[]): {
+    hasAllRequired: boolean;
+    missingScopes: string[];
+    extraScopes: string[];
+};
+/**
+ * Display scope verification results
+ */
+export declare function displayScopeVerification(tokenScopes: string[], environment: 'sandbox' | 'production'): void;
+/**
+ * Get scope description
+ */
+export declare function getScopeDescription(scope: string): string;
+/**
+ * Format scopes for display
+ */
+export declare function formatScopesForDisplay(scopes: string[]): string;
+/**
+ * Get all scopes as a space-separated string
+ */
+export declare function getAllScopesString(environment: 'sandbox' | 'production'): string;
+/**
+ * Parse scope string to array
+ */
+export declare function parseScopeString(scopeString: string): string[];