ebay-mcp 1.14.0 → 1.14.2

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

@@ -0,0 +1,284 @@
+import { buildEndpointParams, optionalNonNegativeNumberEffect, optionalPositiveNumberEffect, optionalStringEffect, requestDeleteEffect, requestGetEffect, requestPostEffect, requestPutEffect, requireObjectEffect, requireStringEffect, } from '../../api/shared/request.js';
+import { Effect } from 'effect';
+import { INVENTORY_BASE_PATH } from './shared.js';
+/** Inventory API — offers methods closed over a shared client. */
+export const createInventoryOffersMethods = (client) => ({
+    /**
+     * Creates multiple offers.
+     *
+     * @param input - Generated BulkEbayOfferDetailsWithKeys body.
+     * @returns An Effect that succeeds with eBay's BulkOfferResponse.
+     *
+     * @example
+     * ```ts
+     * const result = await Effect.runPromise(inventoryApi.bulkCreateOffer({ body: { requests: [] } }));
+     * ```
+     *
+     * @see https://developer.ebay.com/api-docs/sell/inventory/resources/offer/methods/bulkCreateOffer
+     */
+    bulkCreateOffer: (input) => {
+        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');
+            return yield* requestPostEffect(client, path, body);
+        });
+    },
+    /**
+     * Publishes multiple offers.
+     *
+     * @param input - Generated BulkOffer body.
+     * @returns An Effect that succeeds with eBay's BulkPublishResponse.
+     *
+     * @example
+     * ```ts
+     * const result = await Effect.runPromise(inventoryApi.bulkPublishOffer({ body: { offers: [] } }));
+     * ```
+     *
+     * @see https://developer.ebay.com/api-docs/sell/inventory/resources/offer/methods/bulkPublishOffer
+     */
+    bulkPublishOffer: (input) => {
+        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);
+        });
+    },
+    /**
+     * Retrieves offers with optional filters.
+     *
+     * @param input - Optional offer filters and pagination controls.
+     * @returns An Effect that succeeds with eBay's Offers response.
+     *
+     * @example
+     * ```ts
+     * const offers = await Effect.runPromise(
+     *   inventoryApi.getOffers({ sku: 'SKU-1', marketplaceId: 'EBAY_US' }),
+     * );
+     * ```
+     *
+     * @see https://developer.ebay.com/api-docs/sell/inventory/resources/offer/methods/getOffers
+     */
+    getOffers: (input = {}) => {
+        const path = `${INVENTORY_BASE_PATH}/offer`;
+        return Effect.gen(function* () {
+            const validatedInput = yield* requireObjectEffect(input, 'input');
+            const format = yield* optionalStringEffect(validatedInput.format, 'format');
+            const limit = yield* optionalPositiveNumberEffect(validatedInput.limit, 'limit');
+            const marketplaceId = yield* optionalStringEffect(validatedInput.marketplaceId, 'marketplaceId');
+            const offset = yield* optionalNonNegativeNumberEffect(validatedInput.offset, 'offset');
+            const sku = yield* optionalStringEffect(validatedInput.sku, 'sku');
+            const params = buildEndpointParams({
+                format: { wireName: 'format', value: format },
+                limit: { wireName: 'limit', value: limit === undefined ? undefined : String(limit) },
+                marketplaceId: { wireName: 'marketplace_id', value: marketplaceId },
+                offset: { wireName: 'offset', value: offset === undefined ? undefined : String(offset) },
+                sku: { wireName: 'sku', value: sku },
+            });
+            return yield* requestGetEffect(client, path, params);
+        });
+    },
+    /**
+     * Creates one offer.
+     *
+     * @param input - Generated EbayOfferDetailsWithKeys body.
+     * @returns An Effect that succeeds with eBay's OfferResponse.
+     *
+     * @example
+     * ```ts
+     * const offer = await Effect.runPromise(inventoryApi.createOffer({ body: { sku: 'SKU-1' } }));
+     * ```
+     *
+     * @see https://developer.ebay.com/api-docs/sell/inventory/resources/offer/methods/createOffer
+     */
+    createOffer: (input) => {
+        const path = `${INVENTORY_BASE_PATH}/offer`;
+        return Effect.gen(function* () {
+            const validatedInput = yield* requireObjectEffect(input, 'input');
+            const body = yield* requireObjectEffect(validatedInput.body, 'body');
+            return yield* requestPostEffect(client, path, body);
+        });
+    },
+    /**
+     * Retrieves one offer by ID.
+     *
+     * @param input - eBay offer identifier.
+     * @returns An Effect that succeeds with eBay's EbayOfferDetailsWithAll response.
+     *
+     * @example
+     * ```ts
+     * const offer = await Effect.runPromise(inventoryApi.getOffer({ offerId: 'OFFER-1' }));
+     * ```
+     *
+     * @see https://developer.ebay.com/api-docs/sell/inventory/resources/offer/methods/getOffer
+     */
+    getOffer: (input) => {
+        const basePath = INVENTORY_BASE_PATH;
+        return Effect.gen(function* () {
+            const validatedInput = yield* requireObjectEffect(input, 'input');
+            const offerId = yield* requireStringEffect(validatedInput.offerId, 'offerId');
+            return yield* requestGetEffect(client, `${basePath}/offer/${offerId}`);
+        });
+    },
+    /**
+     * Updates one offer by ID.
+     *
+     * @param input - eBay offer identifier and generated EbayOfferDetailsWithId body.
+     * @returns An Effect that succeeds with eBay's OfferResponse.
+     *
+     * @example
+     * ```ts
+     * await Effect.runPromise(
+     *   inventoryApi.updateOffer({ offerId: 'OFFER-1', body: { offerId: 'OFFER-1' } }),
+     * );
+     * ```
+     *
+     * @see https://developer.ebay.com/api-docs/sell/inventory/resources/offer/methods/updateOffer
+     */
+    updateOffer: (input) => {
+        const basePath = INVENTORY_BASE_PATH;
+        return Effect.gen(function* () {
+            const validatedInput = yield* requireObjectEffect(input, 'input');
+            const offerId = yield* requireStringEffect(validatedInput.offerId, 'offerId');
+            const body = yield* requireObjectEffect(validatedInput.body, 'body');
+            return yield* requestPutEffect(client, `${basePath}/offer/${offerId}`, body);
+        });
+    },
+    /**
+     * Deletes one offer by ID.
+     *
+     * @param input - eBay offer identifier.
+     * @returns An Effect that succeeds when eBay returns no content.
+     *
+     * @example
+     * ```ts
+     * await Effect.runPromise(inventoryApi.deleteOffer({ offerId: 'OFFER-1' }));
+     * ```
+     *
+     * @see https://developer.ebay.com/api-docs/sell/inventory/resources/offer/methods/deleteOffer
+     */
+    deleteOffer: (input) => {
+        const basePath = INVENTORY_BASE_PATH;
+        return Effect.gen(function* () {
+            const validatedInput = yield* requireObjectEffect(input, 'input');
+            const offerId = yield* requireStringEffect(validatedInput.offerId, 'offerId');
+            return yield* requestDeleteEffect(client, `${basePath}/offer/${offerId}`);
+        });
+    },
+    /**
+     * Retrieves listing fees for unpublished offers.
+     *
+     * @param input - Generated OfferKeysWithId body.
+     * @returns An Effect that succeeds with eBay's FeesSummaryResponse.
+     *
+     * @example
+     * ```ts
+     * const fees = await Effect.runPromise(
+     *   inventoryApi.getListingFees({ body: { offers: [{ offerId: 'OFFER-1' }] } }),
+     * );
+     * ```
+     *
+     * @see https://developer.ebay.com/api-docs/sell/inventory/resources/offer/methods/getListingFees
+     */
+    getListingFees: (input) => {
+        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);
+        });
+    },
+    /**
+     * Publishes one offer by ID.
+     *
+     * @param input - eBay offer identifier.
+     * @returns An Effect that succeeds with eBay's PublishResponse.
+     *
+     * @example
+     * ```ts
+     * const publish = await Effect.runPromise(inventoryApi.publishOffer({ offerId: 'OFFER-1' }));
+     * ```
+     *
+     * @see https://developer.ebay.com/api-docs/sell/inventory/resources/offer/methods/publishOffer
+     */
+    publishOffer: (input) => {
+        const basePath = INVENTORY_BASE_PATH;
+        return Effect.gen(function* () {
+            const validatedInput = yield* requireObjectEffect(input, 'input');
+            const offerId = yield* requireStringEffect(validatedInput.offerId, 'offerId');
+            return yield* requestPostEffect(client, `${basePath}/offer/${offerId}/publish`);
+        });
+    },
+    /**
+     * Publishes offers for one inventory item group.
+     *
+     * @param input - Generated PublishByInventoryItemGroupRequest body.
+     * @returns An Effect that succeeds with eBay's PublishResponse.
+     *
+     * @example
+     * ```ts
+     * const publish = await Effect.runPromise(
+     *   inventoryApi.publishOfferByInventoryItemGroup({
+     *     body: { inventoryItemGroupKey: 'GROUP-1', marketplaceId: 'EBAY_US' },
+     *   }),
+     * );
+     * ```
+     *
+     * @see https://developer.ebay.com/api-docs/sell/inventory/resources/offer/methods/publishOfferByInventoryItemGroup
+     */
+    publishOfferByInventoryItemGroup: (input) => {
+        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);
+        });
+    },
+    /**
+     * Withdraws one offer by ID.
+     *
+     * @param input - eBay offer identifier.
+     * @returns An Effect that succeeds with eBay's WithdrawResponse.
+     *
+     * @example
+     * ```ts
+     * const withdraw = await Effect.runPromise(inventoryApi.withdrawOffer({ offerId: 'OFFER-1' }));
+     * ```
+     *
+     * @see https://developer.ebay.com/api-docs/sell/inventory/resources/offer/methods/withdrawOffer
+     */
+    withdrawOffer: (input) => {
+        const basePath = INVENTORY_BASE_PATH;
+        return Effect.gen(function* () {
+            const validatedInput = yield* requireObjectEffect(input, 'input');
+            const offerId = yield* requireStringEffect(validatedInput.offerId, 'offerId');
+            return yield* requestPostEffect(client, `${basePath}/offer/${offerId}/withdraw`);
+        });
+    },
+    /**
+     * Withdraws offers for one inventory item group.
+     *
+     * @param input - Generated WithdrawByInventoryItemGroupRequest body.
+     * @returns An Effect that succeeds when eBay returns no content.
+     *
+     * @example
+     * ```ts
+     * await Effect.runPromise(
+     *   inventoryApi.withdrawOfferByInventoryItemGroup({
+     *     body: { inventoryItemGroupKey: 'GROUP-1', marketplaceId: 'EBAY_US' },
+     *   }),
+     * );
+     * ```
+     *
+     * @see https://developer.ebay.com/api-docs/sell/inventory/resources/offer/methods/withdrawOfferByInventoryItemGroup
+     */
+    withdrawOfferByInventoryItemGroup: (input) => {
+        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);
+        });
+    },
+});

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

@@ -0,0 +1 @@
+export const INVENTORY_BASE_PATH = '/sell/inventory/v1';