ebay-api 8.5.0 → 8.6.0

package/dist/auth/oAuth2.js

@@ -2,12 +2,6 @@ import debug from 'debug';
 import { createNanoEvents } from '../nanoevents.js';
 import Base from '../api/base.js';
 const log = debug('ebay:oauth2');
-/**
- * https://developer.ebay.com/api-docs/static/oauth-tokens.html
- *
- * Client credentials grant flow mints a new Application access token that you can use to access the resources owned by the application.
- * Authorization code grant flow mints a new User access token that you can use to access the resources owned by the user.
- */
 class OAuth2 extends Base {
     constructor(config, req) {
         super(config, req);
@@ -30,10 +24,6 @@ class OAuth2 extends Base {
     get identityEndpoint() {
         return this.config.sandbox ? OAuth2.IDENTITY_ENDPOINT.sandbox : OAuth2.IDENTITY_ENDPOINT.production;
     }
-    /**
-     * Return the access token.
-     * First return user access token, if not set Application Access Token.
-     */
     async getAccessToken() {
         return this.getUserAccessToken() || this.getApplicationAccessToken();
     }
@@ -62,9 +52,6 @@ class OAuth2 extends Base {
     getScope() {
         return [...this.scope];
     }
-    /**
-     * Client credentials grant flow.
-     */
     async mintApplicationAccessToken() {
         if (!this.config.appId) {
             throw new Error('Missing App ID (Client Id)');
@@ -89,9 +76,6 @@ class OAuth2 extends Base {
             throw error;
         }
     }
-    /**
-     * Client credentials grant flow.
-     */
     async obtainApplicationAccessToken() {
         log('Obtain a new application access token with scope: ', this.scope.join(','));
         try {
@@ -106,13 +90,6 @@ class OAuth2 extends Base {
             throw error;
         }
     }
-    /**
-     * Generates URL for consent page landing.
-     *
-     * @param ruName RuName
-     * @param scope the scopes
-     * @param state state parameter returned in the redirect URL
-     */
     generateAuthUrl(ruName, scope = this.scope, state = '') {
         ruName = ruName || this.config.ruName;
         if (!ruName) {
@@ -120,14 +97,6 @@ class OAuth2 extends Base {
         }
         return OAuth2.generateAuthUrl(this.config.sandbox, this.config.appId, ruName, scope, state);
     }
-    /**
-     * Authorization code grant flow.
-     *
-     * Mint the user access token for the given code.
-     *
-     * @param code the code
-     * @param ruName the redirectUri
-     */
     async mintUserAccessToken(code, ruName = this.config.ruName) {
         try {
             const response = await this.req.postForm(this.identityEndpoint, {
@@ -149,20 +118,9 @@ class OAuth2 extends Base {
             throw error;
         }
     }
-    /**
-     * Authorization code grant flow.
-     *
-     * Mint the access token for the given code.
-     *
-     * @param code the code
-     * @param ruName the redirectUri
-     */
     async getToken(code, ruName = this.config.ruName) {
         return await this.mintUserAccessToken(code, ruName);
     }
-    /**
-     * Authorization code grant flow.
-     */
     async refreshUserAccessToken() {
         if (!this._authToken || !this._authToken.refresh_token) {
             log('Tried to refresh user access token before it was set.');
@@ -194,13 +152,6 @@ class OAuth2 extends Base {
             throw error;
         }
     }
-    /**
-     * Gets and sets the user access token for the given code.
-     *
-     * Authorization code grant flow.
-     *
-     * @param code the code
-     */
     async obtainToken(code) {
         const token = await this.getToken(code);
         log('Obtain user access token', token);
@@ -234,9 +185,6 @@ class OAuth2 extends Base {
             this._authToken = authToken;
         }
     }
-    /**
-     * Refresh the user access token if set or application access token
-     */
     async refreshToken() {
         if (this._authToken) {
             return await this.refreshUserAccessToken();
@@ -247,7 +195,6 @@ class OAuth2 extends Base {
         throw new Error('Missing credentials. To refresh a token an application access token or user access token must be already set.');
     }
 }
-// If all the calls in our application require just an Application access token we can use this endpoint
 OAuth2.IDENTITY_ENDPOINT = {
     production: 'https://api.ebay.com/identity/v1/oauth2/token',
     sandbox: 'https://api.sandbox.ebay.com/identity/v1/oauth2/token'

package/dist/eBayApi.d.ts

@@ -15,15 +15,8 @@ import { AppConfig, ClientAlerts, Finding, Merchandising, Shopping, Signature, T
 export default class eBayApi extends Api {
     static readonly SiteId: typeof enums.SiteId;
     static readonly MarketplaceId: typeof enums.MarketplaceId;
-    static readonly ContentLanguage: typeof enums.ContentLanguage;
+    static readonly ContentLanguage: typeof enums.Locale;
     static readonly Locale: typeof enums.Locale;
-    /**
-     * Loads config from `process.env`
-     *
-     * @return {eBayApi} a new eBayApi instance
-     * @param {request} req request
-     * @throws {ApiEnvError}
-     */
     static fromEnv(req?: IEBayApiRequest): eBayApi;
     readonly authNAuth: AuthNAuth;
     readonly oAuth2: OAuth2;
@@ -39,10 +32,6 @@ export default class eBayApi extends Api {
     private _shopping?;
     private _merchandising?;
     private _clientAlerts?;
-    /**
-     * @param {AppConfig} config the app config
-     * @param {IEBayApiRequest} req the request
-     */
     constructor(config: AppConfig, req?: IEBayApiRequest);
     get buy(): Buy;
     get commerce(): Commerce;

package/dist/eBayApi.js

@@ -13,15 +13,7 @@ const defaultConfig = {
     acceptLanguage: Locale.en_US,
     contentLanguage: ContentLanguage.en_US
 };
-// tslint:disable-next-line:class-name
 class eBayApi extends Api {
-    /**
-     * Loads config from `process.env`
-     *
-     * @return {eBayApi} a new eBayApi instance
-     * @param {request} req request
-     * @throws {ApiEnvError}
-     */
     static fromEnv(req) {
         if (!process.env.EBAY_APP_ID) {
             throw new ApiEnvError('EBAY_APP_ID');
@@ -50,14 +42,9 @@ class eBayApi extends Api {
             signature
         }, req);
     }
-    /**
-     * @param {AppConfig} config the app config
-     * @param {IEBayApiRequest} req the request
-     */
     constructor(config, req) {
         super({ ...defaultConfig, ...config }, req);
         this.factory = new ApiFactory(this.config, this.req, this.auth);
-        // Shortcuts
         this.authNAuth = this.auth.authNAuth;
         this.OAuth2 = this.auth.OAuth2;
         this.oAuth2 = this.OAuth2;
@@ -77,7 +64,6 @@ class eBayApi extends Api {
     get sell() {
         return this._sell || (this._sell = this.factory.createSellApi());
     }
-    // Traditional
     get trading() {
         return this._trading || (this._trading = this.factory.createTradingApi());
     }