ebay-mcp 1.17.0 → 1.18.2

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

@@ -1,34 +1,15 @@
-import { EbayApiError, EndpointInputError } from '../../api/shared/request.js';
+import { locatedResourceId } from '../../api/shared/location.js';
+import { decodeEndpointInputEffect, EbayApiError } from '../../api/shared/request.js';
 import { getIdentityBaseUrl, getMediaBaseUrl } from '../../config/environment.js';
 import { createDocumentFromUrlInputSchema, createDocumentInputSchema, createImageFromUrlInputSchema, documentIdInputSchema, postOrderDocumentMetadataSchema, } from '../../schemas/inventory-management/mediaDocuments.js';
-import { decodeEffectSchema } from '../../utils/effectSchema.js';
 import { Effect } from 'effect';
 const BASE_PATH = '/commerce/media/v1_beta';
 const UPLOAD_TIMEOUT_MS = 10 * 60_000;
-const inputFailure = (cause) => new EndpointInputError({ parameter: 'input', message: cause.message });
 const uploadForm = (file) => {
     const form = new FormData();
     form.append('file', new Blob([new Uint8Array(file.bytes)], { type: file.mimeType }), file.fileName);
     return form;
 };
-const locationId = (location, path) => Effect.try({
-    try: () => {
-        if (!location) {
-            throw new Error('eBay returned no Location header');
-        }
-        const url = new URL(location);
-        const prefix = `${path}/`;
-        const segment = url.pathname.slice(prefix.length);
-        if (url.protocol !== 'https:' ||
-            !url.pathname.startsWith(prefix) ||
-            !segment ||
-            segment.includes('/')) {
-            throw new Error('eBay returned an invalid resource Location');
-        }
-        return { location, id: decodeURIComponent(segment) };
-    },
-    catch: (cause) => new EbayApiError({ method: 'POST', path, cause }),
-});
 /**
  * Creates endpoint methods for image URLs and documents on the Media API.
  * @param client - Shared authenticated HTTP client.
@@ -51,16 +32,16 @@ export const createMediaResourceMethods = (client) => {
      * @see https://developer.ebay.com/api-docs/commerce/media/resources/image/methods/createImageFromUrl
      */
     const createImageFromUrl = (input) => Effect.gen(function* () {
-        const body = yield* decodeEffectSchema(createImageFromUrlInputSchema, input).pipe(Effect.mapError(inputFailure));
+        const imageSource = yield* decodeEndpointInputEffect(createImageFromUrlInputSchema, input);
         const path = '/image/create_image_from_url';
-        const response = yield* Effect.tryPromise({
-            try: () => client.postForResponse(url(path), body, {
+        const imageResponse = yield* Effect.tryPromise({
+            try: () => client.postForResponse(url(path), imageSource, {
                 absolute: true,
             }),
             catch: failure('POST', path),
         });
-        const resource = yield* locationId(response.headers.location, `${BASE_PATH}/image`);
-        return { imageId: resource.id, location: resource.location, image: response.data };
+        const resource = yield* locatedResourceId(imageResponse.headers.location, `${BASE_PATH}/image`);
+        return { imageId: resource.id, location: resource.location, image: imageResponse.data };
     });
     /**
      * Stages a listing document for subsequent upload.
@@ -70,9 +51,11 @@ export const createMediaResourceMethods = (client) => {
      * @see https://developer.ebay.com/api-docs/commerce/media/resources/document/methods/createDocument
      */
     const createDocument = (input) => Effect.gen(function* () {
-        const body = yield* decodeEffectSchema(createDocumentInputSchema, input).pipe(Effect.mapError(inputFailure));
+        const documentRequest = yield* decodeEndpointInputEffect(createDocumentInputSchema, input);
         return yield* Effect.tryPromise({
-            try: () => client.post(url('/document'), body, { absolute: true }),
+            try: () => client.post(url('/document'), documentRequest, {
+                absolute: true,
+            }),
             catch: failure('POST', '/document'),
         });
     });
@@ -84,10 +67,10 @@ export const createMediaResourceMethods = (client) => {
      * @see https://developer.ebay.com/api-docs/commerce/media/resources/document/methods/createDocumentFromUrl
      */
     const createDocumentFromUrl = (input) => Effect.gen(function* () {
-        const body = yield* decodeEffectSchema(createDocumentFromUrlInputSchema, input).pipe(Effect.mapError(inputFailure));
+        const documentRequest = yield* decodeEndpointInputEffect(createDocumentFromUrlInputSchema, input);
         const path = '/document/create_document_from_url';
         return yield* Effect.tryPromise({
-            try: () => client.post(url(path), body, { absolute: true }),
+            try: () => client.post(url(path), documentRequest, { absolute: true }),
             catch: failure('POST', path),
         });
     });
@@ -99,7 +82,7 @@ export const createMediaResourceMethods = (client) => {
      * @see https://developer.ebay.com/api-docs/commerce/media/resources/document/methods/getDocument
      */
     const getDocument = (input) => Effect.gen(function* () {
-        const { documentId } = yield* decodeEffectSchema(documentIdInputSchema, input).pipe(Effect.mapError(inputFailure));
+        const { documentId } = yield* decodeEndpointInputEffect(documentIdInputSchema, input);
         const path = `/document/${encodeURIComponent(documentId)}`;
         return yield* Effect.tryPromise({
             try: () => client.get(url(path), undefined, { absolute: true }),
@@ -114,7 +97,7 @@ export const createMediaResourceMethods = (client) => {
      * @see https://developer.ebay.com/api-docs/commerce/media/resources/document/methods/uploadDocument
      */
     const uploadDocument = (input) => Effect.gen(function* () {
-        const { documentId } = yield* decodeEffectSchema(documentIdInputSchema, input).pipe(Effect.mapError(inputFailure));
+        const { documentId } = yield* decodeEndpointInputEffect(documentIdInputSchema, input);
         const path = `/document/${encodeURIComponent(documentId)}/upload`;
         return yield* Effect.tryPromise({
             try: () => client.post(url(path), uploadForm(input.file), {
@@ -132,20 +115,20 @@ export const createMediaResourceMethods = (client) => {
      * @see https://developer.ebay.com/api-docs/commerce/media/resources/post_order/methods/uploadPostOrderDocument
      */
     const uploadPostOrderDocument = (input) => Effect.gen(function* () {
-        const metadata = yield* decodeEffectSchema(postOrderDocumentMetadataSchema, input).pipe(Effect.mapError(inputFailure));
+        const metadata = yield* decodeEndpointInputEffect(postOrderDocumentMetadataSchema, input);
         const form = uploadForm(input.file);
-        for (const [key, value] of Object.entries(metadata)) {
-            form.append(key, value);
+        for (const [fieldName, fieldValue] of Object.entries(metadata)) {
+            form.append(fieldName, fieldValue);
         }
         const path = '/post_order/document';
-        const response = yield* Effect.tryPromise({
+        const uploadResponse = yield* Effect.tryPromise({
             try: () => client.postForResponse(url(path, true), form, {
                 absolute: true,
                 timeoutMs: UPLOAD_TIMEOUT_MS,
             }),
             catch: failure('POST', path),
         });
-        const resource = yield* locationId(response.headers.location, `${BASE_PATH}${path}`);
+        const resource = yield* locatedResourceId(uploadResponse.headers.location, `${BASE_PATH}${path}`);
         return { documentId: resource.id, location: resource.location };
     });
     /**
@@ -156,7 +139,7 @@ export const createMediaResourceMethods = (client) => {
      * @see https://developer.ebay.com/api-docs/commerce/media/resources/post_order/methods/downloadPostOrderDocument
      */
     const downloadPostOrderDocument = (input) => Effect.gen(function* () {
-        const { documentId } = yield* decodeEffectSchema(documentIdInputSchema, input).pipe(Effect.mapError(inputFailure));
+        const { documentId } = yield* decodeEndpointInputEffect(documentIdInputSchema, input);
         const path = `/post_order/document/${encodeURIComponent(documentId)}`;
         return yield* Effect.tryPromise({
             try: () => client.get(url(path, true), undefined, {
@@ -175,7 +158,7 @@ export const createMediaResourceMethods = (client) => {
      * @see https://developer.ebay.com/api-docs/commerce/media/resources/post_order/methods/removePostOrderDocument
      */
     const removePostOrderDocument = (input) => Effect.gen(function* () {
-        const { documentId } = yield* decodeEffectSchema(documentIdInputSchema, input).pipe(Effect.mapError(inputFailure));
+        const { documentId } = yield* decodeEndpointInputEffect(documentIdInputSchema, input);
         const path = `/post_order/document/${encodeURIComponent(documentId)}`;
         yield* Effect.tryPromise({
             try: () => client.delete(url(path, true), { absolute: true }),

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

@@ -102,7 +102,7 @@ export const findOfferFormatViolation = (offer, parameter) => {
  *
  * @example
  * ```ts
- * yield* validateOfferFormatEffect(body, 'body');
+ * yield* validateOfferFormatEffect(offerDetails, 'body');
  * ```
  */
 export const validateOfferFormatEffect = (offer, parameter) => {

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

@@ -36,7 +36,7 @@ export const createInventoryOffersMethods = (client) => ({
      *
      * @example
      * ```ts
-     * const result = await Effect.runPromise(inventoryApi.bulkCreateOffer({ body: { requests: [] } }));
+     * const createdOffers = await Effect.runPromise(inventoryApi.bulkCreateOffer({ body: { requests: [] } }));
      * ```
      *
      * @see https://developer.ebay.com/api-docs/sell/inventory/resources/offer/methods/bulkCreateOffer
@@ -45,9 +45,9 @@ export const createInventoryOffersMethods = (client) => ({
         const path = `${INVENTORY_BASE_PATH}/bulk_create_offer`;
         return Effect.gen(function* () {
             const validatedInput = yield* requireObjectEffect(input, 'input');
-            const body = yield* requireObjectEffect(validatedInput.body, 'body');
-            yield* Effect.forEach(body.requests ?? [], (request, index) => validateOfferFormatEffect(request, `body.requests[${index}]`), { discard: true });
-            return yield* requestPostEffect(client, path, body);
+            const bulkOfferRequest = yield* requireObjectEffect(validatedInput.body, 'body');
+            yield* Effect.forEach(bulkOfferRequest.requests ?? [], (offerRequest, index) => validateOfferFormatEffect(offerRequest, `body.requests[${index}]`), { discard: true });
+            return yield* requestPostEffect(client, path, bulkOfferRequest);
         });
     },
     /**
@@ -58,7 +58,7 @@ export const createInventoryOffersMethods = (client) => ({
      *
      * @example
      * ```ts
-     * const result = await Effect.runPromise(inventoryApi.bulkPublishOffer({ body: { offers: [] } }));
+     * const publishedOffers = await Effect.runPromise(inventoryApi.bulkPublishOffer({ body: { offers: [] } }));
      * ```
      *
      * @see https://developer.ebay.com/api-docs/sell/inventory/resources/offer/methods/bulkPublishOffer
@@ -67,8 +67,8 @@ export const createInventoryOffersMethods = (client) => ({
         const path = `${INVENTORY_BASE_PATH}/bulk_publish_offer`;
         return Effect.gen(function* () {
             const validatedInput = yield* requireObjectEffect(input, 'input');
-            const body = yield* requireObjectEffect(validatedInput.body, 'body');
-            return yield* requestPostEffect(client, path, body);
+            const bulkPublishRequest = yield* requireObjectEffect(validatedInput.body, 'body');
+            return yield* requestPostEffect(client, path, bulkPublishRequest);
         });
     },
     /**
@@ -116,7 +116,7 @@ export const createInventoryOffersMethods = (client) => ({
         const format = yield* optionalStringEffect(validatedInput.format, 'format');
         const marketplaceId = yield* optionalStringEffect(validatedInput.marketplaceId, 'marketplaceId');
         const uniqueSkus = [...new Set(validatedInput.skus)];
-        const results = yield* Effect.forEach(uniqueSkus, (sku) => Effect.map(Effect.either(getOffersEffect(client, {
+        const skuResults = yield* Effect.forEach(uniqueSkus, (sku) => Effect.map(Effect.either(getOffersEffect(client, {
             sku,
             format,
             marketplaceId,
@@ -127,13 +127,13 @@ export const createInventoryOffersMethods = (client) => ({
                 status: 'failure',
                 error: { type: outcome.left._tag, message: outcome.left.message },
             }), { concurrency: BATCH_GET_OFFERS_CONCURRENCY });
-        const successCount = results.filter((result) => result.status === 'success').length;
+        const successCount = skuResults.filter((skuResult) => skuResult.status === 'success').length;
         return {
             requestedSkuCount: validatedInput.skus.length,
             uniqueSkuCount: uniqueSkus.length,
             successCount,
-            failureCount: results.length - successCount,
-            results,
+            failureCount: skuResults.length - successCount,
+            results: skuResults,
         };
     }),
     /**
@@ -153,9 +153,9 @@ export const createInventoryOffersMethods = (client) => ({
         const path = `${INVENTORY_BASE_PATH}/offer`;
         return Effect.gen(function* () {
             const validatedInput = yield* requireObjectEffect(input, 'input');
-            const body = yield* requireObjectEffect(validatedInput.body, 'body');
-            yield* validateOfferFormatEffect(body, 'body');
-            return yield* requestPostEffect(client, path, body);
+            const offerDetails = yield* requireObjectEffect(validatedInput.body, 'body');
+            yield* validateOfferFormatEffect(offerDetails, 'body');
+            return yield* requestPostEffect(client, path, offerDetails);
         });
     },
     /**
@@ -199,9 +199,9 @@ export const createInventoryOffersMethods = (client) => ({
         return Effect.gen(function* () {
             const validatedInput = yield* requireObjectEffect(input, 'input');
             const offerId = yield* requireStringEffect(validatedInput.offerId, 'offerId');
-            const body = yield* requireObjectEffect(validatedInput.body, 'body');
-            yield* validateOfferFormatEffect(body, 'body');
-            return yield* requestPutEffect(client, `${basePath}/offer/${offerId}`, body);
+            const offerUpdate = yield* requireObjectEffect(validatedInput.body, 'body');
+            yield* validateOfferFormatEffect(offerUpdate, 'body');
+            return yield* requestPutEffect(client, `${basePath}/offer/${offerId}`, offerUpdate);
         });
     },
     /**
@@ -244,8 +244,8 @@ export const createInventoryOffersMethods = (client) => ({
         const path = `${INVENTORY_BASE_PATH}/offer/get_listing_fees`;
         return Effect.gen(function* () {
             const validatedInput = yield* requireObjectEffect(input, 'input');
-            const body = yield* requireObjectEffect(validatedInput.body, 'body');
-            return yield* requestPostEffect(client, path, body);
+            const listingFeesRequest = yield* requireObjectEffect(validatedInput.body, 'body');
+            return yield* requestPostEffect(client, path, listingFeesRequest);
         });
     },
     /**
@@ -290,8 +290,8 @@ export const createInventoryOffersMethods = (client) => ({
         const path = `${INVENTORY_BASE_PATH}/offer/publish_by_inventory_item_group`;
         return Effect.gen(function* () {
             const validatedInput = yield* requireObjectEffect(input, 'input');
-            const body = yield* requireObjectEffect(validatedInput.body, 'body');
-            return yield* requestPostEffect(client, path, body);
+            const publishGroupRequest = yield* requireObjectEffect(validatedInput.body, 'body');
+            return yield* requestPostEffect(client, path, publishGroupRequest);
         });
     },
     /**
@@ -336,8 +336,8 @@ export const createInventoryOffersMethods = (client) => ({
         const path = `${INVENTORY_BASE_PATH}/offer/withdraw_by_inventory_item_group`;
         return Effect.gen(function* () {
             const validatedInput = yield* requireObjectEffect(input, 'input');
-            const body = yield* requireObjectEffect(validatedInput.body, 'body');
-            return yield* requestPostEffect(client, path, body);
+            const withdrawGroupRequest = yield* requireObjectEffect(validatedInput.body, 'body');
+            return yield* requestPostEffect(client, path, withdrawGroupRequest);
         });
     },
 });

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

@@ -0,0 +1,203 @@
+import { locatedResourceId } from '../../api/shared/location.js';
+import { EbayApiError, optionalStringEffect, requestGetEffect, requireObjectEffect, requireStringEffect, } from '../../api/shared/request.js';
+import { Effect } from 'effect';
+const STORE_PATH = '/sell/stores/v1/store';
+const TASKS_PATH = `${STORE_PATH}/tasks`;
+/**
+ * Sends one asynchronous category change and reads its store task from `Location`.
+ * A missing or foreign header fails with an EbayApiError naming this request.
+ *
+ * @param method - HTTP method of the category change.
+ * @param path - eBay REST path of the category change, used in failures.
+ * @param send - Client call that keeps the response headers.
+ * @returns An Effect with the store task ID and Location, or a typed EbayApiError.
+ */
+const startCategoryTask = (method, path, send) => Effect.tryPromise({
+    try: send,
+    catch: (cause) => new EbayApiError({ method, path, cause }),
+}).pipe(Effect.flatMap((taskResponse) => locatedResourceId(taskResponse.headers.location, TASKS_PATH).pipe(Effect.mapError((error) => new EbayApiError({ method, path, cause: error.cause })))), Effect.map((task) => ({ taskId: task.id, location: task.location })));
+/** Stores API - eBay Store details and store category management. */
+export class StoresApi {
+    client;
+    constructor(client) {
+        this.client = client;
+    }
+    /**
+     * Retrieves the seller's eBay Store details: name, URL, description, and logo.
+     *
+     * @param _input - Empty object accepted for tool/API shape consistency.
+     * @returns An Effect that succeeds with eBay's GetStoreResponseType.
+     *
+     * @example
+     * ```ts
+     * const store = await Effect.runPromise(storesApi.getStore({}));
+     * ```
+     *
+     * @see https://developer.ebay.com/api-docs/sell/stores/resources/store/methods/getStore
+     */
+    getStore = (_input = {}) => requestGetEffect(this.client, STORE_PATH);
+    /**
+     * Retrieves the store's custom category hierarchy (up to three levels).
+     *
+     * @param _input - Empty object accepted for tool/API shape consistency.
+     * @returns An Effect that succeeds with eBay's GetStoreCategoriesResponseType.
+     *
+     * @example
+     * ```ts
+     * const { storeCategories } = await Effect.runPromise(storesApi.getStoreCategories({}));
+     * ```
+     *
+     * @see https://developer.ebay.com/api-docs/sell/stores/resources/store/methods/getStoreCategories
+     */
+    getStoreCategories = (_input = {}) => requestGetEffect(this.client, `${STORE_PATH}/categories`);
+    /**
+     * Retrieves the status of one asynchronous store category task.
+     *
+     * @param input - Store task ID returned by a category change.
+     * @returns An Effect that succeeds with eBay's GetStoreTaskResponseType.
+     *
+     * @example
+     * ```ts
+     * const { task } = await Effect.runPromise(storesApi.getStoreTask({ taskId: 'TASK-1' }));
+     * ```
+     *
+     * @see https://developer.ebay.com/api-docs/sell/stores/resources/store/methods/getStoreTask
+     */
+    getStoreTask = (input) => {
+        const { client } = this;
+        return Effect.gen(function* () {
+            const endpointInput = yield* requireObjectEffect(input, 'input');
+            const taskId = yield* requireStringEffect(endpointInput.taskId, 'taskId');
+            return yield* requestGetEffect(client, `${TASKS_PATH}/${encodeURIComponent(taskId)}`);
+        });
+    };
+    /**
+     * Retrieves the status of all asynchronous store tasks; each finishes as FAILED or COMPLETED
+     * within 24 hours.
+     *
+     * @param _input - Empty object accepted for tool/API shape consistency.
+     * @returns An Effect that succeeds with eBay's GetStoreTasksResponseType.
+     *
+     * @example
+     * ```ts
+     * const { task } = await Effect.runPromise(storesApi.getStoreTasks({}));
+     * ```
+     *
+     * @see https://developer.ebay.com/api-docs/sell/stores/resources/store/methods/getStoreTasks
+     */
+    getStoreTasks = (_input = {}) => requestGetEffect(this.client, TASKS_PATH);
+    /**
+     * Starts adding one custom store category. eBay answers 202 with the store task URI in
+     * `Location`; only one category change can be in flight at a time.
+     *
+     * @param input - Category name plus optional parent and listing-destination store category IDs.
+     * @returns An Effect that succeeds with the store task ID and Location to poll.
+     *
+     * @example
+     * ```ts
+     * const { taskId } = await Effect.runPromise(
+     *   storesApi.addStoreCategory({ categoryName: 'Vintage Cameras' }),
+     * );
+     * ```
+     *
+     * @see https://developer.ebay.com/api-docs/sell/stores/resources/store/methods/addStoreCategory
+     */
+    addStoreCategory = (input) => {
+        const { client } = this;
+        const path = `${STORE_PATH}/categories`;
+        return Effect.gen(function* () {
+            const endpointInput = yield* requireObjectEffect(input, 'input');
+            const addCategoryRequest = {
+                categoryName: yield* requireStringEffect(endpointInput.categoryName, 'categoryName'),
+                destinationParentCategoryId: yield* optionalStringEffect(endpointInput.destinationParentCategoryId, 'destinationParentCategoryId'),
+                listingDestinationCategoryId: yield* optionalStringEffect(endpointInput.listingDestinationCategoryId, 'listingDestinationCategoryId'),
+            };
+            return yield* startCategoryTask('POST', path, () => client.postForResponse(path, addCategoryRequest));
+        });
+    };
+    /**
+     * Starts renaming one custom store category. eBay answers with the store task URI in
+     * `Location`; only one category change can be in flight at a time.
+     *
+     * @param input - Store category ID (path) and its new name.
+     * @returns An Effect that succeeds with the store task ID and Location to poll.
+     *
+     * @example
+     * ```ts
+     * const { taskId } = await Effect.runPromise(
+     *   storesApi.renameStoreCategory({ categoryId: '1234', categoryName: 'Film Cameras' }),
+     * );
+     * ```
+     *
+     * @see https://developer.ebay.com/api-docs/sell/stores/resources/store/methods/renameStoreCategory
+     */
+    renameStoreCategory = (input) => {
+        const { client } = this;
+        return Effect.gen(function* () {
+            const endpointInput = yield* requireObjectEffect(input, 'input');
+            const categoryId = yield* requireStringEffect(endpointInput.categoryId, 'categoryId');
+            const renameCategoryRequest = {
+                categoryName: yield* requireStringEffect(endpointInput.categoryName, 'categoryName'),
+            };
+            const path = `${STORE_PATH}/categories/${encodeURIComponent(categoryId)}`;
+            return yield* startCategoryTask('PUT', path, () => client.putForResponse(path, renameCategoryRequest));
+        });
+    };
+    /**
+     * Starts deleting one custom store category. eBay answers 202 with the store task URI in
+     * `Location`; only one category change can be in flight at a time. The body is sent only
+     * with a listing destination; without one eBay applies its default (the Other category, ID 1).
+     *
+     * @param input - Store category ID to delete and an optional listing-destination store category.
+     * @returns An Effect that succeeds with the store task ID and Location to poll.
+     *
+     * @example
+     * ```ts
+     * const { taskId } = await Effect.runPromise(
+     *   storesApi.deleteStoreCategory({ categoryId: '1234' }),
+     * );
+     * ```
+     *
+     * @see https://developer.ebay.com/api-docs/sell/stores/resources/store/methods/deleteStoreCategory
+     */
+    deleteStoreCategory = (input) => {
+        const { client } = this;
+        return Effect.gen(function* () {
+            const endpointInput = yield* requireObjectEffect(input, 'input');
+            const categoryId = yield* requireStringEffect(endpointInput.categoryId, 'categoryId');
+            const listingDestinationCategoryId = yield* optionalStringEffect(endpointInput.listingDestinationCategoryId, 'listingDestinationCategoryId');
+            const deleteCategoryRequest = listingDestinationCategoryId === undefined ? undefined : { listingDestinationCategoryId };
+            const path = `${STORE_PATH}/categories/${encodeURIComponent(categoryId)}`;
+            return yield* startCategoryTask('DELETE', path, () => client.deleteForResponse(path, undefined, deleteCategoryRequest));
+        });
+    };
+    /**
+     * Starts moving one custom store category under a new parent. eBay answers 202 with the
+     * store task URI in `Location`; only one category change can be in flight at a time.
+     *
+     * @param input - Store category to move, its new parent, and an optional listing destination.
+     * @returns An Effect that succeeds with the store task ID and Location to poll.
+     *
+     * @example
+     * ```ts
+     * const { taskId } = await Effect.runPromise(
+     *   storesApi.moveStoreCategory({ categoryId: '1234', destinationParentCategoryId: '-999' }),
+     * );
+     * ```
+     *
+     * @see https://developer.ebay.com/api-docs/sell/stores/resources/store/methods/moveStoreCategory
+     */
+    moveStoreCategory = (input) => {
+        const { client } = this;
+        const path = `${STORE_PATH}/categories/move_category`;
+        return Effect.gen(function* () {
+            const endpointInput = yield* requireObjectEffect(input, 'input');
+            const moveCategoryRequest = {
+                categoryId: yield* requireStringEffect(endpointInput.categoryId, 'categoryId'),
+                destinationParentCategoryId: yield* requireStringEffect(endpointInput.destinationParentCategoryId, 'destinationParentCategoryId'),
+                listingDestinationCategoryId: yield* optionalStringEffect(endpointInput.listingDestinationCategoryId, 'listingDestinationCategoryId'),
+            };
+            return yield* startCategoryTask('POST', path, () => client.postForResponse(path, moveCategoryRequest));
+        });
+    };
+}

package/build/api/listing-metadata/charity.js

@@ -0,0 +1,76 @@
+import { buildEndpointParams, decodeEndpointInputEffect, EndpointInputError, requestGetEffect, } from '../../api/shared/request.js';
+import { getCharityOrgInputSchema, getCharityOrgsInputSchema } from '../../schemas/taxonomy/charity.js';
+import { Effect } from 'effect';
+const BASE_PATH = '/commerce/charity/v1';
+/**
+ * eBay documents the Charity API as client-credentials only (api_scope) with a required
+ * marketplace header, so every call sends the application token and the caller's marketplace.
+ */
+const charityRequestConfig = (marketplaceId) => ({
+    headers: { 'X-EBAY-C-MARKETPLACE-ID': marketplaceId },
+    tokenType: 'application',
+});
+/** Charity API - charitable organizations supported by eBay for Charity. */
+export class CharityApi {
+    client;
+    constructor(client) {
+        this.client = client;
+    }
+    /**
+     * Retrieves one charitable organization supported by eBay for Charity.
+     *
+     * @param input - Charity organization ID and the EBAY_US or EBAY_GB marketplace.
+     * @returns An Effect that succeeds with eBay's CharityOrg.
+     *
+     * @example
+     * ```ts
+     * const charity = await Effect.runPromise(
+     *   charityApi.getCharityOrg({ charityOrgId: '1234', marketplaceId: 'EBAY_US' }),
+     * );
+     * ```
+     *
+     * @see https://developer.ebay.com/api-docs/commerce/charity/resources/charity_org/methods/getCharityOrg
+     */
+    getCharityOrg = (input) => {
+        const client = this.client;
+        return Effect.gen(function* () {
+            const { charityOrgId, marketplaceId } = yield* decodeEndpointInputEffect(getCharityOrgInputSchema, input);
+            return yield* requestGetEffect(client, `${BASE_PATH}/charity_org/${encodeURIComponent(charityOrgId)}`, undefined, charityRequestConfig(marketplaceId));
+        });
+    };
+    /**
+     * Searches charitable organizations supported by eBay for Charity by keywords or by
+     * registration IDs (eBay requires exactly one of the two).
+     *
+     * @param input - Marketplace, q or registrationIds, and optional limit/offset paging.
+     * @returns An Effect that succeeds with eBay's paginated CharitySearchResponse.
+     *
+     * @example
+     * ```ts
+     * const results = await Effect.runPromise(
+     *   charityApi.getCharityOrgs({ marketplaceId: 'EBAY_US', q: 'animal rescue', limit: 10 }),
+     * );
+     * ```
+     *
+     * @see https://developer.ebay.com/api-docs/commerce/charity/resources/charity_org/methods/getCharityOrgs
+     */
+    getCharityOrgs = (input) => {
+        const client = this.client;
+        return Effect.gen(function* () {
+            const search = yield* decodeEndpointInputEffect(getCharityOrgsInputSchema, input);
+            if ((search.q === undefined) === (search.registrationIds === undefined)) {
+                return yield* Effect.fail(new EndpointInputError({
+                    parameter: 'q',
+                    message: 'Supply either q or registrationIds to search charities, but not both',
+                }));
+            }
+            const params = buildEndpointParams({
+                q: { wireName: 'q', value: search.q },
+                registrationIds: { wireName: 'registration_ids', value: search.registrationIds },
+                limit: { wireName: 'limit', value: search.limit },
+                offset: { wireName: 'offset', value: search.offset },
+            });
+            return yield* requestGetEffect(client, `${BASE_PATH}/charity_org`, params, charityRequestConfig(search.marketplaceId));
+        });
+    };
+}

package/build/api/listing-metadata/metadata.js

@@ -1,11 +1,31 @@
 import { buildEndpointParams, requestGetEffect, requestPostEffect, requireObjectEffect, requireStringEffect, optionalStringEffect, } from '../../api/shared/request.js';
 import { Effect } from 'effect';
-/** Metadata API - marketplace policies, compatibility metadata, and tax jurisdictions. */
+import { createMetadataShippingMethods } from './metadataShipping.js';
+/**
+ * Metadata API - marketplace policies, shipping metadata, compatibility metadata, and tax
+ * jurisdictions.
+ */
 export class MetadataApi {
     client;
     basePath = '/sell/metadata/v1';
+    /** Metadata API getExcludeShippingLocations endpoint; see createMetadataShippingMethods. */
+    getExcludeShippingLocations;
+    /** Metadata API getHandlingTimes endpoint; see createMetadataShippingMethods. */
+    getHandlingTimes;
+    /** Metadata API getShippingCarriers endpoint; see createMetadataShippingMethods. */
+    getShippingCarriers;
+    /** Metadata API getShippingLocations endpoint; see createMetadataShippingMethods. */
+    getShippingLocations;
+    /** Metadata API getShippingServices endpoint; see createMetadataShippingMethods. */
+    getShippingServices;
     constructor(client) {
         this.client = client;
+        const shipping = createMetadataShippingMethods(client);
+        this.getExcludeShippingLocations = shipping.getExcludeShippingLocations;
+        this.getHandlingTimes = shipping.getHandlingTimes;
+        this.getShippingCarriers = shipping.getShippingCarriers;
+        this.getShippingLocations = shipping.getShippingLocations;
+        this.getShippingServices = shipping.getShippingServices;
     }
     /**
      * Retrieves automotive parts compatibility policies for a marketplace.
@@ -285,8 +305,8 @@ export class MetadataApi {
         return Effect.gen(function* () {
             const validatedInput = yield* requireObjectEffect(input, 'input');
             const marketplaceId = yield* requireStringEffect(validatedInput.marketplaceId, 'marketplaceId');
-            const body = yield* requireObjectEffect(validatedInput.specification, 'specification');
-            return yield* requestPostEffect(client, path, body, compatibilityHeaders(marketplaceId));
+            const specificationRequest = yield* requireObjectEffect(validatedInput.specification, 'specification');
+            return yield* requestPostEffect(client, path, specificationRequest, compatibilityHeaders(marketplaceId));
         });
     };
     /**
@@ -313,8 +333,8 @@ export class MetadataApi {
         return Effect.gen(function* () {
             const validatedInput = yield* requireObjectEffect(input, 'input');
             const marketplaceId = yield* requireStringEffect(validatedInput.marketplaceId, 'marketplaceId');
-            const body = yield* requireObjectEffect(validatedInput.data, 'data');
-            return yield* requestPostEffect(client, path, body, compatibilityHeaders(marketplaceId));
+            const propertyNamesRequest = yield* requireObjectEffect(validatedInput.data, 'data');
+            return yield* requestPostEffect(client, path, propertyNamesRequest, compatibilityHeaders(marketplaceId));
         });
     };
     /**
@@ -341,8 +361,8 @@ export class MetadataApi {
         return Effect.gen(function* () {
             const validatedInput = yield* requireObjectEffect(input, 'input');
             const marketplaceId = yield* requireStringEffect(validatedInput.marketplaceId, 'marketplaceId');
-            const body = yield* requireObjectEffect(validatedInput.data, 'data');
-            return yield* requestPostEffect(client, path, body, compatibilityHeaders(marketplaceId));
+            const propertyValuesRequest = yield* requireObjectEffect(validatedInput.data, 'data');
+            return yield* requestPostEffect(client, path, propertyValuesRequest, compatibilityHeaders(marketplaceId));
         });
     };
     /**
@@ -369,8 +389,8 @@ export class MetadataApi {
         return Effect.gen(function* () {
             const validatedInput = yield* requireObjectEffect(input, 'input');
             const marketplaceId = yield* requireStringEffect(validatedInput.marketplaceId, 'marketplaceId');
-            const body = yield* requireObjectEffect(validatedInput.data, 'data');
-            return yield* requestPostEffect(client, path, body, compatibilityHeaders(marketplaceId));
+            const multiPropertyValuesRequest = yield* requireObjectEffect(validatedInput.data, 'data');
+            return yield* requestPostEffect(client, path, multiPropertyValuesRequest, compatibilityHeaders(marketplaceId));
         });
     };
     /**
@@ -397,8 +417,8 @@ export class MetadataApi {
         return Effect.gen(function* () {
             const validatedInput = yield* requireObjectEffect(input, 'input');
             const marketplaceId = yield* requireStringEffect(validatedInput.marketplaceId, 'marketplaceId');
-            const body = yield* requireObjectEffect(validatedInput.data, 'data');
-            return yield* requestPostEffect(client, path, body, compatibilityHeaders(marketplaceId));
+            const productRequest = yield* requireObjectEffect(validatedInput.data, 'data');
+            return yield* requestPostEffect(client, path, productRequest, compatibilityHeaders(marketplaceId));
         });
     };
     /**