ebay-mcp 1.17.0 → 1.18.2

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 createRequest - 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, createRequest, config) => {
+    const path = `${FEED_BASE_PATH}${collection}`;
+    return Effect.tryPromise({
+        try: () => client.postForResponse(path, createRequest, config),
+        catch: (cause) => new EbayApiError({ method: 'POST', path, cause }), // allow-duplicate
+    }).pipe(Effect.flatMap((createdResponse) => locatedResourceId(createdResponse.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 taskRequest - 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, taskRequest, headers) => postFeedResource(client, collection, taskRequest, 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 createScheduleRequest = schedule;
+        return postFeedResource(client, '/schedule', createScheduleRequest);
+    }), 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 updateScheduleRequest = schedule;
+        return requestPutEffect(client, feedResourcePath('/schedule', scheduleId), updateScheduleRequest);
+    }));
+    /**
+     * 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,
+    };
+};

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

@@ -0,0 +1,91 @@
+import { decodeEndpointInputEffect, requestGetEffect, requestPostEffect, requireObjectEffect, requireStringEffect, } from '../../api/shared/request.js';
+import { createFeedTaskInputSchema, feedTaskIdInputSchema, getFeedTasksInputSchema, } from '../../schemas/inventory-management/feed.js';
+import { Effect } from 'effect';
+import { downloadFeedFile, exclusiveFeedFilters, FEED_BASE_PATH, feedListParams, feedResourcePath, postFeedTask, } from './feedRequest.js';
+/** Feed files can be up to 15 MB, far larger than JSON calls. */
+const UPLOAD_TIMEOUT_MS = 10 * 60_000;
+/** Multipart body documented for uploadFile: fileName, name=file, type=form-data, then the file. */
+const feedFileForm = (file) => {
+    const form = new FormData();
+    form.append('fileName', file.fileName);
+    form.append('name', 'file');
+    form.append('type', 'form-data');
+    // Copy into a fresh ArrayBuffer-backed view: Blob rejects Node's ArrayBufferLike-typed views.
+    form.append('file', new Blob([new Uint8Array(file.bytes)], { type: file.mimeType }), file.fileName);
+    return form;
+};
+/**
+ * Creates the Feed API `task` resource endpoints: upload and download tasks without filter
+ * criteria, their input/result files, and feed file uploads.
+ * @param client - Shared authenticated HTTP client.
+ * @returns Endpoint Effects composed into FeedApi.
+ */
+export const createFeedTaskMethods = (client) => {
+    /**
+     * Lists feed tasks by feed type or schedule, with creation-date filters and pagination.
+     * @param input - feedType or scheduleId (not both), dateRange or lookBackDays, limit, offset.
+     * @returns Generated TaskCollection.
+     * @example feed.getTasks({ feedType: 'LMS_ORDER_ACK', lookBackDays: 7 })
+     * @see https://developer.ebay.com/api-docs/sell/feed/resources/task/methods/getTasks
+     */
+    const getTasks = (input = {}) => decodeEndpointInputEffect(getFeedTasksInputSchema, input).pipe(Effect.flatMap(exclusiveFeedFilters), Effect.flatMap((query) => requestGetEffect(client, `${FEED_BASE_PATH}/task`, feedListParams(query))));
+    /**
+     * Creates an upload or download task for a feed type; eBay answers 202 with only a Location.
+     * @param input - CreateTaskRequest body plus optional marketplace and Accept-Language headers.
+     * @returns The new task ID and Location.
+     * @example feed.createTask({ task: { feedType: 'LMS_ADD_FIXED_PRICE_ITEM', schemaVersion: '1423' } })
+     * @see https://developer.ebay.com/api-docs/sell/feed/resources/task/methods/createTask
+     */
+    const createTask = (input) => Effect.gen(function* () {
+        const { task, marketplaceId, acceptLanguage } = yield* decodeEndpointInputEffect(createFeedTaskInputSchema, input);
+        const taskRequest = task;
+        const headers = {};
+        if (marketplaceId) {
+            headers['X-EBAY-C-MARKETPLACE-ID'] = marketplaceId;
+        }
+        if (acceptLanguage) {
+            headers['Accept-Language'] = acceptLanguage;
+        }
+        return yield* postFeedTask(client, '/task', taskRequest, headers);
+    });
+    /**
+     * Retrieves a feed task's status and upload summary.
+     * @param input - Task identifier.
+     * @returns Generated Task.
+     * @example feed.getTask({ taskId: 'TASK-1' })
+     * @see https://developer.ebay.com/api-docs/sell/feed/resources/task/methods/getTask
+     */
+    const getTask = (input) => decodeEndpointInputEffect(feedTaskIdInputSchema, input).pipe(Effect.flatMap(({ taskId }) => requestGetEffect(client, feedResourcePath('/task', taskId))));
+    /**
+     * Downloads the file previously uploaded to a task (not for LMS_ORDER_REPORT or
+     * LMS_ACTIVE_INVENTORY_REPORT tasks).
+     * @param input - Task identifier.
+     * @returns File bytes with eBay's content type and file name.
+     * @example feed.getInputFile({ taskId: 'TASK-1' })
+     * @see https://developer.ebay.com/api-docs/sell/feed/resources/task/methods/getInputFile
+     */
+    const getInputFile = (input) => decodeEndpointInputEffect(feedTaskIdInputSchema, input).pipe(Effect.flatMap(({ taskId }) => downloadFeedFile(client, feedResourcePath('/task', taskId, '/download_input_file'))));
+    /**
+     * Downloads a task's generated result file once it is COMPLETED or COMPLETED_WITH_ERROR.
+     * @param input - Task identifier.
+     * @returns File bytes (often csv.gz or zipped XML) with eBay's content type and file name.
+     * @example feed.getResultFile({ taskId: 'TASK-1' })
+     * @see https://developer.ebay.com/api-docs/sell/feed/resources/task/methods/getResultFile
+     */
+    const getResultFile = (input) => decodeEndpointInputEffect(feedTaskIdInputSchema, input).pipe(Effect.flatMap(({ taskId }) => downloadFeedFile(client, feedResourcePath('/task', taskId, '/download_result_file'))));
+    /**
+     * Uploads the feed file of an upload task as multipart/form-data; eBay then processes it
+     * asynchronously (QUEUED, IN_PROCESS, COMPLETED or COMPLETED_WITH_ERROR).
+     * @param input - Task identifier and a validated local feed file.
+     * @returns eBay's (empty) acknowledgement.
+     * @example feed.uploadFile({ taskId: 'TASK-1', file })
+     * @see https://developer.ebay.com/api-docs/sell/feed/resources/task/methods/uploadFile
+     */
+    const uploadFile = (input) => Effect.gen(function* () {
+        const { taskId } = yield* decodeEndpointInputEffect(feedTaskIdInputSchema, input);
+        const file = yield* requireObjectEffect(input.file, 'file');
+        yield* requireStringEffect(file.fileName, 'file.fileName');
+        return yield* requestPostEffect(client, feedResourcePath('/task', taskId, '/upload_file'), feedFileForm(file), { timeoutMs: UPLOAD_TIMEOUT_MS });
+    });
+    return { getTasks, createTask, getTask, getInputFile, getResultFile, uploadFile };
+};

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

