@naturalcycles/nodejs-lib 12.91.1 → 12.92.0

package/dist/fs/fs.util.d.ts

@@ -25,6 +25,7 @@ export declare function _pathExists(filePath: string): Promise<boolean>;
 export declare function _pathExistsSync(filePath: string): boolean;
 export declare function _ensureDir(dirPath: string): Promise<void>;
 export declare function _ensureDirSync(dirPath: string): void;
+export declare function _ensureFile(filePath: string): Promise<void>;
 export declare function _ensureFileSync(filePath: string): void;
 export declare function _removePath(fileOrDirPath: string): Promise<void>;
 export declare function _removePathSync(fileOrDirPath: string): void;

package/dist/fs/fs.util.js

@@ -15,7 +15,7 @@ Credit to: fs-extra (https://github.com/jprichardson/node-fs-extra)
 
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports._movePathSync = exports._movePath = exports._copyPathSync = exports._copyPath = exports._emptyDirSync = exports._emptyDir = exports._removePathSync = exports._removePath = exports._ensureFileSync = exports._ensureDirSync = exports._ensureDir = exports._pathExistsSync = exports._pathExists = exports._outputJsonFileSync = exports._outputJsonFile = exports._writeJsonFileSync = exports._writeJsonFile = exports._outputFileSync = exports._outputFile = exports._writeFileSync = exports._writeFile = exports._readJsonFileSync = exports._readJsonFile = exports._readFileSync = exports._readFile = void 0;
+exports._movePathSync = exports._movePath = exports._copyPathSync = exports._copyPath = exports._emptyDirSync = exports._emptyDir = exports._removePathSync = exports._removePath = exports._ensureFileSync = exports._ensureFile = exports._ensureDirSync = exports._ensureDir = exports._pathExistsSync = exports._pathExists = exports._outputJsonFileSync = exports._outputJsonFile = exports._writeJsonFileSync = exports._writeJsonFile = exports._outputFileSync = exports._outputFile = exports._writeFileSync = exports._writeFile = exports._readJsonFileSync = exports._readJsonFile = exports._readFileSync = exports._readFile = void 0;
 const fs = require("node:fs");
 const fsp = require("node:fs/promises");
 const path = require("node:path");
@@ -117,7 +117,31 @@ function _ensureDirSync(dirPath) {
     });
 }
 exports._ensureDirSync = _ensureDirSync;
-// Skipping `_ensureFile` (async), until it's needed
+async function _ensureFile(filePath) {
+    let stats;
+    try {
+        stats = await fsp.stat(filePath);
+    }
+    catch { }
+    if (stats?.isFile())
+        return;
+    const dir = path.dirname(filePath);
+    try {
+        if (!(await fsp.stat(dir)).isDirectory()) {
+            // parent is not a directory
+            // This is just to cause an internal ENOTDIR error to be thrown
+            await fsp.readdir(dir);
+        }
+    }
+    catch (err) {
+        // If the stat call above failed because the directory doesn't exist, create it
+        if (err?.code === 'ENOENT')
+            return await _ensureDir(dir);
+        throw err;
+    }
+    await fsp.writeFile(filePath, '');
+}
+exports._ensureFile = _ensureFile;
 function _ensureFileSync(filePath) {
     let stats;
     try {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@naturalcycles/nodejs-lib",
-  "version": "12.91.1",
+  "version": "12.92.0",
   "scripts": {
     "prepare": "husky install",
     "docs-serve": "vuepress dev docs",

package/src/fs/fs.util.ts

@@ -130,7 +130,28 @@ export function _ensureDirSync(dirPath: string): void {
   })
 }
 
-// Skipping `_ensureFile` (async), until it's needed
+export async function _ensureFile(filePath: string): Promise<void> {
+  let stats
+  try {
+    stats = await fsp.stat(filePath)
+  } catch {}
+  if (stats?.isFile()) return
+
+  const dir = path.dirname(filePath)
+  try {
+    if (!(await fsp.stat(dir)).isDirectory()) {
+      // parent is not a directory
+      // This is just to cause an internal ENOTDIR error to be thrown
+      await fsp.readdir(dir)
+    }
+  } catch (err) {
+    // If the stat call above failed because the directory doesn't exist, create it
+    if ((err as any)?.code === 'ENOENT') return await _ensureDir(dir)
+    throw err
+  }
+
+  await fsp.writeFile(filePath, '')
+}
 
 export function _ensureFileSync(filePath: string): void {
   let stats