@dvsa/appdev-api-common 0.0.1 → 0.1.1

package/{src/api/api-gateway-model.ts → api/api-gateway-model.d.ts}

@@ -1,6 +1,5 @@
 import type { APIGatewayEvent, Context } from "aws-lambda";
-
 export interface APIGatewayModel {
-	event: APIGatewayEvent;
-	context: Context;
+    event: APIGatewayEvent;
+    context: Context;
 }

package/api/api-gateway-model.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/api/http-status-codes.d.ts

@@ -0,0 +1,14 @@
+export declare enum HttpStatus {
+    OK = 200,
+    CREATED = 201,
+    ACCEPTED = 202,
+    NO_CONTENT = 204,
+    NOT_MODIFIED = 304,
+    BAD_REQUEST = 400,
+    UNAUTHORIZED = 401,
+    FORBIDDEN = 403,
+    NOT_FOUND = 404,
+    INTERNAL_SERVER_ERROR = 500,
+    BAD_GATEWAY = 502,
+    GATEWAY_TIMEOUT = 504
+}

package/api/http-status-codes.js

@@ -0,0 +1,18 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.HttpStatus = void 0;
+var HttpStatus;
+(function (HttpStatus) {
+    HttpStatus[HttpStatus["OK"] = 200] = "OK";
+    HttpStatus[HttpStatus["CREATED"] = 201] = "CREATED";
+    HttpStatus[HttpStatus["ACCEPTED"] = 202] = "ACCEPTED";
+    HttpStatus[HttpStatus["NO_CONTENT"] = 204] = "NO_CONTENT";
+    HttpStatus[HttpStatus["NOT_MODIFIED"] = 304] = "NOT_MODIFIED";
+    HttpStatus[HttpStatus["BAD_REQUEST"] = 400] = "BAD_REQUEST";
+    HttpStatus[HttpStatus["UNAUTHORIZED"] = 401] = "UNAUTHORIZED";
+    HttpStatus[HttpStatus["FORBIDDEN"] = 403] = "FORBIDDEN";
+    HttpStatus[HttpStatus["NOT_FOUND"] = 404] = "NOT_FOUND";
+    HttpStatus[HttpStatus["INTERNAL_SERVER_ERROR"] = 500] = "INTERNAL_SERVER_ERROR";
+    HttpStatus[HttpStatus["BAD_GATEWAY"] = 502] = "BAD_GATEWAY";
+    HttpStatus[HttpStatus["GATEWAY_TIMEOUT"] = 504] = "GATEWAY_TIMEOUT";
+})(HttpStatus || (exports.HttpStatus = HttpStatus = {}));

package/auth/auth-checker.d.ts

@@ -0,0 +1,14 @@
+import type { Request } from "express";
+import type { Action } from "routing-controllers";
+import type { APIGatewayModel } from "../api/api-gateway-model";
+export type RoutingControllersRequest = Request & {
+    apiGateway: APIGatewayModel;
+};
+export declare class JWTAuthChecker {
+    /**
+     * Perform a JWT token verification and role check
+     * @param {RoutingControllersRequest} request
+     * @param roles
+     */
+    static execute({ request }: Action, roles?: string | string[]): Promise<boolean>;
+}

package/auth/auth-checker.js

