ebay-api 8.4.0 → 8.5.0

package/dist/api/restful/buy/browse/index.js

@@ -1,135 +1,132 @@
-import Restful from '../../index.js';
-/**
- * The Browse API has the following resources: item_summary: Lets shoppers search for specific items by keyword, GTIN,
- * category, charity, product, or item aspects and refine the results by using filters, such as aspects, compatibility,
- * and fields values.
- */
-export default class Browse extends Restful {
-    get basePath() {
-        return '/buy/browse/v1';
-    }
-    //
-    // Item
-    // Client Credentials: https://api.ebay.com/oauth/api_scope
-    //
-    /**
-     * This method searches for eBay items by various query parameters and retrieves summaries of the items.
-     *
-     * @param {BrowseSearchParams} params
-     */
-    search(params) {
-        return this.get(`/item_summary/search`, {
-            params
-        });
-    }
-    /**
-     * This is an Experimental method. This method searches for eBay items based on a image and retrieves summaries of
-     * the items.
-     *
-     * @param {BrowseSearchParams} params
-     * @param {Object} body The container for the image information fields.
-     */
-    searchByImage(params, body = {}) {
-        return this.post(`/item_summary/search_by_image`, body, {
-            params
-        });
-    }
-    /**
-     * This method retrieves the details of specific items that the buyer needs to make a purchasing decision.
-     *
-     * @param itemIds A list of item IDs. Item IDs are the eBay RESTful identifier of items.
-     * @param itemGroupIds A list of item group IDs.
-     */
-    getItems({ itemIds: item_ids, itemGroupIds: item_group_ids }) {
-        return this.get(`/item/`, {
-            params: {
-                item_ids,
-                item_group_ids
-            }
-        });
-    }
-    /**
-     * This method retrieves the details of a specific item, such as description, price, category, all item aspects,
-     * condition, return policies, seller feedback and score, shipping options, shipping costs, estimated delivery,
-     * and other information the buyer needs to make a purchasing decision.
-     *
-     * @param {String} itemId The eBay RESTful identifier of an item.
-     * @param {String} fieldgroups
-     */
-    getItem(itemId, fieldgroups) {
-        const id = encodeURIComponent(itemId);
-        return this.get(`/item/${id}`, {
-            params: {
-                fieldgroups
-            }
-        });
-    }
-    /**
-     * This method is a bridge between the eBay legacy APIs, such as Shopping, and Finding and the eBay Api APIs.
-     *
-     * @param {LegacyItemParams} params
-     */
-    getItemByLegacyId(params) {
-        return this.get(`/item/get_item_by_legacy_id`, {
-            params
-        });
-    }
-    /**
-     * This method retrieves the details of the individual items in an item group.
-     *
-     * @param itemGroupId
-     */
-    getItemsByItemGroup(itemGroupId) {
-        return this.get(`/item/get_items_by_item_group`, {
-            params: {
-                item_group_id: itemGroupId
-            }
-        });
-    }
-    /**
-     * This method checks if a product is compatible with the specified item.
-     * @param {String} itemId The eBay RESTful identifier of an item (such as a part you want to check).
-     * @param {Object} body CompatibilityPayload
-     */
-    checkCompatibility(itemId, body) {
-        const id = encodeURIComponent(itemId);
-        return this.post(`/item/${id}/check_compatibility`, body);
-    }
-    //
-    // Shopping Cart
-    //
-    /**
-     * This is an Experimental method. This method creates an eBay cart for the eBay member, if one does not exist, and
-     * adds items to that cart.
-     *
-     * @param {Object} item AddCartItemInput
-     */
-    addItem(item) {
-        return this.post(`/shopping_cart/add_item`, item);
-    }
-    /**
-     * This is an experimental method. This method retrieves all the items in the eBay member's cart;
-     * items added to the cart while on ebay.com as well as items added to the cart using the Browse API.
-     */
-    getShoppingCart() {
-        return this.get(`/shopping_cart/`);
-    }
-    /**
-     * This is an experimental method. This method removes a specific item from the eBay member's cart.
-     *
-     *  @param {Object} item RemoveCartItemInput
-     */
-    removeItem(item) {
-        return this.post(`/shopping_cart/remove_item`, item);
-    }
-    /**
-     * This is an experimental method. This method updates the quantity value of a specific item in the eBay member's
-     * cart.
-     *
-     * @param {UpdateCartItemInput} item UpdateCartItemInput
-     */
-    updateQuantity(item) {
-        return this.post(`/shopping_cart/update_quantity`, item);
-    }
-}
-Browse.id = 'Browse';
+import Restful from '../../index.js';
+/**
+ * The Browse API has the following resources: item_summary: Lets shoppers search for specific items by keyword, GTIN,
+ * category, charity, product, or item aspects and refine the results by using filters, such as aspects, compatibility,
+ * and fields values.
+ */
+class Browse extends Restful {
+    get basePath() {
+        return '/buy/browse/v1';
+    }
+    //
+    // Item
+    // Client Credentials: https://api.ebay.com/oauth/api_scope
+    //
+    /**
+     * This method searches for eBay items by various query parameters and retrieves summaries of the items.
+     *
+     * @param {BrowseSearchParams} params
+     */
+    search(params) {
+        return this.get(`/item_summary/search`, {
+            params
+        });
+    }
+    /**
+     * This is an Experimental method. This method searches for eBay items based on a image and retrieves summaries of
+     * the items.
+     *
+     * @param {params} params
+     * @param {Object} body The container for the image information fields.
+     */
+    searchByImage(params, body) {
+        return this.post(`/item_summary/search_by_image`, body, {
+            params
+        });
+    }
+    /**
+     * This method retrieves the details of specific items that the buyer needs to make a purchasing decision.
+     *
+     * @param {params} params
+     */
+    getItems(params) {
+        return this.get(`/item/`, {
+            params
+        });
+    }
+    /**
+     * This method retrieves the details of a specific item, such as description, price, category, all item aspects,
+     * condition, return policies, seller feedback and score, shipping options, shipping costs, estimated delivery,
+     * and other information the buyer needs to make a purchasing decision.
+     *
+     * @param {String} itemId The eBay RESTful identifier of an item.
+     * @param {String} fieldgroups
+     */
+    getItem(itemId, fieldgroups) {
+        const id = encodeURIComponent(itemId);
+        return this.get(`/item/${id}`, {
+            params: {
+                fieldgroups
+            }
+        });
+    }
+    /**
+     * This method is a bridge between the eBay legacy APIs, such as Shopping, and Finding and the eBay Api APIs.
+     *
+     * @param {LegacyItemParams} params
+     */
+    getItemByLegacyId(params) {
+        return this.get(`/item/get_item_by_legacy_id`, {
+            params
+        });
+    }
+    /**
+     * This method retrieves the details of the individual items in an item group.
+     *
+     * @param itemGroupId
+     */
+    getItemsByItemGroup(itemGroupId) {
+        return this.get(`/item/get_items_by_item_group`, {
+            params: {
+                item_group_id: itemGroupId
+            }
+        });
+    }
+    /**
+     * This method checks if a product is compatible with the specified item.
+     * @param {String} itemId The eBay RESTful identifier of an item (such as a part you want to check).
+     * @param {Object} body CompatibilityPayload
+     */
+    checkCompatibility(itemId, body) {
+        const id = encodeURIComponent(itemId);
+        return this.post(`/item/${id}/check_compatibility`, body);
+    }
+    //
+    // Shopping Cart
+    //
+    /**
+     * This is an Experimental method. This method creates an eBay cart for the eBay member, if one does not exist, and
+     * adds items to that cart.
+     *
+     * @param {Object} item AddCartItemInput
+     */
+    addItem(item) {
+        return this.post(`/shopping_cart/add_item`, item);
+    }
+    /**
+     * This is an experimental method. This method retrieves all the items in the eBay member's cart;
+     * items added to the cart while on ebay.com as well as items added to the cart using the Browse API.
+     */
+    getShoppingCart() {
+        return this.get(`/shopping_cart/`);
+    }
+    /**
+     * This is an experimental method. This method removes a specific item from the eBay member's cart.
+     *
+     *  @param {Object} item RemoveCartItemInput
+     */
+    removeItem(item) {
+        return this.post(`/shopping_cart/remove_item`, item);
+    }
+    /**
+     * This is an experimental method. This method updates the quantity value of a specific item in the eBay member's
+     * cart.
+     *
+     * @param {UpdateCartItemInput} item UpdateCartItemInput
+     */
+    updateQuantity(item) {
+        return this.post(`/shopping_cart/update_quantity`, item);
+    }
+}
+Browse.id = 'Browse';
+export default Browse;

