feat(api): add commit API module with commitlint scope helper

Author: jrolfs

src/api/__tests__/__fixtures__/ls/configs/.foorc.json

@@ -0,0 +1,18 @@
+const {ls} = require('../commit')
+
+const fixtures = './src/api/__tests__/__fixtures__'
+
+describe('ls', () => {
+  test('configs', () => {
+    const result = ls.configs(`${fixtures}/ls/configs`)
+
+    const expected = [
+      'configs/.foorc',
+      'configs/foo',
+      'configs/foo.setup',
+      'configs/foo',
+    ]
+
+    expect(result.sort()).toEqual(expected.sort())
+  })
+})

src/api/__tests__/__fixtures__/ls/configs/foo.config.js

@@ -0,0 +1,31 @@
+const {readdirSync, statSync} = require('fs')
+const {join, sep} = require('path')
+
+/**
+ * Enumerate config files
+ *
+ * Example
+ *
+ * - `dir/foo.js`
+ * - `dir/bar.config.js`
+ * - `dir/baz.json`
+ * - `dir/qux.ts`
+ *
+ * `ls.config('./dir') → ['dir/foo', 'dir/bar', 'dir/baz', 'dir/qux']`
+ *
+ * @param {string} path - directory to enumerate
+ */
+const configs = path =>
+  readdirSync(path)
+    .filter(f => statSync(join(path, f)).isFile())
+    .map(
+      f =>
+        `${path.split(sep).reverse()[0]}/${f.replace(
+          /(\.config)?.(json|js|ts)/,
+          '',
+        )}`,
+    )
+
+const ls = {configs}
+
+module.exports = {ls}