@thinremote/thinr-cli 1.0.0-alpha.1

package/lib/resource.js

@@ -0,0 +1,124 @@
+import chalk from 'chalk';
+import { readConfig } from './config.js';
+import api from './api.js';
+
+/**
+ * Get device resource value
+ * @param {string} deviceId - Device ID to query
+ * @return {Promise<Object>} Resource value
+ */
+export async function getDeviceResources(deviceId) {
+    // Get configuration
+    const config = readConfig();
+
+    if (!config.token || !config.server || !config.username) {
+        throw new Error('Not configured. Run thinr without parameters to set up.');
+    }
+
+    try {
+        // Fetch resource value
+        const response = await api.get(
+            `/v3/users/${config.username}/devices/${deviceId}/resources`,
+        );
+
+        // Remove hidden resources for which the keys starting with '_'
+        const filtered = Object.fromEntries(
+            Object.entries(response.data).filter(([key]) => !key.startsWith('$'))
+        );
+
+        return filtered;
+    } catch (error) {
+        if (error.response) {
+            // The request was made and the server responded with a status code
+            if (error.response.status === 404) {
+                throw new Error(`Device not found: ${deviceId}`);
+            } else if (error.response.status === 401) {
+                throw new Error('Unauthorized. Your token may have expired. Please reconfigure.');
+            } else {
+                throw new Error(`Server error: ${error.response.status} ${error.response.statusText}`);
+            }
+        } else if (error.request) {
+            // The request was made but no response was received
+            throw new Error('No response from server. Please check your connection.');
+        } else {
+            // Something happened in setting up the request that triggered an Error
+            throw new Error(`Error: ${error.message}`);
+        }
+    }
+
+}
+
+/**
+ * Execute a resource on a device
+ */
+export async function executeDeviceResource(deviceId, resourceId, inputs) {
+    // Get configuration
+    const config = readConfig();
+
+    if (!config.token || !config.server || !config.username) {
+        throw new Error('Not configured. Run thinr without parameters to set up.');
+    }
+
+    try {
+        // Execute resource
+        const response = await api.post(
+            `/v3/users/${config.username}/devices/${deviceId}/resources/${resourceId}`,
+            inputs,
+        );
+
+        return response.data;
+    } catch (error) {
+        if (error.response) {
+            // The request was made and the server responded with a status code
+            if (error.response.status === 404) {
+                throw new Error(`Resource not found: ${resourceId} on device ${deviceId}`);
+            } else if (error.response.status === 401) {
+                throw new Error('Unauthorized. Your token may have expired. Please reconfigure.');
+            } else {
+                throw new Error(`Server error: ${error.response.status} ${error.response.statusText}`);
+            }
+        } else if (error.request) {
+            // The request was made but no response was received
+            throw new Error('No response from server. Please check your connection.');
+        } else {
+            // Something happened in setting up the request that triggered an Error
+            throw new Error(`Error: ${error.message}`);
+        }
+    }
+}
+
+/**
+ * Format device resources for display
+ * @param {string} deviceId - Device ID
+ * @param {Object} resources - Resources data from API
+ * @return {string} Formatted resources
+ */
+export function formatDeviceResources(deviceId, resources) {
+    let formattedResources = `\nResources for device ${chalk.cyan(deviceId)}:\n`;
+
+    //
+    if (resources && Object.keys(resources).length > 0) {
+        Object.keys(resources).forEach(key => {
+            formattedResources += `- ${chalk.green(key)}: ${chalk.blue(getResourceType(resources[key]))}\n`;
+        });
+    } else {
+        formattedResources += chalk.yellow('No resources found for this device.\n');
+    }
+
+    return formattedResources;
+}
+
+function getResourceType(value) {
+    switch (value.fn) {
+        case 1:
+            return "no parameters";
+        case 2:
+            return "input";
+        case 3:
+            return "output";
+        case 4:
+            return "input/output";
+        default:
+            return 'unknown';
+    }
+}

package/lib/status.js

