appwrite-cli 5.0.5 → 6.0.0-rc.1

package/lib/commands/storage.js

@@ -4,7 +4,7 @@ const tar = require("tar");
 const ignore = require("ignore");
 const { promisify } = require('util');
 const libClient = require('../client.js');
-const { getAllFiles } = require('../utils.js');
+const { getAllFiles, showConsoleLink } = require('../utils.js');
 const { Command } = require('commander');
 const { sdkForProject, sdkForConsole } = require('../sdks')
 const { parse, actionRunner, parseInteger, parseBool, commandDescriptions, success, log } = require('../parser')
@@ -43,6 +43,7 @@ const storage = new Command("storage").description(commandDescriptions['storage'
  * @typedef {Object} StorageListBucketsRequestParams
  * @property {string[]} queries Array of query strings generated using the Query class provided by the SDK. [Learn more about queries](https://appwrite.io/docs/queries). Maximum of 100 queries are allowed, each 4096 characters long. You may filter on the following attributes: enabled, name, fileSecurity, maximumFileSize, encryption, antivirus
  * @property {string} search Search term to filter your list results. Max length: 256 chars.
+ * @property {boolean} overrideForCli
  * @property {boolean} parseOutput
  * @property {libClient | undefined} sdk
  */
@@ -50,8 +51,9 @@ const storage = new Command("storage").description(commandDescriptions['storage'
 /**
  * @param {StorageListBucketsRequestParams} params
  */
-const storageListBuckets = async ({ queries, search, parseOutput = true, sdk = undefined}) => {
-    let client = !sdk ? await sdkForProject() : sdk;
+const storageListBuckets = async ({queries,search,parseOutput = true, overrideForCli = false, sdk = undefined, console}) => {
+    let client = !sdk ? await sdkForProject() :
+    sdk;
     let apiPath = '/storage/buckets';
     let payload = {};
     if (typeof queries !== 'undefined') {
@@ -68,11 +70,16 @@ const storageListBuckets = async ({ queries, search, parseOutput = true, sdk = u
     }, payload);
 
     if (parseOutput) {
-        parse(response)
-        success()
+        if(console) {
+            showConsoleLink('storage', 'listBuckets');
+         } else {
+            parse(response)
+            success()
+        }
     }
-    
+
     return response;
+
 }
 
 /**
@@ -87,6 +94,7 @@ const storageListBuckets = async ({ queries, search, parseOutput = true, sdk = u
  * @property {Compression} compression Compression algorithm choosen for compression. Can be one of none,  [gzip](https://en.wikipedia.org/wiki/Gzip), or [zstd](https://en.wikipedia.org/wiki/Zstd), For file size above 20MB compression is skipped even if it's enabled
  * @property {boolean} encryption Is encryption enabled? For file size above 20MB encryption is skipped even if it's enabled
  * @property {boolean} antivirus Is virus scanning enabled? For file size above 20MB AntiVirus scanning is skipped even if it's enabled
+ * @property {boolean} overrideForCli
  * @property {boolean} parseOutput
  * @property {libClient | undefined} sdk
  */
@@ -94,8 +102,9 @@ const storageListBuckets = async ({ queries, search, parseOutput = true, sdk = u
 /**
  * @param {StorageCreateBucketRequestParams} params
  */
-const storageCreateBucket = async ({ bucketId, name, permissions, fileSecurity, enabled, maximumFileSize, allowedFileExtensions, compression, encryption, antivirus, parseOutput = true, sdk = undefined}) => {
-    let client = !sdk ? await sdkForProject() : sdk;
+const storageCreateBucket = async ({bucketId,name,permissions,fileSecurity,enabled,maximumFileSize,allowedFileExtensions,compression,encryption,antivirus,parseOutput = true, overrideForCli = false, sdk = undefined}) => {
+    let client = !sdk ? await sdkForProject() :
+    sdk;
     let apiPath = '/storage/buckets';
     let payload = {};
     if (typeof bucketId !== 'undefined') {
@@ -141,13 +150,15 @@ const storageCreateBucket = async ({ bucketId, name, permissions, fileSecurity,
         parse(response)
         success()
     }
-    
+
     return response;
+
 }
 
 /**
  * @typedef {Object} StorageGetBucketRequestParams
  * @property {string} bucketId Bucket unique ID.
+ * @property {boolean} overrideForCli
  * @property {boolean} parseOutput
  * @property {libClient | undefined} sdk
  */
@@ -155,8 +166,9 @@ const storageCreateBucket = async ({ bucketId, name, permissions, fileSecurity,
 /**
  * @param {StorageGetBucketRequestParams} params
  */
-const storageGetBucket = async ({ bucketId, parseOutput = true, sdk = undefined}) => {
-    let client = !sdk ? await sdkForProject() : sdk;
+const storageGetBucket = async ({bucketId,parseOutput = true, overrideForCli = false, sdk = undefined, console}) => {
+    let client = !sdk ? await sdkForProject() :
+    sdk;
     let apiPath = '/storage/buckets/{bucketId}'.replace('{bucketId}', bucketId);
     let payload = {};
 
@@ -167,11 +179,16 @@ const storageGetBucket = async ({ bucketId, parseOutput = true, sdk = undefined}
     }, payload);
 
     if (parseOutput) {
-        parse(response)
-        success()
+        if(console) {
+            showConsoleLink('storage', 'getBucket', bucketId);
+         } else {
+            parse(response)
+            success()
+        }
     }
-    
+
     return response;
+
 }
 
 /**
@@ -186,6 +203,7 @@ const storageGetBucket = async ({ bucketId, parseOutput = true, sdk = undefined}
  * @property {Compression} compression Compression algorithm choosen for compression. Can be one of none, [gzip](https://en.wikipedia.org/wiki/Gzip), or [zstd](https://en.wikipedia.org/wiki/Zstd), For file size above 20MB compression is skipped even if it's enabled
  * @property {boolean} encryption Is encryption enabled? For file size above 20MB encryption is skipped even if it's enabled
  * @property {boolean} antivirus Is virus scanning enabled? For file size above 20MB AntiVirus scanning is skipped even if it's enabled
+ * @property {boolean} overrideForCli
  * @property {boolean} parseOutput
  * @property {libClient | undefined} sdk
  */
@@ -193,8 +211,9 @@ const storageGetBucket = async ({ bucketId, parseOutput = true, sdk = undefined}
 /**
  * @param {StorageUpdateBucketRequestParams} params
  */
-const storageUpdateBucket = async ({ bucketId, name, permissions, fileSecurity, enabled, maximumFileSize, allowedFileExtensions, compression, encryption, antivirus, parseOutput = true, sdk = undefined}) => {
-    let client = !sdk ? await sdkForProject() : sdk;
+const storageUpdateBucket = async ({bucketId,name,permissions,fileSecurity,enabled,maximumFileSize,allowedFileExtensions,compression,encryption,antivirus,parseOutput = true, overrideForCli = false, sdk = undefined}) => {
+    let client = !sdk ? await sdkForProject() :
+    sdk;
     let apiPath = '/storage/buckets/{bucketId}'.replace('{bucketId}', bucketId);
     let payload = {};
     if (typeof name !== 'undefined') {
@@ -237,13 +256,15 @@ const storageUpdateBucket = async ({ bucketId, name, permissions, fileSecurity,
         parse(response)
         success()
     }
-    
+
     return response;
+
 }
 
 /**
  * @typedef {Object} StorageDeleteBucketRequestParams
  * @property {string} bucketId Bucket unique ID.
+ * @property {boolean} overrideForCli
  * @property {boolean} parseOutput
  * @property {libClient | undefined} sdk
  */
@@ -251,8 +272,9 @@ const storageUpdateBucket = async ({ bucketId, name, permissions, fileSecurity,
 /**
  * @param {StorageDeleteBucketRequestParams} params
  */
-const storageDeleteBucket = async ({ bucketId, parseOutput = true, sdk = undefined}) => {
-    let client = !sdk ? await sdkForProject() : sdk;
+const storageDeleteBucket = async ({bucketId,parseOutput = true, overrideForCli = false, sdk = undefined}) => {
+    let client = !sdk ? await sdkForProject() :
+    sdk;
     let apiPath = '/storage/buckets/{bucketId}'.replace('{bucketId}', bucketId);
     let payload = {};
 
@@ -266,8 +288,9 @@ const storageDeleteBucket = async ({ bucketId, parseOutput = true, sdk = undefin
         parse(response)
         success()
     }
-    
+
     return response;
+
 }
 
 /**
@@ -275,6 +298,7 @@ const storageDeleteBucket = async ({ bucketId, parseOutput = true, sdk = undefin
  * @property {string} bucketId Storage bucket unique ID. You can create a new storage bucket using the Storage service [server integration](https://appwrite.io/docs/server/storage#createBucket).
  * @property {string[]} queries Array of query strings generated using the Query class provided by the SDK. [Learn more about queries](https://appwrite.io/docs/queries). Maximum of 100 queries are allowed, each 4096 characters long. You may filter on the following attributes: name, signature, mimeType, sizeOriginal, chunksTotal, chunksUploaded
  * @property {string} search Search term to filter your list results. Max length: 256 chars.
+ * @property {boolean} overrideForCli
  * @property {boolean} parseOutput
  * @property {libClient | undefined} sdk
  */
@@ -282,8 +306,9 @@ const storageDeleteBucket = async ({ bucketId, parseOutput = true, sdk = undefin
 /**
  * @param {StorageListFilesRequestParams} params
  */
-const storageListFiles = async ({ bucketId, queries, search, parseOutput = true, sdk = undefined}) => {
-    let client = !sdk ? await sdkForProject() : sdk;
+const storageListFiles = async ({bucketId,queries,search,parseOutput = true, overrideForCli = false, sdk = undefined, console}) => {
+    let client = !sdk ? await sdkForProject() :
+    sdk;
     let apiPath = '/storage/buckets/{bucketId}/files'.replace('{bucketId}', bucketId);
     let payload = {};
     if (typeof queries !== 'undefined') {
@@ -300,19 +325,25 @@ const storageListFiles = async ({ bucketId, queries, search, parseOutput = true,
     }, payload);
 
     if (parseOutput) {
-        parse(response)
-        success()
+        if(console) {
+            showConsoleLink('storage', 'listFiles', bucketId);
+         } else {
+            parse(response)
+            success()
+        }
     }
-    
+
     return response;
+
 }
 
 /**
  * @typedef {Object} StorageCreateFileRequestParams
  * @property {string} bucketId Storage bucket unique ID. You can create a new storage bucket using the Storage service [server integration](https://appwrite.io/docs/server/storage#createBucket).
  * @property {string} fileId File ID. Choose a custom ID or generate a random ID with 'ID.unique()'. Valid chars are a-z, A-Z, 0-9, period, hyphen, and underscore. Can't start with a special char. Max length is 36 chars.
- * @property {string} file Binary file. Appwrite SDKs provide helpers to handle file input. [Learn about file input](https://appwrite.io/docs/storage#file-input).
+ * @property {string} file Binary file. Appwrite SDKs provide helpers to handle file input. [Learn about file input](https://appwrite.io/docs/products/storage/upload-download#input-file).
  * @property {string[]} permissions An array of permission strings. By default, only the current user is granted all permissions. [Learn more about permissions](https://appwrite.io/docs/permissions).
+ * @property {boolean} overrideForCli
  * @property {boolean} parseOutput
  * @property {libClient | undefined} sdk
  * @property {CallableFunction} onProgress
@@ -321,8 +352,9 @@ const storageListFiles = async ({ bucketId, queries, search, parseOutput = true,
 /**
  * @param {StorageCreateFileRequestParams} params
  */
-const storageCreateFile = async ({ bucketId, fileId, file, permissions, parseOutput = true, sdk = undefined, onProgress = () => {}}) => {
-    let client = !sdk ? await sdkForProject() : sdk;
+const storageCreateFile = async ({bucketId,fileId,file,permissions,parseOutput = true, overrideForCli = false, sdk = undefined,onProgress = () => {}}) => {
+    let client = !sdk ? await sdkForProject() :
+    sdk;
     let apiPath = '/storage/buckets/{bucketId}/files'.replace('{bucketId}', bucketId);
     let payload = {};
     if (typeof fileId !== 'undefined') {
@@ -342,7 +374,7 @@ const storageCreateFile = async ({ bucketId, fileId, file, permissions, parseOut
     }
 
     const size = file.size;
-    
+
     const apiHeaders = {
         'content-type': 'multipart/form-data',
     };
@@ -377,7 +409,7 @@ const storageCreateFile = async ({ bucketId, fileId, file, permissions, parseOut
         }
 
         let uploadableChunkTrimmed;
-        
+
         if(currentPosition + 1 >= client.CHUNK_SIZE) {
             uploadableChunkTrimmed = uploadableChunk;
         } else {
@@ -430,7 +462,7 @@ const storageCreateFile = async ({ bucketId, fileId, file, permissions, parseOut
         await uploadChunk(true);
     }
 
-            
+
     if (parseOutput) {
         parse(response)
         success()
@@ -443,6 +475,7 @@ const storageCreateFile = async ({ bucketId, fileId, file, permissions, parseOut
  * @typedef {Object} StorageGetFileRequestParams
  * @property {string} bucketId Storage bucket unique ID. You can create a new storage bucket using the Storage service [server integration](https://appwrite.io/docs/server/storage#createBucket).
  * @property {string} fileId File ID.
+ * @property {boolean} overrideForCli
  * @property {boolean} parseOutput
  * @property {libClient | undefined} sdk
  */
@@ -450,8 +483,9 @@ const storageCreateFile = async ({ bucketId, fileId, file, permissions, parseOut
 /**
  * @param {StorageGetFileRequestParams} params
  */
-const storageGetFile = async ({ bucketId, fileId, parseOutput = true, sdk = undefined}) => {
-    let client = !sdk ? await sdkForProject() : sdk;
+const storageGetFile = async ({bucketId,fileId,parseOutput = true, overrideForCli = false, sdk = undefined, console}) => {
+    let client = !sdk ? await sdkForProject() :
+    sdk;
     let apiPath = '/storage/buckets/{bucketId}/files/{fileId}'.replace('{bucketId}', bucketId).replace('{fileId}', fileId);
     let payload = {};
 
@@ -462,11 +496,16 @@ const storageGetFile = async ({ bucketId, fileId, parseOutput = true, sdk = unde
     }, payload);
 
     if (parseOutput) {
-        parse(response)
-        success()
+        if(console) {
+            showConsoleLink('storage', 'getFile', bucketId, fileId);
+         } else {
+            parse(response)
+            success()
+        }
     }
-    
+
     return response;
+
 }
 
 /**
@@ -475,6 +514,7 @@ const storageGetFile = async ({ bucketId, fileId, parseOutput = true, sdk = unde
  * @property {string} fileId File unique ID.
  * @property {string} name Name of the file
  * @property {string[]} permissions An array of permission string. By default, the current permissions are inherited. [Learn more about permissions](https://appwrite.io/docs/permissions).
+ * @property {boolean} overrideForCli
  * @property {boolean} parseOutput
  * @property {libClient | undefined} sdk
  */
@@ -482,8 +522,9 @@ const storageGetFile = async ({ bucketId, fileId, parseOutput = true, sdk = unde
 /**
  * @param {StorageUpdateFileRequestParams} params
  */
-const storageUpdateFile = async ({ bucketId, fileId, name, permissions, parseOutput = true, sdk = undefined}) => {
-    let client = !sdk ? await sdkForProject() : sdk;
+const storageUpdateFile = async ({bucketId,fileId,name,permissions,parseOutput = true, overrideForCli = false, sdk = undefined}) => {
+    let client = !sdk ? await sdkForProject() :
+    sdk;
     let apiPath = '/storage/buckets/{bucketId}/files/{fileId}'.replace('{bucketId}', bucketId).replace('{fileId}', fileId);
     let payload = {};
     if (typeof name !== 'undefined') {
@@ -504,14 +545,16 @@ const storageUpdateFile = async ({ bucketId, fileId, name, permissions, parseOut
         parse(response)
         success()
     }
-    
+
     return response;
+
 }
 
 /**
  * @typedef {Object} StorageDeleteFileRequestParams
  * @property {string} bucketId Storage bucket unique ID. You can create a new storage bucket using the Storage service [server integration](https://appwrite.io/docs/server/storage#createBucket).
  * @property {string} fileId File ID.
+ * @property {boolean} overrideForCli
  * @property {boolean} parseOutput
  * @property {libClient | undefined} sdk
  */
@@ -519,8 +562,9 @@ const storageUpdateFile = async ({ bucketId, fileId, name, permissions, parseOut
 /**
  * @param {StorageDeleteFileRequestParams} params
  */
-const storageDeleteFile = async ({ bucketId, fileId, parseOutput = true, sdk = undefined}) => {
-    let client = !sdk ? await sdkForProject() : sdk;
+const storageDeleteFile = async ({bucketId,fileId,parseOutput = true, overrideForCli = false, sdk = undefined}) => {
+    let client = !sdk ? await sdkForProject() :
+    sdk;
     let apiPath = '/storage/buckets/{bucketId}/files/{fileId}'.replace('{bucketId}', bucketId).replace('{fileId}', fileId);
     let payload = {};
 
@@ -534,14 +578,16 @@ const storageDeleteFile = async ({ bucketId, fileId, parseOutput = true, sdk = u
         parse(response)
         success()
     }
-    
+
     return response;
+
 }
 
 /**
  * @typedef {Object} StorageGetFileDownloadRequestParams
  * @property {string} bucketId Storage bucket ID. You can create a new storage bucket using the Storage service [server integration](https://appwrite.io/docs/server/storage#createBucket).
  * @property {string} fileId File ID.
+ * @property {boolean} overrideForCli
  * @property {boolean} parseOutput
  * @property {libClient | undefined} sdk
  * @property {string} destination
@@ -550,14 +596,17 @@ const storageDeleteFile = async ({ bucketId, fileId, parseOutput = true, sdk = u
 /**
  * @param {StorageGetFileDownloadRequestParams} params
  */
-const storageGetFileDownload = async ({ bucketId, fileId, parseOutput = true, sdk = undefined, destination}) => {
-    let client = !sdk ? await sdkForProject() : sdk;
+const storageGetFileDownload = async ({bucketId,fileId,parseOutput = true, overrideForCli = false, sdk = undefined, destination}) => {
+    let client = !sdk ? await sdkForProject() :
+    sdk;
     let apiPath = '/storage/buckets/{bucketId}/files/{fileId}/download'.replace('{bucketId}', bucketId).replace('{fileId}', fileId);
     let payload = {};
-    payload['project'] = localConfig.getProject().projectId
-    payload['key'] = globalConfig.getKey();
-    const queryParams = new URLSearchParams(payload);
-    apiPath = `${globalConfig.getEndpoint()}${apiPath}?${queryParams.toString()}`;
+    if (!overrideForCli) {
+        payload['project'] = localConfig.getProject().projectId
+        payload['key'] = globalConfig.getKey();
+        const queryParams = new URLSearchParams(payload);
+        apiPath = `${globalConfig.getEndpoint()}${apiPath}?${queryParams.toString()}`;
+    }
 
     let response = undefined;
 
@@ -565,14 +614,18 @@ const storageGetFileDownload = async ({ bucketId, fileId, parseOutput = true, sd
         'content-type': 'application/json',
     }, payload, 'arraybuffer');
 
-    fs.writeFileSync(destination, response);
+    if (overrideForCli) {
+        response = Buffer.from(response);
+    }
 
+    fs.writeFileSync(destination, response);
     if (parseOutput) {
         parse(response)
         success()
     }
-    
+
     return response;
+
 }
 
 /**
@@ -590,6 +643,7 @@ const storageGetFileDownload = async ({ bucketId, fileId, parseOutput = true, sd
  * @property {number} rotation Preview image rotation in degrees. Pass an integer between -360 and 360.
  * @property {string} background Preview image background color. Only works with transparent images (png). Use a valid HEX color, no # is needed for prefix.
  * @property {ImageFormat} output Output format type (jpeg, jpg, png, gif and webp).
+ * @property {boolean} overrideForCli
  * @property {boolean} parseOutput
  * @property {libClient | undefined} sdk
  * @property {string} destination
@@ -598,8 +652,9 @@ const storageGetFileDownload = async ({ bucketId, fileId, parseOutput = true, sd
 /**
  * @param {StorageGetFilePreviewRequestParams} params
  */
-const storageGetFilePreview = async ({ bucketId, fileId, width, height, gravity, quality, borderWidth, borderColor, borderRadius, opacity, rotation, background, output, parseOutput = true, sdk = undefined, destination}) => {
-    let client = !sdk ? await sdkForProject() : sdk;
+const storageGetFilePreview = async ({bucketId,fileId,width,height,gravity,quality,borderWidth,borderColor,borderRadius,opacity,rotation,background,output,parseOutput = true, overrideForCli = false, sdk = undefined, destination}) => {
+    let client = !sdk ? await sdkForProject() :
+    sdk;
     let apiPath = '/storage/buckets/{bucketId}/files/{fileId}/preview'.replace('{bucketId}', bucketId).replace('{fileId}', fileId);
     let payload = {};
     if (typeof width !== 'undefined') {
@@ -635,10 +690,12 @@ const storageGetFilePreview = async ({ bucketId, fileId, width, height, gravity,
     if (typeof output !== 'undefined') {
         payload['output'] = output;
     }
-    payload['project'] = localConfig.getProject().projectId
-    payload['key'] = globalConfig.getKey();
-    const queryParams = new URLSearchParams(payload);
-    apiPath = `${globalConfig.getEndpoint()}${apiPath}?${queryParams.toString()}`;
+    if (!overrideForCli) {
+        payload['project'] = localConfig.getProject().projectId
+        payload['key'] = globalConfig.getKey();
+        const queryParams = new URLSearchParams(payload);
+        apiPath = `${globalConfig.getEndpoint()}${apiPath}?${queryParams.toString()}`;
+    }
 
     let response = undefined;
 
@@ -646,20 +703,25 @@ const storageGetFilePreview = async ({ bucketId, fileId, width, height, gravity,
         'content-type': 'application/json',
     }, payload, 'arraybuffer');
 
-    fs.writeFileSync(destination, response);
+    if (overrideForCli) {
+        response = Buffer.from(response);
+    }
 
+    fs.writeFileSync(destination, response);
     if (parseOutput) {
         parse(response)
         success()
     }
-    
+
     return response;
+
 }
 
 /**
  * @typedef {Object} StorageGetFileViewRequestParams
  * @property {string} bucketId Storage bucket unique ID. You can create a new storage bucket using the Storage service [server integration](https://appwrite.io/docs/server/storage#createBucket).
  * @property {string} fileId File ID.
+ * @property {boolean} overrideForCli
  * @property {boolean} parseOutput
  * @property {libClient | undefined} sdk
  * @property {string} destination
@@ -668,14 +730,17 @@ const storageGetFilePreview = async ({ bucketId, fileId, width, height, gravity,
 /**
  * @param {StorageGetFileViewRequestParams} params
  */
-const storageGetFileView = async ({ bucketId, fileId, parseOutput = true, sdk = undefined, destination}) => {
-    let client = !sdk ? await sdkForProject() : sdk;
+const storageGetFileView = async ({bucketId,fileId,parseOutput = true, overrideForCli = false, sdk = undefined, destination}) => {
+    let client = !sdk ? await sdkForProject() :
+    sdk;
     let apiPath = '/storage/buckets/{bucketId}/files/{fileId}/view'.replace('{bucketId}', bucketId).replace('{fileId}', fileId);
     let payload = {};
-    payload['project'] = localConfig.getProject().projectId
-    payload['key'] = globalConfig.getKey();
-    const queryParams = new URLSearchParams(payload);
-    apiPath = `${globalConfig.getEndpoint()}${apiPath}?${queryParams.toString()}`;
+    if (!overrideForCli) {
+        payload['project'] = localConfig.getProject().projectId
+        payload['key'] = globalConfig.getKey();
+        const queryParams = new URLSearchParams(payload);
+        apiPath = `${globalConfig.getEndpoint()}${apiPath}?${queryParams.toString()}`;
+    }
 
     let response = undefined;
 
@@ -683,19 +748,24 @@ const storageGetFileView = async ({ bucketId, fileId, parseOutput = true, sdk =
         'content-type': 'application/json',
     }, payload, 'arraybuffer');
 
-    fs.writeFileSync(destination, response);
+    if (overrideForCli) {
+        response = Buffer.from(response);
+    }
 
+    fs.writeFileSync(destination, response);
     if (parseOutput) {
         parse(response)
         success()
     }
-    
+
     return response;
+
 }
 
 /**
  * @typedef {Object} StorageGetUsageRequestParams
  * @property {StorageUsageRange} range Date range.
+ * @property {boolean} overrideForCli
  * @property {boolean} parseOutput
  * @property {libClient | undefined} sdk
  */
@@ -703,8 +773,9 @@ const storageGetFileView = async ({ bucketId, fileId, parseOutput = true, sdk =
 /**
  * @param {StorageGetUsageRequestParams} params
  */
-const storageGetUsage = async ({ range, parseOutput = true, sdk = undefined}) => {
-    let client = !sdk ? await sdkForProject() : sdk;
+const storageGetUsage = async ({range,parseOutput = true, overrideForCli = false, sdk = undefined}) => {
+    let client = !sdk ? await sdkForProject() :
+    sdk;
     let apiPath = '/storage/usage';
     let payload = {};
     if (typeof range !== 'undefined') {
@@ -721,14 +792,16 @@ const storageGetUsage = async ({ range, parseOutput = true, sdk = undefined}) =>
         parse(response)
         success()
     }
-    
+
     return response;
+
 }
 
 /**
  * @typedef {Object} StorageGetBucketUsageRequestParams
  * @property {string} bucketId Bucket ID.
  * @property {StorageUsageRange} range Date range.
+ * @property {boolean} overrideForCli
  * @property {boolean} parseOutput
  * @property {libClient | undefined} sdk
  */
@@ -736,8 +809,9 @@ const storageGetUsage = async ({ range, parseOutput = true, sdk = undefined}) =>
 /**
  * @param {StorageGetBucketUsageRequestParams} params
  */
-const storageGetBucketUsage = async ({ bucketId, range, parseOutput = true, sdk = undefined}) => {
-    let client = !sdk ? await sdkForProject() : sdk;
+const storageGetBucketUsage = async ({bucketId,range,parseOutput = true, overrideForCli = false, sdk = undefined, console}) => {
+    let client = !sdk ? await sdkForProject() :
+    sdk;
     let apiPath = '/storage/{bucketId}/usage'.replace('{bucketId}', bucketId);
     let payload = {};
     if (typeof range !== 'undefined') {
@@ -751,11 +825,16 @@ const storageGetBucketUsage = async ({ bucketId, range, parseOutput = true, sdk
     }, payload);
 
     if (parseOutput) {
-        parse(response)
-        success()
+        if(console) {
+            showConsoleLink('storage', 'getBucketUsage', bucketId);
+         } else {
+            parse(response)
+            success()
+        }
     }
-    
+
     return response;
+
 }
 
 storage
@@ -763,6 +842,7 @@ storage
     .description(`Get a list of all the storage buckets. You can use the query params to filter your results.`)
     .option(`--queries [queries...]`, `Array of query strings generated using the Query class provided by the SDK. [Learn more about queries](https://appwrite.io/docs/queries). Maximum of 100 queries are allowed, each 4096 characters long. You may filter on the following attributes: enabled, name, fileSecurity, maximumFileSize, encryption, antivirus`)
     .option(`--search <search>`, `Search term to filter your list results. Max length: 256 chars.`)
+    .option(`--console`, `Get the resource console url`)
     .action(actionRunner(storageListBuckets))
 
 storage
@@ -784,6 +864,7 @@ storage
     .command(`getBucket`)
     .description(`Get a storage bucket by its unique ID. This endpoint response returns a JSON object with the storage bucket metadata.`)
     .requiredOption(`--bucketId <bucketId>`, `Bucket unique ID.`)
+    .option(`--console`, `Get the resource console url`)
     .action(actionRunner(storageGetBucket))
 
 storage
@@ -813,6 +894,7 @@ storage
     .requiredOption(`--bucketId <bucketId>`, `Storage bucket unique ID. You can create a new storage bucket using the Storage service [server integration](https://appwrite.io/docs/server/storage#createBucket).`)
     .option(`--queries [queries...]`, `Array of query strings generated using the Query class provided by the SDK. [Learn more about queries](https://appwrite.io/docs/queries). Maximum of 100 queries are allowed, each 4096 characters long. You may filter on the following attributes: name, signature, mimeType, sizeOriginal, chunksTotal, chunksUploaded`)
     .option(`--search <search>`, `Search term to filter your list results. Max length: 256 chars.`)
+    .option(`--console`, `Get the resource console url`)
     .action(actionRunner(storageListFiles))
 
 storage
@@ -820,7 +902,7 @@ storage
     .description(`Create a new file. Before using this route, you should create a new bucket resource using either a [server integration](https://appwrite.io/docs/server/storage#storageCreateBucket) API or directly from your Appwrite console.  Larger files should be uploaded using multiple requests with the [content-range](https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Content-Range) header to send a partial request with a maximum supported chunk of '5MB'. The 'content-range' header values should always be in bytes.  When the first request is sent, the server will return the **File** object, and the subsequent part request must include the file's **id** in 'x-appwrite-id' header to allow the server to know that the partial upload is for the existing file and not for a new one.  If you're creating a new file using one of the Appwrite SDKs, all the chunking logic will be managed by the SDK internally. `)
     .requiredOption(`--bucketId <bucketId>`, `Storage bucket unique ID. You can create a new storage bucket using the Storage service [server integration](https://appwrite.io/docs/server/storage#createBucket).`)
     .requiredOption(`--fileId <fileId>`, `File ID. Choose a custom ID or generate a random ID with 'ID.unique()'. Valid chars are a-z, A-Z, 0-9, period, hyphen, and underscore. Can't start with a special char. Max length is 36 chars.`)
-    .requiredOption(`--file <file>`, `Binary file. Appwrite SDKs provide helpers to handle file input. [Learn about file input](https://appwrite.io/docs/storage#file-input).`)
+    .requiredOption(`--file <file>`, `Binary file. Appwrite SDKs provide helpers to handle file input. [Learn about file input](https://appwrite.io/docs/products/storage/upload-download#input-file).`)
     .option(`--permissions [permissions...]`, `An array of permission strings. By default, only the current user is granted all permissions. [Learn more about permissions](https://appwrite.io/docs/permissions).`)
     .action(actionRunner(storageCreateFile))
 
@@ -829,6 +911,7 @@ storage
     .description(`Get a file by its unique ID. This endpoint response returns a JSON object with the file metadata.`)
     .requiredOption(`--bucketId <bucketId>`, `Storage bucket unique ID. You can create a new storage bucket using the Storage service [server integration](https://appwrite.io/docs/server/storage#createBucket).`)
     .requiredOption(`--fileId <fileId>`, `File ID.`)
+    .option(`--console`, `Get the resource console url`)
     .action(actionRunner(storageGetFile))
 
 storage
@@ -893,6 +976,7 @@ storage
     .description(``)
     .requiredOption(`--bucketId <bucketId>`, `Bucket ID.`)
     .option(`--range <range>`, `Date range.`)
+    .option(`--console`, `Get the resource console url`)
     .action(actionRunner(storageGetBucketUsage))
 
 module.exports = {
@@ -912,4 +996,4 @@ module.exports = {
     storageGetFileView,
     storageGetUsage,
     storageGetBucketUsage
-};
+};