refactor: port parse to typescript

@commitlint/parse/src/index.test.ts

@@ -2,11 +2,7 @@ import importFrom from 'import-from';
 import parse from '.';
 
 test('throws when called without params', () => {
-	expect(parse()).rejects.toThrowError('Expected a raw commit');
-});
-
-test('throws when called with empty message', () => {
-	expect(parse()).rejects.toThrowError('Expected a raw commit');
+	expect(parse('')).rejects.toThrowError('Expected a raw commit');
 });
 
 test('returns object with raw message', async () => {
@@ -20,15 +16,18 @@ test('calls parser with message and passed options', async () => {
 	const message = 'message';
 
 	expect.assertions(1);
-	await parse(message, (m: string) => {
-		expect(m).toBe(message);
-		return {};
-	});
+	await parse(
+		message,
+		(m: string): any => {
+			expect(m).toBe(message);
+			return {};
+		}
+	);
 });
 
 test('passes object up from parser function', async () => {
 	const message = 'message';
-	const result = {};
+	const result: any = {};
 	const actual = await parse(message, () => result);
 
 	expect(actual).toBe(result);

@commitlint/parse/src/index.ts

@@ -1,5 +1,5 @@
 import {isArray, mergeWith} from 'lodash';
-import {Commit, ParserOptions} from './types';
+import {Commit, Parser, ParserOptions} from './types';
 
 const {sync} = require('conventional-commits-parser');
 const defaultChangelogOpts = require('conventional-changelog-angular');
@@ -8,17 +8,15 @@ export default parse;
 export * from './types';
 
 async function parse(
-	message?: string,
-	parser: any = sync,
+	message: string,
+	parser: Parser = sync,
 	parserOpts?: ParserOptions
 ): Promise<Commit> {
 	const defaultOpts = (await defaultChangelogOpts).parserOpts;
-	const parsed = parser(
-		message,
-		mergeWith({}, defaultOpts, parserOpts, (objValue, srcValue) => {
-			if (isArray(objValue)) return srcValue;
-		})
-	);
+	const opts = mergeWith({}, defaultOpts, parserOpts, (objValue, srcValue) => {
+		if (isArray(objValue)) return srcValue;
+	});
+	const parsed = parser(message, opts) as Commit;
 	parsed.raw = message;
 	return parsed;
 }

@commitlint/parse/src/types.ts

@@ -27,6 +27,11 @@ export interface CommitReference {
 	issue: string | null;
 }
 
+export type Parser = (
+	message: string,
+	options: ParserOptions
+) => Omit<Commit, 'raw'>;
+
 export interface ParserOptions {
 	commentChar?: string;
 	headerCorrespondence?: string[];