package/dist/api/restful/buy/deal/index.d.ts

@@ -1,55 +1,56 @@
-import Restful from '../../index.js';
-/**
- * This API allows third-party developers to search for and retrieve details about eBay deals and events, as well as the items associated with those deals and events.
- */
-export default class Deal extends Restful {
-    static id: string;
-    get basePath(): string;
-    /**
-     * This method retrieves a paginated set of deal items.
-     *
-     * @param categoryIds The unique identifier of the eBay category for the search.
-     * @param commissionable A filter for commissionable deals. Restriction: This filter is currently only supported for the US marketplace.
-     * @param deliveryCountry A filter for items that can be shipped to the specified country.
-     * @param limit The maximum number of items, from the current result set, returned on a single page.
-     * @param offset The number of items that will be skipped in the result set.
-     */
-    getDealItems({ categoryIds, commissionable, deliveryCountry, limit, offset }: {
-        categoryIds?: string;
-        commissionable?: string;
-        deliveryCountry?: string;
-        limit?: string;
-        offset?: string;
-    }): Promise<any>;
-    /**
-     * This method retrieves the details for an eBay event.
-     *
-     * @param eventId The unique identifier for the eBay event.
-     */
-    getEvent(eventId: string): Promise<any>;
-    /**
-     * This method returns paginated results containing all eBay events for the specified marketplace.
-     *
-     * @param limit The maximum number of items, from the current result set, returned on a single page. Default: 20 Maximum Value: 100
-     * @param offset The number of items that will be skipped in the result set.
-     */
-    getEvents({ limit, offset }: {
-        limit?: string;
-        offset?: string;
-    }): Promise<any>;
-    /**
-     * This method returns paginated results containing all eBay events for the specified marketplace.
-     *
-     * @param eventIds The unique identifiers for the eBay events. Maximum Value: 1
-     * @param categoryIds The unique identifier of the eBay category for the search. Maximum Value: 1
-     * @param deliveryCountry A filter for items that can be shipped to the specified country.
-     * @param limit The maximum number of items, from the current result set, returned on a single page. Default: 20 Maximum Value: 100
-     * @param offset The number of items that will be skipped in the result set.
-     */
-    getEventItems(eventIds: string, { categoryIds, deliveryCountry, limit, offset }?: {
-        categoryIds?: string;
-        deliveryCountry?: string;
-        limit?: string;
-        offset?: string;
-    }): Promise<any>;
-}
+import { operations } from '../../../../types/restful/specs/buy_deal_v1_oas3.js';
+import Restful, { OpenApi } from '../../index.js';
+/**
+ * This API allows third-party developers to search for and retrieve details about eBay deals and events, as well as the items associated with those deals and events.
+ */
+export default class Deal extends Restful implements OpenApi<operations> {
+    static id: string;
+    get basePath(): string;
+    /**
+     * This method retrieves a paginated set of deal items.
+     *
+     * @param categoryIds The unique identifier of the eBay category for the search.
+     * @param commissionable A filter for commissionable deals. Restriction: This filter is currently only supported for the US marketplace.
+     * @param deliveryCountry A filter for items that can be shipped to the specified country.
+     * @param limit The maximum number of items, from the current result set, returned on a single page.
+     * @param offset The number of items that will be skipped in the result set.
+     */
+    getDealItems({ categoryIds, commissionable, deliveryCountry, limit, offset }: {
+        categoryIds?: string;
+        commissionable?: string;
+        deliveryCountry?: string;
+        limit?: string;
+        offset?: string;
+    }): Promise<any>;
+    /**
+     * This method retrieves the details for an eBay event.
+     *
+     * @param eventId The unique identifier for the eBay event.
+     */
+    getEvent(eventId: string): Promise<any>;
+    /**
+     * This method returns paginated results containing all eBay events for the specified marketplace.
+     *
+     * @param limit The maximum number of items, from the current result set, returned on a single page. Default: 20 Maximum Value: 100
+     * @param offset The number of items that will be skipped in the result set.
+     */
+    getEvents({ limit, offset }: {
+        limit?: string;
+        offset?: string;
+    }): Promise<any>;
+    /**
+     * This method returns paginated results containing all eBay events for the specified marketplace.
+     *
+     * @param eventIds The unique identifiers for the eBay events. Maximum Value: 1
+     * @param categoryIds The unique identifier of the eBay category for the search. Maximum Value: 1
+     * @param deliveryCountry A filter for items that can be shipped to the specified country.
+     * @param limit The maximum number of items, from the current result set, returned on a single page. Default: 20 Maximum Value: 100
+     * @param offset The number of items that will be skipped in the result set.
+     */
+    getEventItems(eventIds: string, { categoryIds, deliveryCountry, limit, offset }?: {
+        categoryIds?: string;
+        deliveryCountry?: string;
+        limit?: string;
+        offset?: string;
+    }): Promise<any>;
+}

