@jeniex/utils 1.2.0 → 1.3.0

package/node/index.cjs

@@ -1,7 +1,7 @@
 'use strict';
 
-var fs = require('node:fs');
 var fsp = require('node:fs/promises');
+var fs = require('node:fs');
 var path = require('node:path');
 
 function noop() { }
@@ -134,6 +134,64 @@ function capitalize(sentence) {
     return capitalizeWord(sentence);
 }
 
+async function exists(path) {
+    try {
+        await fsp.access(path);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+
+async function existsFile(path) {
+    try {
+        const stats = await fsp.stat(path);
+        return stats.isFile();
+    }
+    catch {
+        return false;
+    }
+}
+
+function existsFileSync(path) {
+    try {
+        return fs.statSync(path).isFile();
+    }
+    catch {
+        return false;
+    }
+}
+
+async function existsFolder(path) {
+    try {
+        const stats = await fsp.stat(path);
+        return stats.isDirectory();
+    }
+    catch {
+        return false;
+    }
+}
+
+function existsFolderSync(path) {
+    try {
+        return fs.statSync(path).isDirectory();
+    }
+    catch {
+        return false;
+    }
+}
+
+function existsSync(path) {
+    try {
+        fs.accessSync(path);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+
 /**
  * Lists the files that are present in the provided folder path.
  * @throws an error if the provided folder path does not exist.
@@ -317,6 +375,12 @@ function rq(url, options) {
 
 exports.asserted = asserted;
 exports.capitalize = capitalize;
+exports.exists = exists;
+exports.existsFile = existsFile;
+exports.existsFileSync = existsFileSync;
+exports.existsFolder = existsFolder;
+exports.existsFolderSync = existsFolderSync;
+exports.existsSync = existsSync;
 exports.isBoolean = isBoolean;
 exports.isFalsy = isFalsy;
 exports.isFunction = isFunction;

package/node/index.d.ts

@@ -56,6 +56,18 @@ type Prettify<T> = {
     [KeyType in keyof T]: T[KeyType];
 } & {};
 
+declare function exists(path: string): Promise<boolean>;
+
+declare function existsFile(path: string): Promise<boolean>;
+
+declare function existsFileSync(path: string): boolean;
+
+declare function existsFolder(path: string): Promise<boolean>;
+
+declare function existsFolderSync(path: string): boolean;
+
+declare function existsSync(path: string): boolean;
+
 interface ListBaseOpt {
     /** The absolute path of the target folder. */
     folderPath: string;
@@ -134,4 +146,4 @@ declare function rq(url: string, options?: RequestInit): RqRequest;
 
 declare function createRequest<TOptions>(transport: Transport<TOptions>, url: string, options?: TOptions): RqRequest;
 
-export { Fn, Nullable, Prettify, asserted, capitalize, isBoolean, isFalsy, isFunction, isNotNullish, isNullish, isNumber, isObject, isString, isTruthy, join, listFiles, listFolders, listFoldersSync, noop, padZeros, readJSON, remove, removeFiles, rq, createRequest as rqc, sleep, stringOrThrow, toString };
+export { Fn, Nullable, Prettify, asserted, capitalize, exists, existsFile, existsFileSync, existsFolder, existsFolderSync, existsSync, isBoolean, isFalsy, isFunction, isNotNullish, isNullish, isNumber, isObject, isString, isTruthy, join, listFiles, listFolders, listFoldersSync, noop, padZeros, readJSON, remove, removeFiles, rq, createRequest as rqc, sleep, stringOrThrow, toString };

package/node/index.js

@@ -1,5 +1,5 @@
-import fs from 'node:fs';
-import fsp from 'node:fs/promises';
+import fsp, { access, stat } from 'node:fs/promises';
+import fs, { statSync, accessSync } from 'node:fs';
 import path from 'node:path';
 
 function noop() { }
@@ -132,6 +132,64 @@ function capitalize(sentence) {
     return capitalizeWord(sentence);
 }
 
+async function exists(path) {
+    try {
+        await access(path);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+
+async function existsFile(path) {
+    try {
+        const stats = await stat(path);
+        return stats.isFile();
+    }
+    catch {
+        return false;
+    }
+}
+
+function existsFileSync(path) {
+    try {
+        return statSync(path).isFile();
+    }
+    catch {
+        return false;
+    }
+}
+
+async function existsFolder(path) {
+    try {
+        const stats = await stat(path);
+        return stats.isDirectory();
+    }
+    catch {
+        return false;
+    }
+}
+
+function existsFolderSync(path) {
+    try {
+        return statSync(path).isDirectory();
+    }
+    catch {
+        return false;
+    }
+}
+
+function existsSync(path) {
+    try {
+        accessSync(path);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+
 /**
  * Lists the files that are present in the provided folder path.
  * @throws an error if the provided folder path does not exist.
@@ -313,4 +371,4 @@ function rq(url, options) {
     return createRequest(fetchTransport, url, options);
 }
 
-export { asserted, capitalize, isBoolean, isFalsy, isFunction, isNotNullish, isNullish, isNumber, isObject, isString, isTruthy, join, listFiles, listFolders, listFoldersSync, noop, padZeros, readJSON, remove, removeFiles, rq, createRequest as rqc, sleep, stringOrThrow, toString };
+export { asserted, capitalize, exists, existsFile, existsFileSync, existsFolder, existsFolderSync, existsSync, isBoolean, isFalsy, isFunction, isNotNullish, isNullish, isNumber, isObject, isString, isTruthy, join, listFiles, listFolders, listFoldersSync, noop, padZeros, readJSON, remove, removeFiles, rq, createRequest as rqc, sleep, stringOrThrow, toString };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@jeniex/utils",
-  "version": "1.2.0",
+  "version": "1.3.0",
   "author": "JenieX",
   "homepage": "https://github.com/JenieX/utils",
   "type": "module",