updating some of the source styling

jeffwilcox · Apr 5, 2012 · f0a9683 · f0a9683
1 parent 8a2a5dd
commit f0a9683
Show file tree

Hide file tree

Showing 3 changed files with 136 additions and 132 deletions.
diff --git a/README.md b/README.md
@@ -1,110 +1,114 @@
-#mpns
-
-Send toast and live tile updates to Windows Phones through the Microsoft Push Notification Service (MPNS). Intended for the cloud and Node.js.
-
-This is one of my very first Node.js projects so feedback and patience appreciated. I hope it helps!
-
-## Installation
-
-Via [npm][]:
-
-	$ npm install mspn
-
-As a submodule of your Git project
-
-	$ git submodule add http://github.com/jeffwilcox/mpns.git mpns
-	$ git submodule update --init
-
-## Usage
-### Load in the module
-
-	var mpns = require('mpns');
-
-### Create a new notification
-You can create a new notification object (either of type live tile or toast).
-
-Property names for the notification object directly correlate to the names used in the MPNS XML payload as documented on MSDN. Properties can either be set directly on the object (such as toast.text1) or by passing the values in as options to the constructor.
-
-	options =   { text1: 'Hello!'
-				, text2: 'Great to see you today.'
-				};
-
-	var toast = new mpns.toast(options);
-
-### Sending a notification
-To send a notification simply call the `send` method on the object. The first parameter is the HTTP URI to the MPNS endpoint of the client you'd like to send the notification to. You may provide an optional callback function as well.
-
-	toast.send('http://sn1.notify.live.net/throttledthirdparty/01.00/YOUR_ENDPOINT_HERE');
-
-You can also use the other syntax. Let's send a live tile update!
-
-	var toast = new mpns.liveTile();
-	toast.title: 'My App';
-	toast.backgroundUri: 'http://sample.com/image.png';
-	toast.send('http://sn1.notify.live.net/throttledthirdparty/01.00/YOUR_ENDPOINT_HERE', function(err,res) {
-		if (err) console.dir(err);
-		else console.dir(res);
-	});
-
-### Sending a raw notification
-When creating the notification object, either provide the raw payload first, or as the `options.payload` property.
-
-	var raw = new mpns.rawNotification('My Raw Payload', options);
-
-Today the type on the request is set to UTF8 explicitly.
-
-### Results object information
-A results object is passed back through the callback and has important information from MPNS.
-
-- `deviceConnectionStatus`: The device status as reported by the service.
-- `notificationStatus`: The status of your provided notification.
-- `subscriptionStatus`: The status of the subscription URI.
-
-The object will also contain all the key fields for your toast or live tile update, plus the pushType. This makes it easy to store this information in a history log somewhere in the ether.
-
-### Handling Errors
-It is very important as a consumer that you store appropriate actionable data about failed push notification attempts. As a result, the callback's first parameter (err) is set to the standard results object as well as a few additional fields depending on the returned status code from the server.
-
-Remember to take action on that information in order to be a good MPNS citizen. These values may be set in the error object and of interest to you:
-
-- `minutesToDelay`: If this is present, it is the suggested minimum amount of time that you should wait until making another request to the same subscription URI. For HTTP 412s, for example, the minimum time is one hour and so the returned value defaults to 61.
-- `shouldDeleteChannel`: If this is set to `true`, the channel is gone according to MPNS. Delete it from your channel/subscription database and never look back.
-- `error`: If an error is captured while trying to make the HTTP request, this will be set to that error callback instance.
-
-### A note about Windows Phone 7.5
-This module permits sending toasts and tiles specific to Mango. If you include the `param` field when sending a push to a 7.0 (first Windows Phone release) phone, unfortunately it may not be received, or will error out the subscription.
-
-Take care when registering your subscription channels with your cloud service to include the application platform version of the app (7.1 for Mango apps). To rock, maybe also grab the OS version and deployed app version. That information can be helpful when supporting customers.
-
-## Credits
-
-Written and maintained by [Jeff Wilcox].
-
-## License
-
-Copyright 2011 Jeff Wilcox
-
-Licensed under the Apache License, Version 2.0 (the "License");
-you may not use this file except in compliance with the License.
-You may obtain a copy of the License at
-
-   http://www.apache.org/licenses/LICENSE-2.0
-
-Unless required by applicable law or agreed to in writing, software
-distributed under the License is distributed on an "AS IS" BASIS,
-WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
-See the License for the specific language governing permissions and
-limitations under the License.
-
-[Jeff Wilcox]: http://www.jeff.wilcox.name
-[npm]: http://github.com/isaacs/npm
-
-## Changelog
-
-1.0.0:
-
-* Initial implementation offering basic live tile and toast (no raw) support.
-
-1.0.1:
-
-* Adds raw notification type support.
+#mpns
+
+Send toast and live tile updates to Windows Phones through the Microsoft Push Notification Service (MPNS). Intended for the cloud and Node.js.
+
+This is one of my very first Node.js projects so feedback and patience appreciated. I hope it helps!
+
+## Installation
+
+Via [npm][]:
+
+	$ npm install mspn
+
+As a submodule of your Git project
+
+	$ git submodule add http://github.com/jeffwilcox/mpns.git mpns
+	$ git submodule update --init
+
+## Usage
+### Load in the module
+
+	var mpns = require('mpns');
+
+### Create a new notification
+You can create a new notification object (either of type live tile or toast).
+
+Property names for the notification object directly correlate to the names used in the MPNS XML payload as documented on MSDN. Properties can either be set directly on the object (such as toast.text1) or by passing the values in as options to the constructor.
+
+	options =   { text1: 'Hello!'
+				, text2: 'Great to see you today.'
+				};
+
+	var toast = new mpns.toast(options);
+
+### Sending a notification
+To send a notification simply call the `send` method on the object. The first parameter is the HTTP URI to the MPNS endpoint of the client you'd like to send the notification to. You may provide an optional callback function as well.
+
+	toast.send('http://sn1.notify.live.net/throttledthirdparty/01.00/YOUR_ENDPOINT_HERE');
+
+You can also use the other syntax. Let's send a live tile update!
+
+	var toast = new mpns.liveTile();
+	toast.title: 'My App';
+	toast.backgroundUri: 'http://sample.com/image.png';
+	toast.send('http://sn1.notify.live.net/throttledthirdparty/01.00/YOUR_ENDPOINT_HERE', function(err,res) {
+		if (err) console.dir(err);
+		else console.dir(res);
+	});
+
+### Sending a raw notification
+When creating the notification object, either provide the raw payload first, or as the `options.payload` property.
+
+	var raw = new mpns.rawNotification('My Raw Payload', options);
+
+Today the type on the request is set to UTF8 explicitly.
+
+### Results object information
+A results object is passed back through the callback and has important information from MPNS.
+
+- `deviceConnectionStatus`: The device status as reported by the service.
+- `notificationStatus`: The status of your provided notification.
+- `subscriptionStatus`: The status of the subscription URI.
+
+The object will also contain all the key fields for your toast or live tile update, plus the pushType. This makes it easy to store this information in a history log somewhere in the ether.
+
+### Handling Errors
+It is very important as a consumer that you store appropriate actionable data about failed push notification attempts. As a result, the callback's first parameter (err) is set to the standard results object as well as a few additional fields depending on the returned status code from the server.
+
+Remember to take action on that information in order to be a good MPNS citizen. These values may be set in the error object and of interest to you:
+
+- `minutesToDelay`: If this is present, it is the suggested minimum amount of time that you should wait until making another request to the same subscription URI. For HTTP 412s, for example, the minimum time is one hour and so the returned value defaults to 61.
+- `shouldDeleteChannel`: If this is set to `true`, the channel is gone according to MPNS. Delete it from your channel/subscription database and never look back.
+- `error`: If an error is captured while trying to make the HTTP request, this will be set to that error callback instance.
+
+### A note about Windows Phone 7.5
+This module permits sending toasts and tiles specific to Mango. If you include the `param` field when sending a push to a 7.0 (first Windows Phone release) phone, unfortunately it may not be received, or will error out the subscription.
+
+Take care when registering your subscription channels with your cloud service to include the application platform version of the app (7.1 for Mango apps). To rock, maybe also grab the OS version and deployed app version. That information can be helpful when supporting customers.
+
+## Credits
+
+Written and maintained by [Jeff Wilcox].
+
+## License
+
+Copyright 2011 Jeff Wilcox
+
+Licensed under the Apache License, Version 2.0 (the "License");
+you may not use this file except in compliance with the License.
+You may obtain a copy of the License at
+
+   http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing, software
+distributed under the License is distributed on an "AS IS" BASIS,
+WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+See the License for the specific language governing permissions and
+limitations under the License.
+
+[Jeff Wilcox]: http://www.jeff.wilcox.name
+[npm]: http://github.com/isaacs/npm
+
+## Changelog
+
+1.0.0:
+
+* Initial implementation offering basic live tile and toast (no raw) support.
+
+1.0.1:
+
+* Adds raw notification type support.
+
+1.0.2:
+
+* Fixes some small formatting issues.
diff --git a/lib/mpns.js b/lib/mpns.js
@@ -30,11 +30,11 @@ var ERROR_MINIMUM_DELAY = 5; // minutes
 
 var Toast = function(options) {
     return new PushMessage('toast', '2', 'toast', options);
-}
+};
 
 var LiveTile = function(options) {
     return new PushMessage('tile', '1', 'token', options);
-}
+};
 
 var RawNotification = function(payload, options) {
     if (options == undefined) {
@@ -43,7 +43,7 @@ var RawNotification = function(payload, options) {
         options.payload = payload;
     }
     return new PushMessage('raw', '3', undefined, options);
-}
+};
 
 function PushMessage(pushType, quickNotificationClass, targetName, options) {
     this.pushType = pushType;
@@ -120,7 +120,7 @@ PushMessage.prototype.send = function(pushUri, callback) {
     // Send the push notification to Microsoft.
     req.write(payload);
     req.end();
-}
+};
 
 function copyOfInterest(source, destination, fieldsOfInterest) {
     if (source && destination && fieldsOfInterest && fieldsOfInterest.length > 0) {
@@ -142,22 +142,22 @@ PushMessage.prototype.getXmlPayload = function() {
     } else if (this.pushType == 'raw') {
         return this.payload;
     }
-}
+};
 
 PushMessage.prototype.validate = function() {
     if (this.pushType != 'toast' && this.pushType != 'tile') {
         throw new Error("Only 'toast' and 'tile' push types are currently supported.");
     }
-}
+};
 
 // This is a little lazy, really more needs to be escaped and I'm sure there's a standard function for that hotness too.
 function escapeAmpersands(str) {
     return str.replace(/\&/g,'&amp;');
 }
 
 function getPushHeader(type) {
-    return '<?xml version="1.0" encoding="utf-8"?><wp:Notification xmlns:wp="WPNotification">'
-        + startTag(type);
+    return '<?xml version="1.0" encoding="utf-8"?><wp:Notification xmlns:wp="WPNotification">' + 
+        startTag(type);
 }
 
 function getPushFooter(type) {
@@ -178,23 +178,23 @@ function wrapValue(object, key, name) {
 
 function toastToXml(options) {
     var type = 'Toast';
-    return getPushHeader(type)
-        + wrapValue(options, 'text1', 'Text1')
-        + wrapValue(options, 'text2', 'Text2')
-        + wrapValue(options, 'param', 'Param')
-        + getPushFooter(type);
+    return getPushHeader(type) + 
+        wrapValue(options, 'text1', 'Text1') + 
+        wrapValue(options, 'text2', 'Text2') + 
+        wrapValue(options, 'param', 'Param') + 
+        getPushFooter(type);
 }
 
 function tileToXml(options) {
     var type = 'Tile';
-    return getPushHeader(type)
-        + wrapValue(options, 'backgroundImage', 'BackgroundImage')
-        + wrapValue(options, 'count', 'Count')
-        + wrapValue(options, 'title', 'Title')
-        + wrapValue(options, 'backBackgroundImage', 'BackBackgroundImage')
-        + wrapValue(options, 'backTitle', 'BackTitle')
-        + wrapValue(options, 'backContent', 'BackContent')
-        + getPushFooter(type);
+    return getPushHeader(type) + 
+        wrapValue(options, 'backgroundImage', 'BackgroundImage') +
+        wrapValue(options, 'count', 'Count') +
+        wrapValue(options, 'title', 'Title') +
+        wrapValue(options, 'backBackgroundImage', 'BackBackgroundImage') +
+        wrapValue(options, 'backTitle', 'BackTitle') +
+        wrapValue(options, 'backContent', 'BackContent') +
+        getPushFooter(type);
 }
 
 var propertiesOfInterest = [

diff --git a/package.json b/package.json
@@ -1,7 +1,7 @@
 {
   "name": "mpns",
   "description": "A Node.js interface to the Microsoft Push Notification Service (MPNS) for Windows Phone.",
-  "version": "1.0.1",
+  "version": "1.0.2",
   "author": "Jeff Wilcox <jeffwilcox+github@gmail.com>",
   "contributors": [ 
     { "name": "Jeff Wilcox", "email": "jeffwilcox+github@gmail.com" }