@chabokan.net/cli 0.8.10 → 0.9.0

package/dist/commands/service/domain/remove.d.ts

@@ -0,0 +1,15 @@
+import Command from "../../../base.js";
+export default class ServiceDomainRemove extends Command {
+    static description: string;
+    static examples: {
+        description: string;
+        command: string;
+    }[];
+    static flags: {
+        service: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        domain: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        help: import("@oclif/core/interfaces").BooleanFlag<void>;
+    };
+    run(): Promise<void>;
+    send_request(cli: Command, selected_service: string, domain_name: string): Promise<void>;
+}

package/dist/commands/service/domain/remove.js

@@ -0,0 +1,72 @@
+import { Flags } from '@oclif/core';
+import Command from "../../../base.js";
+import { handleApiError, logErrorDetails } from "../../../helper.js";
+import * as ui from "../../../ui.js";
+import inquirer from 'inquirer';
+import axios from "axios";
+export default class ServiceDomainRemove extends Command {
+    static description = 'disconnect a custom domain from a service';
+    static examples = [
+        {
+            description: 'Pick the service and enter the domain interactively',
+            command: '<%= config.bin %> service domain remove',
+        },
+        {
+            description: 'Disconnect a domain in one non-interactive command',
+            command: '<%= config.bin %> service domain remove -s my-app -d www.example.com',
+        },
+    ];
+    static flags = {
+        ...Command.flags,
+        service: Flags.string({ char: 's', description: 'name of the service the domain is connected to' }),
+        domain: Flags.string({ char: 'd', description: 'domain name to disconnect' }),
+    };
+    async run() {
+        const { flags } = await this.parse(ServiceDomainRemove);
+        const cli = this;
+        await this.init_run();
+        if (!(await this.require_login())) {
+            return;
+        }
+        const selected_service = await this.select_service(flags.service, {}, 'Disconnect Domain');
+        if (!selected_service) {
+            return;
+        }
+        let domain_name = flags.domain;
+        if (!domain_name) {
+            ({ domain_name } = await inquirer.prompt({
+                type: 'input',
+                message: 'Domain name:',
+                name: 'domain_name',
+                validate(input) {
+                    return input.trim().length > 0 || 'Domain name cannot be empty';
+                },
+            }));
+        }
+        await this.send_request(cli, selected_service, domain_name.trim());
+    }
+    async send_request(cli, selected_service, domain_name) {
+        try {
+            const { data } = await axios.delete(`services/${selected_service}/domain/${domain_name}/`, this.axiosConfig);
+            if (data?.success === false) {
+                cli.log(ui.error(`Could not disconnect ${ui.value(domain_name)}. ${data.message || 'Check the domain name and try again.'}`));
+                return;
+            }
+            cli.log(ui.success(`Disconnected ${ui.value(domain_name)} from ${ui.value(selected_service)}.`));
+        }
+        catch (error) {
+            const errorInfo = handleApiError(error, 'Failed to disconnect domain.', {
+                endpoint: `services/${selected_service}/domain/${domain_name}/`,
+                serviceName: selected_service,
+                operation: 'Disconnect Domain'
+            });
+            if (errorInfo.status === 404) {
+                cli.log(ui.error(`Domain ${ui.value(domain_name)} was not found on ${ui.value(selected_service)}.`));
+            }
+            else {
+                cli.log(ui.error(errorInfo.message));
+            }
+            logErrorDetails(errorInfo, cli);
+        }
+    }
+}

package/dist/commands/service/list.d.ts

@@ -1,8 +1,12 @@
 import Command from "../../base.js";
 export default class ServiceList extends Command {
     static description: string;
+    static examples: {
+        description: string;
+        command: string;
+    }[];
     static flags: {
-        help: import("@oclif/core/lib/interfaces/parser.js").BooleanFlag<void>;
+        help: import("@oclif/core/interfaces").BooleanFlag<void>;
     };
     run(): Promise<void>;
 }

package/dist/commands/service/list.js

@@ -1,32 +1,53 @@
 import Command from "../../base.js";