@@ -11,7 +11,7 @@ export const createInventoryItemsMethods = (client) => ({
      *
      * @example
      * ```ts
-     * const items = await Effect.runPromise(inventoryApi.getInventoryItems({ limit: 25 }));
+     * const inventoryPage = await Effect.runPromise(inventoryApi.getInventoryItems({ limit: 25 }));
      * ```
      *
      * @see https://developer.ebay.com/api-docs/sell/inventory/resources/inventory_item/methods/getInventoryItems
@@ -37,7 +37,7 @@ export const createInventoryItemsMethods = (client) => ({
      *
      * @example
      * ```ts
-     * const item = await Effect.runPromise(inventoryApi.getInventoryItem({ sku: 'SKU-1' }));
+     * const inventoryItem = await Effect.runPromise(inventoryApi.getInventoryItem({ sku: 'SKU-1' }));
      * ```
      *
      * @see https://developer.ebay.com/api-docs/sell/inventory/resources/inventory_item/methods/getInventoryItem
@@ -70,11 +70,11 @@ export const createInventoryItemsMethods = (client) => ({
         return Effect.gen(function* () {
             const validatedInput = yield* requireObjectEffect(input, 'input');
             const sku = yield* requireStringEffect(validatedInput.sku, 'sku');
-            const body = yield* requireObjectEffect(validatedInput.body, 'body');
+            const inventoryItem = yield* requireObjectEffect(validatedInput.body, 'body');
             const config = validatedInput.contentLanguage === undefined
                 ? undefined
                 : { headers: { 'Content-Language': validatedInput.contentLanguage } };
-            return yield* requestPutEffect(client, `${basePath}/inventory_item/${sku}`, body, config);
+            return yield* requestPutEffect(client, `${basePath}/inventory_item/${sku}`, inventoryItem, config);
         });
     },
     /**
@@ -106,7 +106,7 @@ export const createInventoryItemsMethods = (client) => ({
      *
      * @example
      * ```ts
-     * const result = await Effect.runPromise(
+     * const inventoryItemResults = await Effect.runPromise(
      *   inventoryApi.bulkCreateOrReplaceInventoryItem({ body: { requests: [] } }),
      * );
      * ```
@@ -117,8 +117,8 @@ export const createInventoryItemsMethods = (client) => ({
         const path = `${INVENTORY_BASE_PATH}/bulk_create_or_replace_inventory_item`;
         return Effect.gen(function* () {
             const validatedInput = yield* requireObjectEffect(input, 'input');
-            const body = yield* requireObjectEffect(validatedInput.body, 'body');
-            return yield* requestPostEffect(client, path, body);
+            const bulkInventoryItemRequest = yield* requireObjectEffect(validatedInput.body, 'body');
+            return yield* requestPostEffect(client, path, bulkInventoryItemRequest);
         });
     },
     /**
@@ -129,7 +129,7 @@ export const createInventoryItemsMethods = (client) => ({
      *
      * @example
      * ```ts
-     * const result = await Effect.runPromise(
+     * const inventoryItems = await Effect.runPromise(
      *   inventoryApi.bulkGetInventoryItem({ body: { requests: [{ sku: 'SKU-1' }] } }),
      * );
      * ```
@@ -140,8 +140,8 @@ export const createInventoryItemsMethods = (client) => ({
         const path = `${INVENTORY_BASE_PATH}/bulk_get_inventory_item`;
         return Effect.gen(function* () {
             const validatedInput = yield* requireObjectEffect(input, 'input');
-            const body = yield* requireObjectEffect(validatedInput.body, 'body');
-            return yield* requestPostEffect(client, path, body);
+            const bulkGetInventoryItemRequest = yield* requireObjectEffect(validatedInput.body, 'body');
+            return yield* requestPostEffect(client, path, bulkGetInventoryItemRequest);
         });
     },
     /**
@@ -152,7 +152,7 @@ export const createInventoryItemsMethods = (client) => ({
      *
      * @example
      * ```ts
-     * const result = await Effect.runPromise(
+     * const priceQuantityResults = await Effect.runPromise(
      *   inventoryApi.bulkUpdatePriceQuantity({ body: { requests: [] } }),
      * );
      * ```
@@ -163,8 +163,8 @@ export const createInventoryItemsMethods = (client) => ({
         const path = `${INVENTORY_BASE_PATH}/bulk_update_price_quantity`;
         return Effect.gen(function* () {
             const validatedInput = yield* requireObjectEffect(input, 'input');
-            const body = yield* requireObjectEffect(validatedInput.body, 'body');
-            return yield* requestPostEffect(client, path, body);
+            const bulkPriceQuantityRequest = yield* requireObjectEffect(validatedInput.body, 'body');
+            return yield* requestPostEffect(client, path, bulkPriceQuantityRequest);
         });
     },
     /**
@@ -210,8 +210,8 @@ export const createInventoryItemsMethods = (client) => ({
         return Effect.gen(function* () {
             const validatedInput = yield* requireObjectEffect(input, 'input');
             const sku = yield* requireStringEffect(validatedInput.sku, 'sku');
-            const body = yield* requireObjectEffect(validatedInput.body, 'body');
-            return yield* requestPutEffect(client, `${basePath}/inventory_item/${sku}/product_compatibility`, body);
+            const productCompatibility = yield* requireObjectEffect(validatedInput.body, 'body');
+            return yield* requestPutEffect(client, `${basePath}/inventory_item/${sku}/product_compatibility`, productCompatibility);
         });
     },
     /**
@@ -281,8 +281,8 @@ export const createInventoryItemsMethods = (client) => ({
         return Effect.gen(function* () {
             const validatedInput = yield* requireObjectEffect(input, 'input');
             const inventoryItemGroupKey = yield* requireStringEffect(validatedInput.inventoryItemGroupKey, 'inventoryItemGroupKey');
-            const body = yield* requireObjectEffect(validatedInput.body, 'body');
-            return yield* requestPutEffect(client, `${basePath}/inventory_item_group/${inventoryItemGroupKey}`, body);
+            const inventoryItemGroup = yield* requireObjectEffect(validatedInput.body, 'body');
+            return yield* requestPutEffect(client, `${basePath}/inventory_item_group/${inventoryItemGroupKey}`, inventoryItemGroup);
         });
     },
     /**
@@ -316,7 +316,7 @@ export const createInventoryItemsMethods = (client) => ({
      *
      * @example
      * ```ts
-     * const result = await Effect.runPromise(
+     * const migratedListings = await Effect.runPromise(
      *   inventoryApi.bulkMigrateListing({ body: { requests: [] } }),
      * );
      * ```
@@ -327,8 +327,8 @@ export const createInventoryItemsMethods = (client) => ({
         const path = `${INVENTORY_BASE_PATH}/bulk_migrate_listing`;
         return Effect.gen(function* () {
             const validatedInput = yield* requireObjectEffect(input, 'input');
-            const body = yield* requireObjectEffect(validatedInput.body, 'body');
-            return yield* requestPostEffect(client, path, body);
+            const bulkMigrateListingRequest = yield* requireObjectEffect(validatedInput.body, 'body');
+            return yield* requestPostEffect(client, path, bulkMigrateListingRequest);
         });
     },
     /**
@@ -380,8 +380,8 @@ export const createInventoryItemsMethods = (client) => ({
             const validatedInput = yield* requireObjectEffect(input, 'input');
             const listingId = yield* requireStringEffect(validatedInput.listingId, 'listingId');
             const sku = yield* requireStringEffect(validatedInput.sku, 'sku');
-            const body = yield* requireObjectEffect(validatedInput.body, 'body');
-            return yield* requestPutEffect(client, `${basePath}/listing/${listingId}/sku/${sku}/locations`, body);
+            const locationMapping = yield* requireObjectEffect(validatedInput.body, 'body');
+            return yield* requestPutEffect(client, `${basePath}/listing/${listingId}/sku/${sku}/locations`, locationMapping);
         });
     },
     /**

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

@@ -46,8 +46,8 @@ export const createInventoryLocationsMethods = (client) => ({
         return Effect.gen(function* () {
             const validatedInput = yield* requireObjectEffect(input, 'input');
             const merchantLocationKey = yield* requireStringEffect(validatedInput.merchantLocationKey, 'merchantLocationKey');
-            const body = yield* requireObjectEffect(validatedInput.body, 'body');
-            return yield* requestPostEffect(client, `${basePath}/location/${merchantLocationKey}`, body);
+            const inventoryLocation = yield* requireObjectEffect(validatedInput.body, 'body');
+            return yield* requestPostEffect(client, `${basePath}/location/${merchantLocationKey}`, inventoryLocation);
         });
     },
     /**
@@ -165,8 +165,8 @@ export const createInventoryLocationsMethods = (client) => ({
         return Effect.gen(function* () {
             const validatedInput = yield* requireObjectEffect(input, 'input');
             const merchantLocationKey = yield* requireStringEffect(validatedInput.merchantLocationKey, 'merchantLocationKey');
-            const body = yield* requireObjectEffect(validatedInput.body, 'body');
-            return yield* requestPostEffect(client, `${basePath}/location/${merchantLocationKey}/update_location_details`, body);
+            const inventoryLocationUpdate = yield* requireObjectEffect(validatedInput.body, 'body');
+            return yield* requestPostEffect(client, `${basePath}/location/${merchantLocationKey}/update_location_details`, inventoryLocationUpdate);
         });
     },
 });

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

@@ -33,23 +33,23 @@ const videoStatusFinal = (video) => video.status !== undefined && TERMINAL_VIDEO
  * standing still while status requests kept going, so the boundary is checked
  * before the first poll rather than inside the loop.
  *
- * @param value - Caller-supplied duration in milliseconds, or undefined.
+ * @param durationMs - Caller-supplied duration in milliseconds, or undefined.
  * @param fallback - Duration used when the caller supplied none.
  * @param name - Parameter name used in the validation message.
  * @param minimum - Smallest accepted value.
  * @returns An Effect with the duration to use, or a tagged input error.
  */
-const requireDurationMs = (value, fallback, name, minimum) => {
-    if (value === undefined) {
+const requireDurationMs = (durationMs, fallback, name, minimum) => {
+    if (durationMs === undefined) {
         return Effect.succeed(fallback);
     }
-    if (!Number.isFinite(value) || value < minimum) {
+    if (!Number.isFinite(durationMs) || durationMs < minimum) {
         return Effect.fail(new EndpointInputError({
             parameter: name,
             message: `${name} must be a finite number of milliseconds of at least ${minimum} when provided`,
         }));
     }
-    return Effect.succeed(value);
+    return Effect.succeed(durationMs);
 };
 /**
  * Media API client. Image and video uploads go to eBay's `apim` host and return
@@ -120,14 +120,14 @@ export class MediaApi {
             const form = new FormData();
             // Copy into a fresh ArrayBuffer-backed view: Blob rejects Node's ArrayBufferLike-typed views.
             form.append('image', new Blob([new Uint8Array(upload.bytes)], { type: upload.mimeType }), fileName);
-            const response = yield* Effect.tryPromise({
+            const imageResponse = yield* Effect.tryPromise({
                 try: () => client.postForResponse(url, form, {
                     absolute: true,
                     timeoutMs: UPLOAD_TIMEOUT_MS,
                 }),
                 catch: apiFailure('POST', path),
             });
-            const imageUrl = response.data?.imageUrl;
+            const imageUrl = imageResponse.data?.imageUrl;
             if (!imageUrl) {
                 return yield* Effect.fail(new EbayApiError({
                     method: 'POST',
@@ -137,9 +137,9 @@ export class MediaApi {
             }
             return {
                 source: upload.source,
-                imageId: idFromLocation(response.headers.location),
+                imageId: idFromLocation(imageResponse.headers.location),
                 imageUrl,
-                expirationDate: response.data?.expirationDate,
+                expirationDate: imageResponse.data?.expirationDate,
             };
         });
     };
@@ -166,7 +166,7 @@ export class MediaApi {
                     index,
                     uploaded: [...uploaded],
                     cause,
-                    message: `upload of ${file.source} (file ${index + 1} of ${files.length}) failed: ${getErrorMessage(cause)}${uploaded.length > 0 ? `; already uploaded: ${uploaded.map((item) => item.imageUrl).join(', ')}` : ''}`,
+                    message: `upload of ${file.source} (file ${index + 1} of ${files.length}) failed: ${getErrorMessage(cause)}${uploaded.length > 0 ? `; already uploaded: ${uploaded.map((uploadedImage) => uploadedImage.imageUrl).join(', ')}` : ''}`,
                 })));
                 uploaded.push(image);
             }
@@ -218,17 +218,17 @@ export class MediaApi {
         return Effect.gen(function* () {
             const validated = yield* requireObjectEffect(input, 'input');
             const title = yield* requireStringEffect(validated.title, 'title');
-            const body = {
+            const videoRequest = {
                 title,
                 size: validated.size,
                 description: validated.description,
                 classification: ['ITEM'],
             };
-            const response = yield* Effect.tryPromise({
-                try: () => client.postForResponse(url, body, { absolute: true }),
+            const videoResponse = yield* Effect.tryPromise({
+                try: () => client.postForResponse(url, videoRequest, { absolute: true }),
                 catch: apiFailure('POST', path),
             });
-            const videoId = idFromLocation(response.headers.location);
+            const videoId = idFromLocation(videoResponse.headers.location);
             if (!videoId) {
                 return yield* Effect.fail(new EbayApiError({
                     method: 'POST',

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

@@ -6,13 +6,13 @@ export class MediaAttachError extends Data.TaggedError('MediaAttachError') {
 }
 const dedupe = (values) => [...new Set(values)];
 /** Keeps only the fields createOrReplaceInventoryItem accepts (drops sku/group metadata). */
-const toInventoryItemBody = (item) => ({
-    availability: item.availability,
-    condition: item.condition,
-    conditionDescription: item.conditionDescription,
-    conditionDescriptors: item.conditionDescriptors,
-    packageWeightAndSize: item.packageWeightAndSize,
-    product: item.product,
+const toInventoryItemBody = (inventoryItem) => ({
+    availability: inventoryItem.availability,
+    condition: inventoryItem.condition,
+    conditionDescription: inventoryItem.conditionDescription,
+    conditionDescriptors: inventoryItem.conditionDescriptors,
+    packageWeightAndSize: inventoryItem.packageWeightAndSize,
+    product: inventoryItem.product,
 });
 /** `Content-Language` value for an inventory item locale such as `en_US`. */
 const contentLanguageOf = (locale) => locale?.replace('_', '-');
@@ -68,9 +68,9 @@ const failedOutcome = (file, kind, cause) => ({
     status: 'failed',
     error: getErrorMessage(cause),
 });
-const attachFailure = (summary, result) => new MediaAttachError({
-    message: `${summary}. Results: ${JSON.stringify({ images: result.images, videos: result.videos })}`,
-    result,
+const attachFailure = (summary, attachResult) => new MediaAttachError({
+    message: `${summary}. Results: ${JSON.stringify({ images: attachResult.images, videos: attachResult.videos })}`,
+    result: attachResult,
 });
 /** Uploads every file, turning each failure into a `failed` outcome instead of aborting. */
 const uploadAll = (media, input) => Effect.gen(function* () {
@@ -117,7 +117,7 @@ export const createMediaAttachMethods = (items, media) => ({
         const { images, videos } = yield* uploadAll(media, input);
         const failed = [...images, ...videos].filter((outcome) => outcome.status === 'failed');
         const uploaded = uploadedMedia(images, videos);
-        const result = {
+        const attachResult = {
             sku: input.sku,
             updated: false,
             images,
@@ -125,10 +125,10 @@ export const createMediaAttachMethods = (items, media) => ({
             ...mergeMedia(snapshot.product ?? {}, input, uploaded),
         };
         if (failed.length > 0 && !input.allowPartial) {
-            return yield* Effect.fail(attachFailure(`${failed.length} of ${total} uploads failed; inventory item ${input.sku} was not updated (pass allowPartial: true to attach the successful ones)`, result));
+            return yield* Effect.fail(attachFailure(`${failed.length} of ${total} uploads failed; inventory item ${input.sku} was not updated (pass allowPartial: true to attach the successful ones)`, attachResult));
         }
         if (uploaded.imageUrls.length + uploaded.videoIds.length === 0) {
-            return yield* Effect.fail(attachFailure(`no media was uploaded successfully; inventory item ${input.sku} was not updated`, result));
+            return yield* Effect.fail(attachFailure(`no media was uploaded successfully; inventory item ${input.sku} was not updated`, attachResult));
         }
         // Re-read right before the complete-replacement PUT: the uploads can take
         // minutes, and the earlier snapshot must not overwrite edits made meanwhile.
@@ -140,6 +140,6 @@ export const createMediaAttachMethods = (items, media) => ({
             contentLanguage: contentLanguageOf(latest.locale),
             body: { ...toInventoryItemBody(latest), product: { ...product, ...merged } },
         });
-        return { ...result, ...merged, updated: true };
+        return { ...attachResult, ...merged, updated: true };
     }),
 });