@baadal-sdk/dapi 0.30.0 → 0.31.0

package/dist/types/fs/index.d.ts

@@ -2,16 +2,16 @@
  * Check whether a file exists
  * @param file file path
  * @param loud whether to throw errors [default: false]
- * @returns true if it exists, false otherwise
+ * @returns true if it exists, false if it doesn't, null in case of error
  */
-export declare const existsFileSync: (file: string, loud?: boolean) => boolean;
+export declare const existsFileSync: (file: string, loud?: boolean) => boolean | null;
 /**
  * Check whether a directory exists
  * @param dir directory path
  * @param loud whether to throw errors [default: false]
- * @returns true if it exists, false otherwise
+ * @returns true if it exists, false if it doesn't, null in case of error
  */
-export declare const existsDirSync: (dir: string, loud?: boolean) => boolean;
+export declare const existsDirSync: (dir: string, loud?: boolean) => boolean | null;
 /**
  * Read contents of a file
  * @param file file path
@@ -31,12 +31,12 @@ export declare const readFileSync: (file: string, warn?: boolean) => string | nu
  * @param dir directory path
  * @param warn whether to show warnings [default: false]
  * @param hiddenItems whether to include items starting with dot(.) [default: false]
- * @returns an object {dirs,files} containing list of directories & files
+ * @returns an object {dirs,files} containing list of directories & files, null in case or error
  */
 export declare const readDir: (dir: string, warn?: boolean, hiddenItems?: boolean) => Promise<{
-    dirs: string[] | null;
-    files: string[] | null;
-}>;
+    dirs: string[];
+    files: string[];
+} | null>;
 /**
  * Get the list of files in a directory
  * @param dir directory path
@@ -44,7 +44,7 @@ export declare const readDir: (dir: string, warn?: boolean, hiddenItems?: boolea
  * @param hiddenItems whether to include items starting with dot(.) [default: false]
  * @returns list of files, null in case of error or no items
  */
-export declare const readDirFiles: (dir: string, warn?: boolean, hiddenItems?: boolean) => Promise<string[] | null>;
+export declare const readDirFiles: (dir: string, warn?: boolean, hiddenItems?: boolean) => Promise<string[] | null | undefined>;
 /**
  * Get the list of directories in a directory
  * @param dir directory path
@@ -52,51 +52,51 @@ export declare const readDirFiles: (dir: string, warn?: boolean, hiddenItems?: b
  * @param hiddenItems whether to include items starting with dot(.) [default: false]
  * @returns list of directories, null in case of error or no items
  */
-export declare const readDirDirs: (dir: string, warn?: boolean, hiddenItems?: boolean) => Promise<string[] | null>;
+export declare const readDirDirs: (dir: string, warn?: boolean, hiddenItems?: boolean) => Promise<string[] | null | undefined>;
 /**
  * Get the (recursive) list of files in a directory
  * @param dir directory path
  * @param hiddenItems whether to include items starting with dot(.) [default: false]
- * @returns complete (recursive) list of files, null in case of error or no items
+ * @returns complete (recursive) list of files, null in case of error
  */
 export declare const readDirFilesRec: (dir: string, hiddenItems?: boolean) => Promise<string[] | null>;
 /**
  * Write contents to a file (creates the file path if it doesn't exist)
  * @param file file path
  * @param contents contents to write
- * @returns true if successful, false on error
+ * @returns true if successful, null in case of error
  */
-export declare const writeFile: (file: string, contents: string) => Promise<boolean>;
+export declare const writeFile: (file: string, contents: string) => Promise<true | null>;
 /**
  * Append contents to a file
  * @param file file path
  * @param contents contents to append
- * @returns true if successful, false on error
+ * @returns true if successful, null in case of error
  */
-export declare const appendToFile: (file: string, contents: string) => Promise<boolean>;
+export declare const appendToFile: (file: string, contents: string) => Promise<true | null>;
 /**
  * Rename a file
  * @param oldpath old file path
  * @param newpath new file path
- * @returns true if successful, false on error
+ * @returns true if successful, null in case of error
  */
-export declare const renameFile: (oldpath: string, newpath: string) => Promise<boolean>;
+export declare const renameFile: (oldpath: string, newpath: string) => Promise<true | null>;
 /**
  * Create a directory, if it doesn't exist
  * @param dir directory path
- * @returns true if successful, false in case of failure
+ * @returns true if successful, null in case of failure/error
  */
