ebay-mcp 1.16.0 → 1.18.0

package/build/api/client.js

@@ -221,6 +221,7 @@ export class EbayApiClient {
                 body: options.data,
                 timeoutMs: options.timeoutMs ?? this.timeoutMs,
                 responseType: options.responseType,
+                maxBytes: options.maxBytes,
             }).pipe(Effect.map((response) => {
                 logResponse(response.status, response.statusText, response.data, response.headers['x-ebay-c-ratelimit-remaining'], response.headers['x-ebay-c-ratelimit-limit']);
                 return response;
@@ -341,6 +342,22 @@ export class EbayApiClient {
             responseType: config?.responseType,
             absolute: config?.absolute,
             timeoutMs: config?.timeoutMs,
+            maxBytes: config?.maxBytes,
+            tokenType: config?.tokenType,
+        });
+    }
+    /**
+     * Make a GET request and keep the status and headers of the successful
+     * response — for file downloads whose name and type arrive in headers.
+     */
+    async getForResponse(endpoint, params, config) {
+        return await this.requestResponse('GET', endpoint, {
+            params: { ...params, ...config?.params },
+            headers: config?.headers,
+            responseType: config?.responseType,
+            absolute: config?.absolute,
+            timeoutMs: config?.timeoutMs,
+            maxBytes: config?.maxBytes,
             tokenType: config?.tokenType,
         });
     }
@@ -362,6 +379,7 @@ export class EbayApiClient {
             responseType: config?.responseType,
             absolute: config?.absolute,
             timeoutMs: config?.timeoutMs,
+            maxBytes: config?.maxBytes,
             tokenType: config?.tokenType,
         });
     }
