feat: Improve TS Typings (#389)

Enabled strict TS compiler rules, avoid usage of `any`
Offer concrete typings throughout the library

NODE-2717

Author: nbbeeken

.eslintrc.json

@@ -21,10 +21,12 @@
     "ecmaVersion": 2017
   },
   "plugins": [
-    "prettier"
+    "prettier",
+    "eslint-plugin-tsdoc"
   ],
   "rules": {
     "prettier/prettier": "error",
+    "tsdoc/syntax": "warn",
     "no-console": "off",
     "eqeqeq": [
       "error",
@@ -33,11 +35,23 @@
         "null": "ignore"
       }
     ],
+    "@typescript-eslint/no-unused-vars": [
+      "error",
+      {
+        "argsIgnorePattern": "^_"
+      }
+    ],
     "strict": [
       "error",
       "global"
     ],
-    "@typescript-eslint/ban-types": "off",
-    "@typescript-eslint/no-var-requires": "off"
+    "@typescript-eslint/ban-types": [
+      "error",
+      {
+        "types": {
+          "Function": false
+        }
+      }
+    ]
   }
 }

api-extractor.json

@@ -26,7 +26,7 @@
         "logLevel": "warning"
       },
       "ae-internal-missing-underscore": {
-        "logLevel": "none",
+        "logLevel": "error",
         "addToApiReportFile": false
       },
       "ae-missing-release-tag": {
@@ -39,7 +39,7 @@
       },
       "ae-unresolved-link": {
         "addToApiReportFile": false,
-        "logLevel": "none"
+        "logLevel": "error"
       }
     },
     "tsdocMessageReporting": {

karma.conf.js

@@ -40,15 +40,19 @@ module.exports = function (config) {
       output: {
         format: 'iife',
         name: 'BSONtest',
-        sourcemap: true,
+        sourcemap: 'inline',
         exports: 'named'
+      },
+      onwarn(warning) {
+        if (warning.code === 'CIRCULAR_DEPENDENCY') return;
+        console.warn(warning.toString());
       }
     },
 
     // test results reporter to use
     // possible values: 'dots', 'progress'
     // available reporters: https://npmjs.org/browse/keyword/karma-reporter
-    reporters: ['progress'],
+    reporters: ['mocha'],
 
     // web server port
     port: 9876,
@@ -79,6 +83,9 @@ module.exports = function (config) {
 
     // Concurrency level
     // how many browser should be started simultaneous
-    concurrency: 1
+    concurrency: 1,
+
+    // Console log print outs will be prefaced with `LOG:` for grep
+    client: { captureConsole: true }
   });
 };