@formant/formant-cli 0.1.0 → 0.3.0

package/dist/base-command.js

@@ -1,5 +1,6 @@
 import { Command, Flags } from '@oclif/core';
 import { apiRequest } from './lib/api.js';
+import { login } from './lib/auth.js';
 /**
  * Abstract base command for all fcli commands.
  * Provides global --env flag, --json support, and authenticated API helpers.
@@ -47,6 +48,14 @@ export class BaseCommand extends Command {
     async api(target, path, options) {
         return apiRequest(this.env, target, path, options);
     }
+    /**
+     * Get the organization ID from the authenticated session.
+     * Uses the cached login token so no extra network call if already authenticated.
+     */
+    async getOrgId() {
+        const auth = await login(this.env);
+        return auth.organizationId;
+    }
     async catch(err) {
         throw err;
     }

package/dist/base-command.js.map

@@ -1 +1 @@
-{"version":3,"file":"base-command.js","sourceRoot":"","sources":["../src/base-command.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,OAAO,EAAE,KAAK,EAAa,MAAM,aAAa,CAAA;AAEtD,OAAO,EAAiB,UAAU,EAAC,MAAM,cAAc,CAAA;AAQvD;;;GAGG;AACH,MAAM,OAAgB,WAAsC,SAAQ,OAAO;IACzE,MAAM,CAAC,cAAc,GAAG,IAAI,CAAA;IAE5B,MAAM,CAAC,SAAS,GAAG;QACjB,GAAG,EAAE,KAAK,CAAC,OAAO,CAAC;YACjB,WAAW,EAAE,4BAA4B;YACzC,SAAS,EAAE,CAAC,OAAO,CAAC;YACpB,SAAS,EAAE,QAAQ;SACpB,CAAC;QACF,KAAK,EAAE,KAAK,CAAC,OAAO,CAAC;YACnB,WAAW,EAAE,8BAA8B;YAC3C,SAAS,EAAE,CAAC,KAAK,CAAC;YAClB,SAAS,EAAE,QAAQ;SACpB,CAAC;KACH,CAAA;IAES,KAAK,CAAmB;IACxB,IAAI,CAAkB;IAEhC,2DAA2D;IAC3D,IAAc,GAAG;QACf,IAAI,IAAI,CAAC,KAAK,CAAC,GAAG;YAAE,OAAO,KAAK,CAAA;QAChC,IAAI,IAAI,CAAC,KAAK,CAAC,KAAK;YAAE,OAAO,OAAO,CAAA;QACpC,OAAO,MAAM,CAAA;IACf,CAAC;IAEM,KAAK,CAAC,IAAI;QACf,MAAM,KAAK,CAAC,IAAI,EAAE,CAAA;QAClB,MAAM,EAAC,IAAI,EAAE,KAAK,EAAC,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC;YACrC,IAAI,EAAE,IAAI,CAAC,IAAI,CAAC,IAAI;YACpB,SAAS,EAAG,KAAK,CAAC,IAA2B,CAAC,SAAS;YACvD,cAAc,EAAE,IAAI,CAAC,IAAI,CAAC,cAAc;YACxC,KAAK,EAAE,IAAI,CAAC,IAAI,CAAC,KAAK;YACtB,MAAM,EAAE,IAAI,CAAC,IAAI,CAAC,MAAM;SACzB,CAAC,CAAA;QAEF,IAAI,CAAC,KAAK,GAAG,KAAyB,CAAA;QACtC,IAAI,CAAC,IAAI,GAAG,IAAuB,CAAA;IACrC,CAAC;IAED;;;OAGG;IACO,KAAK,CAAC,GAAG,CACjB,MAAiB,EACjB,IAAY,EACZ,OAAgH;QAEhH,OAAO,UAAU,CAAI,IAAI,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,CAAC,CAAA;IACvD,CAAC;IAEkB,KAAK,CAAC,KAAK,CAAC,GAAgC;QAC7D,MAAM,GAAG,CAAA;IACX,CAAC;IAED;;;OAGG;IACO,iBAAiB,CAAC,OAAe;QACzC,2EAA2E;QAC3E,IAAI,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,OAAO,CAAC,KAAK,CAAC,aAAa,CAAC,EAAE,CAAC;YAC1D,OAAO,OAAO,CAAA;QAChB,CAAC;QAED,2DAA2D;QAC3D,OAAO,GAAG,OAAO,YAAY,CAAA;IAC/B,CAAC"}
+{"version":3,"file":"base-command.js","sourceRoot":"","sources":["../src/base-command.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,OAAO,EAAE,KAAK,EAAa,MAAM,aAAa,CAAA;AAEtD,OAAO,EAAiB,UAAU,EAAC,MAAM,cAAc,CAAA;AACvD,OAAO,EAAC,KAAK,EAAC,MAAM,eAAe,CAAA;AAQnC;;;GAGG;AACH,MAAM,OAAgB,WAAsC,SAAQ,OAAO;IACzE,MAAM,CAAC,cAAc,GAAG,IAAI,CAAA;IAE5B,MAAM,CAAC,SAAS,GAAG;QACjB,GAAG,EAAE,KAAK,CAAC,OAAO,CAAC;YACjB,WAAW,EAAE,4BAA4B;YACzC,SAAS,EAAE,CAAC,OAAO,CAAC;YACpB,SAAS,EAAE,QAAQ;SACpB,CAAC;QACF,KAAK,EAAE,KAAK,CAAC,OAAO,CAAC;YACnB,WAAW,EAAE,8BAA8B;YAC3C,SAAS,EAAE,CAAC,KAAK,CAAC;YAClB,SAAS,EAAE,QAAQ;SACpB,CAAC;KACH,CAAA;IAES,KAAK,CAAmB;IACxB,IAAI,CAAkB;IAEhC,2DAA2D;IAC3D,IAAc,GAAG;QACf,IAAI,IAAI,CAAC,KAAK,CAAC,GAAG;YAAE,OAAO,KAAK,CAAA;QAChC,IAAI,IAAI,CAAC,KAAK,CAAC,KAAK;YAAE,OAAO,OAAO,CAAA;QACpC,OAAO,MAAM,CAAA;IACf,CAAC;IAEM,KAAK,CAAC,IAAI;QACf,MAAM,KAAK,CAAC,IAAI,EAAE,CAAA;QAClB,MAAM,EAAC,IAAI,EAAE,KAAK,EAAC,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC;YACrC,IAAI,EAAE,IAAI,CAAC,IAAI,CAAC,IAAI;YACpB,SAAS,EAAG,KAAK,CAAC,IAA2B,CAAC,SAAS;YACvD,cAAc,EAAE,IAAI,CAAC,IAAI,CAAC,cAAc;YACxC,KAAK,EAAE,IAAI,CAAC,IAAI,CAAC,KAAK;YACtB,MAAM,EAAE,IAAI,CAAC,IAAI,CAAC,MAAM;SACzB,CAAC,CAAA;QAEF,IAAI,CAAC,KAAK,GAAG,KAAyB,CAAA;QACtC,IAAI,CAAC,IAAI,GAAG,IAAuB,CAAA;IACrC,CAAC;IAED;;;OAGG;IACO,KAAK,CAAC,GAAG,CACjB,MAAiB,EACjB,IAAY,EACZ,OAAgH;QAEhH,OAAO,UAAU,CAAI,IAAI,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,CAAC,CAAA;IACvD,CAAC;IAED;;;OAGG;IACO,KAAK,CAAC,QAAQ;QACtB,MAAM,IAAI,GAAG,MAAM,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;QAClC,OAAO,IAAI,CAAC,cAAc,CAAA;IAC5B,CAAC;IAEkB,KAAK,CAAC,KAAK,CAAC,GAAgC;QAC7D,MAAM,GAAG,CAAA;IACX,CAAC;IAED;;;OAGG;IACO,iBAAiB,CAAC,OAAe;QACzC,2EAA2E;QAC3E,IAAI,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,OAAO,CAAC,KAAK,CAAC,aAAa,CAAC,EAAE,CAAC;YAC1D,OAAO,OAAO,CAAA;QAChB,CAAC;QAED,2DAA2D;QAC3D,OAAO,GAAG,OAAO,YAAY,CAAA;IAC/B,CAAC"}

package/dist/commands/devices/create.d.ts

@@ -0,0 +1,13 @@
+import { BaseCommand } from '../../base-command.js';
+export default class DevicesCreate extends BaseCommand<typeof DevicesCreate> {
+    static args: {
+        name: import("@oclif/core/interfaces").Arg<string, Record<string, unknown>>;
+    };
+    static description: string;
+    static examples: string[];
+    static flags: {
+        tag: import("@oclif/core/interfaces").OptionFlag<string[] | undefined, import("@oclif/core/interfaces").CustomOptions>;
+    };
+    static summary: string;
+    run(): Promise<Record<string, unknown>>;
+}

package/dist/commands/devices/create.js

@@ -0,0 +1,62 @@
+import { Args, Flags } from '@oclif/core';
+import { BaseCommand } from '../../base-command.js';
+import { formatDetail } from '../../lib/formatters.js';
+export default class DevicesCreate extends BaseCommand {
+    static args = {
+        name: Args.string({ description: 'Name for the new device', required: true }),
+    };
+    static description = `Create a new device in your fleet.
+
+The device is created as enabled by default. You can optionally specify tags.`;
+    static examples = [
+        '<%= config.bin %> devices create my-robot',
+        '<%= config.bin %> devices create my-robot --tag location=warehouse --tag env=prod',
+        '<%= config.bin %> devices create my-robot --json',
+    ];
+    static flags = {
+        tag: Flags.string({
+            char: 't',
+            description: 'Tag to apply (key=value), can be specified multiple times',
+            multiple: true,
+        }),
+    };
+    static summary = 'Create a new device';
+    async run() {
+        const body = {
+            enabled: true,
+            name: this.args.name,
+            type: 'default',
+        };
+        if (this.flags.tag && this.flags.tag.length > 0) {
+            const tags = {};
+            for (const t of this.flags.tag) {
+                const [key, ...rest] = t.split('=');
+                const value = rest.join('=');
+                if (!key || !value) {
+                    this.error(`Invalid tag format: "${t}". Use key=value.`);
+                }
+                tags[key] = value;
+            }
+            body.tags = tags;
+        }
+        const device = await this.api('admin', 'devices', {
+            body,
+            method: 'POST',
+        });
+        if (!this.jsonEnabled()) {
+            this.log(`\nDevice Created (${this.env}):\n`);
+            this.log(formatDetail(device, {
+                createdAt: 'Created',
+                enabled: 'Enabled',
+                id: 'ID',
+                name: 'Name',
+                organizationId: 'Organization',
+                tags: 'Tags',
+                type: 'Type',
+            }));
+            this.log('');
+        }
+        return device;
+    }
+}
+//# sourceMappingURL=create.js.map

package/dist/commands/devices/create.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"create.js","sourceRoot":"","sources":["../../../src/commands/devices/create.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,IAAI,EAAE,KAAK,EAAC,MAAM,aAAa,CAAA;AAEvC,OAAO,EAAC,WAAW,EAAC,MAAM,uBAAuB,CAAA;AACjD,OAAO,EAAC,YAAY,EAAC,MAAM,yBAAyB,CAAA;AAEpD,MAAM,CAAC,OAAO,OAAO,aAAc,SAAQ,WAAiC;IAC1E,MAAM,CAAU,IAAI,GAAG;QACrB,IAAI,EAAE,IAAI,CAAC,MAAM,CAAC,EAAC,WAAW,EAAE,yBAAyB,EAAE,QAAQ,EAAE,IAAI,EAAC,CAAC;KAC5E,CAAA;IAED,MAAM,CAAU,WAAW,GAAG;;8EAE8C,CAAA;IAE5E,MAAM,CAAU,QAAQ,GAAG;QACzB,2CAA2C;QAC3C,mFAAmF;QACnF,kDAAkD;KACnD,CAAA;IAED,MAAM,CAAU,KAAK,GAAG;QACtB,GAAG,EAAE,KAAK,CAAC,MAAM,CAAC;YAChB,IAAI,EAAE,GAAG;YACT,WAAW,EAAE,2DAA2D;YACxE,QAAQ,EAAE,IAAI;SACf,CAAC;KACH,CAAA;IAED,MAAM,CAAU,OAAO,GAAG,qBAAqB,CAAA;IAExC,KAAK,CAAC,GAAG;QACd,MAAM,IAAI,GAA4B;YACpC,OAAO,EAAE,IAAI;YACb,IAAI,EAAE,IAAI,CAAC,IAAI,CAAC,IAAI;YACpB,IAAI,EAAE,SAAS;SAChB,CAAA;QAED,IAAI,IAAI,CAAC,KAAK,CAAC,GAAG,IAAI,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAChD,MAAM,IAAI,GAA2B,EAAE,CAAA;YACvC,KAAK,MAAM,CAAC,IAAI,IAAI,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC;gBAC/B,MAAM,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAA;gBACnC,MAAM,KAAK,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;gBAC5B,IAAI,CAAC,GAAG,IAAI,CAAC,KAAK,EAAE,CAAC;oBACnB,IAAI,CAAC,KAAK,CAAC,wBAAwB,CAAC,mBAAmB,CAAC,CAAA;gBAC1D,CAAC;gBAED,IAAI,CAAC,GAAG,CAAC,GAAG,KAAK,CAAA;YACnB,CAAC;YAED,IAAI,CAAC,IAAI,GAAG,IAAI,CAAA;QAClB,CAAC;QAED,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,GAAG,CAA0B,OAAO,EAAE,SAAS,EAAE;YACzE,IAAI;YACJ,MAAM,EAAE,MAAM;SACf,CAAC,CAAA;QAEF,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,EAAE,CAAC;YACxB,IAAI,CAAC,GAAG,CAAC,qBAAqB,IAAI,CAAC,GAAG,MAAM,CAAC,CAAA;YAC7C,IAAI,CAAC,GAAG,CAAC,YAAY,CAAC,MAAM,EAAE;gBAC5B,SAAS,EAAE,SAAS;gBACpB,OAAO,EAAE,SAAS;gBAClB,EAAE,EAAE,IAAI;gBACR,IAAI,EAAE,MAAM;gBACZ,cAAc,EAAE,cAAc;gBAC9B,IAAI,EAAE,MAAM;gBACZ,IAAI,EAAE,MAAM;aACb,CAAC,CAAC,CAAA;YACH,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAA;QACd,CAAC;QAED,OAAO,MAAM,CAAA;IACf,CAAC"}

package/dist/commands/devices/delete.d.ts

@@ -0,0 +1,10 @@
+import { BaseCommand } from '../../base-command.js';
+export default class DevicesDelete extends BaseCommand<typeof DevicesDelete> {
+    static args: {
+        id: import("@oclif/core/interfaces").Arg<string, Record<string, unknown>>;
+    };
+    static description: string;
+    static examples: string[];
+    static summary: string;
+    run(): Promise<Record<string, unknown>>;
+}

package/dist/commands/devices/delete.js

@@ -0,0 +1,49 @@
+import { Args } from '@oclif/core';
+import { BaseCommand } from '../../base-command.js';
+import { formatDetail } from '../../lib/formatters.js';
+export default class DevicesDelete extends BaseCommand {
+    static args = {
+        id: Args.string({ description: 'Device ID (UUID)', required: true }),
+    };
+    static description = `Delete (disable) a device from your fleet.
+
+This performs a soft-delete by disabling the device. The device and its telemetry
+history are preserved but it will no longer appear in device listings.`;
+    static examples = [
+        '<%= config.bin %> devices delete <device-id>',
+        '<%= config.bin %> devices delete <device-id> --json',
+    ];
+    static summary = 'Delete (disable) a device';
+    async run() {
+        const deviceId = this.args.id;
+        // Fetch the device first to confirm it exists and get its name
+        const device = await this.api('admin', `devices/${deviceId}`, {
+            method: 'GET',
+        });
+        if (!device.enabled) {
+            if (!this.jsonEnabled()) {
+                this.log(`\nDevice "${device.name}" (${deviceId}) is already disabled.\n`);
+            }
+            return { ...device, alreadyDisabled: true };
+        }
+        // Soft-delete: disable the device
+        const updated = await this.api('admin', `devices/${deviceId}`, {
+            body: { enabled: false },
+            method: 'PATCH',
+        });
+        if (!this.jsonEnabled()) {
+            this.log(`\nDevice Deleted (${this.env}):\n`);
+            this.log(`  Device "${device.name}" (${deviceId}) has been disabled.\n`);
+            this.log(formatDetail(updated, {
+                enabled: 'Enabled',
+                id: 'ID',
+                name: 'Name',
+                type: 'Type',
+                updatedAt: 'Updated',
+            }));
+            this.log('');
+        }
+        return updated;
+    }
+}
+//# sourceMappingURL=delete.js.map

package/dist/commands/devices/delete.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"delete.js","sourceRoot":"","sources":["../../../src/commands/devices/delete.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,IAAI,EAAC,MAAM,aAAa,CAAA;AAEhC,OAAO,EAAC,WAAW,EAAC,MAAM,uBAAuB,CAAA;AACjD,OAAO,EAAC,YAAY,EAAC,MAAM,yBAAyB,CAAA;AAEpD,MAAM,CAAC,OAAO,OAAO,aAAc,SAAQ,WAAiC;IAC1E,MAAM,CAAU,IAAI,GAAG;QACrB,EAAE,EAAE,IAAI,CAAC,MAAM,CAAC,EAAC,WAAW,EAAE,kBAAkB,EAAE,QAAQ,EAAE,IAAI,EAAC,CAAC;KACnE,CAAA;IAED,MAAM,CAAU,WAAW,GAAG;;;uEAGuC,CAAA;IAErE,MAAM,CAAU,QAAQ,GAAG;QACzB,8CAA8C;QAC9C,qDAAqD;KACtD,CAAA;IAED,MAAM,CAAU,OAAO,GAAG,2BAA2B,CAAA;IAE9C,KAAK,CAAC,GAAG;QACd,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,EAAE,CAAA;QAE7B,+DAA+D;QAC/D,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,GAAG,CAA0B,OAAO,EAAE,WAAW,QAAQ,EAAE,EAAE;YACrF,MAAM,EAAE,KAAK;SACd,CAAC,CAAA;QAEF,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;YACpB,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,EAAE,CAAC;gBACxB,IAAI,CAAC,GAAG,CAAC,aAAa,MAAM,CAAC,IAAI,MAAM,QAAQ,0BAA0B,CAAC,CAAA;YAC5E,CAAC;YAED,OAAO,EAAC,GAAG,MAAM,EAAE,eAAe,EAAE,IAAI,EAAC,CAAA;QAC3C,CAAC;QAED,kCAAkC;QAClC,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,GAAG,CAA0B,OAAO,EAAE,WAAW,QAAQ,EAAE,EAAE;YACtF,IAAI,EAAE,EAAC,OAAO,EAAE,KAAK,EAAC;YACtB,MAAM,EAAE,OAAO;SAChB,CAAC,CAAA;QAEF,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,EAAE,CAAC;YACxB,IAAI,CAAC,GAAG,CAAC,qBAAqB,IAAI,CAAC,GAAG,MAAM,CAAC,CAAA;YAC7C,IAAI,CAAC,GAAG,CAAC,aAAa,MAAM,CAAC,IAAI,MAAM,QAAQ,wBAAwB,CAAC,CAAA;YACxE,IAAI,CAAC,GAAG,CAAC,YAAY,CAAC,OAAO,EAAE;gBAC7B,OAAO,EAAE,SAAS;gBAClB,EAAE,EAAE,IAAI;gBACR,IAAI,EAAE,MAAM;gBACZ,IAAI,EAAE,MAAM;gBACZ,SAAS,EAAE,SAAS;aACrB,CAAC,CAAC,CAAA;YACH,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAA;QACd,CAAC;QAED,OAAO,OAAO,CAAA;IAChB,CAAC"}

package/dist/commands/devices/rename.d.ts

@@ -0,0 +1,11 @@
+import { BaseCommand } from '../../base-command.js';
+export default class DevicesRename extends BaseCommand<typeof DevicesRename> {
+    static args: {
+        id: import("@oclif/core/interfaces").Arg<string, Record<string, unknown>>;
+        name: import("@oclif/core/interfaces").Arg<string, Record<string, unknown>>;
+    };
+    static description: string;
+    static examples: string[];
+    static summary: string;
+    run(): Promise<Record<string, unknown>>;
+}

package/dist/commands/devices/rename.js

@@ -0,0 +1,42 @@
+import { Args } from '@oclif/core';
+import { BaseCommand } from '../../base-command.js';
+import { formatDetail } from '../../lib/formatters.js';
+export default class DevicesRename extends BaseCommand {
+    static args = {
+        id: Args.string({ description: 'Device ID (UUID)', required: true }),
+        name: Args.string({ description: 'New name for the device', required: true }),
+    };
+    static description = 'Rename a device by updating its name.';
+    static examples = [
+        '<%= config.bin %> devices rename <device-id> new-robot-name',
+        '<%= config.bin %> devices rename <device-id> new-robot-name --json',
+    ];
+    static summary = 'Rename a device';
+    async run() {
+        const { id: deviceId, name: newName } = this.args;
+        // Fetch the device first to confirm it exists and get the old name
+        const device = await this.api('admin', `devices/${deviceId}`, {
+            method: 'GET',
+        });
+        const oldName = device.name;
+        const updated = await this.api('admin', `devices/${deviceId}`, {
+            body: { name: newName },
+            method: 'PATCH',
+        });
+        if (!this.jsonEnabled()) {
+            this.log(`\nDevice Renamed (${this.env}):\n`);
+            this.log(`  "${oldName}" → "${newName}"\n`);
+            this.log(formatDetail(updated, {
+                enabled: 'Enabled',
+                id: 'ID',
+                name: 'Name',
+                tags: 'Tags',
+                type: 'Type',
+                updatedAt: 'Updated',
+            }));
+            this.log('');
+        }
+        return updated;
+    }
+}
+//# sourceMappingURL=rename.js.map

package/dist/commands/devices/rename.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rename.js","sourceRoot":"","sources":["../../../src/commands/devices/rename.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,IAAI,EAAC,MAAM,aAAa,CAAA;AAEhC,OAAO,EAAC,WAAW,EAAC,MAAM,uBAAuB,CAAA;AACjD,OAAO,EAAC,YAAY,EAAC,MAAM,yBAAyB,CAAA;AAEpD,MAAM,CAAC,OAAO,OAAO,aAAc,SAAQ,WAAiC;IAC1E,MAAM,CAAU,IAAI,GAAG;QACrB,EAAE,EAAE,IAAI,CAAC,MAAM,CAAC,EAAC,WAAW,EAAE,kBAAkB,EAAE,QAAQ,EAAE,IAAI,EAAC,CAAC;QAClE,IAAI,EAAE,IAAI,CAAC,MAAM,CAAC,EAAC,WAAW,EAAE,yBAAyB,EAAE,QAAQ,EAAE,IAAI,EAAC,CAAC;KAC5E,CAAA;IAED,MAAM,CAAU,WAAW,GAAG,uCAAuC,CAAA;IAErE,MAAM,CAAU,QAAQ,GAAG;QACzB,6DAA6D;QAC7D,oEAAoE;KACrE,CAAA;IAED,MAAM,CAAU,OAAO,GAAG,iBAAiB,CAAA;IAEpC,KAAK,CAAC,GAAG;QACd,MAAM,EAAC,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,OAAO,EAAC,GAAG,IAAI,CAAC,IAAI,CAAA;QAE/C,mEAAmE;QACnE,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,GAAG,CAA0B,OAAO,EAAE,WAAW,QAAQ,EAAE,EAAE;YACrF,MAAM,EAAE,KAAK;SACd,CAAC,CAAA;QAEF,MAAM,OAAO,GAAG,MAAM,CAAC,IAAc,CAAA;QAErC,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,GAAG,CAA0B,OAAO,EAAE,WAAW,QAAQ,EAAE,EAAE;YACtF,IAAI,EAAE,EAAC,IAAI,EAAE,OAAO,EAAC;YACrB,MAAM,EAAE,OAAO;SAChB,CAAC,CAAA;QAEF,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,EAAE,CAAC;YACxB,IAAI,CAAC,GAAG,CAAC,qBAAqB,IAAI,CAAC,GAAG,MAAM,CAAC,CAAA;YAC7C,IAAI,CAAC,GAAG,CAAC,MAAM,OAAO,QAAQ,OAAO,KAAK,CAAC,CAAA;YAC3C,IAAI,CAAC,GAAG,CAAC,YAAY,CAAC,OAAO,EAAE;gBAC7B,OAAO,EAAE,SAAS;gBAClB,EAAE,EAAE,IAAI;gBACR,IAAI,EAAE,MAAM;gBACZ,IAAI,EAAE,MAAM;gBACZ,IAAI,EAAE,MAAM;gBACZ,SAAS,EAAE,SAAS;aACrB,CAAC,CAAC,CAAA;YACH,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAA;QACd,CAAC;QAED,OAAO,OAAO,CAAA;IAChB,CAAC"}

package/dist/commands/devices/tag.d.ts

@@ -0,0 +1,13 @@
+import { BaseCommand } from '../../base-command.js';
+export default class DevicesTag extends BaseCommand<typeof DevicesTag> {
+    static args: {
+        id: import("@oclif/core/interfaces").Arg<string, Record<string, unknown>>;
+    };
+    static description: string;
+    static examples: string[];
+    static flags: {
+        tag: import("@oclif/core/interfaces").OptionFlag<string[], import("@oclif/core/interfaces").CustomOptions>;
+    };
+    static summary: string;
+    run(): Promise<Record<string, unknown>>;
+}

package/dist/commands/devices/tag.js

@@ -0,0 +1,69 @@
+import { Args, Flags } from '@oclif/core';
+import { BaseCommand } from '../../base-command.js';
+import { formatTable } from '../../lib/formatters.js';
+export default class DevicesTag extends BaseCommand {
+    static args = {
+        id: Args.string({ description: 'Device ID (UUID)', required: true }),
+    };
+    static description = `Add or update tags on a device.
+
+Tags are key-value pairs. If a tag key already exists, its value will be updated.
+Specify one or more tags with --tag key=value.`;
+    static examples = [
+        '<%= config.bin %> devices tag <device-id> --tag location=warehouse',
+        '<%= config.bin %> devices tag <device-id> --tag env=prod --tag region=us-east',
+        '<%= config.bin %> devices tag <device-id> --tag location=factory --json',
+    ];
+    static flags = {
+        tag: Flags.string({
+            char: 't',
+            description: 'Tag to add or update (key=value), can be specified multiple times',
+            multiple: true,
+            required: true,
+        }),
+    };
+    static summary = 'Add or update tags on a device';
+    async run() {
+        const deviceId = this.args.id;
+        // Parse the new tags
+        const newTags = {};
+        for (const t of this.flags.tag) {
+            const [key, ...rest] = t.split('=');
+            const value = rest.join('=');
+            if (!key || !value) {
+                this.error(`Invalid tag format: "${t}". Use key=value.`);
+            }
+            newTags[key] = value;
+        }
+        // Fetch current device to get existing tags
+        const device = await this.api('admin', `devices/${deviceId}`, {
+            method: 'GET',
+        });
+        const currentTags = device.tags ?? {};
+        const mergedTags = { ...currentTags, ...newTags };
+        // Patch the device with merged tags
+        const updated = await this.api('admin', `devices/${deviceId}`, {
+            body: { tags: mergedTags },
+            method: 'PATCH',
+        });
+        const updatedTags = updated.tags ?? {};
+        if (!this.jsonEnabled()) {
+            this.log(`\nTags Updated — ${device.name} (${this.env}):\n`);
+            const rows = Object.entries(updatedTags)
+                .filter(([key]) => !key.startsWith('$.'))
+                .map(([key, value]) => {
+                const isNew = key in newTags;
+                return { key, status: isNew ? '✓' : '', value };
+            });
+            const columns = [
+                { key: 'key', label: 'KEY', width: 25 },
+                { key: 'value', label: 'VALUE', width: 35 },
+                { key: 'status', label: '', width: 4 },
+            ];
+            this.log(formatTable(rows, columns));
+            this.log('');
+        }
+        return updated;
+    }
+}
+//# sourceMappingURL=tag.js.map

package/dist/commands/devices/tag.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tag.js","sourceRoot":"","sources":["../../../src/commands/devices/tag.ts"],"names":[],"mappings":"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"}

package/dist/commands/devices/untag.d.ts

@@ -0,0 +1,13 @@
+import { BaseCommand } from '../../base-command.js';
+export default class DevicesUntag extends BaseCommand<typeof DevicesUntag> {
+    static args: {
+        id: import("@oclif/core/interfaces").Arg<string, Record<string, unknown>>;
+    };
+    static description: string;
+    static examples: string[];
+    static flags: {
+        key: import("@oclif/core/interfaces").OptionFlag<string[], import("@oclif/core/interfaces").CustomOptions>;
+    };
+    static summary: string;
+    run(): Promise<Record<string, unknown>>;
+}

package/dist/commands/devices/untag.js

@@ -0,0 +1,79 @@
+import { Args, Flags } from '@oclif/core';
+import { BaseCommand } from '../../base-command.js';
+import { formatTable } from '../../lib/formatters.js';
+export default class DevicesUntag extends BaseCommand {
+    static args = {
+        id: Args.string({ description: 'Device ID (UUID)', required: true }),
+    };
+    static description = `Remove tags from a device.
+
+Specify one or more tag keys to remove with --key.`;
+    static examples = [
+        '<%= config.bin %> devices untag <device-id> --key location',
+        '<%= config.bin %> devices untag <device-id> --key env --key region',
+        '<%= config.bin %> devices untag <device-id> --key location --json',
+    ];
+    static flags = {
+        key: Flags.string({
+            char: 'k',
+            description: 'Tag key to remove, can be specified multiple times',
+            multiple: true,
+            required: true,
+        }),
+    };
+    static summary = 'Remove tags from a device';
+    async run() {
+        const deviceId = this.args.id;
+        // Fetch current device to get existing tags
+        const device = await this.api('admin', `devices/${deviceId}`, {
+            method: 'GET',
+        });
+        const currentTags = device.tags ?? {};
+        const updatedTags = { ...currentTags };
+        const removed = [];
+        const notFound = [];
+        for (const key of this.flags.key) {
+            if (key in updatedTags) {
+                delete updatedTags[key];
+                removed.push(key);
+            }
+            else {
+                notFound.push(key);
+            }
+        }
+        if (removed.length === 0) {
+            if (!this.jsonEnabled()) {
+                this.log(`\nNo matching tags found on device "${device.name}".`);
+                this.log(`Keys not found: ${notFound.join(', ')}\n`);
+            }
+            return { ...device, removedTags: [], notFound };
+        }
+        // Patch the device with updated tags
+        const updated = await this.api('admin', `devices/${deviceId}`, {
+            body: { tags: updatedTags },
+            method: 'PATCH',
+        });
+        const finalTags = updated.tags ?? {};
+        if (!this.jsonEnabled()) {
+            this.log(`\nTags Removed — ${device.name} (${this.env}):\n`);
+            this.log(`  Removed: ${removed.join(', ')}`);
+            if (notFound.length > 0) {
+                this.log(`  Not found: ${notFound.join(', ')}`);
+            }
+            const rows = Object.entries(finalTags)
+                .filter(([key]) => !key.startsWith('$.'))
+                .map(([key, value]) => ({ key, value }));
+            if (rows.length > 0) {
+                this.log('\n  Remaining tags:\n');
+                const columns = [
+                    { key: 'key', label: 'KEY', width: 25 },
+                    { key: 'value', label: 'VALUE', width: 35 },
+                ];
+                this.log(formatTable(rows, columns));
+            }
+            this.log('');
+        }
+        return updated;
+    }
+}
+//# sourceMappingURL=untag.js.map

package/dist/commands/devices/untag.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"untag.js","sourceRoot":"","sources":["../../../src/commands/devices/untag.ts"],"names":[],"mappings":"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"}

package/dist/commands/ingest/batch.d.ts

@@ -0,0 +1,21 @@
+import { BaseCommand } from '../../base-command.js';
+interface IngestBatchRequest {
+    items: Array<{
+        deviceId: string;
+        name: string;
+        type: 'bitset' | 'health' | 'image' | 'json' | 'numeric' | 'text' | 'video';
+        tags: Record<string, string>;
+        points: Array<[number, unknown]>;
+    }>;
+}
+export default class IngestBatch extends BaseCommand<typeof IngestBatch> {
+    static description: string;
+    static examples: string[];
+    static flags: {
+        file: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        stdin: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+    };
+    static summary: string;
+    run(): Promise<IngestBatchRequest>;
+}
+export {};

package/dist/commands/ingest/batch.js

@@ -0,0 +1,170 @@
+import { readFileSync } from 'node:fs';
+import { Flags } from '@oclif/core';
+import { BaseCommand } from '../../base-command.js';
+export default class IngestBatch extends BaseCommand {
+    static description = `Ingest multiple data points in a single batch request.
+
+Reads a JSON file (or stdin) containing a batch ingestion payload and sends all data points
+in a single API request. This is more efficient than sending individual data points when you
+have multiple values to ingest.
+
+INPUT FORMAT:
+The input JSON must have the following structure:
+{
+  "items": [
+    {
+      "deviceId": "device-uuid",        // Required: Device ID (UUID)
+      "name": "stream-name",             // Required: Stream name
+      "type": "numeric|text|json|...",   // Required: Data type (see below)
+      "tags": {"key": "value"},          // Optional: Tags object (string key-value pairs)
+      "points": [[timestamp_ms, value]]  // Required: Array of [timestamp, value] pairs
+    }
+  ]
+}
+
+SUPPORTED TYPES AND VALUE FORMATS:
+- numeric: Number value
+    Example: "points": [[1708272000000, 42.5]]
+
+- text: String value
+    Example: "points": [[1708272000000, "hello world"]]
+
+- json: JSON object encoded as string
+    Example: "points": [[1708272000000, "{\\"x\\":10,\\"y\\":20}"]]
+
+- image: Object with url (required), size and annotations (optional)
+    Example: "points": [[1708272000000, {"url": "https://example.com/img.jpg", "size": 102400}]]
+
+- video: Object with url, duration, mimeType (required), size (optional)
+    Example: "points": [[1708272000000, {"url": "https://example.com/vid.mp4", "duration": 30000, "mimeType": "video/mp4"}]]
+
+- bitset: Object with keys array and values array (1-1000 pairs)
+    Example: "points": [[1708272000000, {"keys": ["door", "window"], "values": [true, false]}]]
+
+- health: Object with status (required) and clockSkewMs (optional)
+    Example: "points": [[1708272000000, {"status": "operational", "clockSkewMs": 150}]]
+    Valid status values: "unknown", "operational", "offline", "error"
+
+Each item can have multiple points (timestamp/value pairs) for the same stream.
+Timestamps are Unix milliseconds (use Date.now() for current time).`;
+    static examples = [
+        `<%= config.bin %> ingest batch --file data.json`,
+        `<%= config.bin %> ingest batch --stdin < data.json`,
+        `cat payload.json | <%= config.bin %> ingest batch --stdin`,
+        `# Example payload.json with multiple types:
+{
+  "items": [
+    {
+      "deviceId": "abc-123",
+      "name": "battery_level",
+      "type": "numeric",
+      "tags": {"env": "prod"},
+      "points": [[1708272000000, 42.5], [1708272060000, 41.8]]
+    },
+    {
+      "deviceId": "abc-123",
+      "name": "status",
+      "type": "text",
+      "tags": {"env": "prod"},
+      "points": [[1708272000000, "operational"]]
+    },
+    {
+      "deviceId": "abc-123",
+      "name": "health",
+      "type": "health",
+      "tags": {},
+      "points": [[1708272000000, {"status": "operational"}]]
+    }
+  ]
+}`,
+    ];
+    static flags = {
+        file: Flags.string({
+            char: 'f',
+            description: 'Path to JSON file containing batch payload',
+            exclusive: ['stdin'],
+        }),
+        stdin: Flags.boolean({
+            description: 'Read JSON payload from stdin',
+            exclusive: ['file'],
+        }),
+    };
+    static summary = 'Ingest batch data from file or stdin';
+    async run() {
+        // Ensure either --file or --stdin is specified
+        if (!this.flags.file && !this.flags.stdin) {
+            this.error('Must specify either --file <path> or --stdin');
+        }
+        // Read input
+        let inputJson;
+        if (this.flags.file) {
+            try {
+                inputJson = readFileSync(this.flags.file, 'utf8');
+            }
+            catch (error) {
+                this.error(`Failed to read file "${this.flags.file}": ${error instanceof Error ? error.message : 'Unknown error'}`);
+            }
+        }
+        else {
+            // Read from stdin
+            const chunks = [];
+            for await (const chunk of process.stdin) {
+                chunks.push(chunk);
+            }
+            inputJson = Buffer.concat(chunks).toString('utf8');
+            if (!inputJson.trim()) {
+                this.error('No data received from stdin');
+            }
+        }
+        // Parse JSON
+        let body;
+        try {
+            body = JSON.parse(inputJson);
+        }
+        catch (error) {
+            this.error(`Invalid JSON: ${error instanceof Error ? error.message : 'Unknown error'}. Input must be valid JSON.`);
+        }
+        // Validate structure
+        if (!body || typeof body !== 'object') {
+            this.error('Input must be a JSON object');
+        }
+        if (!Array.isArray(body.items)) {
+            this.error('Input must have an "items" array');
+        }
+        if (body.items.length === 0) {
+            this.error('Items array cannot be empty');
+        }
+        // Basic validation of items
+        for (const [index, item] of body.items.entries()) {
+            if (!item.deviceId) {
+                this.error(`Item ${index}: Missing required field "deviceId"`);
+            }
+            if (!item.name) {
+                this.error(`Item ${index}: Missing required field "name"`);
+            }
+            if (!item.type) {
+                this.error(`Item ${index}: Missing required field "type"`);
+            }
+            const validTypes = ['numeric', 'text', 'json', 'image', 'video', 'bitset', 'health'];
+            if (!validTypes.includes(item.type)) {
+                this.error(`Item ${index}: Invalid type "${item.type}". Must be one of: ${validTypes.join(', ')}`);
+            }
+            if (!Array.isArray(item.points)) {
+                this.error(`Item ${index}: "points" must be an array`);
+            }
+            if (item.points.length === 0) {
+                this.error(`Item ${index}: "points" array cannot be empty`);
+            }
+        }
+        // Count total points
+        const totalPoints = body.items.reduce((sum, item) => sum + item.points.length, 0);
+        // Send request (expect 204 No Content)
+        await this.api('ingest', 'batch', { body, method: 'POST' });
+        if (!this.jsonEnabled()) {
+            this.log(`\n✓ Ingested batch: ${body.items.length} stream(s), ${totalPoints} data point(s) (${this.env})\n`);
+        }
+        // Return the request body for --json output
+        return body;
+    }
+}
+//# sourceMappingURL=batch.js.map

package/dist/commands/ingest/batch.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"batch.js","sourceRoot":"","sources":["../../../src/commands/ingest/batch.ts"],"names":[],"mappings":"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"}