appwrite-cli 0.14.0

package/lib/commands/storage.js

@@ -0,0 +1,743 @@
+const fs = require('fs');
+const { promisify } = require('util');
+const libClient = require('../client.js');
+const childProcess = require('child_process');
+const { Command } = require('commander');
+const { sdkForProject, sdkForConsole } = require('../sdks')
+const { parse, actionRunner, parseInteger, parseBool, commandDescriptions, success, log } = require('../parser')
+const { localConfig, globalConfig } = require("../config");
+
+const storage = new Command("storage").description(commandDescriptions['storage'])
+
+const storageListBuckets = async ({ search, limit, offset, cursor, cursorDirection, orderType, parseOutput = true, sdk = undefined}) => {
+    /* @param {string} search */
+    /* @param {number} limit */
+    /* @param {number} offset */
+    /* @param {string} cursor */
+    /* @param {string} cursorDirection */
+    /* @param {string} orderType */
+
+    let client = !sdk ? await sdkForProject() : sdk;
+    let path = '/storage/buckets';
+    let payload = {};
+
+    /** Query Params */
+    if (typeof search !== 'undefined') {
+        payload['search'] = search;
+    }
+    if (typeof limit !== 'undefined') {
+        payload['limit'] = limit;
+    }
+    if (typeof offset !== 'undefined') {
+        payload['offset'] = offset;
+    }
+    if (typeof cursor !== 'undefined') {
+        payload['cursor'] = cursor;
+    }
+    if (typeof cursorDirection !== 'undefined') {
+        payload['cursorDirection'] = cursorDirection;
+    }
+    if (typeof orderType !== 'undefined') {
+        payload['orderType'] = orderType;
+    }
+    let response = undefined;
+    response = await client.call('get', path, {
+        'content-type': 'application/json',
+    }, payload);
+    
+    if (parseOutput) {
+        parse(response)
+        success()
+    }
+    return response;
+}
+
+const storageCreateBucket = async ({ bucketId, name, permission, read, write, enabled, maximumFileSize, allowedFileExtensions, encryption, antivirus, parseOutput = true, sdk = undefined}) => {
+    /* @param {string} bucketId */
+    /* @param {string} name */
+    /* @param {string} permission */
+    /* @param {string[]} read */
+    /* @param {string[]} write */
+    /* @param {boolean} enabled */
+    /* @param {number} maximumFileSize */
+    /* @param {string[]} allowedFileExtensions */
+    /* @param {boolean} encryption */
+    /* @param {boolean} antivirus */
+
+    let client = !sdk ? await sdkForProject() : sdk;
+    let path = '/storage/buckets';
+    let payload = {};
+    
+    /** Body Params */
+    if (typeof bucketId !== 'undefined') {
+        payload['bucketId'] = bucketId;
+    }
+
+    if (typeof name !== 'undefined') {
+        payload['name'] = name;
+    }
+
+    if (typeof permission !== 'undefined') {
+        payload['permission'] = permission;
+    }
+
+    if (typeof read !== 'undefined') {
+        payload['read'] = read;
+    }
+
+    if (typeof write !== 'undefined') {
+        payload['write'] = write;
+    }
+
+    if (typeof enabled !== 'undefined') {
+        payload['enabled'] = enabled;
+    }
+
+    if (typeof maximumFileSize !== 'undefined') {
+        payload['maximumFileSize'] = maximumFileSize;
+    }
+
+    if (typeof allowedFileExtensions !== 'undefined') {
+        payload['allowedFileExtensions'] = allowedFileExtensions;
+    }
+
+    if (typeof encryption !== 'undefined') {
+        payload['encryption'] = encryption;
+    }
+
+    if (typeof antivirus !== 'undefined') {
+        payload['antivirus'] = antivirus;
+    }
+
+    let response = undefined;
+    response = await client.call('post', path, {
+        'content-type': 'application/json',
+    }, payload);
+    
+    if (parseOutput) {
+        parse(response)
+        success()
+    }
+    return response;
+}
+
+const storageGetBucket = async ({ bucketId, parseOutput = true, sdk = undefined}) => {
+    /* @param {string} bucketId */
+
+    let client = !sdk ? await sdkForProject() : sdk;
+    let path = '/storage/buckets/{bucketId}'.replace('{bucketId}', bucketId);
+    let payload = {};
+    let response = undefined;
+    response = await client.call('get', path, {
+        'content-type': 'application/json',
+    }, payload);
+    
+    if (parseOutput) {
+        parse(response)
+        success()
+    }
+    return response;
+}
+
+const storageUpdateBucket = async ({ bucketId, name, permission, read, write, enabled, maximumFileSize, allowedFileExtensions, encryption, antivirus, parseOutput = true, sdk = undefined}) => {
+    /* @param {string} bucketId */
+    /* @param {string} name */
+    /* @param {string} permission */
+    /* @param {string[]} read */
+    /* @param {string[]} write */
+    /* @param {boolean} enabled */
+    /* @param {number} maximumFileSize */
+    /* @param {string[]} allowedFileExtensions */
+    /* @param {boolean} encryption */
+    /* @param {boolean} antivirus */
+
+    let client = !sdk ? await sdkForProject() : sdk;
+    let path = '/storage/buckets/{bucketId}'.replace('{bucketId}', bucketId);
+    let payload = {};
+    
+    /** Body Params */
+    if (typeof name !== 'undefined') {
+        payload['name'] = name;
+    }
+
+    if (typeof permission !== 'undefined') {
+        payload['permission'] = permission;
+    }
+
+    if (typeof read !== 'undefined') {
+        payload['read'] = read;
+    }
+
+    if (typeof write !== 'undefined') {
+        payload['write'] = write;
+    }
+
+    if (typeof enabled !== 'undefined') {
+        payload['enabled'] = enabled;
+    }
+
+    if (typeof maximumFileSize !== 'undefined') {
+        payload['maximumFileSize'] = maximumFileSize;
+    }
+
+    if (typeof allowedFileExtensions !== 'undefined') {
+        payload['allowedFileExtensions'] = allowedFileExtensions;
+    }
+
+    if (typeof encryption !== 'undefined') {
+        payload['encryption'] = encryption;
+    }
+
+    if (typeof antivirus !== 'undefined') {
+        payload['antivirus'] = antivirus;
+    }
+
+    let response = undefined;
+    response = await client.call('put', path, {
+        'content-type': 'application/json',
+    }, payload);
+    
+    if (parseOutput) {
+        parse(response)
+        success()
+    }
+    return response;
+}
+
+const storageDeleteBucket = async ({ bucketId, parseOutput = true, sdk = undefined}) => {
+    /* @param {string} bucketId */
+
+    let client = !sdk ? await sdkForProject() : sdk;
+    let path = '/storage/buckets/{bucketId}'.replace('{bucketId}', bucketId);
+    let payload = {};
+    let response = undefined;
+    response = await client.call('delete', path, {
+        'content-type': 'application/json',
+    }, payload);
+    
+    if (parseOutput) {
+        parse(response)
+        success()
+    }
+    return response;
+}
+
+const storageListFiles = async ({ bucketId, search, limit, offset, cursor, cursorDirection, orderType, parseOutput = true, sdk = undefined}) => {
+    /* @param {string} bucketId */
+    /* @param {string} search */
+    /* @param {number} limit */
+    /* @param {number} offset */
+    /* @param {string} cursor */
+    /* @param {string} cursorDirection */
+    /* @param {string} orderType */
+
+    let client = !sdk ? await sdkForProject() : sdk;
+    let path = '/storage/buckets/{bucketId}/files'.replace('{bucketId}', bucketId);
+    let payload = {};
+
+    /** Query Params */
+    if (typeof search !== 'undefined') {
+        payload['search'] = search;
+    }
+    if (typeof limit !== 'undefined') {
+        payload['limit'] = limit;
+    }
+    if (typeof offset !== 'undefined') {
+        payload['offset'] = offset;
+    }
+    if (typeof cursor !== 'undefined') {
+        payload['cursor'] = cursor;
+    }
+    if (typeof cursorDirection !== 'undefined') {
+        payload['cursorDirection'] = cursorDirection;
+    }
+    if (typeof orderType !== 'undefined') {
+        payload['orderType'] = orderType;
+    }
+    let response = undefined;
+    response = await client.call('get', path, {
+        'content-type': 'application/json',
+    }, payload);
+    
+    if (parseOutput) {
+        parse(response)
+        success()
+    }
+    return response;
+}
+
+const storageCreateFile = async ({ bucketId, fileId, file, read, write, parseOutput = true, sdk = undefined, onProgress = () => {}}) => {
+    /* @param {string} bucketId */
+    /* @param {string} fileId */
+    /* @param {File} file */
+    /* @param {string[]} read */
+    /* @param {string[]} write */
+
+    let client = !sdk ? await sdkForProject() : sdk;
+    let path = '/storage/buckets/{bucketId}/files'.replace('{bucketId}', bucketId);
+    let payload = {};
+    
+    /** Body Params */
+    if (typeof fileId !== 'undefined') {
+        payload['fileId'] = fileId;
+    }
+
+    let filePath = fs.realpathSync(file);
+    if (typeof filePath !== 'undefined') {
+        payload['file'] = filePath;
+    }
+
+    if (typeof read !== 'undefined') {
+        payload['read'] = read;
+    }
+
+    if (typeof write !== 'undefined') {
+        payload['write'] = write;
+    }
+
+    let response = undefined;
+    const { size: size } = await promisify(fs.stat)(file);
+
+    if (size <= libClient.CHUNK_SIZE) {
+        payload['file'] = fs.createReadStream(payload['file']);
+
+        response = await client.call('post', path, {
+            'content-type': 'multipart/form-data',
+        }, payload);
+    } else {
+        const streamFilePath = payload['file'];
+        let id = undefined;
+
+        const totalCounters = Math.ceil(size / libClient.CHUNK_SIZE);
+
+        for (let counter = 0; counter < totalCounters; counter++) {
+                const start = (counter * libClient.CHUNK_SIZE);
+                const end = Math.min((((counter * libClient.CHUNK_SIZE) + libClient.CHUNK_SIZE) - 1), size);
+                const headers = {
+                        'content-type': 'multipart/form-data',
+                        'content-range': 'bytes ' + start + '-' + end + '/' + size
+                };
+
+                if (id) {
+                        headers['x-appwrite-id'] = id;
+                }
+
+                const stream = fs.createReadStream(streamFilePath, {
+                        start,
+                        end
+                });
+                payload['file'] = stream;
+
+                response = await client.call('post', path, headers, payload);
+
+                if (!id) {
+                        id = response['$id'];
+                }
+
+                if (onProgress !== null) {
+                        onProgress(Math.min((counter+1) * libClient.CHUNK_SIZE, size) / size * 100);
+                }
+        }
+    }
+    
+    if (parseOutput) {
+        parse(response)
+        success()
+    }
+    return response;
+}
+
+const storageGetFile = async ({ bucketId, fileId, parseOutput = true, sdk = undefined}) => {
+    /* @param {string} bucketId */
+    /* @param {string} fileId */
+
+    let client = !sdk ? await sdkForProject() : sdk;
+    let path = '/storage/buckets/{bucketId}/files/{fileId}'.replace('{bucketId}', bucketId).replace('{fileId}', fileId);
+    let payload = {};
+    let response = undefined;
+    response = await client.call('get', path, {
+        'content-type': 'application/json',
+    }, payload);
+    
+    if (parseOutput) {
+        parse(response)
+        success()
+    }
+    return response;
+}
+
+const storageUpdateFile = async ({ bucketId, fileId, read, write, parseOutput = true, sdk = undefined}) => {
+    /* @param {string} bucketId */
+    /* @param {string} fileId */
+    /* @param {string[]} read */
+    /* @param {string[]} write */
+
+    let client = !sdk ? await sdkForProject() : sdk;
+    let path = '/storage/buckets/{bucketId}/files/{fileId}'.replace('{bucketId}', bucketId).replace('{fileId}', fileId);
+    let payload = {};
+    
+    /** Body Params */
+    if (typeof read !== 'undefined') {
+        payload['read'] = read;
+    }
+
+    if (typeof write !== 'undefined') {
+        payload['write'] = write;
+    }
+
+    let response = undefined;
+    response = await client.call('put', path, {
+        'content-type': 'application/json',
+    }, payload);
+    
+    if (parseOutput) {
+        parse(response)
+        success()
+    }
+    return response;
+}
+
+const storageDeleteFile = async ({ bucketId, fileId, parseOutput = true, sdk = undefined}) => {
+    /* @param {string} bucketId */
+    /* @param {string} fileId */
+
+    let client = !sdk ? await sdkForProject() : sdk;
+    let path = '/storage/buckets/{bucketId}/files/{fileId}'.replace('{bucketId}', bucketId).replace('{fileId}', fileId);
+    let payload = {};
+    let response = undefined;
+    response = await client.call('delete', path, {
+        'content-type': 'application/json',
+    }, payload);
+    
+    if (parseOutput) {
+        parse(response)
+        success()
+    }
+    return response;
+}
+
+const storageGetFileDownload = async ({ bucketId, fileId, parseOutput = true, sdk = undefined, destination}) => {
+    /* @param {string} bucketId */
+    /* @param {string} fileId */
+
+    let client = !sdk ? await sdkForProject() : sdk;
+    let path = '/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);
+    path = `${globalConfig.getEndpoint()}${path}?${queryParams.toString()}`;
+
+    const response = await client.call('get', path, {
+        'content-type': 'application/json',
+    }, payload, 'arraybuffer');
+
+    fs.writeFileSync(destination, response);
+
+    if (parseOutput) { 
+        log(`File stored in ${destination}`)
+        success()
+    }
+}
+
+const storageGetFilePreview = async ({ bucketId, fileId, width, height, gravity, quality, borderWidth, borderColor, borderRadius, opacity, rotation, background, output, parseOutput = true, sdk = undefined}) => {
+    /* @param {string} bucketId */
+    /* @param {string} fileId */
+    /* @param {number} width */
+    /* @param {number} height */
+    /* @param {string} gravity */
+    /* @param {number} quality */
+    /* @param {number} borderWidth */
+    /* @param {string} borderColor */
+    /* @param {number} borderRadius */
+    /* @param {number} opacity */
+    /* @param {number} rotation */
+    /* @param {string} background */
+    /* @param {string} output */
+
+    let client = !sdk ? await sdkForProject() : sdk;
+    let path = '/storage/buckets/{bucketId}/files/{fileId}/preview'.replace('{bucketId}', bucketId).replace('{fileId}', fileId);
+    let payload = {};
+
+    /** Query Params */
+    if (typeof width !== 'undefined') {
+        payload['width'] = width;
+    }
+    if (typeof height !== 'undefined') {
+        payload['height'] = height;
+    }
+    if (typeof gravity !== 'undefined') {
+        payload['gravity'] = gravity;
+    }
+    if (typeof quality !== 'undefined') {
+        payload['quality'] = quality;
+    }
+    if (typeof borderWidth !== 'undefined') {
+        payload['borderWidth'] = borderWidth;
+    }
+    if (typeof borderColor !== 'undefined') {
+        payload['borderColor'] = borderColor;
+    }
+    if (typeof borderRadius !== 'undefined') {
+        payload['borderRadius'] = borderRadius;
+    }
+    if (typeof opacity !== 'undefined') {
+        payload['opacity'] = opacity;
+    }
+    if (typeof rotation !== 'undefined') {
+        payload['rotation'] = rotation;
+    }
+    if (typeof background !== 'undefined') {
+        payload['background'] = background;
+    }
+    if (typeof output !== 'undefined') {
+        payload['output'] = output;
+    }
+    let response = undefined;
+    response = await client.call('get', path, {
+        'content-type': 'application/json',
+    }, payload);
+    
+    if (parseOutput) {
+        parse(response)
+        success()
+    }
+    return response;
+}
+
+const storageGetFileView = async ({ bucketId, fileId, parseOutput = true, sdk = undefined, destination}) => {
+    /* @param {string} bucketId */
+    /* @param {string} fileId */
+
+    let client = !sdk ? await sdkForProject() : sdk;
+    let path = '/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);
+    path = `${globalConfig.getEndpoint()}${path}?${queryParams.toString()}`;
+
+    const response = await client.call('get', path, {
+        'content-type': 'application/json',
+    }, payload, 'arraybuffer');
+
+    fs.writeFileSync(destination, response);
+
+    if (parseOutput) { 
+        log(`File stored in ${destination}`)
+        success()
+    }
+}
+
+const storageGetUsage = async ({ range, parseOutput = true, sdk = undefined}) => {
+    /* @param {string} range */
+
+    let client = !sdk ? await sdkForProject() : sdk;
+    let path = '/storage/usage';
+    let payload = {};
+
+    /** Query Params */
+    if (typeof range !== 'undefined') {
+        payload['range'] = range;
+    }
+    let response = undefined;
+    response = await client.call('get', path, {
+        'content-type': 'application/json',
+    }, payload);
+    
+    if (parseOutput) {
+        parse(response)
+        success()
+    }
+    return response;
+}
+
+const storageGetBucketUsage = async ({ bucketId, range, parseOutput = true, sdk = undefined}) => {
+    /* @param {string} bucketId */
+    /* @param {string} range */
+
+    let client = !sdk ? await sdkForProject() : sdk;
+    let path = '/storage/{bucketId}/usage'.replace('{bucketId}', bucketId);
+    let payload = {};
+
+    /** Query Params */
+    if (typeof range !== 'undefined') {
+        payload['range'] = range;
+    }
+    let response = undefined;
+    response = await client.call('get', path, {
+        'content-type': 'application/json',
+    }, payload);
+    
+    if (parseOutput) {
+        parse(response)
+        success()
+    }
+    return response;
+}
+
+
+storage
+    .command(`listBuckets`)
+    .description(`Get a list of all the storage buckets. You can use the query params to filter your results.`)
+    .option(`--search <search>`, `Search term to filter your list results. Max length: 256 chars.`)
+    .option(`--limit <limit>`, `Results limit value. By default will return maximum 25 results. Maximum of 100 results allowed per request.`, parseInteger)
+    .option(`--offset <offset>`, `Results offset. The default value is 0. Use this param to manage pagination.`, parseInteger)
+    .option(`--cursor <cursor>`, `ID of the bucket used as the starting point for the query, excluding the bucket itself. Should be used for efficient pagination when working with large sets of data.`)
+    .option(`--cursorDirection <cursorDirection>`, `Direction of the cursor.`)
+    .option(`--orderType <orderType>`, `Order result by ASC or DESC order.`)
+    .action(actionRunner(storageListBuckets))
+
+storage
+    .command(`createBucket`)
+    .description(`Create a new storage bucket.`)
+    .requiredOption(`--bucketId <bucketId>`, `Unique Id. Choose your own unique ID or pass the string 'unique()' to auto generate it. 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(`--name <name>`, `Bucket name`)
+    .requiredOption(`--permission <permission>`, `Permissions type model to use for reading files in this bucket. You can use bucket-level permission set once on the bucket using the 'read' and 'write' params, or you can set file-level permission where each file read and write params will decide who has access to read and write to each file individually. [learn more about permissions](/docs/permissions) and get a full list of available permissions.`)
+    .option(`--read <read...>`, `An array of strings with read permissions. By default no user is granted with any read permissions. [learn more about permissions](/docs/permissions) and get a full list of available permissions.`)
+    .option(`--write <write...>`, `An array of strings with write permissions. By default no user is granted with any write permissions. [learn more about permissions](/docs/permissions) and get a full list of available permissions.`)
+    .option(`--enabled <enabled>`, `Is bucket enabled?`, parseBool)
+    .option(`--maximumFileSize <maximumFileSize>`, `Maximum file size allowed in bytes. Maximum allowed value is 30MB. For self-hosted setups you can change the max limit by changing the '_APP_STORAGE_LIMIT' environment variable. [Learn more about storage environment variables](docs/environment-variables#storage)`, parseInteger)
+    .option(`--allowedFileExtensions <allowedFileExtensions...>`, `Allowed file extensions`)
+    .option(`--encryption <encryption>`, `Is encryption enabled? For file size above 20MB encryption is skipped even if it's enabled`, parseBool)
+    .option(`--antivirus <antivirus>`, `Is virus scanning enabled? For file size above 20MB AntiVirus scanning is skipped even if it's enabled`, parseBool)
+    .action(actionRunner(storageCreateBucket))
+
+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.`)
+    .action(actionRunner(storageGetBucket))
+
+storage
+    .command(`updateBucket`)
+    .description(`Update a storage bucket by its unique ID.`)
+    .requiredOption(`--bucketId <bucketId>`, `Bucket unique ID.`)
+    .requiredOption(`--name <name>`, `Bucket name`)
+    .requiredOption(`--permission <permission>`, `Permissions type model to use for reading files in this bucket. You can use bucket-level permission set once on the bucket using the 'read' and 'write' params, or you can set file-level permission where each file read and write params will decide who has access to read and write to each file individually. [learn more about permissions](/docs/permissions) and get a full list of available permissions.`)
+    .option(`--read <read...>`, `An array of strings with read permissions. By default inherits the existing read permissions. [learn more about permissions](/docs/permissions) and get a full list of available permissions.`)
+    .option(`--write <write...>`, `An array of strings with write permissions. By default inherits the existing write permissions. [learn more about permissions](/docs/permissions) and get a full list of available permissions.`)
+    .option(`--enabled <enabled>`, `Is bucket enabled?`, parseBool)
+    .option(`--maximumFileSize <maximumFileSize>`, `Maximum file size allowed in bytes. Maximum allowed value is 30MB. For self hosted version you can change the limit by changing _APP_STORAGE_LIMIT environment variable. [Learn more about storage environment variables](docs/environment-variables#storage)`, parseInteger)
+    .option(`--allowedFileExtensions <allowedFileExtensions...>`, `Allowed file extensions`)
+    .option(`--encryption <encryption>`, `Is encryption enabled? For file size above 20MB encryption is skipped even if it's enabled`, parseBool)
+    .option(`--antivirus <antivirus>`, `Is virus scanning enabled? For file size above 20MB AntiVirus scanning is skipped even if it's enabled`, parseBool)
+    .action(actionRunner(storageUpdateBucket))
+
+storage
+    .command(`deleteBucket`)
+    .description(`Delete a storage bucket by its unique ID.`)
+    .requiredOption(`--bucketId <bucketId>`, `Bucket unique ID.`)
+    .action(actionRunner(storageDeleteBucket))
+
+storage
+    .command(`listFiles`)
+    .description(`Get a list of all the user files. You can use the query params to filter your results. On admin mode, this endpoint will return a list of all of the project's files. [Learn more about different API modes](/docs/admin).`)
+    .requiredOption(`--bucketId <bucketId>`, `Storage bucket unique ID. You can create a new storage bucket using the Storage service [server integration](/docs/server/storage#createBucket).`)
+    .option(`--search <search>`, `Search term to filter your list results. Max length: 256 chars.`)
+    .option(`--limit <limit>`, `Maximum number of files to return in response. By default will return maximum 25 results. Maximum of 100 results allowed per request.`, parseInteger)
+    .option(`--offset <offset>`, `Offset value. The default value is 0. Use this param to manage pagination. [learn more about pagination](https://appwrite.io/docs/pagination)`, parseInteger)
+    .option(`--cursor <cursor>`, `ID of the file used as the starting point for the query, excluding the file itself. Should be used for efficient pagination when working with large sets of data. [learn more about pagination](https://appwrite.io/docs/pagination)`)
+    .option(`--cursorDirection <cursorDirection>`, `Direction of the cursor.`)
+    .option(`--orderType <orderType>`, `Order result by ASC or DESC order.`)
+    .action(actionRunner(storageListFiles))
+
+storage
+    .command(`createFile`)
+    .description(`Create a new file. Before using this route, you should create a new bucket resource using either a [server integration](/docs/server/database#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](/docs/server/storage#createBucket).`)
+    .requiredOption(`--fileId <fileId>`, `File ID. Choose your own unique ID or pass the string "unique()" to auto generate it. 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.`)
+    .option(`--read <read...>`, `An array of strings with read permissions. By default only the current user is granted with read permissions. [learn more about permissions](https://appwrite.io/docs/permissions) and get a full list of available permissions.`)
+    .option(`--write <write...>`, `An array of strings with write permissions. By default only the current user is granted with write permissions. [learn more about permissions](https://appwrite.io/docs/permissions) and get a full list of available permissions.`)
+    .action(actionRunner(storageCreateFile))
+
+storage
+    .command(`getFile`)
+    .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](/docs/server/storage#createBucket).`)
+    .requiredOption(`--fileId <fileId>`, `File ID.`)
+    .action(actionRunner(storageGetFile))
+
+storage
+    .command(`updateFile`)
+    .description(`Update a file by its unique ID. Only users with write permissions have access to update this resource.`)
+    .requiredOption(`--bucketId <bucketId>`, `Storage bucket unique ID. You can create a new storage bucket using the Storage service [server integration](/docs/server/storage#createBucket).`)
+    .requiredOption(`--fileId <fileId>`, `File unique ID.`)
+    .option(`--read <read...>`, `An array of strings with read permissions. By default no user is granted with any read permissions. [learn more about permissions](https://appwrite.io/docs/permissions) and get a full list of available permissions.`)
+    .option(`--write <write...>`, `An array of strings with write permissions. By default no user is granted with any write permissions. [learn more about permissions](https://appwrite.io/docs/permissions) and get a full list of available permissions.`)
+    .action(actionRunner(storageUpdateFile))
+
+storage
+    .command(`deleteFile`)
+    .description(`Delete a file by its unique ID. Only users with write permissions have access to delete this resource.`)
+    .requiredOption(`--bucketId <bucketId>`, `Storage bucket unique ID. You can create a new storage bucket using the Storage service [server integration](/docs/server/storage#createBucket).`)
+    .requiredOption(`--fileId <fileId>`, `File ID.`)
+    .action(actionRunner(storageDeleteFile))
+
+storage
+    .command(`getFileDownload`)
+    .description(`Get a file content by its unique ID. The endpoint response return with a 'Content-Disposition: attachment' header that tells the browser to start downloading the file to user downloads directory.`)
+    .requiredOption(`--bucketId <bucketId>`, `Storage bucket ID. You can create a new storage bucket using the Storage service [server integration](/docs/server/storage#createBucket).`)
+    .requiredOption(`--fileId <fileId>`, `File ID.`)
+    .requiredOption(`--destination <path>`, `output file path.`)
+    .action(actionRunner(storageGetFileDownload))
+
+storage
+    .command(`getFilePreview`)
+    .description(`Get a file preview image. Currently, this method supports preview for image files (jpg, png, and gif), other supported formats, like pdf, docs, slides, and spreadsheets, will return the file icon image. You can also pass query string arguments for cutting and resizing your preview image. Preview is supported only for image files smaller than 10MB.`)
+    .requiredOption(`--bucketId <bucketId>`, `Storage bucket unique ID. You can create a new storage bucket using the Storage service [server integration](/docs/server/storage#createBucket).`)
+    .requiredOption(`--fileId <fileId>`, `File ID`)
+    .option(`--width <width>`, `Resize preview image width, Pass an integer between 0 to 4000.`, parseInteger)
+    .option(`--height <height>`, `Resize preview image height, Pass an integer between 0 to 4000.`, parseInteger)
+    .option(`--gravity <gravity>`, `Image crop gravity. Can be one of center,top-left,top,top-right,left,right,bottom-left,bottom,bottom-right`)
+    .option(`--quality <quality>`, `Preview image quality. Pass an integer between 0 to 100. Defaults to 100.`, parseInteger)
+    .option(`--borderWidth <borderWidth>`, `Preview image border in pixels. Pass an integer between 0 to 100. Defaults to 0.`, parseInteger)
+    .option(`--borderColor <borderColor>`, `Preview image border color. Use a valid HEX color, no # is needed for prefix.`)
+    .option(`--borderRadius <borderRadius>`, `Preview image border radius in pixels. Pass an integer between 0 to 4000.`, parseInteger)
+    .option(`--opacity <opacity>`, `Preview image opacity. Only works with images having an alpha channel (like png). Pass a number between 0 to 1.`, parseInteger)
+    .option(`--rotation <rotation>`, `Preview image rotation in degrees. Pass an integer between -360 and 360.`, parseInteger)
+    .option(`--background <background>`, `Preview image background color. Only works with transparent images (png). Use a valid HEX color, no # is needed for prefix.`)
+    .option(`--output <output>`, `Output format type (jpeg, jpg, png, gif and webp).`)
+    .action(actionRunner(storageGetFilePreview))
+
+storage
+    .command(`getFileView`)
+    .description(`Get a file content by its unique ID. This endpoint is similar to the download method but returns with no  'Content-Disposition: attachment' header.`)
+    .requiredOption(`--bucketId <bucketId>`, `Storage bucket unique ID. You can create a new storage bucket using the Storage service [server integration](/docs/server/storage#createBucket).`)
+    .requiredOption(`--fileId <fileId>`, `File ID.`)
+    .requiredOption(`--destination <path>`, `output file path.`)
+    .action(actionRunner(storageGetFileView))
+
+storage
+    .command(`getUsage`)
+    .description(``)
+    .option(`--range <range>`, `Date range.`)
+    .action(actionRunner(storageGetUsage))
+
+storage
+    .command(`getBucketUsage`)
+    .description(``)
+    .requiredOption(`--bucketId <bucketId>`, `Bucket ID.`)
+    .option(`--range <range>`, `Date range.`)
+    .action(actionRunner(storageGetBucketUsage))
+
+
+module.exports = {
+    storage,
+    storageListBuckets,
+    storageCreateBucket,
+    storageGetBucket,
+    storageUpdateBucket,
+    storageDeleteBucket,
+    storageListFiles,
+    storageCreateFile,
+    storageGetFile,
+    storageUpdateFile,
+    storageDeleteFile,
+    storageGetFileDownload,
+    storageGetFilePreview,
+    storageGetFileView,
+    storageGetUsage,
+    storageGetBucketUsage
+};