load-parser-opts.ts

import {ParserPreset} from '@commitlint/types';

function isObjectLike(obj: unknown): obj is Record<string, unknown> {
	return Boolean(obj) && typeof obj === 'object'; // typeof null === 'object'
}

function isParserOptsFunction<T extends ParserPreset>(
	obj: T
): obj is T & {
	parserOpts: (...args: any[]) => any;
} {
	return typeof obj.parserOpts === 'function';
}

export async function loadParserOpts(
	pendingParser: string | ParserPreset | Promise<ParserPreset> | undefined
): Promise<ParserPreset | undefined> {
	if (!pendingParser || typeof pendingParser !== 'object') {
		return undefined;
	}
	// Await for the module, loaded with require
	const parser = await pendingParser;

	// exit early, no opts to resolve
	if (!parser.parserOpts) {
		return parser;
	}

	// Pull nested parserOpts, might happen if overwritten with a module in main config
	if (typeof parser.parserOpts === 'object') {
		// Await parser opts if applicable
		const opts = await parser.parserOpts;
		parser.parserOpts = isObjectLike(opts) ? opts.parserOpts : undefined;
		return parser;
	}

	// Create parser opts from factory
	if (
		isParserOptsFunction(parser) &&
		typeof parser.name === 'string' &&
		parser.name.startsWith('conventional-changelog-')
	) {
		return new Promise((resolve) => {
			const result = parser.parserOpts((_: never, opts: any) => {
				resolve({
					...parser,
					parserOpts: opts?.parserOpts,
				});
			});

			// If result has data or a promise, the parser doesn't support factory-init
			// due to https://github.com/nodejs/promises-debugging/issues/16 it just quits, so let's use this fallback
			if (result) {
				Promise.resolve(result).then((opts) => {
					resolve({
						...parser,
						parserOpts: opts?.parserOpts,
					});
				});
			}
			return;
		});
	}

	return parser;
}