Merge pull request #1 from StatelessStudio/github-v2.1.0

GitHub v2.1.0

Author: DrewImm

CHANGELOG.md

@@ -1,5 +1,12 @@
 # typescript-template
 
+## [2.1.0]
+
+### Additions
+- [TSTEMPLATE-33] Add teardown function for graceful shutdown
+
+### Fixes
+
 ## [2.0.1]
 
 ### Fixes

package-lock.json

@@ -1,7 +1,7 @@
 {
 	"name": "typescript-template",
 	"version": "1.0.0",
-	"ts-project-version": "2.0.1",
+	"ts-project-version": "2.1.0",
 	"description": "typescript-template",
 	"scripts": {
 		"start": "npm run dev",
@@ -25,9 +25,9 @@
 		"admin:example": "ts-node script/example"
 	},
 	"dependencies": {
-		"ts-appconfig": "^1.0.0",
-		"ts-async-bootstrap": "^2.0.0",
-		"ts-error-handler": "^1.0.0",
+		"ts-appconfig": "^1.2.0",
+		"ts-async-bootstrap": "^2.1.0",
+		"ts-error-handler": "^1.0.2",
 		"ts-tiny-log": "^1.0.2"
 	},
 	"devDependencies": {

package.json

@@ -2,34 +2,19 @@
  * This file bootstraps your application by running the register function
  * 	and setting up error handling.
  */
-import {
-	bootstrap as _bootstrap,
-	BootstrapFunction,
-	BootstrapOptions
-} from 'ts-async-bootstrap';
+import { Bootstrap as _Bootstrap, RunFunction } from 'ts-async-bootstrap';
 
 import { errorHandler } from './error-handler';
-import { register } from './register';
+import { register, teardown } from './register';
 
-/**
- * Default bootstrapping options
- */
-export const defaultBootstrapOptions: Partial<BootstrapOptions> = {
-	register: register,
-	errorHandler: errorHandler,
-	shouldExitOnError: true,
-};
+export class App extends _Bootstrap {
+	onError = errorHandler;
+	register = register;
+	teardown = teardown;
+}
 
-/**
- * Bootstrap a function
- */
-export function bootstrap(
-	run: BootstrapFunction,
-	options?: Partial<BootstrapOptions>
-): void {
-	_bootstrap({
-		...defaultBootstrapOptions,
-		...options,
-		run: run
-	});
+export const app = new App();
+
+export function bootstrap(run: RunFunction) {
+	app.boot(run);
 }

src/bootstrap.ts

@@ -1,4 +1,5 @@
 import { setupErrorHandling } from 'ts-error-handler';
+import { app } from './bootstrap';
 import { log } from './log';
 
 /**
@@ -8,6 +9,8 @@ import { log } from './log';
  */
 export function errorHandler(error: Error): void {
 	log.fatal(error);
+
+	app.exit();
 }
 
 // Setup error handling

src/error-handler.ts

@@ -12,6 +12,6 @@ bootstrap(main);
 /**
  * Documentation - Exported modules will appear in documentation
  */
-export { bootstrap } from './bootstrap';
+export { App, app, bootstrap } from './bootstrap';
 export { Environment } from './environment';
 export { errorHandler } from './error-handler';

src/index.ts

@@ -1,8 +1,19 @@
-
+import { log } from './log';
 
 /**
  * Initialize & register your app's services here
  */
 export async function register(): Promise<void> {
+	log.info('Booting...');
+
 	// TODO: Register services here
 }
+
+/**
+ * Teardown services here
+ */
+export async function teardown(): Promise<void> {
+	log.info('Tearing down...');
+
+	// TODO: Teardown services here
+}

src/register.ts

@@ -12,7 +12,7 @@
 		"target": "es6",
 		"types": ["node"],
 		"typeRoots": ["node_modules/@types", "./"],
-		"lib": ["es2017"]
+		"lib": ["es2020"]
 	},
 	"exclude": [
 		"./dist/"