chore: added warning for untracked directory

[ci skip]

Author: aryanjassal

src/secrets/CommandMkdir.ts

@@ -54,7 +54,7 @@ class CommandMkdir extends CommandPolykey {
           },
           logger: this.logger.getChild(PolykeyClient.name),
         });
-        await binUtils.retryAuthentication(async (auth) => {
+        const response = await binUtils.retryAuthentication(async (auth) => {
           const response =
             await pkClient.rpcClient.methods.vaultsSecretsMkdir();
           const writer = response.writable.getWriter();
@@ -69,26 +69,33 @@ class CommandMkdir extends CommandPolykey {
             });
           }
           await writer.close();
-          for await (const result of response.readable) {
-            if (result.type === 'error') {
-              const error = result as ErrorMessage;
-              let message: string = '';
-              if (error.code === 'ENOENT') {
-                message = 'No such secret or directory';
-              } else if (error.code === 'EEXIST') {
-                message = 'Secret or directory exists';
-              } else {
-                throw new ErrorPolykeyCLIUncaughtException(
-                  `Unexpected error code ${error.code}`,
-                );
-              }
+          return response;
+        }, meta);
+
+        // As git does not track empty directories in version control, we need
+        // to inform the user about this.
+        process.stderr.write(
+          'WARNING: Empty directories will not be affected by modifications to the vault state (version change, sharing/cloning, etc.)',
+        );
 
-              process.stderr.write(
-                `${error.code}: cannot create directory ${error.reason}: ${message}`,
+        for await (const result of response.readable) {
+          if (result.type === 'error') {
+            const error = result as ErrorMessage;
+            let message: string = '';
+            if (error.code === 'ENOENT') {
+              message = 'No such secret or directory';
+            } else if (error.code === 'EEXIST') {
+              message = 'Secret or directory exists';
+            } else {
+              throw new ErrorPolykeyCLIUncaughtException(
+                `Unexpected error code ${error.code}`,
               );
             }
+            process.stderr.write(
+              `${error.code}: cannot create directory ${error.reason}: ${message}`,
+            );
           }
-        }, meta);
+        }
       } finally {
         if (pkClient! != null) await pkClient.stop();
       }