feat(utils): saveFile

__mocks__/fs/promises.ts

@@ -0,0 +1,16 @@
+import type fs from 'fs/promises'
+
+/**
+ * @file Node Module Mock - fs/promises
+ * @module tests/mocks/fs/promises
+ * @see https://jestjs.io/docs/manual-mocks#mocking-node-modules
+ * @see https://jestjs.io/docs/manual-mocks#examples
+ * @see https://github.com/nodejs/node/blob/v16.0.0/doc/api/fs.md
+ */
+
+export default {
+  chmod: jest.fn(),
+  stat: jest.fn(),
+  unlink: jest.fn(),
+  writeFile: jest.fn()
+} as jest.Mocked<Partial<typeof fs>>

__mocks__/mkdirp.ts

@@ -0,0 +1,8 @@
+/**
+ * @file Node Module Mock - mkdirp
+ * @module tests/mocks/mkdirp
+ * @see https://jestjs.io/docs/manual-mocks#mocking-node-modules
+ * @see https://github.com/isaacs/node-mkdirp
+ */
+
+export default jest.fn()

src/utils/__tests__/save-file.util.functional.spec.ts

@@ -0,0 +1,33 @@
+import fs from 'fs/promises'
+import mkdirp from 'mkdirp'
+import path from 'path'
+import testSubject from '../save-file.util'
+
+/**
+ * @file Functional Tests - saveFile
+ * @module trext/utils/tests/functional/saveFile
+ */
+
+jest.mock('fs/promises')
+
+const mockFs = fs as jest.Mocked<typeof fs>
+const mockMkdirp = mkdirp as jest.MockedFunction<typeof mkdirp>
+
+describe('functional:utils/saveFile', () => {
+  const FILENAME: string = 'dist/hello-world.mjs'
+  const DATA: Buffer = Buffer.from("console.log('Hello, World!')")
+
+  beforeEach(async () => {
+    await testSubject(FILENAME, DATA)
+  })
+
+  it('should handle directory creation', () => {
+    expect(mockMkdirp).toBeCalledTimes(1)
+    expect(mockMkdirp).toBeCalledWith(path.dirname(FILENAME))
+  })
+
+  it('should create new file', () => {
+    expect(mockFs.writeFile).toBeCalledTimes(1)
+    expect(mockFs.writeFile).toBeCalledWith(FILENAME, DATA)
+  })
+})

src/utils/index.ts

@@ -4,3 +4,4 @@
  */
 
 export { default as ignore404 } from './ignore-404.util'
+export { default as saveFile } from './save-file.util'

src/utils/save-file.util.ts

@@ -0,0 +1,26 @@
+import fs from 'fs/promises'
+import mkdirp from 'mkdirp'
+import path from 'path'
+
+/**
+ * @file Utilities - saveFile
+ * @module trext/utils/saveFile
+ */
+
+/**
+ * Saves a file. Creates a new directory if necessary.
+ *
+ * @async
+ * @param {string} filename - Name of file to save
+ * @param {string | Buffer} data - File content
+ * @return {Promise<void>} Empty promise when complete
+ */
+const saveFile = async (
+  filename: string,
+  data: string | Buffer
+): Promise<void> => {
+  await mkdirp(path.dirname(filename))
+  return await fs.writeFile(filename, data)
+}
+
+export default saveFile