@@ -369,13 +387,36 @@ export class EbayApiClient {
      * Make a PUT request to eBay API
      */
     async put(endpoint, data, config) {
-        return await this.request('PUT', endpoint, {
+        return (await this.putForResponse(endpoint, data, config)).data;
+    }
+    /**
+     * Make a PUT request and keep the status and headers of the successful
+     * response — for asynchronous updates that return a task `Location` header.
+     */
+    async putForResponse(endpoint, data, config) {
+        return await this.requestResponse('PUT', endpoint, {
+            data,
+            params: config?.params,
+            headers: config?.headers,
+            responseType: config?.responseType,
+            absolute: config?.absolute,
+            timeoutMs: config?.timeoutMs,
+            maxBytes: config?.maxBytes,
+            tokenType: config?.tokenType,
+        });
+    }
+    /**
+     * Make a PATCH request to eBay API
+     */
+    async patch(endpoint, data, config) {
+        return await this.request('PATCH', endpoint, {
             data,
             params: config?.params,
             headers: config?.headers,
             responseType: config?.responseType,
             absolute: config?.absolute,
             timeoutMs: config?.timeoutMs,
+            maxBytes: config?.maxBytes,
             tokenType: config?.tokenType,
         });
     }
@@ -383,12 +424,22 @@ export class EbayApiClient {
      * Make a DELETE request to eBay API
      */
     async delete(endpoint, config) {
-        return await this.request('DELETE', endpoint, {
+        return (await this.deleteForResponse(endpoint, config)).data;
+    }
+    /**
+     * Make a DELETE request and keep the status and headers of the successful
+     * response — for asynchronous deletes that return a task `Location` header.
+     * `data` is the optional body a few eBay DELETE calls document.
+     */
+    async deleteForResponse(endpoint, config, data) {
+        return await this.requestResponse('DELETE', endpoint, {
+            data,
             params: config?.params,
             headers: config?.headers,
             responseType: config?.responseType,
             absolute: config?.absolute,
             timeoutMs: config?.timeoutMs,
+            maxBytes: config?.maxBytes,
             tokenType: config?.tokenType,
         });
     }

package/build/api/index.js

@@ -1,4 +1,6 @@
 import { AccountApi } from '../api/account-management/account.js';
+import { AccountV2Api } from '../api/account-management/accountV2.js';
+import { FinancesApi } from '../api/account-management/finances.js';
 import { AnalyticsApi } from '../api/analytics-and-report/analytics.js';
 import { EbayApiClient } from '../api/client.js';
 import { FeedbackApi } from '../api/communication/feedback.js';
@@ -6,14 +8,18 @@ import { MessageApi } from '../api/communication/message.js';
 import { NegotiationApi } from '../api/communication/negotiation.js';
 import { NotificationApi } from '../api/communication/notification.js';
 import { DeveloperApi } from '../api/developer/developer.js';
+import { FeedApi } from '../api/listing-management/feed.js';
 import { InventoryApi } from '../api/listing-management/inventory.js';
 import { MediaApi } from '../api/listing-management/media.js';
+import { StoresApi } from '../api/listing-management/stores.js';
+import { CharityApi } from '../api/listing-metadata/charity.js';
 import { MetadataApi } from '../api/listing-metadata/metadata.js';
 import { TaxonomyApi } from '../api/listing-metadata/taxonomy.js';
 import { MarketingApi } from '../api/marketing-and-promotions/marketing.js';
 import { RecommendationApi } from '../api/marketing-and-promotions/recommendation.js';
 import { DisputeApi } from '../api/order-management/dispute.js';
 import { FulfillmentApi } from '../api/order-management/fulfillment.js';
+import { LogisticsApi } from '../api/order-management/logistics.js';
 import { ComplianceApi } from '../api/other/compliance.js';
 import { EDeliveryApi } from '../api/other/edelivery.js';
 import { BrowseApi } from '../api/other/browse.js';
@@ -31,15 +37,21 @@ export class EbaySellerApi {
     config;
     // API categories
     account;
+    accountV2;
+    finances;
     inventory;
     media;
+    feed;
+    stores;
     fulfillment;
+    logistics;
     dispute;
     marketing;
     recommendation;
     analytics;
     metadata;
     taxonomy;
+    charity;
     negotiation;
     message;
     notification;
@@ -58,15 +70,21 @@ export class EbaySellerApi {
         this.client = new EbayApiClient(config);
         // Initialize API category handlers
         this.account = new AccountApi(this.client);
+        this.accountV2 = new AccountV2Api(this.client);
+        this.finances = new FinancesApi(this.client);
         this.inventory = new InventoryApi(this.client);
         this.media = new MediaApi(this.client, this.inventory);
+        this.feed = new FeedApi(this.client);
+        this.stores = new StoresApi(this.client);
         this.fulfillment = new FulfillmentApi(this.client);
+        this.logistics = new LogisticsApi(this.client);
         this.dispute = new DisputeApi(this.client);
         this.marketing = new MarketingApi(this.client);
         this.recommendation = new RecommendationApi(this.client);
         this.analytics = new AnalyticsApi(this.client);
         this.metadata = new MetadataApi(this.client);
         this.taxonomy = new TaxonomyApi(this.client);
+        this.charity = new CharityApi(this.client);
         this.negotiation = new NegotiationApi(this.client);
         this.message = new MessageApi(this.client);
         this.notification = new NotificationApi(this.client);
@@ -129,21 +147,27 @@ export class EbaySellerApi {
     }
 }
 export * from '../api/account-management/account.js';
+export * from '../api/account-management/accountV2.js';
+export * from '../api/account-management/finances.js';
 export * from '../api/analytics-and-report/analytics.js';
 export * from '../api/client.js';
 export * from '../api/communication/feedback.js';
 export * from '../api/communication/message.js';
 export * from '../api/communication/negotiation.js';
 export * from '../api/communication/notification.js';
+export * from '../api/listing-management/feed.js';
 export * from '../api/listing-management/inventory.js';
 export * from '../api/listing-management/media.js';
 export * from '../api/listing-management/mediaAttach.js';
+export * from '../api/listing-management/stores.js';
+export * from '../api/listing-metadata/charity.js';
 export * from '../api/listing-metadata/metadata.js';
 export * from '../api/listing-metadata/taxonomy.js';
 export * from '../api/marketing-and-promotions/marketing.js';
 export * from '../api/marketing-and-promotions/recommendation.js';
 export * from '../api/order-management/dispute.js';
 export * from '../api/order-management/fulfillment.js';
+export * from '../api/order-management/logistics.js';
 export * from '../api/other/compliance.js';
 export * from '../api/other/edelivery.js';
 export { BrowseApi } from '../api/other/browse.js';

package/build/api/listing-management/feed.js

@@ -0,0 +1,91 @@
+import { createFeedReportTaskMethods } from './feedReportTasks.js';
+import { createFeedScheduleMethods } from './feedSchedules.js';
+import { createFeedTaskMethods } from './feedTasks.js';
+/**
+ * Feed API - asynchronous order, inventory, and customer service metric feed tasks and
+ * schedules. Every member is the eBay operation of the same name; the endpoints live in
+ * `feedTasks.ts`, `feedReportTasks.ts` and `feedSchedules.ts` by resource.
+ */
+export class FeedApi {
+    // task resource: feed tasks without filter criteria, their files and uploads.
+    /** Feed API getTasks endpoint; see createFeedTaskMethods. */
+    getTasks;
+    /** Feed API createTask endpoint; see createFeedTaskMethods. */
+    createTask;
+    /** Feed API getTask endpoint; see createFeedTaskMethods. */
+    getTask;
+    /** Feed API getInputFile endpoint; see createFeedTaskMethods. */
+    getInputFile;
+    /** Feed API getResultFile endpoint; see createFeedTaskMethods. */
+    getResultFile;
+    /** Feed API uploadFile endpoint; see createFeedTaskMethods. */
+    uploadFile;
+    // order_task, inventory_task and customer_service_metric_task: filtered report tasks.
+    /** Feed API getOrderTasks endpoint; see createFeedReportTaskMethods. */
+    getOrderTasks;
+    /** Feed API createOrderTask endpoint; see createFeedReportTaskMethods. */
+    createOrderTask;
+    /** Feed API getOrderTask endpoint; see createFeedReportTaskMethods. */
+    getOrderTask;
+    /** Feed API getInventoryTasks endpoint; see createFeedReportTaskMethods. */
+    getInventoryTasks;
+    /** Feed API createInventoryTask endpoint; see createFeedReportTaskMethods. */
+    createInventoryTask;
+    /** Feed API getInventoryTask endpoint; see createFeedReportTaskMethods. */
+    getInventoryTask;
+    /** Feed API getCustomerServiceMetricTasks endpoint; see createFeedReportTaskMethods. */
+    getCustomerServiceMetricTasks;
+    /** Feed API createCustomerServiceMetricTask endpoint; see createFeedReportTaskMethods. */
+    createCustomerServiceMetricTask;
+    /** Feed API getCustomerServiceMetricTask endpoint; see createFeedReportTaskMethods. */
+    getCustomerServiceMetricTask;
+    // schedule resource: recurring reports and the templates they subscribe to.
+    /** Feed API getSchedules endpoint; see createFeedScheduleMethods. */
+    getSchedules;
+    /** Feed API createSchedule endpoint; see createFeedScheduleMethods. */
+    createSchedule;
+    /** Feed API getSchedule endpoint; see createFeedScheduleMethods. */
+    getSchedule;
+    /** Feed API updateSchedule endpoint; see createFeedScheduleMethods. */
+    updateSchedule;
+    /** Feed API deleteSchedule endpoint; see createFeedScheduleMethods. */
+    deleteSchedule;
+    /** Feed API getLatestResultFile endpoint; see createFeedScheduleMethods. */
+    getLatestResultFile;
+    /** Feed API getScheduleTemplate endpoint; see createFeedScheduleMethods. */
+    getScheduleTemplate;
+    /** Feed API getScheduleTemplates endpoint; see createFeedScheduleMethods. */
+    getScheduleTemplates;
+    /**
+     * Builds every Feed API endpoint over one shared client.
+     * @param client - Shared authenticated HTTP client.
+     */
+    constructor(client) {
+        const tasks = createFeedTaskMethods(client);
+        this.getTasks = tasks.getTasks;
+        this.createTask = tasks.createTask;
+        this.getTask = tasks.getTask;
+        this.getInputFile = tasks.getInputFile;
+        this.getResultFile = tasks.getResultFile;
+        this.uploadFile = tasks.uploadFile;
+        const reports = createFeedReportTaskMethods(client);
+        this.getOrderTasks = reports.getOrderTasks;
+        this.createOrderTask = reports.createOrderTask;
+        this.getOrderTask = reports.getOrderTask;
+        this.getInventoryTasks = reports.getInventoryTasks;
+        this.createInventoryTask = reports.createInventoryTask;
+        this.getInventoryTask = reports.getInventoryTask;
+        this.getCustomerServiceMetricTasks = reports.getCustomerServiceMetricTasks;
+        this.createCustomerServiceMetricTask = reports.createCustomerServiceMetricTask;
+        this.getCustomerServiceMetricTask = reports.getCustomerServiceMetricTask;
+        const schedules = createFeedScheduleMethods(client);
+        this.getSchedules = schedules.getSchedules;
+        this.createSchedule = schedules.createSchedule;
+        this.getSchedule = schedules.getSchedule;
+        this.updateSchedule = schedules.updateSchedule;
+        this.deleteSchedule = schedules.deleteSchedule;
+        this.getLatestResultFile = schedules.getLatestResultFile;
+        this.getScheduleTemplate = schedules.getScheduleTemplate;
+        this.getScheduleTemplates = schedules.getScheduleTemplates;
+    }
+}

package/build/api/listing-management/feedReportTasks.js

@@ -0,0 +1,107 @@
+import { decodeEndpointInputEffect, requestGetEffect } from '../../api/shared/request.js';
+import { createCustomerServiceMetricTaskInputSchema, createInventoryTaskInputSchema, createOrderTaskInputSchema, feedTaskIdInputSchema, getCustomerServiceMetricTasksInputSchema, getInventoryTasksInputSchema, getOrderTasksInputSchema, } from '../../schemas/inventory-management/feed.js';
+import { Effect } from 'effect';
+import { exclusiveFeedFilters, FEED_BASE_PATH, feedListParams, feedResourcePath, postFeedTask, } from './feedRequest.js';
+/**
+ * Creates the Feed API report-task endpoints that take filter criteria: order reports
+ * (`order_task`), active inventory reports (`inventory_task`) and customer service metric
+ * reports (`customer_service_metric_task`).
+ * @param client - Shared authenticated HTTP client.
+ * @returns Endpoint Effects composed into FeedApi.
+ */
+export const createFeedReportTaskMethods = (client) => {
+    /**
+     * Lists order report tasks by feed type or schedule.
+     * @param input - feedType or scheduleId (not both), dateRange or lookBackDays, limit, offset.
+     * @returns Generated OrderTaskCollection.
+     * @example feed.getOrderTasks({ feedType: 'LMS_ORDER_REPORT', lookBackDays: 10 })
+     * @see https://developer.ebay.com/api-docs/sell/feed/resources/order_task/methods/getOrderTasks
+     */
+    const getOrderTasks = (input = {}) => decodeEndpointInputEffect(getOrderTasksInputSchema, input).pipe(Effect.flatMap(exclusiveFeedFilters), Effect.flatMap((query) => requestGetEffect(client, `${FEED_BASE_PATH}/order_task`, feedListParams(query))));
+    /**
+     * Creates an LMS_ORDER_REPORT download task; eBay answers 202 with only a Location.
+     * @param input - CreateOrderTaskRequest body.
+     * @returns The new task ID and Location.
+     * @example feed.createOrderTask({ task: { feedType: 'LMS_ORDER_REPORT', schemaVersion: '1235' } })
+     * @see https://developer.ebay.com/api-docs/sell/feed/resources/order_task/methods/createOrderTask
+     */
+    const createOrderTask = (input) => decodeEndpointInputEffect(createOrderTaskInputSchema, input).pipe(Effect.flatMap(({ task }) => {
+        const body = task;
+        return postFeedTask(client, '/order_task', body);
+    }));
+    /**
+     * Retrieves one order report task.
+     * @param input - Task identifier.
+     * @returns Generated OrderTask.
+     * @example feed.getOrderTask({ taskId: 'TASK-1' })
+     * @see https://developer.ebay.com/api-docs/sell/feed/resources/order_task/methods/getOrderTask
+     */
+    const getOrderTask = (input) => decodeEndpointInputEffect(feedTaskIdInputSchema, input).pipe(Effect.flatMap(({ taskId }) => requestGetEffect(client, feedResourcePath('/order_task', taskId))));
+    /**
+     * Lists active inventory report tasks.
+     * @param input - feedType, dateRange or lookBackDays, limit, offset.
+     * @returns Generated InventoryTaskCollection.
+     * @example feed.getInventoryTasks({ feedType: 'LMS_ACTIVE_INVENTORY_REPORT' })
+     * @see https://developer.ebay.com/api-docs/sell/feed/resources/inventory_task/methods/getInventoryTasks
+     */
+    const getInventoryTasks = (input = {}) => decodeEndpointInputEffect(getInventoryTasksInputSchema, input).pipe(Effect.flatMap(exclusiveFeedFilters), Effect.flatMap((query) => requestGetEffect(client, `${FEED_BASE_PATH}/inventory_task`, feedListParams(query))));
+    /**
+     * Creates an LMS_ACTIVE_INVENTORY_REPORT download task; eBay answers 202 with only a Location.
+     * @param input - CreateInventoryTaskRequest body.
+     * @returns The new task ID and Location.
+     * @example feed.createInventoryTask({ task: { feedType: 'LMS_ACTIVE_INVENTORY_REPORT', schemaVersion: '1.0' } })
+     * @see https://developer.ebay.com/api-docs/sell/feed/resources/inventory_task/methods/createInventoryTask
+     */
+    const createInventoryTask = (input) => decodeEndpointInputEffect(createInventoryTaskInputSchema, input).pipe(Effect.flatMap(({ task }) => {
+        const body = task;
+        return postFeedTask(client, '/inventory_task', body);
+    }));
+    /**
+     * Retrieves one active inventory report task.
+     * @param input - Task identifier.
+     * @returns Generated InventoryTask.
+     * @example feed.getInventoryTask({ taskId: 'TASK-1' })
+     * @see https://developer.ebay.com/api-docs/sell/feed/resources/inventory_task/methods/getInventoryTask
+     */
+    const getInventoryTask = (input) => decodeEndpointInputEffect(feedTaskIdInputSchema, input).pipe(Effect.flatMap(({ taskId }) => requestGetEffect(client, feedResourcePath('/inventory_task', taskId))));
+    /**
+     * Lists customer service metric report tasks.
+     * @param input - feedType, dateRange or lookBackDays, limit, offset.
+     * @returns Generated CustomerServiceMetricTaskCollection.
+     * @example feed.getCustomerServiceMetricTasks({ lookBackDays: 30 })
+     * @see https://developer.ebay.com/api-docs/sell/feed/resources/customer_service_metric_task/methods/getCustomerServiceMetricTasks
+     */
+    const getCustomerServiceMetricTasks = (input = {}) => decodeEndpointInputEffect(getCustomerServiceMetricTasksInputSchema, input).pipe(Effect.flatMap(exclusiveFeedFilters), Effect.flatMap((query) => requestGetEffect(client, `${FEED_BASE_PATH}/customer_service_metric_task`, feedListParams(query))));
+    /**
+     * Creates a CUSTOMER_SERVICE_METRICS_REPORT download task; eBay answers 202 with only a
+     * Location. Accept-Language is required by eBay and defaults to the configured language.
+     * @param input - CreateServiceMetricsTaskRequest body and optional Accept-Language.
+     * @returns The new task ID and Location.
+     * @example feed.createCustomerServiceMetricTask({ task: { feedType: 'CUSTOMER_SERVICE_METRICS_REPORT', schemaVersion: '1.0', filterCriteria: { customerServiceMetricType: 'ITEM_NOT_RECEIVED', evaluationMarketplaceId: 'EBAY_US' } } })
+     * @see https://developer.ebay.com/api-docs/sell/feed/resources/customer_service_metric_task/methods/createCustomerServiceMetricTask
+     */
+    const createCustomerServiceMetricTask = (input) => decodeEndpointInputEffect(createCustomerServiceMetricTaskInputSchema, input).pipe(Effect.flatMap(({ task, acceptLanguage }) => {
+        const body = task;
+        const headers = acceptLanguage ? { 'Accept-Language': acceptLanguage } : undefined;
+        return postFeedTask(client, '/customer_service_metric_task', body, headers);
+    }));
+    /**
+     * Retrieves one customer service metric report task.
+     * @param input - Task identifier.
+     * @returns Generated ServiceMetricsTask.
+     * @example feed.getCustomerServiceMetricTask({ taskId: 'TASK-1' })
+     * @see https://developer.ebay.com/api-docs/sell/feed/resources/customer_service_metric_task/methods/getCustomerServiceMetricTask
+     */
+    const getCustomerServiceMetricTask = (input) => decodeEndpointInputEffect(feedTaskIdInputSchema, input).pipe(Effect.flatMap(({ taskId }) => requestGetEffect(client, feedResourcePath('/customer_service_metric_task', taskId))));
+    return {
+        getOrderTasks,
+        createOrderTask,
+        getOrderTask,
+        getInventoryTasks,
+        createInventoryTask,
+        getInventoryTask,
+        getCustomerServiceMetricTasks,
+        createCustomerServiceMetricTask,
+        getCustomerServiceMetricTask,
+    };
+};

package/build/api/listing-management/feedRequest.js

@@ -0,0 +1,91 @@
+import { requestDownloadEffect, } from '../../api/shared/download.js';
+import { locatedResourceId } from '../../api/shared/location.js';
+import { buildEndpointParams, EbayApiError, EndpointInputError, } from '../../api/shared/request.js';
+import { Effect } from 'effect';
+/** Feed API base path on the default `api` host. */
+export const FEED_BASE_PATH = '/sell/feed/v1';
+/**
+ * Feed API path of one resource, with its ID encoded as a single path segment.
+ *
+ * @param collection - Collection path below the base path, e.g. `/task`.
+ * @param id - Resource ID.
+ * @param suffix - Optional sub-path, e.g. `/download_result_file`.
+ * @returns The full REST path.
+ * @example feedResourcePath('/task', 'TASK-1', '/upload_file')
+ */
+export const feedResourcePath = (collection, id, suffix = '') => `${FEED_BASE_PATH}${collection}/${encodeURIComponent(id)}${suffix}`;
+/**
+ * Builds the query of a Feed API list endpoint with eBay's wire names.
+ *
+ * @param query - Decoded list filters and pagination.
+ * @returns Query params, or undefined when every value is omitted.
+ * @example feedListParams({ feedType: 'LMS_ORDER_REPORT', limit: 10 })
+ */
+export const feedListParams = (query) => buildEndpointParams({
+    feedType: { wireName: 'feed_type', value: query.feedType },
+    scheduleId: { wireName: 'schedule_id', value: query.scheduleId },
+    dateRange: { wireName: 'date_range', value: query.dateRange },
+    lookBackDays: { wireName: 'look_back_days', value: query.lookBackDays },
+    limit: { wireName: 'limit', value: query.limit },
+    offset: { wireName: 'offset', value: query.offset },
+});
+/**
+ * Rejects the list filter pairs eBay documents as mutually exclusive (feedType with scheduleId,
+ * dateRange with lookBackDays) before any request is sent.
+ *
+ * @param query - Decoded list filters and pagination.
+ * @returns An Effect with the same query, or an EndpointInputError naming the conflicting filter.
+ * @example exclusiveFeedFilters({ feedType: 'LMS_ORDER_REPORT', lookBackDays: 10 })
+ */
+export const exclusiveFeedFilters = (query) => {
+    if (query.feedType !== undefined && query.scheduleId !== undefined) {
+        return Effect.fail(new EndpointInputError({
+            parameter: 'scheduleId',
+            message: 'Pass feedType or scheduleId, not both',
+        }));
+    }
+    if (query.dateRange !== undefined && query.lookBackDays !== undefined) {
+        return Effect.fail(new EndpointInputError({
+            parameter: 'lookBackDays',
+            message: 'Pass dateRange or lookBackDays, not both',
+        }));
+    }
+    return Effect.succeed(query);
+};
+/**
+ * POSTs a Feed API create request whose new resource ID arrives only in `Location`.
+ *
+ * @param client - Shared authenticated HTTP client.
+ * @param collection - Collection path below the base path, e.g. `/schedule`.
+ * @param body - Generated create-request DTO.
+ * @param config - Optional per-request headers.
+ * @returns An Effect with the decoded ID and Location, or an EbayApiError.
+ * @example postFeedResource(client, '/schedule', { feedType: 'LMS_ORDER_REPORT', scheduleTemplateId: 'T-1' })
+ */
+export const postFeedResource = (client, collection, body, config) => {
+    const path = `${FEED_BASE_PATH}${collection}`;
+    return Effect.tryPromise({
+        try: () => client.postForResponse(path, body, config),
+        catch: (cause) => new EbayApiError({ method: 'POST', path, cause }), // allow-duplicate
+    }).pipe(Effect.flatMap((response) => locatedResourceId(response.headers.location, path)));
+};
+/**
+ * Creates a Feed API task (HTTP 202, no body) and returns the ID from its `Location`.
+ *
+ * @param client - Shared authenticated HTTP client.
+ * @param collection - Task collection path, e.g. `/order_task`.
+ * @param body - Generated create-task DTO.
+ * @param headers - Optional request headers such as Accept-Language.
+ * @returns An Effect with the new task ID and Location, or an EbayApiError.
+ * @example postFeedTask(client, '/task', { feedType: 'LMS_ORDER_ACK', schemaVersion: '1235' })
+ */
+export const postFeedTask = (client, collection, body, headers) => postFeedResource(client, collection, body, headers ? { headers } : undefined).pipe(Effect.map(({ id, location }) => ({ taskId: id, location })));
+/**
+ * Downloads a Feed API file (input, result or latest schedule report) as raw bytes.
+ *
+ * @param client - Shared authenticated HTTP client.
+ * @param path - Full Feed API download path.
+ * @returns An Effect with the bytes, content type and file name.
+ * @example downloadFeedFile(client, feedResourcePath('/task', 'TASK-1', '/download_result_file'))
+ */
+export const downloadFeedFile = (client, path) => requestDownloadEffect(client, path, { headers: { Accept: 'application/octet-stream' } });

package/build/api/listing-management/feedSchedules.js

@@ -0,0 +1,95 @@
+import { decodeEndpointInputEffect, EndpointInputError, requestDeleteEffect, requestGetEffect, requestPutEffect, } from '../../api/shared/request.js';
+import { createFeedScheduleInputSchema, feedScheduleIdInputSchema, feedScheduleTemplateIdInputSchema, feedTypePageInputSchema, updateFeedScheduleInputSchema, } from '../../schemas/inventory-management/feed.js';
+import { Effect } from 'effect';
+import { downloadFeedFile, FEED_BASE_PATH, feedListParams, feedResourcePath, postFeedResource, } from './feedRequest.js';
+/**
+ * Creates the Feed API `schedule` resource endpoints: recurring report schedules, their
+ * latest result file, and the templates schedules subscribe to.
+ * @param client - Shared authenticated HTTP client.
+ * @returns Endpoint Effects composed into FeedApi.
+ */
+export const createFeedScheduleMethods = (client) => {
+    /**
+     * Lists the seller's schedules for a feed type.
+     * @param input - feedType (required), limit, offset.
+     * @returns Generated UserScheduleCollection.
+     * @example feed.getSchedules({ feedType: 'LMS_ORDER_REPORT' })
+     * @see https://developer.ebay.com/api-docs/sell/feed/resources/schedule/methods/getSchedules
+     */
+    const getSchedules = (input) => decodeEndpointInputEffect(feedTypePageInputSchema, input).pipe(Effect.flatMap((query) => requestGetEffect(client, `${FEED_BASE_PATH}/schedule`, feedListParams(query))));
+    /**
+     * Subscribes to a schedule template; eBay answers 201 with the new ID only in Location.
+     * @param input - CreateUserScheduleRequest body.
+     * @returns The new schedule ID and Location.
+     * @example feed.createSchedule({ schedule: { feedType: 'LMS_ORDER_REPORT', scheduleTemplateId: 'T-1' } })
+     * @see https://developer.ebay.com/api-docs/sell/feed/resources/schedule/methods/createSchedule
+     */
+    const createSchedule = (input) => decodeEndpointInputEffect(createFeedScheduleInputSchema, input).pipe(Effect.flatMap(({ schedule }) => {
+        const body = schedule;
+        return postFeedResource(client, '/schedule', body);
+    }), Effect.map(({ id, location }) => ({ scheduleId: id, location })));
+    /**
+     * Retrieves one schedule's details and status.
+     * @param input - Schedule identifier.
+     * @returns Generated UserScheduleResponse.
+     * @example feed.getSchedule({ scheduleId: 'S-1' })
+     * @see https://developer.ebay.com/api-docs/sell/feed/resources/schedule/methods/getSchedule
+     */
+    const getSchedule = (input) => decodeEndpointInputEffect(feedScheduleIdInputSchema, input).pipe(Effect.flatMap(({ scheduleId }) => requestGetEffect(client, feedResourcePath('/schedule', scheduleId))));
+    /**
+     * Updates a schedule; the input is validated against its (possibly changed) template.
+     * @param input - Schedule identifier and UpdateUserScheduleRequest body with at least one field.
+     * @returns An Effect completing on eBay's empty HTTP 204 response.
+     * @example feed.updateSchedule({ scheduleId: 'S-1', schedule: { preferredTriggerHour: '11Z' } })
+     * @see https://developer.ebay.com/api-docs/sell/feed/resources/schedule/methods/updateSchedule
+     */
+    const updateSchedule = (input) => decodeEndpointInputEffect(updateFeedScheduleInputSchema, input).pipe(Effect.filterOrFail(({ schedule }) => Object.keys(schedule).length > 0, () => new EndpointInputError({
+        parameter: 'schedule',
+        message: 'Provide at least one schedule field to update',
+    })), Effect.flatMap(({ scheduleId, schedule }) => {
+        const body = schedule;
+        return requestPutEffect(client, feedResourcePath('/schedule', scheduleId), body);
+    }));
+    /**
+     * Deletes a schedule; it stops generating reports.
+     * @param input - Schedule identifier.
+     * @returns An Effect completing on eBay's empty HTTP 204 response.
+     * @example feed.deleteSchedule({ scheduleId: 'S-1' })
+     * @see https://developer.ebay.com/api-docs/sell/feed/resources/schedule/methods/deleteSchedule
+     */
+    const deleteSchedule = (input) => decodeEndpointInputEffect(feedScheduleIdInputSchema, input).pipe(Effect.flatMap(({ scheduleId }) => requestDeleteEffect(client, feedResourcePath('/schedule', scheduleId))));
+    /**
+     * Downloads the latest report a schedule generated.
+     * @param input - Schedule identifier.
+     * @returns File bytes (compressed or plain CSV, XML or JSON) with eBay's type and name.
+     * @example feed.getLatestResultFile({ scheduleId: 'S-1' })
+     * @see https://developer.ebay.com/api-docs/sell/feed/resources/schedule/methods/getLatestResultFile
+     */
+    const getLatestResultFile = (input) => decodeEndpointInputEffect(feedScheduleIdInputSchema, input).pipe(Effect.flatMap(({ scheduleId }) => downloadFeedFile(client, feedResourcePath('/schedule', scheduleId, '/download_result_file'))));
+    /**
+     * Retrieves one schedule template, including the fields a schedule must supply.
+     * @param input - Schedule template identifier.
+     * @returns Generated ScheduleTemplateResponse.
+     * @example feed.getScheduleTemplate({ scheduleTemplateId: 'T-1' })
+     * @see https://developer.ebay.com/api-docs/sell/feed/resources/schedule/methods/getScheduleTemplate
+     */
+    const getScheduleTemplate = (input) => decodeEndpointInputEffect(feedScheduleTemplateIdInputSchema, input).pipe(Effect.flatMap(({ scheduleTemplateId }) => requestGetEffect(client, feedResourcePath('/schedule_template', scheduleTemplateId))));
+    /**
+     * Lists the schedule templates for a feed type.
+     * @param input - feedType (required), limit, offset.
+     * @returns Generated ScheduleTemplateCollection.
+     * @example feed.getScheduleTemplates({ feedType: 'LMS_ORDER_REPORT' })
+     * @see https://developer.ebay.com/api-docs/sell/feed/resources/schedule/methods/getScheduleTemplates
+     */
+    const getScheduleTemplates = (input) => decodeEndpointInputEffect(feedTypePageInputSchema, input).pipe(Effect.flatMap((query) => requestGetEffect(client, `${FEED_BASE_PATH}/schedule_template`, feedListParams(query))));
+    return {
+        getSchedules,
+        createSchedule,
+        getSchedule,
+        updateSchedule,
+        deleteSchedule,
+        getLatestResultFile,
+        getScheduleTemplate,
+        getScheduleTemplates,
+    };
+};