@formant/formant-cli 0.1.0 → 0.3.0

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>>;
+}

package/dist/commands/ingest/image.js

@@ -0,0 +1,99 @@
+import { Flags } from '@oclif/core';
+import { BaseCommand } from '../../base-command.js';
+export default class IngestImage extends BaseCommand {
+    static description = `Ingest an image URL to a device stream.
+
+Sends an image reference (by URL) to the specified device stream. The image must be accessible
+via HTTP/HTTPS. Formant will fetch and store the image from the provided URL.
+
+Image streams are used for camera feeds, snapshots, diagnostic images, etc.`;
+    static examples = [
+        '<%= config.bin %> ingest image --device <device-id> --stream camera_front --url https://example.com/image.jpg',
+        '<%= config.bin %> ingest image --device <device-id> --stream snapshot --url https://example.com/snap.png --size 1024000',
+        '<%= config.bin %> ingest image --device <device-id> --stream detection --url https://example.com/detect.jpg --tag frame=123',
+    ];
+    static flags = {
+        device: Flags.string({
+            char: 'd',
+            description: 'Device ID (UUID)',
+            required: true,
+        }),
+        stream: Flags.string({
+            char: 's',
+            description: 'Stream name',
+            required: true,
+        }),
+        url: Flags.string({
+            char: 'u',
+            description: 'Image URL (must be http:// or https://)',
+            required: true,
+        }),
+        size: Flags.integer({
+            description: 'Image size in bytes (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 image data';
+    async run() {
+        // Validate URL format
+        if (!this.flags.url.match(/^https?:\/\//i)) {
+            this.error('Image URL must start with http:// or https://');
+        }
+        // Build image value object
+        const imageValue = {
+            url: this.flags.url,
+        };
+        if (this.flags.size !== undefined) {
+            if (this.flags.size <= 0) {
+                this.error('Image size must be a positive number');
+            }
+            imageValue.size = this.flags.size;
+        }
+        // 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: 'image',
+                    tags,
+                    points: [[timestamp, imageValue]],
+                },
+            ],
+        };
+        // Send request (expect 204 No Content)
+        await this.api('ingest', 'batch', { body, method: 'POST' });
+        if (!this.jsonEnabled()) {
+            this.log(`\n✓ Ingested image ${this.flags.url} to stream "${this.flags.stream}" on device ${this.flags.device} (${this.env})\n`);
+        }
+        // Return the request body for --json output
+        return body;
+    }
+}
+//# sourceMappingURL=image.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"image.js","sourceRoot":"","sources":["../../../src/commands/ingest/image.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,KAAK,EAAC,MAAM,aAAa,CAAA;AAEjC,OAAO,EAAC,WAAW,EAAC,MAAM,uBAAuB,CAAA;AAEjD,MAAM,CAAC,OAAO,OAAO,WAAY,SAAQ,WAA+B;IACtE,MAAM,CAAU,WAAW,GAAG;;;;;4EAK4C,CAAA;IAE1E,MAAM,CAAU,QAAQ,GAAG;QACzB,+GAA+G;QAC/G,yHAAyH;QACzH,6HAA6H;KAC9H,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,GAAG,EAAE,KAAK,CAAC,MAAM,CAAC;YAChB,IAAI,EAAE,GAAG;YACT,WAAW,EAAE,yCAAyC;YACtD,QAAQ,EAAE,IAAI;SACf,CAAC;QACF,IAAI,EAAE,KAAK,CAAC,OAAO,CAAC;YAClB,WAAW,EAAE,gCAAgC;SAC9C,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,mBAAmB,CAAA;IAEtC,KAAK,CAAC,GAAG;QACd,sBAAsB;QACtB,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,KAAK,CAAC,eAAe,CAAC,EAAE,CAAC;YAC3C,IAAI,CAAC,KAAK,CAAC,+CAA+C,CAAC,CAAA;QAC7D,CAAC;QAED,2BAA2B;QAC3B,MAAM,UAAU,GAA4B;YAC1C,GAAG,EAAE,IAAI,CAAC,KAAK,CAAC,GAAG;SACpB,CAAA;QAED,IAAI,IAAI,CAAC,KAAK,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;YAClC,IAAI,IAAI,CAAC,KAAK,CAAC,IAAI,IAAI,CAAC,EAAE,CAAC;gBACzB,IAAI,CAAC,KAAK,CAAC,sCAAsC,CAAC,CAAA;YACpD,CAAC;YAED,UAAU,CAAC,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAA;QACnC,CAAC;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,GAAG,EAAE,GAAG,UAAU,CAAC,GAAG,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAA;gBAC3C,IAAI,CAAC,GAAG,IAAI,UAAU,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;oBACpC,IAAI,CAAC,KAAK,CAAC,wBAAwB,GAAG,uBAAuB,CAAC,CAAA;gBAChE,CAAC;gBAED,IAAI,CAAC,GAAG,CAAC,GAAG,UAAU,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;YAClC,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,OAAO;oBACb,IAAI;oBACJ,MAAM,EAAE,CAAC,CAAC,SAAS,EAAE,UAAU,CAAC,CAAC;iBAClC;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,sBAAsB,IAAI,CAAC,KAAK,CAAC,GAAG,eAAe,IAAI,CAAC,KAAK,CAAC,MAAM,eAAe,IAAI,CAAC,KAAK,CAAC,MAAM,KAAK,IAAI,CAAC,GAAG,KAAK,CACvH,CAAA;QACH,CAAC;QAED,4CAA4C;QAC5C,OAAO,IAAI,CAAA;IACb,CAAC"}

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

@@ -0,0 +1,16 @@
+import { BaseCommand } from '../../base-command.js';
+export default class IngestJson extends BaseCommand<typeof IngestJson> {
+    static args: {
+        value: import("@oclif/core/interfaces").Arg<string, Record<string, unknown>>;
+    };
+    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>;
+        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/json.js

@@ -0,0 +1,92 @@
+import { Args, Flags } from '@oclif/core';
+import { BaseCommand } from '../../base-command.js';
+export default class IngestJson extends BaseCommand {
+    static args = {
+        value: Args.string({ description: 'JSON value to ingest (as a JSON string)', required: true }),
+    };
+    static description = `Ingest a JSON data point to a device stream.
+
+Sends structured JSON data to the specified device stream. The value must be valid JSON.
+JSON streams are used for complex structured data like configuration objects, state machines,
+nested telemetry, etc.
+
+Note: The JSON is sent as a JSON-encoded string to Formant.`;
+    static examples = [
+        '<%= config.bin %> ingest json \'{"x":1,"y":2}\' --device <device-id> --stream position',
+        '<%= config.bin %> ingest json \'{"status":"active","mode":"auto"}\' --device <device-id> --stream config',
+        '<%= config.bin %> ingest json \'[1,2,3,4,5]\' --device <device-id> --stream array_data',
+    ];
+    static flags = {
+        device: Flags.string({
+            char: 'd',
+            description: 'Device ID (UUID)',
+            required: true,
+        }),
+        stream: Flags.string({
+            char: 's',
+            description: 'Stream name',
+            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 JSON data';
+    async run() {
+        // Validate JSON
+        let jsonValue;
+        try {
+            // Parse to validate, but send as string
+            JSON.parse(this.args.value);
+            jsonValue = this.args.value;
+        }
+        catch (error) {
+            this.error(`Invalid JSON value: ${error instanceof Error ? error.message : 'Unknown error'}.\nValue must be valid JSON.`);
+        }
+        // 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 (json type sends the value as a JSON string)
+        const body = {
+            items: [
+                {
+                    deviceId: this.flags.device,
+                    name: this.flags.stream,
+                    type: 'json',
+                    tags,
+                    points: [[timestamp, jsonValue]],
+                },
+            ],
+        };
+        // Send request (expect 204 No Content)
+        await this.api('ingest', 'batch', { body, method: 'POST' });
+        if (!this.jsonEnabled()) {
+            const preview = jsonValue.length > 50 ? `${jsonValue.slice(0, 47)}...` : jsonValue;
+            this.log(`\n✓ Ingested JSON ${preview} to stream "${this.flags.stream}" on device ${this.flags.device} (${this.env})\n`);
+        }
+        // Return the request body for --json output
+        return body;
+    }
+}
+//# sourceMappingURL=json.js.map

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

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

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

@@ -0,0 +1,16 @@
+import { BaseCommand } from '../../base-command.js';
+export default class IngestNumeric extends BaseCommand<typeof IngestNumeric> {
+    static args: {
+        value: import("@oclif/core/interfaces").Arg<string, Record<string, unknown>>;
+    };
+    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>;
+        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/numeric.js

@@ -0,0 +1,83 @@
+import { Args, Flags } from '@oclif/core';
+import { BaseCommand } from '../../base-command.js';
+export default class IngestNumeric extends BaseCommand {
+    static args = {
+        value: Args.string({ description: 'Numeric value to ingest', required: true }),
+    };
+    static description = `Ingest a numeric data point to a device stream.
+
+Sends a single numeric value to the specified device stream. The value must be a valid number.
+Numeric streams are commonly used for sensor readings like battery level, temperature, speed, etc.`;
+    static examples = [
+        '<%= config.bin %> ingest numeric 42.5 --device <device-id> --stream battery_level',
+        '<%= config.bin %> ingest numeric 98.6 --device <device-id> --stream temperature --tag unit=fahrenheit',
+        '<%= config.bin %> ingest numeric 1500 --device <device-id> --stream rpm --timestamp 1700000000000',
+    ];
+    static flags = {
+        device: Flags.string({
+            char: 'd',
+            description: 'Device ID (UUID)',
+            required: true,
+        }),
+        stream: Flags.string({
+            char: 's',
+            description: 'Stream name',
+            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 numeric data';
+    async run() {
+        // Parse and validate numeric value
+        const numericValue = Number.parseFloat(this.args.value);
+        if (Number.isNaN(numericValue)) {
+            this.error(`Invalid numeric value: "${this.args.value}". Must be a valid number.`);
+        }
+        // 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: 'numeric',
+                    tags,
+                    points: [[timestamp, numericValue]],
+                },
+            ],
+        };
+        // Send request (expect 204 No Content)
+        await this.api('ingest', 'batch', { body, method: 'POST' });
+        if (!this.jsonEnabled()) {
+            this.log(`\n✓ Ingested numeric value ${numericValue} to stream "${this.flags.stream}" on device ${this.flags.device} (${this.env})\n`);
+        }
+        // Return the request body for --json output
+        return body;
+    }
+}
+//# sourceMappingURL=numeric.js.map

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

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

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

@@ -0,0 +1,16 @@
+import { BaseCommand } from '../../base-command.js';
+export default class IngestText extends BaseCommand<typeof IngestText> {
+    static args: {
+        value: import("@oclif/core/interfaces").Arg<string, Record<string, unknown>>;
+    };
+    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>;
+        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>>;
+}