@feralfile/cli 2.1.0 → 2.2.0

package/dist/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@feralfile/cli",
-    "version": "2.1.0",
+    "version": "2.2.0",
     "description": "CLI for building, signing, and playing DP-1 playlists of digital art on Feral File devices",
     "repository": {
         "type": "git",

package/dist/src/commands/device.js

@@ -11,6 +11,7 @@ const device_lookup_1 = require("../utilities/device-lookup");
 const device_normalize_1 = require("../utilities/device-normalize");
 const device_upsert_1 = require("../utilities/device-upsert");
 const device_default_1 = require("../utilities/device-default");
+const device_rename_1 = require("../utilities/device-rename");
 const config_files_1 = require("./helpers/config-files");
 const device_discovery_1 = require("./helpers/device-discovery");
 const prompt_1 = require("./helpers/prompt");
@@ -291,6 +292,50 @@ deviceCommand
         process.exit(1);
     }
 });
+deviceCommand
+    .command('rename')
+    .description('Rename a configured FF1 device (host, API key, and default status are untouched)')
+    .argument('<name>', 'Current device name or host')
+    .argument('<new-name>', 'New device name')
+    .action(async (name, newName) => {
+    try {
+        const configPath = await (0, config_files_1.resolveExistingConfigPath)();
+        if (!configPath) {
+            console.log(chalk_1.default.red('config.json not found'));
+            console.log(chalk_1.default.dim('Run: ff-cli setup'));
+            process.exit(1);
+        }
+        const config = await (0, config_files_1.readConfigFile)(configPath);
+        const existingDevices = config.ff1Devices?.devices || [];
+        if (existingDevices.length === 0) {
+            console.log(chalk_1.default.yellow('\nNo devices configured'));
+            console.log(chalk_1.default.dim('Run: ff-cli device add\n'));
+            process.exit(1);
+        }
+        let result;
+        try {
+            result = (0, device_rename_1.renameDevice)(existingDevices, name, newName);
+        }
+        catch (error) {
+            console.error(chalk_1.default.red(`\n${error.message}`));
+            const names = existingDevices.map((d) => d.name || d.host).join(', ');
+            console.log(chalk_1.default.dim(`Available devices: ${names}\n`));
+            process.exit(1);
+        }
+        if (result.unchanged) {
+            console.log(chalk_1.default.dim(`\n"${result.renamed.name}" is already named that.\n`));
+            return;
+        }
+        config.ff1Devices = { devices: result.devices };
+        await fs_1.promises.writeFile(configPath, `${JSON.stringify(config, null, 2)}\n`, 'utf-8');
+        const from = result.previousName || result.renamed.host;
+        console.log(chalk_1.default.green(`\nRenamed device: ${from} → ${result.renamed.name}\n`));
+    }
+    catch (error) {
+        console.error(chalk_1.default.red('\nError:'), error.message);
+        process.exit(1);
+    }
+});
 deviceCommand
     .command('default')
     .description('Set the default FF1 device (reorders so this device is used when -d is omitted)')

package/dist/src/utilities/device-rename.js

@@ -0,0 +1,50 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.renameDevice = renameDevice;
+const device_normalize_1 = require("./device-normalize");
+/**
+ * Rename a configured device without touching host, apiKey, topicID, or list
+ * position — a pure config edit that needs no discovery or network access
+ * (unlike `device add`, whose update path requires the host or mDNS).
+ *
+ * Matches by name (case-insensitive) or by host URL, mirroring `device remove`
+ * so unnamed legacy entries can still be targeted (renaming gives them a name
+ * for the first time).
+ *
+ * @throws {Error} When no device matches the identifier, the new name is
+ *   empty, or the new name is already used by a different device
+ *   (case-insensitive, so lookups elsewhere stay unambiguous).
+ */
+function renameDevice(devices, identifier, newName) {
+    const trimmedName = newName.trim();
+    if (!trimmedName) {
+        throw new Error('New device name must not be empty');
+    }
+    const normalizedArg = identifier.toLowerCase();
+    let normalizedArgHost = '';
+    try {
+        normalizedArgHost = (0, device_normalize_1.normalizeDeviceHost)(identifier).toLowerCase();
+    }
+    catch {
+        // not a valid URL — host matching will not apply
+    }
+    const index = devices.findIndex((d) => (d.name && d.name.toLowerCase() === normalizedArg) ||
+        (d.host && d.host.toLowerCase() === normalizedArg) ||
+        (normalizedArgHost &&
+            d.host &&
+            (0, device_normalize_1.normalizeDeviceHost)(d.host).toLowerCase() === normalizedArgHost));
+    if (index === -1) {
+        throw new Error(`Device "${identifier}" not found`);
+    }
+    const conflict = devices.find((d, i) => i !== index && d.name && d.name.toLowerCase() === trimmedName.toLowerCase());
+    if (conflict) {
+        throw new Error(`Device name "${trimmedName}" is already used by another device (${conflict.host})`);
+    }
+    const target = devices[index];
+    if (target.name === trimmedName) {
+        return { devices: [...devices], renamed: target, previousName: target.name, unchanged: true };
+    }
+    const updated = [...devices];
+    updated[index] = { ...target, name: trimmedName };
+    return { devices: updated, renamed: updated[index], previousName: target.name, unchanged: false };
+}

package/docs/CONFIGURATION.md

@@ -139,6 +139,7 @@ You can also manage devices independently with:
   non-interactively with `--host`, `--name`, and the physical `--id` shown in
   Feral File mobile. Manual devices need the ID before relayer pairing.
 - `ff-cli device list` – Show all configured devices.
+- `ff-cli device rename <name> <new-name>` – Rename a device without touching its host, API key, or default status. Works offline; also accepts the host URL as the identifier, so unnamed legacy entries can be given a name.
 - `ff-cli device remove <name>` – Remove a device by name.
 - `ff-cli device default <name>` – Promote a device to the top of the list so it is used when `-d` is omitted.
 - `ff-cli device pair [name]` – Display a one-time handoff code and key-bound

package/docs/EXAMPLES.md

@@ -385,6 +385,9 @@ npm run dev -- device add
 # Add a device non-interactively
 npm run dev -- device add --host 192.168.1.100 --name kitchen
 
+# Rename a device (host, API key, and default status are untouched)
+npm run dev -- device rename kitchen gallery
+
 # Remove a device by name
 npm run dev -- device remove kitchen
 

package/docs/README.md

@@ -120,6 +120,7 @@ Both paths run the same deterministic pipeline: fetch metadata, assemble a DP-1
 - `device add` – Add a device with mDNS or manual `--host`, `--name`, and `--id`
   - Options: `--host <host>`, `--name <name>`, `--id <id>`
 - `device pair [name]` – Securely receive relayer access from Feral File mobile
+- `device rename <name> <new-name>` – Rename a configured FF1 device (host, API key, and default status are untouched)
 - `device remove <name>` – Remove a configured FF1 device
 - `device default <name>` – Set the default FF1 device (used when `-d` is omitted)
 - `config <init|show|validate>` – Manage configuration
@@ -274,6 +275,9 @@ ff-cli device add
 # Add a device non-interactively
 ff-cli device add --host 192.168.1.100 --name kitchen --id FF1-XXXXXXXX
 
+# Rename a device (host, API key, and default status are untouched)
+ff-cli device rename kitchen gallery
+
 # Remove a device by name
 ff-cli device remove kitchen
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@feralfile/cli",
-  "version": "2.1.0",
+  "version": "2.2.0",
   "description": "CLI for building, signing, and playing DP-1 playlists of digital art on Feral File devices",
   "repository": {
     "type": "git",