Merge pull request #27 from bhushankumarl/development

Add basic Test cases, Add jshint lint checking, Code Reformatting

.jshintignore

@@ -0,0 +1,3 @@
+node_modules
+examples/typeScript
+test/

.jshintrc

@@ -6,7 +6,15 @@
     "exports": true,
     "module": true,
     "Buffer": true,
-    "JSON": true
+    "JSON": true,
+    "async": true,
+    /* MOCHA */
+    "describe": false,
+    "it": false,
+    "before": false,
+    "beforeEach": false,
+    "after": false,
+    "afterEach": false
   },
   "maxparams": 6,
   "maxdepth": 15,
@@ -40,7 +48,7 @@
   "smarttabs": true,
   "indent": 2,
   "latedef": "nofunc",
-  "unused": false,
+  "unused": true,
   "enforceall": true,
   "-W024": true,
   "-W089": false,

.travis.yml

@@ -1,6 +1,5 @@
 language: node_js
 node_js:
-  - "0.12"
   - "4"
   - "5"
   - "6"

CHANGELOG.md

@@ -1,3 +1,12 @@
+0.0.18
+  - Add basic Test cases
+  - Add jshint lint checking
+  - Code Reformatting
+  - Add support for parsing special characters
+  - Add support for API which return data as binary file format
+  - Extend support for GetLowestPricedOffersForASIN, GetLowestPricedOffersForSKU and other product methods
+  - Added test cases for Feeds, Finances, Fulfillment Inventory, Fulfillment Outbound Shipment, Fulfillment Inbound Shipment, Products, Orders, Sellers
+
 0.0.17
   - Extend support for TypeScript typed definition : feeds, finances, fulfillmentInboundShipment, fulfillmentInventory, fulfillmentOutboundShipment, merchantFulfillment, orders, products, sellers
 

README.md

