feat: Wrap retracers in a class

Author: mckomo

.gitignore

@@ -0,0 +1,15 @@
+.idea/
+.vscode/
+node_modules/
+dist
+build
+.DS_Store
+*.tgz
+my-app*
+template/src/__tests__/__snapshots__/
+lerna-debug.log
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*
+/.changelog
+yarn.lock

.node-version

@@ -0,0 +1 @@
+10.15.3

.prettierignore

@@ -0,0 +1 @@
+dist

.travis.yml

@@ -1,4 +1,4 @@
 language: node_js
 node_js:
-  - "8"
   - "10"
+  - "12"

README.md

@@ -5,9 +5,11 @@
 ### Usage
 
 ```js
-import {parseStack, retraceStack}
+import { StackRetracer } from "stack-retrace"
 
-const stack = parseStack(
+const stackRetracer = new StackRetracer()
+
+await stackRetracer.retrace(
   "StatusCodeError: No such placement\n" +
     "    at new StatusCodeError (http://localhost:8080/nfp.js:8961:28)\n" +
     "    at CollinsFetch.<anonymous> (http://localhost:8080/nfp.js:8867:35)\n" +
@@ -16,12 +18,18 @@ const stack = parseStack(
     "    at fulfilled (http://localhost:8080/vendors~nfp.js:83680:58)"
 )
 
+"new StatusCodeError (webpack:///state-actions/src/client/statusCodeError.ts:18:4)\n" +
+  "CollinsFetch.<anonymous> (webpack:///state-actions/src/client/collinsFetch.ts:63:12)\n" +
+  "step (webpack:///Users/mckomo/Projects/revenue-desk/node_modules/tslib/tslib.es6.js:97:0)\n" +
+  "Object.next (webpack:///Users/mckomo/Projects/revenue-desk/node_modules/tslib/tslib.es6.js:78:44)\n" +
+  "fulfilled (webpack:///Users/mckomo/Projects/revenue-desk/node_modules/tslib/tslib.es6.js:68:41)"
+```
 
-retraceStack(stack).join("\n") // Results in:
+### Options
 
-"new StatusCodeError (webpack:///state-actions/src/client/statusCodeError.ts:18:4)\n" +
-"CollinsFetch.<anonymous> (webpack:///state-actions/src/client/collinsFetch.ts:63:12)\n" +
-"step (webpack:///Users/mckomo/Projects/revenue-desk/node_modules/tslib/tslib.es6.js:97:0)\n" +
-"Object.next (webpack:///Users/mckomo/Projects/revenue-desk/node_modules/tslib/tslib.es6.js:78:44)\n" +
-"fulfilled (webpack:///Users/mckomo/Projects/revenue-desk/node_modules/tslib/tslib.es6.js:68:41)"
+```js
+const stackRetracer = new StackRetracer({
+  stackParser: (rawStack: string) => Stack,
+  sourceMapProvider: (fileUrl: string) => Promise<SourceMap>
+})
 ```

dist/ErrorMock.d.ts

@@ -1,13 +1,11 @@
 export interface StackFrame {
-    fileName: string;
-    lineNumber: number;
-    columnNumber: number;
-    functionName: string;
+    fileName: string | null;
+    lineNumber: number | null;
+    columnNumber: number | null;
+    functionName: string | null;
 }
 export declare class StackFrame {
-    constructor(params: Partial<StackFrame> & {
-        lineNumber: number;
-    });
+    constructor(params: StackFrame);
     toString(): string;
 }
 export declare type Stack = StackFrame[];