feat: adds AmazonMarketplaceAdvertisingRegion object

Adds AmazonMarketplaceAdvertisingRegion object suppot.

BREAKING CHANGE: Adds AmazonMarketplaceAdvertisingRegion object suppot.

README.md

@@ -81,9 +81,15 @@ const US = findAmazonMarketplaceOrFail('countryCode', AmazonMarketplaceCountryCo
   "uri": "https://www.amazon.ca",
   "webServiceUri": "https://mws.amazonservices.ca",
   "advertising": {
-    "uri": "https://advertising-api.amazon.com",
     "countryCode": "CA",
-    "region": "NA",
+    "timeZone": "America/Los_Angeles",
+    "region": {
+      "accessTokenUri": "https://api.amazon.com/auth/o2/token",
+      "authorizationUri": "https://www.amazon.com/ap/oa",
+      "code": "NA",
+      "endpoint": "https://advertising-api.amazon.com",
+      "name": "North America",
+    },
     "bids": {
       "sponsoredBrands": {
         "min": 10,
@@ -94,7 +100,6 @@ const US = findAmazonMarketplaceOrFail('countryCode', AmazonMarketplaceCountryCo
         "max": 100000
       }
     },
-    "timeZone": "America/Los_Angeles"
   }
 }
 ```

src/amazon-marketplace-advertising-region.ts

@@ -0,0 +1,33 @@
+export interface AmazonMarketplaceAdvertisingRegion {
+  /**
+   * Region code.
+   */
+  code: string
+
+  /**
+   * Region name.
+   */
+  name: string
+
+  /**
+   * Authorization URI.
+   */
+  authorizationUri: string
+
+  /**
+   * Access Token URI
+   */
+  accessTokenUri: string
+
+  /**
+   * Access endpoint URI.
+   */
+  endpoint: string
+}
+
+export class AmazonMarketplaceAdvertisingRegion implements AmazonMarketplaceAdvertisingRegion {
+  constructor(data: AmazonMarketplaceAdvertisingRegion) {
+    Object.assign(this, data)
+    Object.freeze(this)
+  }
+}

src/amazon-marketplace.ts

@@ -1,3 +1,5 @@
+import { AmazonMarketplaceAdvertisingRegion } from './amazon-marketplace-advertising-region'
+
 /**
  * Amazon Marketplace country code enum.
  */
@@ -70,21 +72,7 @@ export enum AmazonMarketplaceAdvertisingTimeZone {
   EUROPE_PARIS = 'Europe/Paris',
 }
 
-/**
- * Amazon Advertising API Regions
- */
-export enum AmazonMarketplaceAdvertisingRegion {
-  NORTH_AMERICA = 'NA',
-  EUROPE = 'EU',
-  FAR_EAST = 'FE',
-}
-
 export interface AmazonMarketplaceAdvertising {
-  /**
-   * Amazon Advertising API endpoint URI.
-   */
-  readonly uri: string
-
   /**
    * Amazon Advertising account time zone.
    *

src/european-advertising-factory.ts

@@ -2,16 +2,15 @@ import {
   AmazonMarketplaceAdvertisingCountryCode,
   AmazonMarketplaceAdvertisingTimeZone,
   AmazonMarketplaceAdvertising,
-  AmazonMarketplaceAdvertisingRegion,
 } from './amazon-marketplace'
+import { marketplaceAdvertisingRegions } from './marketplace-advertising-regions'
 
 export function europeanAdvertisingFactory(
   countryCode: AmazonMarketplaceAdvertisingCountryCode,
 ): AmazonMarketplaceAdvertising {
   return {
-    uri: 'https://advertising-api-eu.amazon.com',
     countryCode,
-    region: AmazonMarketplaceAdvertisingRegion.EUROPE,
+    region: marketplaceAdvertisingRegions.EU,
     bids: {
       sponsoredBrands: {
         min: 10,

src/marketplace-advertising-regions/EU.ts

@@ -0,0 +1,9 @@
+import { AmazonMarketplaceAdvertisingRegion } from '../amazon-marketplace-advertising-region'
+
+export const EU = new AmazonMarketplaceAdvertisingRegion({
+  accessTokenUri: 'https://api.amazon.co.uk/auth/o2/token',
+  authorizationUri: 'https://eu.account.amazon.com/ap/oa',
+  code: 'EU',
+  endpoint: 'https://advertising-api-eu.amazon.com',
+  name: 'Europe',
+})

src/marketplace-advertising-regions/FE.ts

@@ -0,0 +1,9 @@
+import { AmazonMarketplaceAdvertisingRegion } from '../amazon-marketplace-advertising-region'
+
+export const FE = new AmazonMarketplaceAdvertisingRegion({
+  accessTokenUri: 'https://api.amazon.co.jp/auth/o2/token',
+  authorizationUri: 'https://apac.account.amazon.com/ap/oa',
+  code: 'FE',
+  endpoint: 'https://advertising-api-fe.amazon.com',
+  name: 'Far East',
+})

src/marketplace-advertising-regions/NA.ts

@@ -0,0 +1,9 @@
+import { AmazonMarketplaceAdvertisingRegion } from '../amazon-marketplace-advertising-region'
+
+export const NA = new AmazonMarketplaceAdvertisingRegion({
+  accessTokenUri: 'https://api.amazon.com/auth/o2/token',
+  authorizationUri: 'https://www.amazon.com/ap/oa',
+  code: 'NA',
+  endpoint: 'https://advertising-api.amazon.com',
+  name: 'North America',
+})

src/marketplace-advertising-regions/index.ts

@@ -0,0 +1,9 @@
+import { EU } from './EU'
+import { FE } from './FE'
+import { NA } from './NA'
+
+export const marketplaceAdvertisingRegions = {
+  EU,
+  FE,
+  NA,
+} as const

src/marketplaces/AE.ts

@@ -4,8 +4,8 @@ import {
   AmazonMarketplaceCountryCode,
   AmazonMarketplaceAdvertisingCurrency,
   AmazonMarketplaceAdvertisingCountryCode,
-  AmazonMarketplaceAdvertisingRegion,
 } from '../amazon-marketplace'
+import { marketplaceAdvertisingRegions } from '../marketplace-advertising-regions'
 
 export const AE = new AmazonMarketplace({
   countryCode: AmazonMarketplaceCountryCode.AE,
@@ -15,9 +15,8 @@ export const AE = new AmazonMarketplace({
   uri: 'https://www.amazon.ae',
   webServiceUri: 'https://mws.amazonservices.ae',
   advertising: {
-    uri: 'https://advertising-api-eu.amazon.com',
     countryCode: AmazonMarketplaceAdvertisingCountryCode.AE,
-    region: AmazonMarketplaceAdvertisingRegion.EUROPE,
+    region: marketplaceAdvertisingRegions.EU,
     bids: {
       sponsoredBrands: {
         min: 24,

src/marketplaces/AU.ts

@@ -4,8 +4,8 @@ import {
   AmazonMarketplaceCountryCode,
   AmazonMarketplaceAdvertisingCurrency,
   AmazonMarketplaceAdvertisingCountryCode,
-  AmazonMarketplaceAdvertisingRegion,
 } from '../amazon-marketplace'
+import { marketplaceAdvertisingRegions } from '../marketplace-advertising-regions'
 
 export const AU = new AmazonMarketplace({
   countryCode: AmazonMarketplaceCountryCode.AU,
@@ -15,9 +15,8 @@ export const AU = new AmazonMarketplace({
   uri: 'https://www.amazon.com.au',
   webServiceUri: 'https://mws.amazonservices.com.au',
   advertising: {
-    uri: 'https://advertising-api-fe.amazon.com',
     countryCode: AmazonMarketplaceAdvertisingCountryCode.AU,
-    region: AmazonMarketplaceAdvertisingRegion.FAR_EAST,
+    region: marketplaceAdvertisingRegions.FE,
     bids: {
       sponsoredBrands: {
         min: 10,

src/marketplaces/CA.ts

@@ -4,8 +4,8 @@ import {
   AmazonMarketplaceCountryCode,
   AmazonMarketplaceAdvertisingCurrency,
   AmazonMarketplaceAdvertisingCountryCode,
-  AmazonMarketplaceAdvertisingRegion,
 } from '../amazon-marketplace'
+import { marketplaceAdvertisingRegions } from '../marketplace-advertising-regions'
 
 /**
  * Canada
@@ -18,9 +18,8 @@ export const CA = new AmazonMarketplace({
   uri: 'https://www.amazon.ca',
   webServiceUri: 'https://mws.amazonservices.ca',
   advertising: {
-    uri: 'https://advertising-api.amazon.com',
     countryCode: AmazonMarketplaceAdvertisingCountryCode.CA,
-    region: AmazonMarketplaceAdvertisingRegion.NORTH_AMERICA,
+    region: marketplaceAdvertisingRegions.NA,
     bids: {
       sponsoredBrands: {
         min: 10,

src/marketplaces/GB.ts

@@ -4,8 +4,8 @@ import {
   AmazonMarketplaceCountryCode,
   AmazonMarketplaceAdvertisingCurrency,
   AmazonMarketplaceAdvertisingCountryCode,
-  AmazonMarketplaceAdvertisingRegion,
 } from '../amazon-marketplace'
+import { marketplaceAdvertisingRegions } from '../marketplace-advertising-regions'
 import { DE } from './DE'
 
 if (!DE.advertising) {
@@ -20,9 +20,8 @@ export const GB = new AmazonMarketplace({
   uri: 'https://www.amazon.co.uk',
   webServiceUri: DE.webServiceUri,
   advertising: {
-    uri: DE.advertising.uri,
     countryCode: AmazonMarketplaceAdvertisingCountryCode.UK,
-    region: AmazonMarketplaceAdvertisingRegion.EUROPE,
+    region: marketplaceAdvertisingRegions.EU,
     bids: {
       sponsoredBrands: {
         min: 10,

src/marketplaces/JP.ts

@@ -4,8 +4,8 @@ import {
   AmazonMarketplaceCountryCode,
   AmazonMarketplaceAdvertisingCurrency,
   AmazonMarketplaceAdvertisingCountryCode,
-  AmazonMarketplaceAdvertisingRegion,
 } from '../amazon-marketplace'
+import { marketplaceAdvertisingRegions } from '../marketplace-advertising-regions'
 
 export const JP = new AmazonMarketplace({
   countryCode: AmazonMarketplaceCountryCode.JP,
@@ -15,9 +15,8 @@ export const JP = new AmazonMarketplace({
   uri: 'https://www.amazon.co.jp',
   webServiceUri: 'https://mws.amazonservices.jp',
   advertising: {
-    uri: 'https://advertising-api-fe.amazon.com',
     countryCode: AmazonMarketplaceAdvertisingCountryCode.JP,
-    region: AmazonMarketplaceAdvertisingRegion.FAR_EAST,
+    region: marketplaceAdvertisingRegions.FE,
     bids: {
       sponsoredBrands: {
         min: 1000,

src/marketplaces/US.ts

@@ -4,8 +4,8 @@ import {
   AmazonMarketplaceCountryCode,
   AmazonMarketplaceAdvertisingCurrency,
   AmazonMarketplaceAdvertisingCountryCode,
-  AmazonMarketplaceAdvertisingRegion,
 } from '../amazon-marketplace'
+import { marketplaceAdvertisingRegions } from '../marketplace-advertising-regions'
 
 export const US = new AmazonMarketplace({
   countryCode: AmazonMarketplaceCountryCode.US,
@@ -15,9 +15,8 @@ export const US = new AmazonMarketplace({
   uri: 'https://www.amazon.com',
   webServiceUri: 'https://mws.amazonservices.com',
   advertising: {
-    uri: 'https://advertising-api.amazon.com',
     countryCode: AmazonMarketplaceAdvertisingCountryCode.US,
-    region: AmazonMarketplaceAdvertisingRegion.NORTH_AMERICA,
+    region: marketplaceAdvertisingRegions.NA,
     bids: {
       sponsoredBrands: {
         min: 10,