-export declare const createDir: (dir: string) => Promise<boolean>;
+export declare const createDir: (dir: string) => Promise<true | null>;
 /**
  * Delete a file
  * @param file file path
- * @returns true if successful, false on error
+ * @returns true if successful, null in case of error
  */
-export declare const deleteFile: (file: string) => Promise<boolean>;
+export declare const deleteFile: (file: string) => Promise<true | null>;
 /**
  * Delete a directory
  * @param dir directory path
- * @returns true if successful, false on error
+ * @returns true if successful, null in case of error
  */
-export declare const deleteDir: (dir: string) => Promise<boolean>;
+export declare const deleteDir: (dir: string) => Promise<true | null>;
 //# sourceMappingURL=index.d.ts.map

package/dist/types/fs/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/fs/index.ts"],"names":[],"mappings":"AAQA;;;;;GAKG;AACH,eAAO,MAAM,cAAc,SAAU,MAAM,4BAiB1C,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,aAAa,QAAS,MAAM,4BAiBxC,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,QAAQ,SAAgB,MAAM,2CAU1C,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,YAAY,SAAU,MAAM,kCAUxC,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,OAAO,QAAe,MAAM;UAiCL,MAAM,EAAE,GAAG,IAAI;WAAS,MAAM,EAAE,GAAG,IAAI;EAC1E,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,YAAY,QAAe,MAAM,oEAI7C,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,WAAW,QAAe,MAAM,oEAI5C,CAAC;AAuBF;;;;;GAKG;AACH,eAAO,MAAM,eAAe,QAAe,MAAM,oDAMhD,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,SAAS,SAAgB,MAAM,YAAY,MAAM,qBAY7D,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,YAAY,SAAgB,MAAM,YAAY,MAAM,qBAkBhE,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,UAAU,YAAmB,MAAM,WAAW,MAAM,qBAWhE,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,SAAS,QAAe,MAAM,qBAY1C,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,UAAU,SAAgB,MAAM,qBAU5C,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,SAAS,QAAe,MAAM,qBAe1C,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/fs/index.ts"],"names":[],"mappings":"AAQA;;;;;GAKG;AACH,eAAO,MAAM,cAAc,SAAU,MAAM,mCAiB1C,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,aAAa,QAAS,MAAM,mCAiBxC,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,QAAQ,SAAgB,MAAM,2CAU1C,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,YAAY,SAAU,MAAM,kCAUxC,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,OAAO,QAAe,MAAM;;;SA2BxC,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,YAAY,QAAe,MAAM,gFAI7C,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,WAAW,QAAe,MAAM,gFAI5C,CAAC;AA0BF;;;;;GAKG;AACH,eAAO,MAAM,eAAe,QAAe,MAAM,oDAMhD,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,SAAS,SAAgB,MAAM,YAAY,MAAM,yBAY7D,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,YAAY,SAAgB,MAAM,YAAY,MAAM,yBAkBhE,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,UAAU,YAAmB,MAAM,WAAW,MAAM,yBAWhE,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,SAAS,QAAe,MAAM,yBAY1C,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,UAAU,SAAgB,MAAM,yBAU5C,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,SAAS,QAAe,MAAM,yBAe1C,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@baadal-sdk/dapi",
-  "version": "0.30.0",
+  "version": "0.31.0",
   "description": "Dead-simple API wrappers",
   "main": "dist/cjs/index.js",
   "module": "dist/esm/index.js",
@@ -77,7 +77,7 @@
     "@aws-sdk/client-dynamodb": "^3.34.0",
     "@aws-sdk/client-s3": "^3.36.0",
     "@aws-sdk/lib-dynamodb": "^3.34.0",
-    "@baadal-sdk/utils": "0.11.1",
+    "@baadal-sdk/utils": "0.12.0",
     "@octokit/core": "^3.5.1",
     "chalk": "^2.4.2",
     "core-js": "^3.18.0",

package/src/aws/db.ts

