Initial commit

Author: tomdale

.gitignore

@@ -0,0 +1 @@
+node_modules

.jshintrc

@@ -0,0 +1,5 @@
+{
+  "node": true,
+  "esnext": true,
+  "unused": true
+}

README.md

@@ -0,0 +1,35 @@
+## FastBoot S3 Notifier
+
+This notifier for the [FastBoot App Server][app-server] works with AWS
+S3 to poll an object's Last Modified header to detect when you have
+deployed a new version of your app.
+
+To use the notifier, configure it with an S3 bucket and key:
+
+```js
+const S3Notifier = require('fastboot-s3-notifier');
+
+let notifier = new S3Notifier({
+  bucket: S3_BUCKET,
+  key: S3_KEY
+});
+
+let server = new FastBootAppServer({
+  notifier: notifier
+});
+```
+
+When the notifier starts, it will poll the object at the specified
+bucket and key. Once the `LastModified` metadata changes, it will tell
+the FastBoot App Server to fetch the latest version of the app.
+
+Note that you should point the notifier at a _static_ path on S3, like
+`fastboot-deploy-info.json`. That JSON file should then point the app
+server to the latest application bundle. This way, you don't have to
+propagate configuration changes to all of your app servers, and they can
+poll a single key in perpetuity.
+
+If you like this, you may also be interested in the companion
+[fastboot-s3-downloader](https://github.com/tomdale/fastboot-s3-downloader),
+which parses the above-described JSON file to find and download the
+latest version of your app.

index.js

@@ -0,0 +1,65 @@
+"use strict";
+
+const AWS  = require('aws-sdk');
+
+const DEFAULT_POLL_TIME = 3 * 1000;
+
+const s3 = new AWS.S3({
+  apiVersion: '2006-03-01'
+});
+
+class S3Notifier {
+  constructor(options) {
+    this.ui = options.ui;
+    this.bucket = options.bucket;
+    this.key = options.key;
+    this.pollTime = options.poll || DEFAULT_POLL_TIME;
+
+    this.params = {
+      Bucket: this.bucket,
+      Key: this.key
+    };
+  }
+
+  subscribe(notify) {
+    this.notify = notify;
+
+    this.getCurrentLastModified()
+      .then(() => this.schedulePoll());
+  }
+
+  getCurrentLastModified() {
+    return s3.headObject(this.params).promise()
+      .then(data => {
+        this.lastModified = data.LastModified;
+      })
+      .catch(() => {
+        this.ui.writeError('error fetching S3 last modified; notifications disabled');
+      });
+  }
+
+  schedulePoll() {
+    setTimeout(() => {
+      this.poll();
+    }, this.pollTime);
+  }
+
+  poll() {
+    s3.headObject(this.params).promise()
+      .then(data => {
+        this.compareLastModifieds(data.LastModified);
+        this.schedulePoll();
+      });
+  }
+
+  compareLastModifieds(newLastModified) {
+    if (newLastModified !== this.lastModified) {
+      this.ui.writeLine('config modified; old=%s; new=%s', this.lastModified, newLastModified);
+      this.lastModified = newLastModified;
+      this.notify();
+    }
+  }
+}
+
+
+module.exports = S3Notifier;

package.json

@@ -0,0 +1,28 @@
+{
+  "name": "fastboot-s3-notifier",
+  "version": "0.1.0",
+  "description": "A FastBoot App Server notifier for AWS S3",
+  "main": "index.js",
+  "scripts": {
+    "test": "mocha"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/tomdale/fastboot-s3-notifier.git"
+  },
+  "keywords": [
+    "ember",
+    "fastboot",
+    "notifier",
+    "s3"
+  ],
+  "author": "Tom Dale <[email protected]>",
+  "license": "MIT",
+  "bugs": {
+    "url": "https://github.com/tomdale/fastboot-s3-notifier/issues"
+  },
+  "homepage": "https://github.com/tomdale/fastboot-s3-notifier#readme",
+  "dependencies": {
+    "aws-sdk": "^2.3.4"
+  }
+}