package/dist/api/restful/buy/deal/index.js

@@ -1,73 +1,74 @@
-import Restful from '../../index.js';
-/**
- * This API allows third-party developers to search for and retrieve details about eBay deals and events, as well as the items associated with those deals and events.
- */
-export default class Deal extends Restful {
-    get basePath() {
-        return '/buy/deal/v1';
-    }
-    /**
-     * This method retrieves a paginated set of deal items.
-     *
-     * @param categoryIds The unique identifier of the eBay category for the search.
-     * @param commissionable A filter for commissionable deals. Restriction: This filter is currently only supported for the US marketplace.
-     * @param deliveryCountry A filter for items that can be shipped to the specified country.
-     * @param limit The maximum number of items, from the current result set, returned on a single page.
-     * @param offset The number of items that will be skipped in the result set.
-     */
-    getDealItems({ categoryIds, commissionable, deliveryCountry, limit, offset }) {
-        return this.get(`/deal_item`, {
-            params: {
-                category_ids: categoryIds,
-                commissionable,
-                delivery_country: deliveryCountry,
-                limit,
-                offset
-            }
-        });
-    }
-    /**
-     * This method retrieves the details for an eBay event.
-     *
-     * @param eventId The unique identifier for the eBay event.
-     */
-    getEvent(eventId) {
-        eventId = encodeURIComponent(eventId);
-        return this.get(`/event/${eventId}`);
-    }
-    /**
-     * This method returns paginated results containing all eBay events for the specified marketplace.
-     *
-     * @param limit The maximum number of items, from the current result set, returned on a single page. Default: 20 Maximum Value: 100
-     * @param offset The number of items that will be skipped in the result set.
-     */
-    getEvents({ limit, offset }) {
-        return this.get(`/event`, {
-            params: {
-                limit,
-                offset
-            }
-        });
-    }
-    /**
-     * This method returns paginated results containing all eBay events for the specified marketplace.
-     *
-     * @param eventIds The unique identifiers for the eBay events. Maximum Value: 1
-     * @param categoryIds The unique identifier of the eBay category for the search. Maximum Value: 1
-     * @param deliveryCountry A filter for items that can be shipped to the specified country.
-     * @param limit The maximum number of items, from the current result set, returned on a single page. Default: 20 Maximum Value: 100
-     * @param offset The number of items that will be skipped in the result set.
-     */
-    getEventItems(eventIds, { categoryIds, deliveryCountry, limit, offset } = {}) {
-        return this.get(`/event_item`, {
-            params: {
-                event_ids: eventIds,
-                limit,
-                offset,
-                category_ids: categoryIds,
-                delivery_country: deliveryCountry
-            }
-        });
-    }
-}
-Deal.id = 'Deal';
+import Restful from '../../index.js';
+/**
+ * This API allows third-party developers to search for and retrieve details about eBay deals and events, as well as the items associated with those deals and events.
+ */
+class Deal extends Restful {
+    get basePath() {
+        return '/buy/deal/v1';
+    }
+    /**
+     * This method retrieves a paginated set of deal items.
+     *
+     * @param categoryIds The unique identifier of the eBay category for the search.
+     * @param commissionable A filter for commissionable deals. Restriction: This filter is currently only supported for the US marketplace.
+     * @param deliveryCountry A filter for items that can be shipped to the specified country.
+     * @param limit The maximum number of items, from the current result set, returned on a single page.
+     * @param offset The number of items that will be skipped in the result set.
+     */
+    getDealItems({ categoryIds, commissionable, deliveryCountry, limit, offset }) {
+        return this.get(`/deal_item`, {
+            params: {
+                category_ids: categoryIds,
+                commissionable,
+                delivery_country: deliveryCountry,
+                limit,
+                offset
+            }
+        });
+    }
+    /**
+     * This method retrieves the details for an eBay event.
+     *
+     * @param eventId The unique identifier for the eBay event.
+     */
+    getEvent(eventId) {
+        eventId = encodeURIComponent(eventId);
+        return this.get(`/event/${eventId}`);
+    }
+    /**
+     * This method returns paginated results containing all eBay events for the specified marketplace.
+     *
+     * @param limit The maximum number of items, from the current result set, returned on a single page. Default: 20 Maximum Value: 100
+     * @param offset The number of items that will be skipped in the result set.
+     */
+    getEvents({ limit, offset }) {
+        return this.get(`/event`, {
+            params: {
+                limit,
+                offset
+            }
+        });
+    }
+    /**
+     * This method returns paginated results containing all eBay events for the specified marketplace.
+     *
+     * @param eventIds The unique identifiers for the eBay events. Maximum Value: 1
+     * @param categoryIds The unique identifier of the eBay category for the search. Maximum Value: 1
+     * @param deliveryCountry A filter for items that can be shipped to the specified country.
+     * @param limit The maximum number of items, from the current result set, returned on a single page. Default: 20 Maximum Value: 100
+     * @param offset The number of items that will be skipped in the result set.
+     */
+    getEventItems(eventIds, { categoryIds, deliveryCountry, limit, offset } = {}) {
+        return this.get(`/event_item`, {
+            params: {
+                event_ids: eventIds,
+                limit,
+                offset,
+                category_ids: categoryIds,
+                delivery_country: deliveryCountry
+            }
+        });
+    }
+}
+Deal.id = 'Deal';
+export default Deal;