@@ -0,0 +1,49 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.JWTAuthChecker = void 0;
+const http_status_codes_1 = require("../api/http-status-codes");
+const auth_errors_1 = require("./auth-errors");
+const verify_jwt_1 = require("./verify-jwt");
+// biome-ignore lint/complexity/noStaticOnlyClass: this class will be extended in the future
+class JWTAuthChecker {
+    /**
+     * Perform a JWT token verification and role check
+     * @param {RoutingControllersRequest} request
+     * @param roles
+     */
+    static async execute({ request }, roles = []) {
+        // if running locally, skip the token auth and role check
+        if (process.env.IS_OFFLINE === "true")
+            return true;
+        // extract the token from the request headers
+        const token = request?.apiGateway.event
+            .headers?.Authorization;
+        // if no token is found, then deny access to resource
+        if (!token || token.trim()?.length === 0) {
+            throw new auth_errors_1.AuthError(http_status_codes_1.HttpStatus.UNAUTHORIZED, "Missing Authorization header");
+        }
+        // create an instance of the JwtAuthoriser class
+        const authoriser = new verify_jwt_1.JwtAuthoriser();
+        // Validate the token and extract the roles from it
+        const { roles: tokenRoles } = await authoriser.verify(token);
+        // check if a singular or list of roles were passed into the @Authorized decorator & remove nullish values
+        const requiredRoles = (Array.isArray(roles) ? roles : [roles]).filter((role) => !!role);
+        // if there are no requiredRoles, then any valid token can access the resource, so return true
+        if (requiredRoles.length === 0)
+            return true;
+        // if there are no roles in JWT token but roles are required, then deny access
+        if (!tokenRoles || !Array.isArray(tokenRoles) || tokenRoles.length === 0) {
+            throw new auth_errors_1.AuthError(http_status_codes_1.HttpStatus.UNAUTHORIZED, "No roles found in token", "MISSING_ROLES");
+        }
+        // check if one of the required roles is present in JWT token
+        const success = requiredRoles.some((role) => tokenRoles.includes(role));
+        if (!success) {
+            throw new auth_errors_1.AuthError(http_status_codes_1.HttpStatus.UNAUTHORIZED, "Insufficient permissions", "UNAUTHORIZED", {
+                required: requiredRoles,
+                actual: tokenRoles,
+            });
+        }
+        return true;
+    }
+}
+exports.JWTAuthChecker = JWTAuthChecker;

package/auth/auth-errors.d.ts

@@ -0,0 +1,21 @@
+import { HttpStatus } from "../api/http-status-codes";
+type RoleInfo = {
+    required: string[];
+    actual: string[];
+};
+export declare class AuthError extends Error {
+    private readonly statusCode;
+    private readonly code;
+    private readonly roleInfo?;
+    constructor(statusCode?: HttpStatus, message?: string, code?: string, roleInfo?: RoleInfo | undefined);
+    toJSON(): {
+        error: {
+            name: string;
+            code: string;
+            message: string;
+            statusCode: number;
+            roleInfo: RoleInfo | undefined;
+        };
+    };
+}
+export {};

package/auth/auth-errors.js

@@ -0,0 +1,31 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AuthError = void 0;
+const http_status_codes_1 = require("../api/http-status-codes");
+class AuthError extends Error {
+    statusCode;
+    code;
+    roleInfo;
+    constructor(statusCode = http_status_codes_1.HttpStatus.UNAUTHORIZED, message = "Authorization failed", code = "UNAUTHORIZED", roleInfo = undefined) {
+        super(message);
+        this.statusCode = statusCode;
+        this.code = code;
+        this.name = "AuthError";
+        this.roleInfo = roleInfo ?? undefined;
+        if (Error.captureStackTrace) {
+            Error.captureStackTrace(this, AuthError);
+        }
+    }
+    toJSON() {
+        return {
+            error: {
+                name: this.name,
+                code: this.code,
+                message: this.message,
+                statusCode: this.statusCode,
+                roleInfo: this.roleInfo,
+            },
+        };
+    }
+}
+exports.AuthError = AuthError;

package/auth/verify-jwt.d.ts

@@ -0,0 +1,14 @@
+import { type JWTPayload } from "jose";
+export declare class JwtAuthoriser {
+    private readonly clientId;
+    private static readonly ENV;
+    private static readonly tokenExpiryEnvExclusionList;
+    private static readonly JWKS_URI;
+    private static JWKS;
+    constructor(clientId?: string | null);
+    /**
+     * Validate a JWT and return the decoded payload
+     * @returns {Promise<JWTPayload>}
+     */
+    verify(token: string): Promise<JWTPayload>;
+}

package/auth/verify-jwt.js