@@ -176,7 +176,8 @@ export const writeItem = async (input: WriteItemInput) => {
 const batchWriteItems = async (table: string, items: StringIndexable[]) => {
   if (!dbClient.client) tryInit();
   if (!dbClient.client) return null;
-  if (!table || !items || !Array.isArray(items) || !items.length) return null;
+  if (!table || !items || !Array.isArray(items)) return null;
+  if (!items.length) return false;
 
   const reqList = items.map(item => ({ PutRequest: { Item: item } }));
   const cmdParams: BatchWriteCommandInput = {
@@ -224,7 +225,8 @@ export interface WriteItemsAllInput {
 export const writeItemsAll = async (input: WriteItemsAllInput) => {
   if (!dbClient.client) tryInit();
   if (!dbClient.client) return null;
-  if (!input.table || !input.items || !Array.isArray(input.items) || !input.items.length) return null;
+  if (!input.table || !input.items || !Array.isArray(input.items)) return null;
+  if (!input.items.length) return false;
 
   let errFlag = false;
 
@@ -368,9 +370,10 @@ const batchReadItems = async <T = any>(
 ) => {
   if (!dbClient.client) tryInit();
   if (!dbClient.client) return null;
-  if (!table || !keys || !Array.isArray(keys) || !keys.length) return null;
+  if (!table || !keys || !Array.isArray(keys)) return null;
+  if (!keys.length) return [];
 
-  let contents: StringIndexable<T>[] | null = null;
+  let contents: StringIndexable<T>[] = [];
 
   let reqParams: any = { Keys: keys };
   if (projection) reqParams = { ...reqParams, ProjectionExpression: projection };
@@ -432,9 +435,10 @@ export interface ReadItemsAllInput {
 export const readItemsAll = async <T = any>(input: ReadItemsAllInput) => {
   if (!dbClient.client) tryInit();
   if (!dbClient.client) return null;
-  if (!input.table || !input.keys || !Array.isArray(input.keys) || !input.keys.length) return null;
+  if (!input.table || !input.keys || !Array.isArray(input.keys)) return null;
+  if (!input.keys.length) return [];
 
-  let contents: StringIndexable<T>[] | null = null;
+  let contents: StringIndexable<T>[] = [];
   let errFlag = false;
 
   const batchedKeys = chunkifyArray(input.keys, BATCH_SIZE);
@@ -450,13 +454,10 @@ export const readItemsAll = async <T = any>(input: ReadItemsAllInput) => {
     const isError = icontents.find(e => e === null) === null;
     if (isError) {
       errFlag = true;
-      contents = null;
-    } else if (!errFlag) {
-      if (contents) {
-        contents = contents.concat(icontents as StringIndexable[]);
-      } else {
-        contents = icontents as StringIndexable[];
-      }
+      return null;
+    }
+    if (!errFlag) {
+      contents = contents.concat(icontents as StringIndexable[]);
     }
   }
 
@@ -504,7 +505,7 @@ export const queryItems = async (input: QueryItemsInput) => {
   if (!dbClient.client) return null;
   if (!input.table || !input.cond || !input.attr) return null;
 
-  let contents: StringIndexable[] | null = null;
+  let contents: StringIndexable[] = [];
   const desc = input.desc || false;
 
   // Ref: https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/Query.html
@@ -570,7 +571,7 @@ export const scanItems = async (input: ScanItemsInput) => {
   if (!dbClient.client) return null;
   if (!input.table) return null;
 
-  let contents: StringIndexable[] | null = null;
+  let contents: StringIndexable[] = [];
 
   // Ref: https://docs.aws.amazon.com/sdk-for-javascript/v3/developer-guide/dynamodb-example-query-scan.html
   let cmdParams: ScanCommandInput = {
@@ -650,7 +651,8 @@ export const deleteItem = async (input: DeleteItemInput) => {
 const batchDeleteItems = async (table: string, keys: StringIndexable[]) => {
   if (!dbClient.client) tryInit();
   if (!dbClient.client) return null;
-  if (!table || !keys || !Array.isArray(keys) || !keys.length) return null;
+  if (!table || !keys || !Array.isArray(keys)) return null;
+  if (!keys.length) return false;
 
   const reqList = keys.map(key => ({ DeleteRequest: { Key: key } }));
   const cmdParams: BatchWriteCommandInput = {
@@ -698,7 +700,8 @@ export interface DeleteItemsAllInput {
 export const deleteItemsAll = async (input: DeleteItemsAllInput) => {
   if (!dbClient.client) tryInit();
   if (!dbClient.client) return null;
-  if (!input.table || !input.keys || !Array.isArray(input.keys) || !input.keys.length) return null;
+  if (!input.table || !input.keys || !Array.isArray(input.keys)) return null;
+  if (!input.keys.length) return false;
 
   let errFlag = false;
 

package/src/aws/s3.ts

@@ -175,7 +175,8 @@ export const uploadFile = async (bucket: string, file: string, s3path?: string)
 export const uploadFilesAll = async (bucket: string, files: string[], s3paths?: string[]) => {
   if (!s3Client.client) tryInit();
   if (!s3Client.client) return null;
-  if (!bucket || !files || !Array.isArray(files) || !files.length) return null;
+  if (!bucket || !files || !Array.isArray(files)) return null;
+  if (!files.length) return false;
   if (s3paths && (!Array.isArray(s3paths) || !s3paths.length || files.length !== s3paths.length)) return null;
 
   let errFlag = false;
@@ -292,7 +293,7 @@ export const listObjects = async (bucket: string, prefix?: string) => {
   if (!s3Client.client) return null;
   if (!bucket) return null;
 
-  let filesList: string[] | null = null;
+  let filesList: string[] = [];
 
   let cmdParams: ListObjectsV2CommandInput = { Bucket: bucket };
   if (prefix) cmdParams = { ...cmdParams, Prefix: prefix };
@@ -363,9 +364,10 @@ export const getObjectHead = async (bucket: string, s3path: string) => {
 export const getObjectHeadsAll = async (bucket: string, s3paths: string[]) => {
   if (!s3Client.client) tryInit();
   if (!s3Client.client) return null;
-  if (!bucket || !s3paths || !Array.isArray(s3paths) || !s3paths.length) return null;
+  if (!bucket || !s3paths || !Array.isArray(s3paths)) return null;
+  if (!s3paths.length) return [];
 
-  let contents: (HeadObject | null)[] | null = null;
+  let contents: (HeadObject | null)[] = [];
 
   const chunkedItems = chunkifyArray(s3paths, CHUNK_SIZE);
 
@@ -374,14 +376,10 @@ export const getObjectHeadsAll = async (bucket: string, s3paths: string[]) => {
     const pList = chunk.map(item => getObjectHead(bucket, item));
     const rList = await Promise.all(pList); // eslint-disable-line no-await-in-loop
 
-    if (contents) {
-      contents = contents.concat(rList);
-    } else {
-      contents = rList;
-    }
+    contents = contents.concat(rList);
   }
 
-  if (contents?.length) {
+  if (contents.length) {
     contents = contents.filter(e => !!e);
   }
 
@@ -417,7 +415,8 @@ export const deleteObject = async (bucket: string, s3path: string) => {
 const batchDeleteObjects = async (bucket: string, s3paths: string[]) => {
   if (!s3Client.client) tryInit();
   if (!s3Client.client) return null;
-  if (!bucket || !s3paths || !Array.isArray(s3paths) || !s3paths.length) return null;
+  if (!bucket || !s3paths || !Array.isArray(s3paths)) return null;
+  if (!s3paths.length) return false;
 
   const keys = s3paths.map(key => ({ Key: key }));
   const cmdParams: DeleteObjectsCommandInput = { Bucket: bucket, Delete: { Objects: keys } };
@@ -444,7 +443,8 @@ const batchDeleteObjects = async (bucket: string, s3paths: string[]) => {
 export const deleteObjectsAll = async (bucket: string, s3paths: string[]) => {
   if (!s3Client.client) tryInit();
   if (!s3Client.client) return null;
-  if (!bucket || !s3paths || !Array.isArray(s3paths) || !s3paths.length) return null;
+  if (!bucket || !s3paths || !Array.isArray(s3paths)) return null;
+  if (!s3paths.length) return false;
 
   let errFlag = false;
 

package/src/fs/index.ts

@@ -10,10 +10,10 @@ import { warn as cwarn } from '../common/logger';
  * Check whether a file exists
  * @param file file path
  * @param loud whether to throw errors [default: false]
- * @returns true if it exists, false otherwise
+ * @returns true if it exists, false if it doesn't, null in case of error
  */
 export const existsFileSync = (file: string, loud = false) => {
-  if (!file) return false;
+  if (!file) return null;
   file = assertPath(file);
   try {
     if (!fs.existsSync(file)) {
@@ -21,7 +21,7 @@ export const existsFileSync = (file: string, loud = false) => {
       throw new CustomError(`File does not exist: ${file}`);
     }
   } catch (e) {
-    if (!loud) return false;
+    if (!loud) return null;
     if (e instanceof CustomError) {
       throw e;
     } else {
@@ -35,10 +35,10 @@ export const existsFileSync = (file: string, loud = false) => {
  * Check whether a directory exists
  * @param dir directory path
  * @param loud whether to throw errors [default: false]
- * @returns true if it exists, false otherwise
+ * @returns true if it exists, false if it doesn't, null in case of error
  */
 export const existsDirSync = (dir: string, loud = false) => {
-  if (!dir) return false;
+  if (!dir) return null;
   dir = assertPath(dir);
   try {
     if (!fs.existsSync(dir)) {
@@ -46,7 +46,7 @@ export const existsDirSync = (dir: string, loud = false) => {
       throw new CustomError(`Directory does not exist: ${dir}`);
     }
   } catch (e) {
-    if (!loud) return false;
+    if (!loud) return null;
     if (e instanceof CustomError) {
       throw e;
     } else {
@@ -97,42 +97,35 @@ export const readFileSync = (file: string, warn = false) => {
  * @param dir directory path
  * @param warn whether to show warnings [default: false]
  * @param hiddenItems whether to include items starting with dot(.) [default: false]
- * @returns an object {dirs,files} containing list of directories & files
+ * @returns an object {dirs,files} containing list of directories & files, null in case or error
  */
 export const readDir = async (dir: string, warn = false, hiddenItems = false) => {
-  if (!dir) return { dirs: null, files: null };
+  if (!dir) return null;
   dir = assertPath(dir);
 
-  let dirs: string[] | null = null;
-  let files: string[] | null = null;
+  let dirs: string[] = [];
+  let files: string[] = [];
 
   try {
     const items = await fsa.readdir(dir, { withFileTypes: true });
     items.forEach(item => {
       if (item.isDirectory()) {
-        if (!dirs) {
-          dirs = [item.name];
-        } else {
-          dirs.push(item.name);
-        }
+        dirs.push(item.name);
       } else if (item.isFile()) {
-        if (!files) {
-          files = [item.name];
-        } else {
-          files.push(item.name);
-        }
+        files.push(item.name);
       }
     });
   } catch (e) {
     if (warn) cwarn(`Cannot read dir: ${dir}`);
+    return null;
   }
 
   if (!hiddenItems) {
-    if (dirs) dirs = (dirs as string[]).filter(d => !d.startsWith('.'));
-    if (files) files = (files as string[]).filter(f => !f.startsWith('.'));
+    dirs = (dirs as string[]).filter(d => !d.startsWith('.'));
+    files = (files as string[]).filter(f => !f.startsWith('.'));
   }
 
-  return { dirs, files } as { dirs: string[] | null; files: string[] | null };
+  return { dirs, files };
 };
 
 /**
@@ -145,7 +138,7 @@ export const readDir = async (dir: string, warn = false, hiddenItems = false) =>
 export const readDirFiles = async (dir: string, warn = false, hiddenItems = false) => {
   if (!dir) return null;
   dir = assertPath(dir);
-  return (await readDir(dir, warn, hiddenItems)).files;
+  return (await readDir(dir, warn, hiddenItems))?.files;
 };
 
 /**
@@ -158,7 +151,7 @@ export const readDirFiles = async (dir: string, warn = false, hiddenItems = fals
 export const readDirDirs = async (dir: string, warn = false, hiddenItems = false) => {
   if (!dir) return null;
   dir = assertPath(dir);
-  return (await readDir(dir, warn, hiddenItems)).dirs;
+  return (await readDir(dir, warn, hiddenItems))?.dirs;
 };
 
 const readDirFilesRecHelper = async (dir: string, basePath = ''): Promise<string[] | null> => {
@@ -166,7 +159,10 @@ const readDirFilesRecHelper = async (dir: string, basePath = ''): Promise<string
   dir = assertPath(dir);
 
   const dirPath = basePath ? `${dir}/${basePath}` : dir;
-  const { dirs, files } = await readDir(dirPath);
+  const readDirObj = await readDir(dirPath);
+  if (!readDirObj) return null;
+
+  const { dirs, files } = readDirObj;
   let allFiles: string[] = files || [];
   allFiles = allFiles.map(file => (basePath ? `${basePath}/${file}` : file));
   const absDirs = (dirs || []).map(d => (basePath ? `${basePath}/${d}` : d));
@@ -179,14 +175,14 @@ const readDirFilesRecHelper = async (dir: string, basePath = ''): Promise<string
     }
   });
 
-  return allFiles.length ? allFiles : null;
+  return allFiles;
 };
 
 /**
  * Get the (recursive) list of files in a directory
  * @param dir directory path
  * @param hiddenItems whether to include items starting with dot(.) [default: false]
- * @returns complete (recursive) list of files, null in case of error or no items
+ * @returns complete (recursive) list of files, null in case of error
  */
 export const readDirFilesRec = async (dir: string, hiddenItems = false) => {
   let allFiles = await readDirFilesRecHelper(dir);
@@ -200,10 +196,10 @@ export const readDirFilesRec = async (dir: string, hiddenItems = false) => {
  * Write contents to a file (creates the file path if it doesn't exist)
  * @param file file path
  * @param contents contents to write
- * @returns true if successful, false on error
+ * @returns true if successful, null in case of error
  */
 export const writeFile = async (file: string, contents: string) => {
-  if (!file || !contents) return false;
+  if (!file || !contents) return null;
   file = assertPath(file);
   try {
     const dir = file.substring(0, file.lastIndexOf('/'));
@@ -211,7 +207,7 @@ export const writeFile = async (file: string, contents: string) => {
     await fsa.writeFile(file, contents);
   } catch (e) {
     console.error(`Error while writing to ${file}`, e);
-    return false;
+    return null;
   }
   return true;
 };
@@ -220,10 +216,10 @@ export const writeFile = async (file: string, contents: string) => {
  * Append contents to a file
  * @param file file path
  * @param contents contents to append
- * @returns true if successful, false on error
+ * @returns true if successful, null in case of error
  */
 export const appendToFile = async (file: string, contents: string) => {
-  if (!file || !contents) return false;
+  if (!file || !contents) return null;
   file = assertPath(file);
   try {
     const dir = file.substring(0, file.lastIndexOf('/'));
@@ -237,7 +233,7 @@ export const appendToFile = async (file: string, contents: string) => {
     // stream.end();
   } catch (e) {
     console.error(`Error while appending to ${file}`, e);
-    return false;
+    return null;
   }
   return true;
 };
@@ -246,17 +242,17 @@ export const appendToFile = async (file: string, contents: string) => {
  * Rename a file
  * @param oldpath old file path
  * @param newpath new file path
- * @returns true if successful, false on error
+ * @returns true if successful, null in case of error
  */
 export const renameFile = async (oldpath: string, newpath: string) => {
-  if (!oldpath || !newpath) return false;
+  if (!oldpath || !newpath) return null;
   oldpath = assertPath(oldpath);
   newpath = assertPath(newpath);
   try {
     await fsa.rename(oldpath, newpath);
   } catch (e) {
     console.error(`Error while renaming file ${oldpath} to ${newpath}`, e);
-    return false;
+    return null;
   }
   return true;
 };
@@ -264,10 +260,10 @@ export const renameFile = async (oldpath: string, newpath: string) => {
 /**
  * Create a directory, if it doesn't exist
  * @param dir directory path
- * @returns true if successful, false in case of failure
+ * @returns true if successful, null in case of failure/error
  */
 export const createDir = async (dir: string) => {
-  if (!dir) return false;
+  if (!dir) return null;
   dir = assertPath(dir);
   try {
     if (!existsDirSync(dir)) {
@@ -275,7 +271,7 @@ export const createDir = async (dir: string) => {
     }
   } catch (e) {
     console.error(`Error while creating directory: ${dir}`, e);
-    return false;
+    return null;
   }
   return true;
 };
@@ -283,16 +279,16 @@ export const createDir = async (dir: string) => {
 /**
  * Delete a file
  * @param file file path
- * @returns true if successful, false on error
+ * @returns true if successful, null in case of error
  */
 export const deleteFile = async (file: string) => {
-  if (!file) return false;
+  if (!file) return null;
   file = assertPath(file);
   try {
     await fsa.unlink(file);
   } catch (e) {
     console.error(`Error while deleting file ${file}`, e);
-    return false;
+    return null;
   }
   return true;
 };
@@ -300,10 +296,10 @@ export const deleteFile = async (file: string) => {
 /**
  * Delete a directory
  * @param dir directory path
- * @returns true if successful, false on error
+ * @returns true if successful, null in case of error
  */
 export const deleteDir = async (dir: string) => {
-  if (!dir) return false;
+  if (!dir) return null;
   dir = assertPath(dir);
   try {
     const rimraf = require('rimraf');
@@ -314,7 +310,7 @@ export const deleteDir = async (dir: string) => {
     // await fsa.rm(dir, { recursive: true, force: true });
   } catch (e) {
     console.error(`Error while deleting dir ${dir}`, e);
-    return false;
+    return null;
   }
   return true;
 };