@@ -15,6 +15,11 @@ You can find [examples here](https://github.com/bhushankumarl/amazon-mws/tree/ma
 $ npm install amazon-mws --save
 ```
 
+## Test Cases
+```bash
+$ npm run test.mocha
+```
+
 ## Debugging
 
 Run the DEBUG:
@@ -31,14 +36,24 @@ export AWS_ACCESS_KEY_ID=KEY
 export AWS_SECRET_ACCESS_KEY=SECRET
 ```
 
-## Configuration
+## Configuration Using JavaScript
 
 Set your Access Key and Access Secret.
 
 ```js
 var amazonMws = require('amazon-mws')('AWS_ACCESS_KEY_ID','AWS_SECRET_ACCESS_KEY');
 ```
 
+## Configuration Using TypeScript
+
+```
+import * as MwsApi from 'amazon-mws';
+
+const amazonMws = new MwsApi();
+amazonMws.setApiKey(accessKey, accessSecret);
+```
+
+
 ### Feeds
 
 #### Submit Feed
@@ -346,6 +361,44 @@ var amazonMws = require('amazon-mws')('AWS_ACCESS_KEY_ID','AWS_SECRET_ACCESS_KEY
 
 ### Products
 
+#### Get Lowest Priced Offers For ASIN
+```js
+    amazonMws.products.searchFor({
+        'Version': '2011-10-01',
+        'Action': 'GetLowestPricedOffersForASIN',
+        'SellerId': 'SELLER_ID',
+        'MWSAuthToken': 'MWS_AUTH_TOKEN',
+        'MarketplaceId': 'MARKET_PLACE_ID',
+        'ASIN': 'ASIN',
+        'ItemCondition': 'New'
+    }, function (error, response) {
+        if (error) {
+            console.log('error products', error);
+            return;
+        }
+        console.log('response ', response);
+    });
+```
+
+#### Get Lowest Priced Offers For SKU
+```js
+    amazonMws.products.searchFor({
+        'Version': '2011-10-01',
+        'Action': 'GetLowestPricedOffersForSKU',
+        'SellerId': 'SELLER_ID',
+        'MWSAuthToken': 'MWS_AUTH_TOKEN',
+        'MarketplaceId': 'MARKET_PLACE_ID',
+        'SellerSKU': 'SELLER_SKU',
+        'ItemCondition': 'New'
+    }, function (error, response) {
+        if (error) {
+            console.log('error ', error);
+            return;
+        }
+        console.log('response ', response);
+    });
+```
+
 #### List Matching Products
 ```js
     amazonMws.products.search({
@@ -438,6 +491,7 @@ var amazonMws = require('amazon-mws')('AWS_ACCESS_KEY_ID','AWS_SECRET_ACCESS_KEY
 
 #### Get Report
 ###### This will provide you JSON report/data.
+###### This will not provide you Throttling details in Header.
 ```js
     amazonMws.reports.search({
         'Version': '2009-01-01',
@@ -479,6 +533,31 @@ var amazonMws = require('amazon-mws')('AWS_ACCESS_KEY_ID','AWS_SECRET_ACCESS_KEY
     });
 ```
 
+#### Get Report
+###### Using TypeScript.
+```
+    const accessKey = process.env.AWS_ACCESS_KEY_ID || 'YOUR_KEY';
+    const accessSecret = process.env.AWS_SECRET_ACCESS_KEY || 'YOUR_SECRET';
+    
+    import * as MwsApi from 'amazon-mws';
+    
+    const amazonMws = new MwsApi();
+    amazonMws.setApiKey(accessKey, accessSecret);
+    
+    try {
+        const response: any = await amazonMws.reports.search({
+            'Version': '2009-01-01',
+            'Action': 'GetReport',
+            'SellerId': 'SELLER_ID',
+            'MWSAuthToken': 'MWS_AUTH_TOKEN',
+            'ReportId': 'REPORT_ID'
+        });
+        console.log('response', response);
+    } catch (error: any) {
+        console.log('error ', error);
+    } 
+```
+
 #### Additionally all api returns Throttling: Limits to how often you can submit requests
 Reference : http://docs.developer.amazonservices.com/en_CA/dev_guide/DG_Throttling.html
 ```json

examples/javaScript/feeds/file.txt

@@ -2,7 +2,7 @@
 <AmazonEnvelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="amznenvelope.xsd">
 <Header>
 <DocumentVersion>1.01</DocumentVersion>
-<MerchantIdentifier>AUV38W4NKU8JH</MerchantIdentifier>
+<MerchantIdentifier>XXXXXXXXXXXXXXX</MerchantIdentifier>
 </Header>
 <MessageType>Inventory</MessageType>
 <Message>

examples/javaScript/feeds/getFeedSubmissionResultRaw.js

@@ -0,0 +1,33 @@
+'use strict';
+var fs = require('fs');
+
+var accessKey = process.env.AWS_ACCESS_KEY_ID || 'YOUR_KEY';
+var accessSecret = process.env.AWS_SECRET_ACCESS_KEY || 'YOUR_SECRET';
+
+var amazonMws = require('../../../lib/amazon-mws')(accessKey, accessSecret);
+var fse = require('fs-extra');
+
+/**
+ * Use __RAW__ to get the raw response in response->data;
+ * This along  with __CHARSET__ do not get written in the request.
+ * */
+function feedRequest() {
+    var FeedSubmissionId = '10101010XXX';
+    amazonMws.feeds.search({
+        'Version': '2009-01-01',
+        'Action': 'GetFeedSubmissionResult',
+        'SellerId': 'SELLER_ID',
+        'MWSAuthToken': 'MWS_AUTH_TOKEN',
+        'FeedSubmissionId': FeedSubmissionId,
+        __RAW__: true
+    }, function (error, response) {
+        if (error) {
+            console.log('error ', error);
+            return;
+        }
+        fse.writeFileSync('response.txt', response.data);
+        console.log('Headers', response.Headers);
+    });
+}
+
+feedRequest();

examples/javaScript/products/getLowestPricedOffersForASIN.js

@@ -0,0 +1,26 @@
+'use strict';
+
+var accessKey = process.env.AWS_ACCESS_KEY_ID || 'YOUR_KEY';
+var accessSecret = process.env.AWS_SECRET_ACCESS_KEY || 'YOUR_SECRET';
+
+var amazonMws = require('../../../lib/amazon-mws')(accessKey, accessSecret);
+
+var productRequest = function () {
+    amazonMws.products.searchFor({
+        'Version': '2011-10-01',
+        'Action': 'GetLowestPricedOffersForASIN',
+        'SellerId': 'SELLER_ID',
+        'MWSAuthToken': 'MWS_AUTH_TOKEN',
+        'MarketplaceId': 'MARKET_PLACE_ID',
+        'ASIN': 'ASIN',
+        'ItemCondition': 'New'
+    }, function (error, response) {
+        if (error) {
+            console.log('error products', error);
+            return;
+        }
+        console.log('response ', response);
+    });
+};
+
+productRequest();

examples/javaScript/products/getLowestPricedOffersForSKU.js

@@ -0,0 +1,26 @@
+'use strict';
+
+var accessKey = process.env.AWS_ACCESS_KEY_ID || 'YOUR_KEY';
+var accessSecret = process.env.AWS_SECRET_ACCESS_KEY || 'YOUR_SECRET';
+
+var amazonMws = require('../../../lib/amazon-mws')(accessKey, accessSecret);
+
+var productRequest = function () {
+    amazonMws.products.searchFor({
+        'Version': '2011-10-01',
+        'Action': 'GetLowestPricedOffersForSKU',
+        'SellerId': 'SELLER_ID',
+        'MWSAuthToken': 'MWS_AUTH_TOKEN',
+        'MarketplaceId': 'MARKET_PLACE_ID',
+        'SellerSKU': 'SELLER_SKU',
+        'ItemCondition': 'New'
+    }, function (error, response) {
+        if (error) {
+            console.log('error ', error);
+            return;
+        }
+        console.log('response ', response);
+    });
+};
+
+productRequest();

examples/javaScript/reports/getReport.js

@@ -5,13 +5,18 @@ var accessSecret = process.env.AWS_SECRET_ACCESS_KEY || 'YOUR_SECRET';
 
 var amazonMws = require('../../../lib/amazon-mws')(accessKey, accessSecret);
 
+/**
+ * This will not provide you Throttling details in Header.
+ * Amazon MWS itself not providing Throttling detail in GetReport call.
+ */
+
 var reportRequest = function () {
     amazonMws.reports.search({
         'Version': '2009-01-01',
         'Action': 'GetReport',
         'SellerId': 'SELLER_ID',
         'MWSAuthToken': 'MWS_AUTH_TOKEN',
-        'ReportId':'REPORT_ID'
+        'ReportId': 'REPORT_ID'
     }, function (error, response) {
         if (error) {
             console.log('error ', error);

examples/javaScript/reports/getReportList.js

@@ -11,7 +11,7 @@ var reportRequest = function () {
         'Version': '2009-01-01',
         'Action': 'GetReportList',
         'SellerId': 'SELLER_ID',
-        'MWSAuthToken': 'MWS_AUTH_TOKEN',
+        'MWSAuthToken': 'MWS_AUTH_TOKEN'
         //'ReportTypeList.Type.1': 'REPORT_TYPE_LIST' //optional
     }, function (error, response) {
         if (error) {

examples/typeScript/package.json

@@ -1,15 +1,15 @@
 {
-    "name": "trello-sample",
-    "version": "1.0.0",
-    "description": "trello",
-    "license": "MIT",
-    "dependencies": {
-        "@types/node": "^8.0.53",
-        "@types/es6-promise": "0.0.33",
-        "babel-eslint": "^8.0.1",
-        "babel-preset-node6": "^11.0.0",
-        "amazon-mws": "^0.0.16",
-        "node-expat": "^2.3.16"
-    },
-    "devDependencies": {}
+  "name": "amazon-mws-typescript-sample",
+  "version": "1.0.0",
+  "description": "trello",
+  "license": "MIT",
+  "dependencies": {
+    "@types/node": "^8.0.53",
+    "@types/es6-promise": "0.0.33",
+    "babel-eslint": "^8.0.1",
+    "babel-preset-node6": "^11.0.0",
+    "amazon-mws": "*",
+    "node-expat": "^2.3.16"
+  },
+  "devDependencies": {}
 }

examples/typeScript/reports/getReport.ts

@@ -6,6 +6,11 @@ import * as MwsApi from 'amazon-mws';
 const amazonMws = new MwsApi();
 amazonMws.setApiKey(accessKey, accessSecret);
 
+/**
+ * This will not provide you Throttling details in Header.
+ * Amazon MWS itself not providing Throttling detail in GetReport call.
+ */
+
 const reportRequest = async () => {
 
     try {
@@ -21,7 +26,6 @@ const reportRequest = async () => {
         console.log('error ', error);
     }
 
-
 };
 
 reportRequest();

index.d.ts

@@ -42,6 +42,8 @@ declare class Orders extends BaseAmazonMWS {
 
 declare class Products extends BaseAmazonMWS {
 
+    searchFor(params: any): Promise<any>;
+
 }
 
 declare class Reports extends BaseAmazonMWS {