package/dist/api/restful/buy/feed/index.d.ts

@@ -1,43 +1,44 @@
-import Restful from '../../index.js';
-import { BuyFeedParams } from '../../../../types/index.js';
-/**
- * The Feed API provides the ability to download TSV_GZIP feed files containing eBay items and an hourly snapshot file
- * of the items that have changed within an hour for a specific category, date and marketplace.
- */
-export default class Feed extends Restful {
-    static id: string;
-    get basePath(): string;
-    /**
-     * This method lets you download a TSV_GZIP (tab separated value gzip) Item feed file.
-     *
-     * @param {BuyFeedParams} params
-     * @param range his header specifies the range in bytes of the chunks of the gzip file being returned.
-     *          Format: bytes=startpos-endpos For example, the following retrieves the first 10 MBs of the feed file.
-     */
-    getItemFeed(params: BuyFeedParams, range: string): Promise<any>;
-    /**
-     * This method lets you download a TSV_GZIP (tab separated value gzip) Item Group feed file.
-     * @param {BuyFeedParams} params
-     * @param range his header specifies the range in bytes of the chunks of the gzip file being returned.
-     *          Format: bytes=startpos-endpos For example, the following retrieves the first 10 MBs of the feed file.
-     */
-    getItemGroupFeed(params: BuyFeedParams, range: string): Promise<any>;
-    /**
-     * The Hourly Snapshot feed file is generated each hour every day for all categories.
-     *
-     * @param {BuyFeedParams} params
-     * @param {String} snapshotDate
-     * @param range his header specifies the range in bytes of the chunks of the gzip file being returned.
-     *          Format: bytes=startpos-endpos For example, the following retrieves the first 10 MBs of the feed file.
-     */
-    getItemSnapshotFeed(params: BuyFeedParams, snapshotDate: string, range: string): Promise<any>;
-    /**
-     * The Hourly Snapshot feed file is generated each hour every day for all categories.
-     *
-     * @param {BuyFeedParams} params
-     * @param {String} snapshotDate
-     * @param range his header specifies the range in bytes of the chunks of the gzip file being returned.
-     *          Format: bytes=startpos-endpos For example, the following retrieves the first 10 MBs of the feed file.
-     */
-    getProductFeed(params: BuyFeedParams, snapshotDate: string, range: string): Promise<any>;
-}
+import { BuyFeedParams } from '../../../../types/index.js';
+import { operations } from '../../../../types/restful/specs/buy_feed_v1_beta_oas3.js';
+import Restful, { OpenApi } from '../../index.js';
+/**
+ * The Feed API provides the ability to download TSV_GZIP feed files containing eBay items and an hourly snapshot file
+ * of the items that have changed within an hour for a specific category, date and marketplace.
+ */
+export default class Feed extends Restful implements OpenApi<operations> {
+    static id: string;
+    get basePath(): string;
+    /**
+     * This method lets you download a TSV_GZIP (tab separated value gzip) Item feed file.
+     *
+     * @param {BuyFeedParams} params
+     * @param range his header specifies the range in bytes of the chunks of the gzip file being returned.
+     *          Format: bytes=startpos-endpos For example, the following retrieves the first 10 MBs of the feed file.
+     */
+    getItemFeed(params: BuyFeedParams, range: string): Promise<any>;
+    /**
+     * This method lets you download a TSV_GZIP (tab separated value gzip) Item Group feed file.
+     * @param {BuyFeedParams} params
+     * @param range his header specifies the range in bytes of the chunks of the gzip file being returned.
+     *          Format: bytes=startpos-endpos For example, the following retrieves the first 10 MBs of the feed file.
+     */
+    getItemGroupFeed(params: BuyFeedParams, range: string): Promise<any>;
+    /**
+     * The Hourly Snapshot feed file is generated each hour every day for all categories.
+     *
+     * @param {BuyFeedParams} params
+     * @param {String} snapshotDate
+     * @param range his header specifies the range in bytes of the chunks of the gzip file being returned.
+     *          Format: bytes=startpos-endpos For example, the following retrieves the first 10 MBs of the feed file.
+     */
+    getItemSnapshotFeed(params: BuyFeedParams, snapshotDate: string, range: string): Promise<any>;
+    /**
+     * The Hourly Snapshot feed file is generated each hour every day for all categories.
+     *
+     * @param {BuyFeedParams} params
+     * @param {String} snapshotDate
+     * @param range his header specifies the range in bytes of the chunks of the gzip file being returned.
+     *          Format: bytes=startpos-endpos For example, the following retrieves the first 10 MBs of the feed file.
+     */
+    getProductFeed(params: BuyFeedParams, snapshotDate: string, range: string): Promise<any>;
+}