@formant/formant-cli 0.2.0 → 0.3.1

package/dist/commands/devices/streams.js

@@ -1,56 +1,100 @@
-import { Args } from '@oclif/core';
+import { Args, Flags } from '@oclif/core';
 import { BaseCommand } from '../../base-command.js';
 import { formatTable } from '../../lib/formatters.js';
 export default class DevicesStreams extends BaseCommand {
     static args = {
         id: Args.string({ description: 'Device ID (UUID)', required: true }),
     };
-    static description = `List telemetry streams configured on a device.
+    static description = `List telemetry streams for a device.
 
-Shows a clean view of stream definitions parsed from the device configuration,
-including stream names, types, topics, and quality settings.`;
+Shows streams parsed from the device configuration as well as any streams
+discovered from actual ingested data (even if not explicitly configured).
+Unconfigured streams are marked with a SOURCE of "data" in the output.`;
     static examples = [
         '<%= config.bin %> devices streams <device-id>',
         '<%= config.bin %> devices streams <device-id> --json',
+        '<%= config.bin %> devices streams <device-id> --days 30',
     ];
+    static flags = {
+        days: Flags.integer({
+            default: 14,
+            description: 'How many days back to look for unconfigured streams in ingested data',
+        }),
+    };
     static summary = 'List device streams';
     async run() {
-        // Fetch device and its configuration
-        const device = await this.api('admin', `devices/${this.args.id}`, {
+        const deviceId = this.args.id;
+        // ── 1. Fetch config-based streams ────────────────────────────────────────
+        const device = await this.api('admin', `devices/${deviceId}`, {
             method: 'GET',
         });
         const configVersion = device.desiredConfigurationVersion;
-        if (!configVersion) {
-            this.error('Device has no configuration version set');
+        let configuredStreamNames = new Set();
+        let configStreams = [];
+        if (configVersion) {
+            const config = await this.api('admin', `devices/${deviceId}/configurations/${configVersion}`, { method: 'GET' });
+            const doc = config.document;
+            const telemetry = doc?.telemetry;
+            configStreams = telemetry?.streams || [];
+            configuredStreamNames = new Set(configStreams.map((s) => s.name).filter(Boolean));
+        }
+        // ── 2. Discover streams from actual ingested data ─────────────────────────
+        const since = new Date();
+        since.setDate(since.getDate() - this.flags.days);
+        let metadataItems = [];
+        try {
+            const metaResult = await this.api('query', 'metadata', {
+                body: {
+                    deviceIds: [deviceId],
+                    start: since.toISOString(),
+                },
+            });
+            metadataItems = metaResult?.items ?? [];
+        }
+        catch {
+            // metadata endpoint failure is non-fatal; we still return config streams
+        }
+        // ── 3. Build merged stream list ───────────────────────────────────────────
+        // Configured streams come first, annotated with source="config"
+        const rows = configStreams.map((s) => {
+            const conf = s.configuration;
+            return {
+                name: s.name,
+                quality: s.quality || '—',
+                source: 'config',
+                topic: conf?.topic || '—',
+                type: conf?.type || '—',
+            };
+        });
+        // Append streams seen in data but absent from config
+        for (const item of metadataItems) {
+            if (!configuredStreamNames.has(item.name)) {
+                rows.push({
+                    name: item.name,
+                    quality: '—',
+                    source: 'data',
+                    topic: '—',
+                    type: item.type || '—',
+                });
+            }
         }
-        const config = await this.api('admin', `devices/${this.args.id}/configurations/${configVersion}`, { method: 'GET' });
-        // Parse streams from config
-        const doc = config.document;
-        const telemetry = doc?.telemetry;
-        const streams = telemetry?.streams || [];
         if (!this.jsonEnabled()) {
             const columns = [
                 { key: 'name', label: 'NAME', width: 30 },
                 { key: 'type', label: 'TYPE', width: 20 },
-                { key: 'topic', label: 'TOPIC', width: 40 },
-                { key: 'quality', label: 'QUALITY', width: 12 },
+                { key: 'topic', label: 'TOPIC', width: 36 },
+                { key: 'quality', label: 'QUALITY', width: 10 },
+                { key: 'source', label: 'SOURCE', width: 8 },
             ];
-            // Format streams for display
-            const rows = streams.map((s) => {
-                const conf = s.configuration;
-                return {
-                    name: s.name,
-                    type: conf?.type || '—',
-                    topic: conf?.topic || '—',
-                    quality: s.quality || '—',
-                };
-            });
+            const configured = rows.filter((r) => r.source === 'config').length;
+            const discovered = rows.filter((r) => r.source === 'data').length;
             this.log(`\nDevice Streams (${this.env}):\n`);
-            this.log(`  Device: ${device.name} (${this.args.id})\n`);
+            this.log(`  Device: ${device.name} (${deviceId})`);
+            this.log(`  Configured: ${configured}  |  Discovered from data (last ${this.flags.days}d): ${discovered}\n`);
             this.log(formatTable(rows, columns));
             this.log('');
         }
-        return { streams };
+        return { streams: rows };
     }
 }
 //# sourceMappingURL=streams.js.map

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

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

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

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

package/dist/commands/ingest/bitset.js

@@ -0,0 +1,128 @@
+import { Flags } from '@oclif/core';
+import { BaseCommand } from '../../base-command.js';
+export default class IngestBitset extends BaseCommand {
+    static description = `Ingest a bitset data point to a device stream.
+
+Sends a bitset (array of named boolean values) to the specified device stream. A bitset
+consists of parallel arrays of keys (strings) and values (booleans).
+
+Bitsets are useful for representing sets of binary states, flags, or boolean sensor readings
+where you have multiple named on/off states.
+
+Constraints:
+- Must have 1-1000 key/value pairs
+- Keys must be max 255 characters each
+- Keys and values arrays must have the same length`;
+    static examples = [
+        '<%= config.bin %> ingest bitset --device <device-id> --stream sensors --keys "door,window,motion" --values "true,false,true"',
+        '<%= config.bin %> ingest bitset --device <device-id> --stream flags --keys "active,paused,error" --values "true,false,false" --tag system=main',
+        '<%= config.bin %> ingest bitset --device <device-id> --stream states --keys "a,b" --values "false,true"',
+    ];
+    static flags = {
+        device: Flags.string({
+            char: 'd',
+            description: 'Device ID (UUID)',
+            required: true,
+        }),
+        stream: Flags.string({
+            char: 's',
+            description: 'Stream name',
+            required: true,
+        }),
+        keys: Flags.string({
+            char: 'k',
+            description: 'Comma-separated list of key names (1-1000 keys, max 255 chars each)',
+            required: true,
+        }),
+        values: Flags.string({
+            char: 'v',
+            description: 'Comma-separated list of boolean values (true/false, must match key count)',
+            required: true,
+        }),
+        tag: Flags.string({
+            char: 't',
+            description: 'Tag as key=value where both are strings (can be specified multiple times)',
+            multiple: true,
+        }),
+        timestamp: Flags.string({
+            description: 'Unix timestamp in milliseconds (defaults to now)',
+        }),
+    };
+    static summary = 'Ingest bitset data';
+    async run() {
+        // Parse keys
+        const keys = this.flags.keys.split(',').map((k) => k.trim());
+        // Parse values
+        const valueStrings = this.flags.values.split(',').map((v) => v.trim().toLowerCase());
+        const values = [];
+        for (const v of valueStrings) {
+            if (v === 'true') {
+                values.push(true);
+            }
+            else if (v === 'false') {
+                values.push(false);
+            }
+            else {
+                this.error(`Invalid boolean value: "${v}". Must be "true" or "false".`);
+            }
+        }
+        // Validate arrays have same length
+        if (keys.length !== values.length) {
+            this.error(`Keys and values must have the same count. Got ${keys.length} keys and ${values.length} values.`);
+        }
+        // Validate count (1-1000)
+        if (keys.length < 1 || keys.length > 1000) {
+            this.error('Bitset must have between 1 and 1000 key/value pairs.');
+        }
+        // Validate key lengths
+        for (const key of keys) {
+            if (key.length > 255) {
+                this.error(`Key "${key}" exceeds maximum length of 255 characters.`);
+            }
+        }
+        // Build bitset value
+        const bitsetValue = {
+            keys,
+            values,
+        };
+        // Parse tags
+        const tags = {};
+        if (this.flags.tag) {
+            for (const tag of this.flags.tag) {
+                const [tagKey, ...valueParts] = tag.split('=');
+                if (!tagKey || valueParts.length === 0) {
+                    this.error(`Invalid tag format: "${tag}". Must be key=value.`);
+                }
+                tags[tagKey] = valueParts.join('=');
+            }
+        }
+        // Parse timestamp
+        let timestamp = Date.now();
+        if (this.flags.timestamp) {
+            timestamp = Number.parseInt(this.flags.timestamp, 10);
+            if (Number.isNaN(timestamp) || timestamp <= 0) {
+                this.error(`Invalid timestamp: "${this.flags.timestamp}". Must be a positive integer.`);
+            }
+        }
+        // Build request body
+        const body = {
+            items: [
+                {
+                    deviceId: this.flags.device,
+                    name: this.flags.stream,
+                    type: 'bitset',
+                    tags,
+                    points: [[timestamp, bitsetValue]],
+                },
+            ],
+        };
+        // Send request (expect 204 No Content)
+        await this.api('ingest', 'batch', { body, method: 'POST' });
+        if (!this.jsonEnabled()) {
+            this.log(`\n✓ Ingested bitset with ${keys.length} entries to stream "${this.flags.stream}" on device ${this.flags.device} (${this.env})\n`);
+        }
+        // Return the request body for --json output
+        return body;
+    }
+}
+//# sourceMappingURL=bitset.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"bitset.js","sourceRoot":"","sources":["../../../src/commands/ingest/bitset.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,KAAK,EAAC,MAAM,aAAa,CAAA;AAEjC,OAAO,EAAC,WAAW,EAAC,MAAM,uBAAuB,CAAA;AAEjD,MAAM,CAAC,OAAO,OAAO,YAAa,SAAQ,WAAgC;IACxE,MAAM,CAAU,WAAW,GAAG;;;;;;;;;;;mDAWmB,CAAA;IAEjD,MAAM,CAAU,QAAQ,GAAG;QACzB,8HAA8H;QAC9H,gJAAgJ;QAChJ,yGAAyG;KAC1G,CAAA;IAED,MAAM,CAAU,KAAK,GAAG;QACtB,MAAM,EAAE,KAAK,CAAC,MAAM,CAAC;YACnB,IAAI,EAAE,GAAG;YACT,WAAW,EAAE,kBAAkB;YAC/B,QAAQ,EAAE,IAAI;SACf,CAAC;QACF,MAAM,EAAE,KAAK,CAAC,MAAM,CAAC;YACnB,IAAI,EAAE,GAAG;YACT,WAAW,EAAE,aAAa;YAC1B,QAAQ,EAAE,IAAI;SACf,CAAC;QACF,IAAI,EAAE,KAAK,CAAC,MAAM,CAAC;YACjB,IAAI,EAAE,GAAG;YACT,WAAW,EAAE,qEAAqE;YAClF,QAAQ,EAAE,IAAI;SACf,CAAC;QACF,MAAM,EAAE,KAAK,CAAC,MAAM,CAAC;YACnB,IAAI,EAAE,GAAG;YACT,WAAW,EAAE,2EAA2E;YACxF,QAAQ,EAAE,IAAI;SACf,CAAC;QACF,GAAG,EAAE,KAAK,CAAC,MAAM,CAAC;YAChB,IAAI,EAAE,GAAG;YACT,WAAW,EAAE,2EAA2E;YACxF,QAAQ,EAAE,IAAI;SACf,CAAC;QACF,SAAS,EAAE,KAAK,CAAC,MAAM,CAAC;YACtB,WAAW,EAAE,kDAAkD;SAChE,CAAC;KACH,CAAA;IAED,MAAM,CAAU,OAAO,GAAG,oBAAoB,CAAA;IAEvC,KAAK,CAAC,GAAG;QACd,aAAa;QACb,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAA;QAE5D,eAAe;QACf,MAAM,YAAY,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC,CAAA;QACpF,MAAM,MAAM,GAAc,EAAE,CAAA;QAE5B,KAAK,MAAM,CAAC,IAAI,YAAY,EAAE,CAAC;YAC7B,IAAI,CAAC,KAAK,MAAM,EAAE,CAAC;gBACjB,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;YACnB,CAAC;iBAAM,IAAI,CAAC,KAAK,OAAO,EAAE,CAAC;gBACzB,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;YACpB,CAAC;iBAAM,CAAC;gBACN,IAAI,CAAC,KAAK,CAAC,2BAA2B,CAAC,+BAA+B,CAAC,CAAA;YACzE,CAAC;QACH,CAAC;QAED,mCAAmC;QACnC,IAAI,IAAI,CAAC,MAAM,KAAK,MAAM,CAAC,MAAM,EAAE,CAAC;YAClC,IAAI,CAAC,KAAK,CACR,iDAAiD,IAAI,CAAC,MAAM,aAAa,MAAM,CAAC,MAAM,UAAU,CACjG,CAAA;QACH,CAAC;QAED,0BAA0B;QAC1B,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC,IAAI,IAAI,CAAC,MAAM,GAAG,IAAI,EAAE,CAAC;YAC1C,IAAI,CAAC,KAAK,CAAC,sDAAsD,CAAC,CAAA;QACpE,CAAC;QAED,uBAAuB;QACvB,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;YACvB,IAAI,GAAG,CAAC,MAAM,GAAG,GAAG,EAAE,CAAC;gBACrB,IAAI,CAAC,KAAK,CAAC,QAAQ,GAAG,6CAA6C,CAAC,CAAA;YACtE,CAAC;QACH,CAAC;QAED,qBAAqB;QACrB,MAAM,WAAW,GAAG;YAClB,IAAI;YACJ,MAAM;SACP,CAAA;QAED,aAAa;QACb,MAAM,IAAI,GAA2B,EAAE,CAAA;QACvC,IAAI,IAAI,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC;YACnB,KAAK,MAAM,GAAG,IAAI,IAAI,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC;gBACjC,MAAM,CAAC,MAAM,EAAE,GAAG,UAAU,CAAC,GAAG,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAA;gBAC9C,IAAI,CAAC,MAAM,IAAI,UAAU,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;oBACvC,IAAI,CAAC,KAAK,CAAC,wBAAwB,GAAG,uBAAuB,CAAC,CAAA;gBAChE,CAAC;gBAED,IAAI,CAAC,MAAM,CAAC,GAAG,UAAU,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;YACrC,CAAC;QACH,CAAC;QAED,kBAAkB;QAClB,IAAI,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAA;QAC1B,IAAI,IAAI,CAAC,KAAK,CAAC,SAAS,EAAE,CAAC;YACzB,SAAS,GAAG,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,SAAS,EAAE,EAAE,CAAC,CAAA;YACrD,IAAI,MAAM,CAAC,KAAK,CAAC,SAAS,CAAC,IAAI,SAAS,IAAI,CAAC,EAAE,CAAC;gBAC9C,IAAI,CAAC,KAAK,CAAC,uBAAuB,IAAI,CAAC,KAAK,CAAC,SAAS,gCAAgC,CAAC,CAAA;YACzF,CAAC;QACH,CAAC;QAED,qBAAqB;QACrB,MAAM,IAAI,GAAG;YACX,KAAK,EAAE;gBACL;oBACE,QAAQ,EAAE,IAAI,CAAC,KAAK,CAAC,MAAM;oBAC3B,IAAI,EAAE,IAAI,CAAC,KAAK,CAAC,MAAM;oBACvB,IAAI,EAAE,QAAQ;oBACd,IAAI;oBACJ,MAAM,EAAE,CAAC,CAAC,SAAS,EAAE,WAAW,CAAC,CAAC;iBACnC;aACF;SACF,CAAA;QAED,uCAAuC;QACvC,MAAM,IAAI,CAAC,GAAG,CAAC,QAAQ,EAAE,OAAO,EAAE,EAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAC,CAAC,CAAA;QAEzD,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,EAAE,CAAC;YACxB,IAAI,CAAC,GAAG,CACN,4BAA4B,IAAI,CAAC,MAAM,uBAAuB,IAAI,CAAC,KAAK,CAAC,MAAM,eAAe,IAAI,CAAC,KAAK,CAAC,MAAM,KAAK,IAAI,CAAC,GAAG,KAAK,CAClI,CAAA;QACH,CAAC;QAED,4CAA4C;QAC5C,OAAO,IAAI,CAAA;IACb,CAAC"}

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

@@ -0,0 +1,15 @@
+import { BaseCommand } from '../../base-command.js';
+export default class IngestHealth extends BaseCommand<typeof IngestHealth> {
+    static description: string;
+    static examples: string[];
+    static flags: {
+        device: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+        stream: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+        status: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+        'clock-skew': import("@oclif/core/interfaces").OptionFlag<number | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        tag: import("@oclif/core/interfaces").OptionFlag<string[] | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        timestamp: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+    };
+    static summary: string;
+    run(): Promise<Record<string, unknown>>;
+}

package/dist/commands/ingest/health.js

@@ -0,0 +1,94 @@
+import { Flags } from '@oclif/core';
+import { BaseCommand } from '../../base-command.js';
+export default class IngestHealth extends BaseCommand {
+    static description = `Ingest a health status data point to a device stream.
+
+Sends device health status information to the specified stream. Health data consists of:
+- status: One of "unknown", "operational", "offline", or "error"
+- clockSkewMs (optional): Clock skew in milliseconds between device and server
+
+Health streams are used to track device operational state, system health, and time synchronization.`;
+    static examples = [
+        '<%= config.bin %> ingest health --device <device-id> --stream system_health --status operational',
+        '<%= config.bin %> ingest health --device <device-id> --stream health --status error --tag component=motor',
+        '<%= config.bin %> ingest health --device <device-id> --stream sync --status operational --clock-skew 150',
+    ];
+    static flags = {
+        device: Flags.string({
+            char: 'd',
+            description: 'Device ID (UUID)',
+            required: true,
+        }),
+        stream: Flags.string({
+            char: 's',
+            description: 'Stream name',
+            required: true,
+        }),
+        status: Flags.string({
+            description: 'Health status (unknown, operational, offline, or error)',
+            options: ['unknown', 'operational', 'offline', 'error'],
+            required: true,
+        }),
+        'clock-skew': Flags.integer({
+            description: 'Clock skew in milliseconds (optional)',
+        }),
+        tag: Flags.string({
+            char: 't',
+            description: 'Tag as key=value where both are strings (can be specified multiple times)',
+            multiple: true,
+        }),
+        timestamp: Flags.string({
+            description: 'Unix timestamp in milliseconds (defaults to now)',
+        }),
+    };
+    static summary = 'Ingest health status data';
+    async run() {
+        // Build health value
+        const healthValue = {
+            status: this.flags.status,
+        };
+        if (this.flags['clock-skew'] !== undefined) {
+            healthValue.clockSkewMs = this.flags['clock-skew'];
+        }
+        // Parse tags
+        const tags = {};
+        if (this.flags.tag) {
+            for (const tag of this.flags.tag) {
+                const [key, ...valueParts] = tag.split('=');
+                if (!key || valueParts.length === 0) {
+                    this.error(`Invalid tag format: "${tag}". Must be key=value.`);
+                }
+                tags[key] = valueParts.join('=');
+            }
+        }
+        // Parse timestamp
+        let timestamp = Date.now();
+        if (this.flags.timestamp) {
+            timestamp = Number.parseInt(this.flags.timestamp, 10);
+            if (Number.isNaN(timestamp) || timestamp <= 0) {
+                this.error(`Invalid timestamp: "${this.flags.timestamp}". Must be a positive integer.`);
+            }
+        }
+        // Build request body
+        const body = {
+            items: [
+                {
+                    deviceId: this.flags.device,
+                    name: this.flags.stream,
+                    type: 'health',
+                    tags,
+                    points: [[timestamp, healthValue]],
+                },
+            ],
+        };
+        // Send request (expect 204 No Content)
+        await this.api('ingest', 'batch', { body, method: 'POST' });
+        if (!this.jsonEnabled()) {
+            const skewInfo = this.flags['clock-skew'] ? `, clock skew: ${this.flags['clock-skew']}ms` : '';
+            this.log(`\n✓ Ingested health status "${this.flags.status}"${skewInfo} to stream "${this.flags.stream}" on device ${this.flags.device} (${this.env})\n`);
+        }
+        // Return the request body for --json output
+        return body;
+    }
+}
+//# sourceMappingURL=health.js.map

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

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

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

@@ -0,0 +1,15 @@
+import { BaseCommand } from '../../base-command.js';
+export default class IngestImage extends BaseCommand<typeof IngestImage> {
+    static description: string;
+    static examples: string[];
+    static flags: {
+        device: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+        stream: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+        url: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+        size: import("@oclif/core/interfaces").OptionFlag<number | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        tag: import("@oclif/core/interfaces").OptionFlag<string[] | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        timestamp: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+    };
+    static summary: string;
+    run(): Promise<Record<string, unknown>>;
+}