Initial commit

Author: blove

.gitignore

@@ -0,0 +1,4 @@
+.tscache
+.baseDir.ts
+dist
+node_modules

README.md

@@ -0,0 +1,19 @@
+# TypeScript 2 + Express + Node.js
+
+This is a repository to go with my article on creating an Express web application using TypeScript 2.
+
+## Install
+
+Install the node packages via:
+
+`$ npm install`
+
+And then run the grunt task to compile the TypeScript:
+
+`$ npm run grunt`
+
+## Starting
+
+To start the server run:
+
+`$ npm start`

bin/www

@@ -0,0 +1,80 @@
+#!/usr/bin/env node
+"use strict";
+
+//module dependencies
+var server = require("../dist/server");
+var debug = require("debug")("express:server");
+var http = require("http");
+
+//create http server
+var httpPort = normalizePort(process.env.PORT || 8080);
+var app = server.Server.bootstrap().app;
+app.set("port", httpPort);
+var httpServer = http.createServer(app);
+
+//listen on provided ports
+httpServer.listen(httpPort);
+
+//add error handler
+httpServer.on("error", onError);
+
+//start listening on port
+httpServer.on("listening", onListening);
+
+
+/**
+ * Normalize a port into a number, string, or false.
+ */
+function normalizePort(val) {
+  var port = parseInt(val, 10);
+
+  if (isNaN(port)) {
+    // named pipe
+    return val;
+  }
+
+  if (port >= 0) {
+    // port number
+    return port;
+  }
+
+  return false;
+}
+
+/**
+ * Event listener for HTTP server "error" event.
+ */
+function onError(error) {
+  if (error.syscall !== "listen") {
+    throw error;
+  }
+
+  var bind = typeof port === "string"
+    ? "Pipe " + port
+    : "Port " + port;
+
+  // handle specific listen errors with friendly messages
+  switch (error.code) {
+    case "EACCES":
+      console.error(bind + " requires elevated privileges");
+      process.exit(1);
+      break;
+    case "EADDRINUSE":
+      console.error(bind + " is already in use");
+      process.exit(1);
+      break;
+    default:
+      throw error;
+  }
+}
+
+/**
+ * Event listener for HTTP server "listening" event.
+ */
+function onListening() {
+  var addr = httpServer.address();
+  var bind = typeof addr === "string"
+    ? "pipe " + addr
+    : "port " + addr.port;
+  debug("Listening on " + bind);
+}

gruntfile.js

@@ -0,0 +1,57 @@
+module.exports = function(grunt) {
+  "use strict";
+
+  grunt.initConfig({
+    copy: {
+      build: {
+        files: [
+          {
+            expand: true,
+            cwd: "./public",
+            src: ["**"],
+            dest: "dist/public"
+          },
+          {
+            expand: true,
+            cwd: "./views",
+            src: ["**"],
+            dest: "dist/views"
+          }
+        ]
+      }
+    },
+    ts: {
+      app: {
+        files: [{
+          src: ["src/\*\*/\*.ts", "!src/.baseDir.ts"],
+          dest: "./dist"
+        }],
+        options: {
+          module: "commonjs",
+          target: "es6",
+          sourceMap: false
+        }
+      }
+    },
+    watch: {
+      ts: {
+        files: ["src/\*\*/\*.ts"],
+        tasks: ["ts"]
+      },
+      views: {
+        files: ["views/**/*.pug"],
+        tasks: ["copy"]
+      }
+    }
+  });
+
+  grunt.loadNpmTasks("grunt-contrib-copy");
+  grunt.loadNpmTasks("grunt-contrib-watch");
+  grunt.loadNpmTasks("grunt-ts");
+
+  grunt.registerTask("default", [
+    "copy",
+    "ts"
+  ]);
+
+};

package.json