@@ -0,0 +1,96 @@
+import chalk from 'chalk';
+import { readConfig } from './config.js';
+import api from './api.js';
+
+/**
+ * Get device status
+ * @param {string} deviceId - Device ID to check
+ * @returns {Promise<Object>} Status information
+ */
+export async function getDeviceStatus(deviceId) {
+    // Get configuration
+    const config = readConfig();
+
+    if (!config.token || !config.server || !config.username) {
+        throw new Error('Not configured. Run thinr without parameters to set up.');
+    }
+
+    try {
+        // Fetch device status
+        const response = await api.get(
+            `/v1/users/${config.username}/devices/${deviceId}/stats`,
+        );
+
+        return response.data;
+    } catch (error) {
+        if (error.response) {
+            // The request was made and the server responded with a status code
+            // that falls out of the range of 2xx
+            if (error.response.status === 404) {
+                throw new Error(`Device not found: ${deviceId}`);
+            } else if (error.response.status === 401) {
+                throw new Error('Unauthorized. Your token may have expired. Please reconfigure.');
+            } else {
+                throw new Error(`Server error: ${error.response.status} ${error.response.statusText}`);
+            }
+        } else if (error.request) {
+            // The request was made but no response was received
+            throw new Error('No response from server. Please check your connection.');
+        } else {
+            // Something happened in setting up the request that triggered an Error
+            throw new Error(`Error: ${error.message}`);
+        }
+    }
+}
+
+/**
+ * Format device status data for display
+ * @param {string} deviceId - Device ID
+ * @param {Object} status - Status data from API
+ * @returns {string} Formatted status
+ */
+export function formatDeviceStatus(deviceId, status) {
+    const connectedStatus = status.connected ?
+        chalk.green('● Online') :
+        chalk.red('○ Offline');
+
+    // Format connected time
+    let connectedTime = '';
+    if (status.connected && status.connected_ts) {
+        const now = new Date().getTime();
+        const connectedSince = new Date(status.connected_ts).getTime();
+        const diffSeconds = Math.floor((now - connectedSince) / 1000);
+
+        if (diffSeconds < 60) {
+            connectedTime = `for ${diffSeconds} seconds`;
+        } else if (diffSeconds < 3600) {
+            connectedTime = `for ${Math.floor(diffSeconds / 60)} minutes`;
+        } else if (diffSeconds < 86400) {
+            connectedTime = `for ${Math.floor(diffSeconds / 3600)} hours`;
+        } else {
+            connectedTime = `for ${Math.floor(diffSeconds / 86400)} days`;
+        }
+    }
+
+    // Format data transfer
+    const rxMB = status.rx_bytes ? (status.rx_bytes / (1024 * 1024)).toFixed(2) : '0.00';
+    const txMB = status.tx_bytes ? (status.tx_bytes / (1024 * 1024)).toFixed(2) : '0.00';
+
+    // Build the output
+    let output = `
+${chalk.bold(`Device: ${deviceId}`)}
+Status: ${connectedStatus} ${connectedTime}
+`;
+
+    if (status.ip_address) {
+        output += `IP Address: ${status.ip_address}\n`;
+    }
+
+    output += `
+Data Transfer:
+  ↓ Received: ${rxMB} MB
+  ↑ Sent: ${txMB} MB
+`;
+
+    return output;
+}

package/package.json

@@ -0,0 +1,39 @@
+{
+  "name": "@thinremote/thinr-cli",
+  "version": "1.0.0-alpha.1",
+  "description": "CLI for ThinRemote - Remote management for IoT devices",
+  "main": "bin/thinr.js",
+  "bin": {
+    "thinr": "bin/thinr.js"
+  },
+  "scripts": {
+    "start": "node bin/thinr.js",
+    "test": "echo \"Error: no test specified\" && exit 1"
+  },
+  "keywords": [
+    "cli",
+    "iot",
+    "remote",
+    "management",
+    "thing",
+    "thinger"
+  ],
+  "author": "ThinRemote",
+  "license": "MIT",
+  "dependencies": {
+    "axios": "^1.10.0",
+    "chalk": "^5.4.1",
+    "commander": "^14.0.0",
+    "conf": "^14.0.0",
+    "figlet": "^1.8.1",
+    "@inquirer/prompts": "^7.5.3",
+    "jsonwebtoken": "^9.0.2",
+    "open": "^10.1.2",
+    "ora": "^8.2.0",
+    "ws": "^8.18.2"
+  },
+  "type": "module",
+  "engines": {
+    "node": ">=14.16"
+  }
+}