@@ -0,0 +1,46 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.JwtAuthoriser = void 0;
+const jose_1 = require("jose");
+const http_status_codes_1 = require("../api/http-status-codes");
+const auth_errors_1 = require("./auth-errors");
+class JwtAuthoriser {
+    clientId;
+    static ENV = process.env.environment?.toUpperCase() ?? "";
+    static tokenExpiryEnvExclusionList = [
+        "DEVELOPMENT",
+        "NON-PROD",
+    ];
+    static JWKS_URI = new URL("https://login.microsoftonline.com/common/discovery/keys");
+    static JWKS = (0, jose_1.createRemoteJWKSet)(JwtAuthoriser.JWKS_URI);
+    constructor(clientId = null) {
+        this.clientId = clientId;
+    }
+    /**
+     * Validate a JWT and return the decoded payload
+     * @returns {Promise<JWTPayload>}
+     */
+    async verify(token) {
+        try {
+            const opts = {
+                clockTolerance: 10,
+                algorithms: ["RS256"],
+            };
+            // issuer validation is handled automatically if present in token
+            if (this.clientId) {
+                opts.audience = this.clientId;
+            }
+            if (JwtAuthoriser.tokenExpiryEnvExclusionList.includes(JwtAuthoriser.ENV)) {
+                opts.maxTokenAge = Number.POSITIVE_INFINITY;
+            }
+            const { payload } = await (0, jose_1.jwtVerify)(token, JwtAuthoriser.JWKS, opts);
+            return payload;
+        }
+        catch (err) {
+            const error = err;
+            const code = "code" in error ? error.code : "";
+            throw new auth_errors_1.AuthError(http_status_codes_1.HttpStatus.UNAUTHORIZED, err.message, code);
+        }
+    }
+}
+exports.JwtAuthoriser = JwtAuthoriser;

package/index.js

@@ -0,0 +1,20 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./api/http-status-codes"), exports);
+__exportStar(require("./auth/auth-checker"), exports);
+__exportStar(require("./auth/auth-errors"), exports);
+__exportStar(require("./auth/verify-jwt"), exports);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dvsa/appdev-api-common",
-  "version": "0.0.1",
+  "version": "0.1.1",
   "keywords": [
     "dvsa",
     "nodejs",
@@ -8,15 +8,25 @@
   ],
   "author": "DVSA",
   "description": "Utils library for common API functionality",
