ebay-api 8.5.0 → 8.6.0

package/README.md

@@ -21,7 +21,7 @@ It supports `client credentials grant` and `authorization code grant` \(Auth'N'A
 
 ## Changelog
 
-* `v8.5.0` is the latest release.
+* `v8.6.0` is the latest release.
 * See [here](https://github.com/hendt/ebay-api/blob/master/CHANGELOG.md) for the full changelog.
 
 ## Implementation status
@@ -34,7 +34,7 @@ It supports `client credentials grant` and `authorization code grant` \(Auth'N'A
 | **Commerce API**   | ✔ Catalog API<br>✔ Charity API `v1.2.0`<br>✔ Identity API<br>✔ Notification API `v1.2.0`<br>✔ Taxonomy API `v1.0.0`<br>✔ Translation API `v1_beta.1.4`                                                                                                                                                                                 |
 | **Developer API**  | ✔ Analytics API                                                                                                                                                                                                                                                                                                                        |
 | **Post Order API** | ✔ Cancellation API<br>✔ Case Management API<br>✔ Inquiry API<br>✔ Return API                                                                                                                                                                                                                                                           |
-| **Sell API**       | ✔ Account API `v1.9.0`<br>✔ Analytics API `v1.3.0`<br>✔ Compliance API `v1.4.1`<br>✔ Feed API<br>✔ Finance API `v1.9.0`<br>✔ Fulfillment API `v1.19.10`<br>✔ Inventory API `v1.14.0`<br>✔ Listing API<br>✔ Logistics API<br>✔ Marketing API `v1.14.0`<br>✔ Metadata API<br>✔ Negotiation API `v1.1.0`<br>✔ Recommendation API `v1.1.0` |
+| **Sell API**       | ✔ Account API `v1.9.0`<br>✔ Analytics API `v1.3.0`<br>✔ Compliance API `v1.4.1`<br>✔ Feed API<br>✔ Finance API `v1.9.0`<br>✔ Fulfillment API `v1.19.10`<br>✔ Inventory API `v1.14.0`<br>✔ Listing API<br>✔ Logistics API<br>✔ Marketing API `v1.17.0`<br>✔ Metadata API<br>✔ Negotiation API `v1.1.0`<br>✔ Recommendation API `v1.1.0` |
 
 ### Traditional API
 
@@ -90,7 +90,7 @@ const eBay = new eBayApi({
 
   marketplaceId: eBayApi.MarketplaceId.EBAY_US, // default. required for RESTful APIs
   acceptLanguage: eBayApi.Locale.en_US, // default
-  contentLanguage: eBayApi.ContentLanguage.en_US, // default.
+  contentLanguage: eBayApi.Locale.en_US, // default.
 
   // optional parameters, should be omitted if not used
   devId: '-- devId --', // required for traditional Trading API
@@ -166,7 +166,7 @@ The first (required) parameter in eBayApi instance takes an object with followin
 | marketplaceId<br><i>RESTful</i>   | Required<br><pre>Default: `MarketplaceId.EBAY_US`</pre>                              | [Docs](https://developer.ebay.com/api-docs/static/rest-request-components.html#marketpl) REST HTTP Header. X-EBAY-C-MARKETPLACE-ID identifies the user's business context and is specified using a marketplace ID value. Note that this header does not indicate a language preference or consumer location.   |
 | scope<br><i>RESTful</i>           | Conditionally<bre><pre>Default:<br>`['https://api.ebay.com/oauth/api_scope']` </pre> | The scopes assigned to your application allow access to different API resources and functionality.                                                                                                                                                                                                             |
 | endUserCtx<br><i>RESTful</i>      | Conditionally recommended<br><i>RESTful</i>                                          | [Docs](https://developer.ebay.com/api-docs/static/rest-request-components.html#headers) X-EBAY\_C\_ENDUSERCTX provides various types of information associated with the request.                                                                                                                               |
-| contentLanguage<br><i>RESTful</i> | Conditionally required<br><pre>Default: `ContentLanguage.en_US`</pre>                | [Docs](https://developer.ebay.com/api-docs/static/rest-request-components.html#headers)Content-Language indicates the locale preferred by the client for the response.                                                                                                                                         |
+| contentLanguage<br><i>RESTful</i> | Conditionally required<br><pre>Default: `Locale.en_US`</pre>                | [Docs](https://developer.ebay.com/api-docs/static/rest-request-components.html#headers)Content-Language indicates the locale preferred by the client for the response.                                                                                                                                         |
 | acceptLanguage<br><i>RESTful</i>  | Optional<pre>Default: `Locale.en_US`</pre>                                           | [Docs](https://developer.ebay.com/api-docs/static/rest-request-components.html#headers) Accept-Language indicates the natural language the client prefers for the response. This specifies the language the client wants to use when the field values provided in the request body are displayed to consumers. |
 
 ## Load config from environment

package/dist/api/apiFactory.d.ts

@@ -6,9 +6,6 @@ import { Developer } from './restful/developer/index.js';
 import { PostOrder } from './restful/postOrder/index.js';
 import { Sell } from './restful/sell/index.js';
 import Traditional from './traditional/index.js';
-/**
- * Factory class to create RESTFul API or Traditional API.
- */
 export default class ApiFactory extends Api {
     private _traditional?;
     private _restful;

package/dist/api/apiFactory.js

@@ -5,9 +5,6 @@ import { Analytics as DeveloperAnalytics, KeyManagement } from './restful/develo
 import { Cancellation, Case, Inquiry, Return, } from './restful/postOrder/index.js';
 import { Account, Analytics as SellAnalytics, Compliance, Feed as SellFeed, Finances, Fulfillment, Inventory, Listing, Logistics, Marketing as SellMarketing, Metadata, Negotiation, Recommendation } from './restful/sell/index.js';
 import Traditional from './traditional/index.js';
-/**
- * Factory class to create RESTFul API or Traditional API.
- */
 export default class ApiFactory extends Api {
     constructor() {
         super(...arguments);
@@ -86,7 +83,6 @@ export default class ApiFactory extends Api {
     createMerchandisingApi() {
         return this.traditional.createMerchandisingApi();
     }
-    // tslint:disable-next-line:variable-name
     createRestfulApi(RestfulApiClass) {
         const id = RestfulApiClass.id;
         return (this._restful[id] || (this._restful[id] = new RestfulApiClass(this.config, this.req, this.auth)));

package/dist/api/base.d.ts

@@ -1,8 +1,5 @@
 import { IEBayApiRequest } from '../request.js';
 import { AppConfig } from '../types/index.js';
-/**
- * Abstract superclass.
- */
 export default abstract class Base {
     readonly config: AppConfig;
     readonly req: IEBayApiRequest;

package/dist/api/base.js

@@ -1,7 +1,4 @@
 import { AxiosRequest } from '../request.js';
-/**
- * Abstract superclass.
- */
 export default class Base {
     constructor(config, req = new AxiosRequest(config.axiosConfig)) {
         this.config = config;

package/dist/api/digitalSignature.d.ts

@@ -1,43 +1,10 @@
 import { Cipher, Headers } from '../types/index.js';
-/**
- * Generates the 'Content-Digest' header value for the input payload.
- *
- * @param {any} payload The request payload.
- * @param {string} cipher The algorithm used to calculate the digest.
- * @returns {string} contentDigest The 'Content-Digest' header value.
- */
 export declare const generateContentDigestValue: (payload: unknown, cipher?: Cipher) => string;
 export type SignatureComponents = {
     method: string;
     authority: string;
     path: string;
 };
-/**
- * Generates the base string.
- *
- * @param {any} headers The HTTP request headers.
- * @param {SignatureComponents} signatureComponents The config.
- * @param {any} payload The payload.
- * @param {number} timestamp The timestamp.
- * @returns {string} payload The base string.
- */
 export declare function generateBaseString(headers: Headers, signatureComponents: SignatureComponents, payload: any, timestamp?: number): string;
-/**
- * Generates the Signature-Input header value for the input payload.
- *
- * @param {any} payload The input config.
- * @param {number} timestamp The timestamp.
- * @returns {string} the 'Signature-Input' header value.
- */
 export declare const generateSignatureInput: (payload: any, timestamp?: number) => string;
-/**
- * Generates the 'Signature' header.
- *
- * @param {any} headers The HTTP headers.
- * @param {string} privateKey The HTTP headers.
- * @param {SignatureComponents} signatureComponents The signature components
- * @param {any} payload The payload
- * @param {number} timestamp The payload
- * @returns {string} the signature header value.
- */
 export declare function generateSignature(headers: any, privateKey: string, signatureComponents: SignatureComponents, payload: any, timestamp?: number): string;

package/dist/api/digitalSignature.js

@@ -1,12 +1,6 @@
 import { createHash, sign } from 'crypto';
 const beginPrivateKey = '-----BEGIN PRIVATE KEY-----';
 const endPrivateKey = '-----END PRIVATE KEY-----';
-// based on https://github.com/ebay/digital-signature-nodejs-sdk
-/**
- * Returns the current UNIX timestamp.
- *
- * @returns {number} The unix timestamp.
- */
 const getUnixTimestamp = () => Date.now() / 1000 | 0;
 const getSignatureParams = (payload) => [
     ...payload ? ['content-digest'] : [],
@@ -16,28 +10,12 @@ const getSignatureParams = (payload) => [
     '@authority'
 ];
 const getSignatureParamsValue = (payload) => getSignatureParams(payload).map(param => `"${param}"`).join(' ');
-/**
- * Generates the 'Content-Digest' header value for the input payload.
- *
- * @param {any} payload The request payload.
- * @param {string} cipher The algorithm used to calculate the digest.
- * @returns {string} contentDigest The 'Content-Digest' header value.
- */
 export const generateContentDigestValue = (payload, cipher = 'sha256') => {
     const payloadBuffer = Buffer.from(typeof payload === 'string' ? payload : JSON.stringify(payload));
     const hash = createHash(cipher).update(payloadBuffer).digest('base64');
     const algo = cipher === 'sha512' ? 'sha-512' : 'sha-256';
     return `${algo}=:${hash}:`;
 };
-/**
- * Generates the base string.
- *
- * @param {any} headers The HTTP request headers.
- * @param {SignatureComponents} signatureComponents The config.
- * @param {any} payload The payload.
- * @param {number} timestamp The timestamp.
- * @returns {string} payload The base string.
- */
 export function generateBaseString(headers, signatureComponents, payload, timestamp = getUnixTimestamp()) {
     try {
         let baseString = '';
@@ -74,32 +52,14 @@ export function generateBaseString(headers, signatureComponents, payload, timest
         throw new Error(`Error calculating signature base: ${ex.message}`);
     }
 }
-/**
- * Generates the Signature-Input header value for the input payload.
- *
- * @param {any} payload The input config.
- * @param {number} timestamp The timestamp.
- * @returns {string} the 'Signature-Input' header value.
- */
 export const generateSignatureInput = (payload, timestamp = getUnixTimestamp()) => `sig1=(${getSignatureParamsValue(payload)});created=${timestamp}`;
-/**
- * Generates the 'Signature' header.
- *
- * @param {any} headers The HTTP headers.
- * @param {string} privateKey The HTTP headers.
- * @param {SignatureComponents} signatureComponents The signature components
- * @param {any} payload The payload
- * @param {number} timestamp The payload
- * @returns {string} the signature header value.
- */
 export function generateSignature(headers, privateKey, signatureComponents, payload, timestamp = getUnixTimestamp()) {
     const baseString = generateBaseString(headers, signatureComponents, payload, timestamp);
     privateKey = privateKey.trim();
     if (!privateKey.startsWith(beginPrivateKey)) {
         privateKey = beginPrivateKey + '\n' + privateKey + '\n' + endPrivateKey;
     }
-    const signatureBuffer = sign(undefined, // If algorithm is undefined, then it is dependent upon the private key type.
-    Buffer.from(baseString), privateKey);
+    const signatureBuffer = sign(undefined, Buffer.from(baseString), privateKey);
     const signature = signatureBuffer.toString('base64');
     return `sig1=:${signature}:`;
 }

package/dist/api/index.d.ts

@@ -3,9 +3,6 @@ import { IEBayApiRequest } from '../request.js';
 import { AppConfig } from '../types/index.js';
 import Base from './base.js';
 import { SignatureComponents } from './digitalSignature.js';
-/**
- * Superclass with Auth container.
- */
 export default abstract class Api extends Base {
     readonly auth: Auth;
     constructor(config: AppConfig, req?: IEBayApiRequest, auth?: Auth);

package/dist/api/index.js

@@ -1,9 +1,6 @@
 import Auth from '../auth/index.js';
 import Base from './base.js';
 import { generateContentDigestValue, generateSignature, generateSignatureInput } from './digitalSignature.js';
-/**
- * Superclass with Auth container.
- */
 export default class Api extends Base {
     constructor(config, req, auth) {
         super(config, req);

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

@@ -1,84 +1,18 @@
 import { AddCartItemInput, BuyBrowseGetItemsParams, BuyBrowseItemByLegacyIdParams, BuyBrowseSearchByImageParams, BuyBrowseSearchParams, CompatibilityPayload, RemoveCartItemInput, SearchByImageRequest, UpdateCartItemInput } from '../../../../types/index.js';
 import { operations } from '../../../../types/restful/specs/buy_browse_v1_oas3.js';
 import Restful, { OpenApi } 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 implements OpenApi<operations> {
     static id: string;
     get basePath(): string;
-    /**
-     * This method searches for eBay items by various query parameters and retrieves summaries of the items.
-     *
-     * @param {BrowseSearchParams} params
-     */
     search(params: BuyBrowseSearchParams): Promise<any>;
-    /**
-     * 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: BuyBrowseSearchByImageParams, body?: SearchByImageRequest): Promise<any>;
-    /**
-     * This method retrieves the details of specific items that the buyer needs to make a purchasing decision.
-     *
-     * @param {params} params
-     */
     getItems(params: BuyBrowseGetItemsParams): Promise<any>;
-    /**
-     * 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: string, fieldgroups?: string): Promise<any>;
-    /**
-     * 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: BuyBrowseItemByLegacyIdParams): Promise<any>;
-    /**
-     * This method retrieves the details of the individual items in an item group.
-     *
-     * @param itemGroupId
-     */
     getItemsByItemGroup(itemGroupId: string): Promise<any>;
-    /**
-     * 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: string, body?: CompatibilityPayload): Promise<any>;
-    /**
-     * 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: AddCartItemInput): Promise<any>;
-    /**
-     * 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(): Promise<any>;
-    /**
-     * This is an experimental method. This method removes a specific item from the eBay member's cart.
-     *
-     *  @param {Object} item RemoveCartItemInput
-     */
     removeItem(item: RemoveCartItemInput): Promise<any>;
-    /**
-     * 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: UpdateCartItemInput): Promise<any>;
 }

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

@@ -1,57 +1,23 @@
 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}`, {
@@ -60,21 +26,11 @@ class Browse extends Restful {
             }
         });
     }
-    /**
-     * 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: {
@@ -82,48 +38,19 @@ class Browse extends Restful {
             }
         });
     }
-    /**
-     * 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);
     }

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

@@ -1,20 +1,8 @@
 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;
@@ -22,31 +10,11 @@ export default class Deal extends Restful implements OpenApi<operations> {
         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;

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

@@ -1,20 +1,8 @@
 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: {
@@ -26,21 +14,10 @@ class Deal extends Restful {
             }
         });
     }
-    /**
-     * 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: {
@@ -49,15 +26,6 @@ class Deal extends Restful {
             }
         });
     }
-    /**
-     * 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: {

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

@@ -1,44 +1,11 @@
 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>;
 }

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

@@ -1,19 +1,8 @@
 import Restful 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.
- */
 class Feed extends Restful {
     get basePath() {
         return '/buy/feed/v1_beta';
     }
-    /**
-     * 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, range) {
         return this.get(`/item`, {
             params,
@@ -22,12 +11,6 @@ class Feed extends Restful {
             }
         });
     }
-    /**
-     * 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, range) {
         return this.get(`/item_group`, {
             params,
@@ -36,14 +19,6 @@ class Feed extends Restful {
             }
         });
     }
-    /**
-     * 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, snapshotDate, range) {
         return this.get(`/item_snapshot`, {
             params: {
@@ -55,14 +30,6 @@ class Feed extends Restful {
             }
         });
     }
-    /**
-     * 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, snapshotDate, range) {
         return this.get(`/product`, {
             params: {