@@ -0,0 +1,33 @@
+{
+  "name": "heros",
+  "description": "The tour of heros",
+  "version": "1.0.0",
+  "private": true,
+  "author": "Brian Love",
+  "scripts": {
+    "dev": "NODE_ENV=development nodemon ./bin/www",
+    "grunt": "grunt",
+    "start": "node ./bin/www"
+  },
+  "dependencies": {
+    "body-parser": "^1.15.2",
+    "cookie-parser": "^1.4.3",
+    "errorhandler": "^1.4.3",
+    "express": "^4.14.0",
+    "method-override": "^2.3.6",
+    "morgan": "^1.7.0",
+    "pug": "^2.0.0-beta6"
+  },
+  "devDependencies": {
+    "@types/body-parser": "0.0.33",
+    "@types/cookie-parser": "^1.3.30",
+    "@types/errorhandler": "0.0.30",
+    "@types/method-override": "0.0.29",
+    "@types/morgan": "^1.7.32",
+    "grunt": "^1.0.1",
+    "grunt-contrib-copy": "^1.0.0",
+    "grunt-contrib-watch": "^1.0.0",
+    "grunt-ts": "^6.0.0-beta.3",
+    "typescript": "^2.0.8"
+  }
+}

src/routes/index.ts

@@ -0,0 +1,60 @@
+import { NextFunction, Request, Response, Router } from "express";
+import { BaseRoute } from "./route";
+
+
+/**
+ * / route
+ *
+ * @class User
+ */
+export class IndexRoute extends BaseRoute {
+
+  /**
+   * Create the routes.
+   *
+   * @class IndexRoute
+   * @method create
+   * @static
+   */
+  public static create(router: Router) {
+    //log
+    console.log("[IndexRoute::create] Creating index route.");
+
+    //add home page route
+    router.get("/", (req: Request, res: Response, next: NextFunction) => {
+      new IndexRoute().index(req, res, next);
+    });
+  }
+
+  /**
+   * Constructor
+   *
+   * @class IndexRoute
+   * @constructor
+   */
+  constructor() {
+    super();
+  }
+
+  /**
+   * The home page route.
+   *
+   * @class IndexRoute
+   * @method index
+   * @param req {Request} The express Request object.
+   * @param res {Response} The express Response object.
+   * @next {NextFunction} Execute the next method.
+   */
+  public index(req: Request, res: Response, next: NextFunction) {
+    //set custom title
+    this.title = "Home | Tour of Heros";
+
+    //set message
+    let options: Object = {
+      "message": "Welcome to the Tour of Heros"
+    };
+
+    //render template
+    this.render(req, res, "index", options);
+  }
+}

src/routes/route.ts

@@ -0,0 +1,64 @@
+import { NextFunction, Request, Response } from "express";
+
+/**
+ * Constructor
+ *
+ * @class BaseRoute
+ */
+export class BaseRoute {
+
+  protected title: string;
+
+  private scripts: string[];
+
+
+  /**
+   * Constructor
+   *
+   * @class BaseRoute
+   * @constructor
+   */
+  constructor() {
+    //initialize variables
+    this.title = "Tour of Heros";
+    this.scripts = [];
+  }
+
+  /**
+   * Add a JS external file to the request.
+   *
+   * @class BaseRoute
+   * @method addScript
+   * @param src {string} The src to the external JS file.
+   * @return {BaseRoute} Self for chaining
+   */
+  public addScript(src: string): BaseRoute {
+    this.scripts.push(src);
+    return this;
+  }
+
+  /**
+   * Render a page.
+   *
+   * @class BaseRoute
+   * @method render
+   * @param req {Request} The request object.
+   * @param res {Response} The response object.
+   * @param view {String} The view to render.
+   * @param options {Object} Additional options to append to the view's local scope.
+   * @return void
+   */
+  public render(req: Request, res: Response, view: string, options?: Object) {
+    //add constants
+    res.locals.BASE_URL = "/";
+
+    //add scripts
+    res.locals.scripts = this.scripts;
+
+    //add title
+    res.locals.title = this.title;
+
+    //render view
+    res.render(view, options);
+  }
+}