+  "publishConfig": {
+    "directory": "dist",
+    "access": "public"
+  },
   "scripts": {
+    "clean": "rimraf coverage dist",
+    "clean:temp": "rimraf auth api",
     "lint": "biome check src",
-    "lint:fix": "npm run lint -- --write"
+    "lint:fix": "npm run lint -- --write",
+    "build": "npm run clean && tsc",
+    "build:package": "npm run build",
+    "prepublishOnly": "npm run build:package && cp -r ./dist/* . && rm -rf ./dist",
+    "postpublish": "git clean -fd && npm run clean:temp"
   },
   "dependencies": {
     "jose": "^5.9.6"
   },
   "devDependencies": {
-    "@biomejs/biome": "1.8.3",
+    "@biomejs/biome": "1.9.3",
     "@dvsa/biome-config": "0.3.0",
     "@types/aws-lambda": "^8.10.145",
     "@types/express": "^5.0.0",

package/src/api/http-status-codes.ts

@@ -1,14 +0,0 @@
-export enum HttpStatus {
-	OK = 200,
-	CREATED = 201,
-	ACCEPTED = 202,
-	NO_CONTENT = 204,
-	NOT_MODIFIED = 304,
-	BAD_REQUEST = 400,
-	UNAUTHORIZED = 401,
-	FORBIDDEN = 403,
-	NOT_FOUND = 404,
-	INTERNAL_SERVER_ERROR = 500,
-	BAD_GATEWAY = 502,
-	GATEWAY_TIMEOUT = 504,
-}

package/src/auth/auth-checker.ts

@@ -1,78 +0,0 @@
-import type { Request } from "express";
-import type { Action } from "routing-controllers";
-import type { APIGatewayModel } from "../api/api-gateway-model";
-import { HttpStatus } from "../api/http-status-codes";
-import { AuthError } from "./auth-errors";
-import { JwtAuthoriser } from "./verify-jwt";
-
-export type RoutingControllersRequest = Request & {
-	apiGateway: APIGatewayModel;
-};
-
-// biome-ignore lint/complexity/noStaticOnlyClass: this class will be extended in the future
-export class JWTAuthChecker {
-	/**
-	 * Perform a JWT token verification and role check
-	 * @param {RoutingControllersRequest} request
-	 * @param roles
-	 */
-	static async execute(
-		{ request }: Action,
-		roles: string | string[] = [],
-	): Promise<boolean> {
-		// if running locally, skip the token auth and role check
-		if (process.env.IS_OFFLINE === "true") return true;
-
-		// extract the token from the request headers
-		const token = (request as RoutingControllersRequest)?.apiGateway.event
-			.headers?.Authorization;
-
-		// if no token is found, then deny access to resource
-		if (!token || token.trim()?.length === 0) {
-			throw new AuthError(
-				HttpStatus.UNAUTHORIZED,
-				"Missing Authorization header",
-			);
-		}
-
-		// create an instance of the JwtAuthoriser class
-		const authoriser = new JwtAuthoriser();
-
-		// Validate the token and extract the roles from it
-		const { roles: tokenRoles } = await authoriser.verify(token);
-
-		// check if a singular or list of roles were passed into the @Authorized decorator & remove nullish values
-		const requiredRoles = (Array.isArray(roles) ? roles : [roles]).filter(
-			(role) => !!role,
-		);
-
-		// if there are no requiredRoles, then any valid token can access the resource, so return true
-		if (requiredRoles.length === 0) return true;
-
-		// if there are no roles in JWT token but roles are required, then deny access
-		if (!tokenRoles || !Array.isArray(tokenRoles) || tokenRoles.length === 0) {
-			throw new AuthError(
-				HttpStatus.UNAUTHORIZED,
-				"No roles found in token",
-				"MISSING_ROLES",
-			);
-		}
-
-		// check if one of the required roles is present in JWT token
-		const success = requiredRoles.some((role) => tokenRoles.includes(role));
-
-		if (!success) {
-			throw new AuthError(
-				HttpStatus.UNAUTHORIZED,
-				"Insufficient permissions",
-				"UNAUTHORIZED",
-				{
-					required: requiredRoles,
-					actual: tokenRoles,
-				},
-			);
-		}
-
-		return true;
-	}
-}

package/src/auth/auth-errors.ts

@@ -1,38 +0,0 @@
-import { HttpStatus } from "../api/http-status-codes";
-
-type RoleInfo = { required: string[]; actual: string[] };
-
-export class AuthError extends Error {
-	private readonly statusCode: number;
-	private readonly code: string;
-	private readonly roleInfo?: RoleInfo;
-
-	constructor(
-		statusCode = HttpStatus.UNAUTHORIZED,
-		message = "Authorization failed",
-		code = "UNAUTHORIZED",
-		roleInfo: RoleInfo | undefined = undefined,
-	) {
-		super(message);
-		this.statusCode = statusCode;
-		this.code = code;
-		this.name = "AuthError";
-		this.roleInfo = roleInfo ?? undefined;
-
-		if (Error.captureStackTrace) {
-			Error.captureStackTrace(this, AuthError);
-		}
-	}
-
-	public toJSON() {
-		return {
-			error: {
-				name: this.name,
-				code: this.code,
-				message: this.message,
-				statusCode: this.statusCode,
-				roleInfo: this.roleInfo,
-			},
-		};
-	}
-}

package/src/auth/verify-jwt.ts

@@ -1,63 +0,0 @@
-import {
-	type JWTPayload,
-	type JWTVerifyOptions,
-	createRemoteJWKSet,
-	jwtVerify,
-} from "jose";
-import { HttpStatus } from "../api/http-status-codes";
-import { AuthError } from "./auth-errors";
-
-export class JwtAuthoriser {
-	private readonly clientId: string | null;
-	private static readonly ENV = process.env.environment?.toUpperCase() ?? "";
-	private static readonly tokenExpiryEnvExclusionList = [
-		"DEVELOPMENT",
-		"NON-PROD",
-	];
-	private static readonly JWKS_URI = new URL(
-		"https://login.microsoftonline.com/common/discovery/keys",
-	);
-	private static JWKS = createRemoteJWKSet(JwtAuthoriser.JWKS_URI);
-
-	public constructor(clientId: string | null = null) {
-		this.clientId = clientId;
-	}
-
-	/**
-	 * Validate a JWT and return the decoded payload
-	 * @returns {Promise<JWTPayload>}
-	 */
-	public async verify(token: string): Promise<JWTPayload> {
-		try {
-			const opts: JWTVerifyOptions = {
-				clockTolerance: 10,
-				algorithms: ["RS256"],
-			};
-
-			// issuer validation is handled automatically if present in token
-			if (this.clientId) {
-				opts.audience = this.clientId;
-			}
-
-			if (
-				JwtAuthoriser.tokenExpiryEnvExclusionList.includes(JwtAuthoriser.ENV)
-			) {
-				opts.maxTokenAge = Number.POSITIVE_INFINITY;
-			}
-
-			const { payload } = await jwtVerify(token, JwtAuthoriser.JWKS, opts);
-
-			return payload;
-		} catch (err) {
-			const error = err as { code?: string };
-
-			const code = "code" in error ? error.code : "";
-
-			throw new AuthError(
-				HttpStatus.UNAUTHORIZED,
-				(err as Error).message,
-				code,
-			);
-		}
-	}
-}

package/tsconfig.json

@@ -1,120 +0,0 @@
-{
-  "compilerOptions": {
-    /* Visit https://aka.ms/tsconfig to read more about this file */
-
-    /* Projects */
-    // "incremental": true,                              /* Save .tsbuildinfo files to allow for incremental compilation of projects. */
-    // "composite": true,                                /* Enable constraints that allow a TypeScript project to be used with project references. */
-    // "tsBuildInfoFile": "./.tsbuildinfo",              /* Specify the path to .tsbuildinfo incremental compilation file. */
-    // "disableSourceOfProjectReferenceRedirect": true,  /* Disable preferring source files instead of declaration files when referencing composite projects. */
-    // "disableSolutionSearching": true,                 /* Opt a project out of multi-project reference checking when editing. */
-    // "disableReferencedProjectLoad": true,             /* Reduce the number of projects loaded automatically by TypeScript. */
-
-    /* Language and Environment */
-    "target": "ES2022",
-    /* Set the JavaScript language version for emitted JavaScript and include compatible library declarations. */
-    "lib": ["ES2022"],
-    /* Specify a set of bundled library declaration files that describe the target runtime environment. */
-    // "jsx": "preserve",                                /* Specify what JSX code is generated. */
-    "experimentalDecorators": true,
-    /* Enable experimental support for legacy experimental decorators. */
-    "emitDecoratorMetadata": true,
-    /* Emit design-type metadata for decorated declarations in source files. */
-    // "jsxFactory": "",                                 /* Specify the JSX factory function used when targeting React JSX emit, e.g. 'React.createElement' or 'h'. */
-    // "jsxFragmentFactory": "",                         /* Specify the JSX Fragment reference used for fragments when targeting React JSX emit e.g. 'React.Fragment' or 'Fragment'. */
-    // "jsxImportSource": "",                            /* Specify module specifier used to import the JSX factory functions when using 'jsx: react-jsx*'. */
-    // "reactNamespace": "",                             /* Specify the object invoked for 'createElement'. This only applies when targeting 'react' JSX emit. */
-    // "noLib": true,                                    /* Disable including any library files, including the default lib.d.ts. */
-    // "useDefineForClassFields": true,                  /* Emit ECMAScript-standard-compliant class fields. */
-    // "moduleDetection": "auto",                        /* Control what method is used to detect module-format JS files. */
-
-    /* Modules */
-    "module": "CommonJS",
-    /* Specify what module code is generated. */
-    // "rootDir": "./",                                  /* Specify the root folder within your source files. */
-    // "moduleResolution": "Node",                     /* Specify how TypeScript looks up a file from a given module specifier. */
-    // "baseUrl": "./",                                  /* Specify the base directory to resolve non-relative module names. */
-    // "paths": {},                                      /* Specify a set of entries that re-map imports to additional lookup locations. */
-    // "rootDirs": [],                                   /* Allow multiple folders to be treated as one when resolving modules. */
-    // "typeRoots": [],                                  /* Specify multiple folders that act like './node_modules/@types'. */
-    "types": ["node", "jest"],
-    /* Specify type package names to be included without being referenced in a source file. */
-    // "allowUmdGlobalAccess": true,                     /* Allow accessing UMD globals from modules. */
-    // "moduleSuffixes": [],                             /* List of file name suffixes to search when resolving a module. */
-    // "allowImportingTsExtensions": true,               /* Allow imports to include TypeScript file extensions. Requires '--moduleResolution bundler' and either '--noEmit' or '--emitDeclarationOnly' to be set. */
-    // "resolvePackageJsonExports": true,                /* Use the package.json 'exports' field when resolving package imports. */
-    // "resolvePackageJsonImports": true,                /* Use the package.json 'imports' field when resolving imports. */
-    // "customConditions": [],                           /* Conditions to set in addition to the resolver-specific defaults when resolving imports. */
-    // "resolveJsonModule": true,                        /* Enable importing .json files. */
-    // "allowArbitraryExtensions": true,                 /* Enable importing files with any extension, provided a declaration file is present. */
-    // "noResolve": true,                                /* Disallow 'import's, 'require's or '<reference>'s from expanding the number of files TypeScript should add to a project. */
-
-    /* JavaScript Support */
-    // "allowJs": true,                                  /* Allow JavaScript files to be a part of your program. Use the 'checkJS' option to get errors from these files. */
-    // "checkJs": true,                                  /* Enable error reporting in type-checked JavaScript files. */
-    // "maxNodeModuleJsDepth": 1,                        /* Specify the maximum folder depth used for checking JavaScript files from 'node_modules'. Only applicable with 'allowJs'. */
-
-    /* Emit */
-    "declaration": true /* Generate .d.ts files from TypeScript and JavaScript files in your project. */,
-    // "declarationMap": true,                           /* Create sourcemaps for d.ts files. */
-    // "emitDeclarationOnly": true,                       /* Only output d.ts files and not JavaScript files. */
-    // "sourceMap": true,                                /* Create source map files for emitted JavaScript files. */
-    // "inlineSourceMap": true,                          /* Include sourcemap files inside the emitted JavaScript. */
-    // "outFile": "./",                                  /* Specify a file that bundles all outputs into one JavaScript file. If 'declaration' is true, also designates a file that bundles all .d.ts output. */
-    "outDir": "./dist" /* Specify an output folder for all emitted files. */,
-    // "removeComments": true,                           /* Disable emitting comments. */
-    // "noEmit": true,                                   /* Disable emitting files from a compilation. */
-    // "importHelpers": true,                            /* Allow importing helper functions from tslib once per project, instead of including them per-file. */
-    // "importsNotUsedAsValues": "remove",               /* Specify emit/checking behavior for imports that are only used for types. */
-    // "downlevelIteration": true,                       /* Emit more compliant, but verbose and less performant JavaScript for iteration. */
-    // "sourceRoot": "",                                 /* Specify the root path for debuggers to find the reference source code. */
-    // "mapRoot": "",                                    /* Specify the location where debugger should locate map files instead of generated locations. */
-    // "inlineSources": true,                            /* Include source code in the sourcemaps inside the emitted JavaScript. */
-    // "emitBOM": true,                                  /* Emit a UTF-8 Byte Order Mark (BOM) in the beginning of output files. */
-    // "newLine": "crlf",                                /* Set the newline character for emitting files. */
-    // "stripInternal": true,                            /* Disable emitting declarations that have '@internal' in their JSDoc comments. */
-    // "noEmitHelpers": true,                            /* Disable generating custom helper functions like '__extends' in compiled output. */
-    // "noEmitOnError": true,                            /* Disable emitting files if any type checking errors are reported. */
-    // "preserveConstEnums": true,                       /* Disable erasing 'const enum' declarations in generated code. */
-    // "declarationDir": "./",                           /* Specify the output directory for generated declaration files. */
-    // "preserveValueImports": true,                     /* Preserve unused imported values in the JavaScript output that would otherwise be removed. */
-
-    /* Interop Constraints */
-    // "isolatedModules": true,                          /* Ensure that each file can be safely transpiled without relying on other imports. */
-    // "verbatimModuleSyntax": true,                     /* Do not transform or elide any imports or exports not marked as type-only, ensuring they are written in the output file's format based on the 'module' setting. */
-    // "allowSyntheticDefaultImports": true,             /* Allow 'import x from y' when a module doesn't have a default export. */
-    "esModuleInterop": true /* Emit additional JavaScript to ease support for importing CommonJS modules. This enables 'allowSyntheticDefaultImports' for type compatibility. */,
-    // "preserveSymlinks": true,                         /* Disable resolving symlinks to their realpath. This correlates to the same flag in node. */
-    "forceConsistentCasingInFileNames": true,
-    /* Ensure that casing is correct in imports. */
-
-    /* Type Checking */
-    "strict": true,
-    /* Enable all strict type-checking options. */
-    // "noImplicitAny": true,                            /* Enable error reporting for expressions and declarations with an implied 'any' type. */
-    // "strictNullChecks": true,                         /* When type checking, take into account 'null' and 'undefined'. */
-    // "strictFunctionTypes": true,                      /* When assigning functions, check to ensure parameters and the return values are subtype-compatible. */
-    // "strictBindCallApply": true,                      /* Check that the arguments for 'bind', 'call', and 'apply' methods match the original function. */
-    // "strictPropertyInitialization": true,             /* Check for class properties that are declared but not set in the constructor. */
-    // "noImplicitThis": true,                           /* Enable error reporting when 'this' is given the type 'any'. */
-    // "useUnknownInCatchVariables": true,               /* Default catch clause variables as 'unknown' instead of 'any'. */
-    // "alwaysStrict": true,                             /* Ensure 'use strict' is always emitted. */
-    // "noUnusedLocals": true,                           /* Enable error reporting when local variables aren't read. */
-    // "noUnusedParameters": true,                       /* Raise an error when a function parameter isn't read. */
-    // "exactOptionalPropertyTypes": true,               /* Interpret optional property types as written, rather than adding 'undefined'. */
-    // "noImplicitReturns": true,                        /* Enable error reporting for codepaths that do not explicitly return in a function. */
-    // "noFallthroughCasesInSwitch": true,               /* Enable error reporting for fallthrough cases in switch statements. */
-    // "noUncheckedIndexedAccess": true,                 /* Add 'undefined' to a type when accessed using an index. */
-    // "noImplicitOverride": true,                       /* Ensure overriding members in derived classes are marked with an override modifier. */
-    // "noPropertyAccessFromIndexSignature": true,       /* Enforces using indexed accessors for keys declared using an indexed type. */
-    // "allowUnusedLabels": true,                        /* Disable error reporting for unused labels. */
-    // "allowUnreachableCode": true,                     /* Disable error reporting for unreachable code. */
-
-    /* Completeness */
-    // "skipDefaultLibCheck": true,                      /* Skip type checking .d.ts files that are included with TypeScript. */
-    "skipLibCheck": true
-    /* Skip type checking all .d.ts files. */
-  },
-  "include": ["src/**/*.ts"],
-  "exclude": ["node_modules", "src/**/*.spec.ts", "src/**/*.spec.d.ts"]
-}