-import { ux } from "@oclif/core";
+import { printTable } from "@oclif/table";
+import * as ui from "../../ui.js";
+import { handleApiError, logErrorDetails } from "../../helper.js";
 export default class ServiceList extends Command {
-    static description = "show account services list";
+    static description = "list the services on your account";
+    static examples = [
+        {
+            description: 'List every service on the active account',
+            command: '<%= config.bin %> service list',
+        },
+        {
+            description: 'Switch account first, then list that account’s services',
+            command: '<%= config.bin %> account use -u me@example.com && <%= config.bin %> service list',
+        },
+    ];
     static flags = {
         ...Command.flags,
     };
     async run() {
-        const { args, flags } = await this.parse(ServiceList);
+        await this.parse(ServiceList);
         const cli = this;
-        await this.init_run();
-        const config_json = await this.read_config();
-        let all_services = await this.get_services();
-        if (all_services.length > 0) {
-            const services_data = all_services.map((service) => {
-                // const shamshiate = shamsi.gregorianToJalali(
-                //   new Date(project.created)
-                // );
-                return {
-                    Name: service.name,
-                };
+        try {
+            await this.init_run();
+            if (!(await this.require_login())) {
+                return;
+            }
+            const all_services = await this.get_services();
+            if (all_services.length === 0) {
+                cli.log(ui.info('You have no services yet.'));
+                cli.log(ui.hint('Create one at https://hub.chabokan.net, then come back here'));
+                return;
+            }
+            const services_data = all_services.map((service) => ({
+                Service: service.value,
+                Platform: service.platform,
+            }));
+            printTable({
+                data: services_data,
+                columns: ["Service", "Platform"],
             });
-            ux.table(services_data, {
-                Name: {},
-            }, flags);
+            cli.log(ui.hint(`Act on one with ${ui.cmd('chabok service logs -s <name>')}, ${ui.cmd('restart')}, ${ui.cmd('stop')} …`));
         }
-        else {
-            cli.log("first you should create service");
-            return;
+        catch (error) {
+            const errorInfo = handleApiError(error, 'Failed to fetch services list.', {
+                endpoint: 'services/',
+                operation: 'List Services'
+            });
+            cli.log(ui.error(errorInfo.message));
+            logErrorDetails(errorInfo, cli);
         }
     }
 }

package/dist/commands/service/logs.d.ts

@@ -1,10 +1,14 @@
 import Command from "../../base.js";
 export default class ServiceLogs extends Command {
     static description: string;
+    static examples: {
+        description: string;
+        command: string;
+    }[];
     static flags: {
-        service: import("@oclif/core/lib/interfaces/parser.js").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces/parser.js").CustomOptions>;
-        help: import("@oclif/core/lib/interfaces/parser.js").BooleanFlag<void>;
+        service: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        help: import("@oclif/core/interfaces").BooleanFlag<void>;
     };
     run(): Promise<void>;
-    send_request(cli: any, selected_service: any): Promise<void>;
+    send_request(cli: Command, selected_service: string): Promise<void>;
 }

package/dist/commands/service/logs.js

@@ -1,59 +1,71 @@
 import { Flags } from '@oclif/core';
 import Command from "../../base.js";
-import { isEmptyObject } from "../../helper.js";
-import chalk from "chalk";
-import inquirer from 'inquirer';
+import { handleApiError, logErrorDetails } from "../../helper.js";
+import * as ui from "../../ui.js";
 import axios from "axios";
 export default class ServiceLogs extends Command {
-    static description = 'read latest logs from service';
+    static description = 'read the latest logs from a service';
+    static examples = [
+        {
+            description: 'Pick a service from an interactive list',
+            command: '<%= config.bin %> service logs',
+        },
+        {
+            description: 'Read logs for a specific service',
+            command: '<%= config.bin %> service logs --service my-app',
+        },
+        {
+            description: 'Search the logs for errors',
+            command: '<%= config.bin %> service logs -s my-app | grep -i error',
+        },
+        {
+            description: 'Save the logs to a file',
+            command: '<%= config.bin %> service logs -s my-app > my-app.log',
+        },
+    ];
     static flags = {
         ...Command.flags,
-        service: Flags.string({ char: 's', description: 'service name' }),
+        service: Flags.string({ char: 's', description: 'name of the service to read logs from' }),
     };
     async run() {
-        const { args, flags } = await this.parse(ServiceLogs);
+        const { flags } = await this.parse(ServiceLogs);
         const cli = this;
         await this.init_run();
-        const config_json = await this.read_config();
-        let selected_service = flags.service;
-        if (isEmptyObject(config_json.users)) {
-            cli.log(`${chalk.red('[Error]')} first you should login!`);
+        if (!(await this.require_login())) {
             return;
         }
-        if (!flags.service) {
-            let all_services = await this.get_services();
-            if (all_services.length > 0) {
-                let { service } = await inquirer.prompt({
-                    type: 'list',
-                    message: 'Please select a service:',
-                    name: 'service',
-                    choices: all_services
-                });
-                selected_service = service;
-            }
-            else {
-                cli.log("first you should create service");
-                return;
-            }
+        const selected_service = await this.select_service(flags.service, {}, 'Fetch Logs');
+        if (!selected_service) {
+            return;
         }
         await this.send_request(cli, selected_service);
     }
     async send_request(cli, selected_service) {
         try {
-            if (selected_service) {
-                const { data } = await axios.get("services/" + selected_service + "/logs/", this.axiosConfig);
-                if (data.success) {
-                    cli.log(data.logs);
-                }
+            const { data } = await axios.get(`services/${selected_service}/logs/`, this.axiosConfig);
+            if (data.success && data.logs) {
+                // Logs go out verbatim so they stay pipeable into grep, tee and friends.
+                cli.log(data.logs);
+            }
+            else {
+                cli.log(ui.info(`No logs yet for ${ui.value(selected_service)}.`));
+                cli.log(ui.hint('A service that has just started may take a moment to produce output'));
             }
         }
-        catch (e) {
-            if (e.response.status == 404) {
-                cli.log(chalk.blue("Selected Service Not Founded."));
+        catch (error) {
+            const errorInfo = handleApiError(error, 'Failed to fetch service logs.', {
+                endpoint: `services/${selected_service}/logs/`,
+                serviceName: selected_service,
+                operation: 'Fetch Logs'
+            });
+            if (errorInfo.status === 404) {
+                cli.log(ui.error(`Service ${ui.value(selected_service)} was not found.`));
+                cli.log(ui.hint(`Check the available names with ${ui.cmd('chabok service list')}`));
             }
             else {
-                console.log(e.data);
+                cli.log(ui.error(errorInfo.message));
             }
+            logErrorDetails(errorInfo, cli);
         }
     }
 }

package/dist/commands/service/resize.d.ts

@@ -1,13 +1,17 @@
 import Command from "../../base.js";
 export default class ServiceResize extends Command {
     static description: string;
+    static examples: {
+        description: string;
+        command: string;
+    }[];
     static flags: {
-        service: import("@oclif/core/lib/interfaces/parser.js").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces/parser.js").CustomOptions>;
-        ram: import("@oclif/core/lib/interfaces/parser.js").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces/parser.js").CustomOptions>;
-        cpu: import("@oclif/core/lib/interfaces/parser.js").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces/parser.js").CustomOptions>;
-        disk: import("@oclif/core/lib/interfaces/parser.js").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces/parser.js").CustomOptions>;
-        help: import("@oclif/core/lib/interfaces/parser.js").BooleanFlag<void>;
+        service: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        ram: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        cpu: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        disk: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        help: import("@oclif/core/interfaces").BooleanFlag<void>;
     };
     run(): Promise<void>;
-    send_request(cli: any, selected_service: any, ram: any, cpu: any, disk: any): Promise<void>;
+    send_request(cli: Command, selected_service: string, ram: string, cpu: string, disk: string): Promise<void>;
 }

package/dist/commands/service/resize.js

@@ -1,130 +1,152 @@
 import { Flags } from '@oclif/core';
 import Command from "../../base.js";
-import { isEmptyObject } from "../../helper.js";
-import chalk from "chalk";
+import { handleApiError, logErrorDetails } from "../../helper.js";
+import * as ui from "../../ui.js";
 import inquirer from 'inquirer';
 import axios from "axios";
 export default class ServiceResize extends Command {
-    static description = 'resize a service';
+    static description = 'change the RAM, CPU and disk allocated to a service';
+    static examples = [
+        {
+            description: 'Choose the service and every resource interactively',
+            command: '<%= config.bin %> service resize',
+        },
+        {
+            description: 'Resize a service in one non-interactive command',
+            command: '<%= config.bin %> service resize -s my-app --ram 2 --cpu 1 --disk 10',
+        },
+        {
+            description: 'Set only the RAM and pick the rest from the prompts',
+            command: '<%= config.bin %> service resize -s my-app --ram 4',
+        },
+    ];
     static flags = {
         ...Command.flags,
-        service: Flags.string({ char: 's', description: 'service name' }),
-        ram: Flags.string({ char: 'r', description: 'RAM' }),
-        cpu: Flags.string({ char: 'c', description: 'CPU' }),
-        disk: Flags.string({ char: 'd', description: 'DISK' }),
+        service: Flags.string({ char: 's', description: 'name of the service to resize' }),
+        ram: Flags.string({ char: 'r', description: 'RAM in GB, in steps of 0.5 (e.g. 0.5, 1, 2)' }),
+        cpu: Flags.string({ char: 'c', description: 'CPU cores, in steps of 0.5 (e.g. 0.5, 1, 2)' }),
+        disk: Flags.string({ char: 'd', description: 'disk in GB, in steps of 5 (e.g. 5, 10, 30)' }),
     };
     async run() {
-        const { args, flags } = await this.parse(ServiceResize);
+        const { flags } = await this.parse(ServiceResize);
         const cli = this;
         await this.init_run();
-        const config_json = await this.read_config();
-        let selected_service = flags.service;
         let selected_ram = flags.ram;
         let selected_cpu = flags.cpu;
         let selected_disk = flags.disk;
-        if (isEmptyObject(config_json.users)) {
-            cli.log(`${chalk.red('[Error]')} first you should login!`);
+        if (!(await this.require_login())) {
             return;
         }
+        const selected_service = await this.select_service(flags.service, { 'not_status': 'pending', 'has_custom_plan': 'true' }, 'Resize Service');
         if (!selected_service) {
-            let all_services = await this.get_services({ 'not_status': 'pending', 'has_custom_plan': 'true' });
-            if (all_services) {
-                let { service } = await inquirer.prompt({
-                    type: 'list',
-                    message: 'Please select a service:',
-                    name: 'service',
-                    choices: all_services
-                });
-                selected_service = service;
-            }
+            return;
         }
         if (!selected_ram) {
-            let { ram } = await inquirer.prompt({
-                type: 'list',
-                message: 'Please select service ram:',
+            const { ram } = await inquirer.prompt({
+                type: 'select',
+                message: 'RAM:',
                 name: 'ram',
                 choices: [
-                    { value: "0.5", name: "0.5G" },
-                    { value: "1", name: "1G" },
-                    { value: "2", name: "2G" },
-                    { value: "4", name: "4G" },
-                    { value: "6", name: "6G" },
-                    { value: "8", name: "8G" },
+                    { value: "0.5", name: "0.5 GB" },
+                    { value: "1", name: "1 GB" },
+                    { value: "2", name: "2 GB" },
+                    { value: "4", name: "4 GB" },
+                    { value: "6", name: "6 GB" },
+                    { value: "8", name: "8 GB" },
                 ]
             });
             selected_ram = ram;
         }
         if (!selected_cpu) {
-            let { cpu } = await inquirer.prompt({
-                type: 'list',
-                message: 'Please select service cpu:',
+            const { cpu } = await inquirer.prompt({
+                type: 'select',
+                message: 'CPU:',
                 name: 'cpu',
                 choices: [
-                    { value: "0.5", name: "0.5 Core" },
-                    { value: "1", name: "1 Core" },
-                    { value: "2", name: "2 Core" },
-                    { value: "3", name: "3 Core" },
-                    { value: "4", name: "4 Core" },
+                    { value: "0.5", name: "0.5 core" },
+                    { value: "1", name: "1 core" },
+                    { value: "2", name: "2 cores" },
+                    { value: "3", name: "3 cores" },
+                    { value: "4", name: "4 cores" },
                 ]
             });
             selected_cpu = cpu;
         }
         if (!selected_disk) {
-            let { disk } = await inquirer.prompt({
-                type: 'list',
-                message: 'Please select service disk:',
+            const { disk } = await inquirer.prompt({
+                type: 'select',
+                message: 'Disk:',
                 name: 'disk',
                 choices: [
-                    { value: "5", name: "5G" },
-                    { value: "10", name: "10G" },
-                    { value: "15", name: "15G" },
-                    { value: "30", name: "30G" },
-                    { value: "40", name: "40G" },
-                    { value: "50", name: "50G" },
+                    { value: "5", name: "5 GB" },
+                    { value: "10", name: "10 GB" },
+                    { value: "15", name: "15 GB" },
+                    { value: "30", name: "30 GB" },
+                    { value: "40", name: "40 GB" },
+                    { value: "50", name: "50 GB" },
                 ]
             });
             selected_disk = disk;
         }
+        if (!selected_ram || !selected_cpu || !selected_disk) {
+            cli.log(ui.error('RAM, CPU and disk are all required.'));
+            return;
+        }
         let wrong_value = false;
-        if (selected_ram % 0.5 != 0) {
-            cli.log(`${chalk.red('[Error]')} ram amount should coefficient of 0.5`);
+        const ramNum = Number.parseFloat(selected_ram);
+        const cpuNum = Number.parseFloat(selected_cpu);
+        const diskNum = Number.parseFloat(selected_disk);
+        if (Number.isNaN(ramNum) || ramNum % 0.5 !== 0) {
+            cli.log(ui.error(`RAM must be a multiple of 0.5 GB, got ${ui.value(selected_ram)}.`));
             wrong_value = true;
         }
-        if (selected_cpu % 0.5 != 0) {
-            cli.log(`${chalk.red('[Error]')} cpu amount should coefficient of 0.5`);
+        if (Number.isNaN(cpuNum) || cpuNum % 0.5 !== 0) {
+            cli.log(ui.error(`CPU must be a multiple of 0.5 cores, got ${ui.value(selected_cpu)}.`));
             wrong_value = true;
         }
-        if (selected_disk % 5 != 0) {
-            cli.log(`${chalk.red('[Error]')} disk amount should coefficient of 5`);
+        if (Number.isNaN(diskNum) || diskNum % 5 !== 0) {
+            cli.log(ui.error(`Disk must be a multiple of 5 GB, got ${ui.value(selected_disk)}.`));
             wrong_value = true;
         }
-        if (selected_service && selected_ram && selected_cpu && selected_disk && !wrong_value) {
-            await this.send_request(cli, selected_service, selected_ram, selected_cpu, selected_disk);
+        if (wrong_value) {
+            cli.log(ui.hint(`Example: ${ui.cmd(`chabok service resize -s ${selected_service} --ram 2 --cpu 1 --disk 10`)}`));
+            return;
         }
+        await this.send_request(cli, selected_service, selected_ram, selected_cpu, selected_disk);
     }
     async send_request(cli, selected_service, ram, cpu, disk) {
         try {
-            if (selected_service) {
-                const { data } = await axios.post("services/" + selected_service + "/resize/", {
-                    "ram": ram,
-                    "cpu": cpu,
-                    "disk": disk,
-                }, this.axiosConfig);
-                if (data.success) {
-                    cli.log(`${chalk.green('[Success]')} service resized successfully.`);
-                }
-                else {
-                    cli.log(`${chalk.red('[Error]')} some problem in resize.`);
-                }
+            const { data } = await axios.post(`services/${selected_service}/resize/`, {
+                ram,
+                cpu,
+                disk,
+            }, this.axiosConfig);
+            if (data.success) {
+                cli.log(ui.success(`Service ${ui.value(selected_service)} resized to ${ui.value(`${ram} GB RAM`)}, ${ui.value(`${cpu} CPU`)}, ${ui.value(`${disk} GB disk`)}.`));
+                cli.log(ui.hint(`Restart it to apply the new limits: ${ui.cmd(`chabok service restart -s ${selected_service}`)}`));
+            }
+            else {
+                cli.log(ui.error(`Could not resize ${ui.value(selected_service)}. ${data.message || 'Check the resource values and try again.'}`));
             }
         }
-        catch (e) {
-            if (e.response.status == 404) {
-                cli.log(chalk.blue("Selected Service Not Founded."));
+        catch (error) {
+            const errorInfo = handleApiError(error, 'Failed to resize service.', {
+                endpoint: `services/${selected_service}/resize/`,
+                serviceName: selected_service,
+                operation: 'Resize Service'
+            });
+            if (errorInfo.status === 404) {
+                cli.log(ui.error(`Service ${ui.value(selected_service)} was not found.`));
+                cli.log(ui.hint(`Check the available names with ${ui.cmd('chabok service list')}`));
+            }
+            else if (errorInfo.status === 400 || errorInfo.status === 422) {
+                cli.log(ui.error(errorInfo.message));
+                cli.log(ui.hint('RAM and CPU go in steps of 0.5; disk goes in steps of 5'));
             }
             else {
-                console.log(e.data);
+                cli.log(ui.error(errorInfo.message));
             }
+            logErrorDetails(errorInfo, cli);
         }
     }
 }

package/dist/commands/service/restart.d.ts

@@ -1,10 +1,14 @@
 import Command from "../../base.js";
 export default class ServiceRestart extends Command {
     static description: string;
+    static examples: {
+        description: string;
+        command: string;
+    }[];
     static flags: {
-        service: import("@oclif/core/lib/interfaces/parser.js").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces/parser.js").CustomOptions>;
-        help: import("@oclif/core/lib/interfaces/parser.js").BooleanFlag<void>;
+        service: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        help: import("@oclif/core/interfaces").BooleanFlag<void>;
     };
     run(): Promise<void>;
-    send_request(cli: any, selected_service: any): Promise<void>;
+    send_request(cli: Command, selected_service: string): Promise<void>;
 }