@formant/formant-cli 0.4.2 → 0.4.4

package/dist/lib/presence.d.ts

@@ -0,0 +1,46 @@
+/**
+ * Shared utilities for querying per-stream per-device data presence
+ * via the analytics SQL backend.
+ *
+ * Uses a UNION ALL across all telemetry tables to discover what data
+ * exists, grouped by (device_id, stream_name, stream_type).
+ */
+export interface StreamPresenceRow {
+    data_points: number;
+    device_id: string;
+    first_seen: string;
+    last_seen: string;
+    stream_name: string;
+    stream_type: string;
+}
+/**
+ * Build a SQL query that returns per-stream per-device data presence.
+ *
+ * Returns columns: device_id, stream_name, stream_type, data_points, first_seen, last_seen
+ */
+export declare function buildPresenceSQL(options: {
+    days?: number;
+    deviceIds?: string[];
+    limit?: number;
+    streamNames?: string[];
+    streamTypes?: string[];
+}): string;
+/**
+ * Build a SQL query that returns the last time any data was seen per device.
+ *
+ * Returns columns: device_id, last_seen, total_points, stream_count
+ */
+export declare function buildLastSeenSQL(options: {
+    days?: number;
+    deviceIds?: string[];
+}): string;
+/**
+ * Normalize a timestamp string from analytics SQL (e.g. "2026-02-19 23:37:04.747")
+ * to ISO 8601 format ("2026-02-19T23:37:04.747Z").
+ */
+export declare function toIsoDateTime(sqlTimestamp: string): string;
+/**
+ * Freshness label based on how recently data was seen.
+ */
+export type FreshnessLevel = 'active' | 'dormant' | 'recent' | 'stale';
+export declare function getFreshness(lastSeenIso: string): FreshnessLevel;

package/dist/lib/presence.js

@@ -0,0 +1,95 @@
+/**
+ * Shared utilities for querying per-stream per-device data presence
+ * via the analytics SQL backend.
+ *
+ * Uses a UNION ALL across all telemetry tables to discover what data
+ * exists, grouped by (device_id, stream_name, stream_type).
+ */
+/**
+ * The telemetry tables that hold stream data.
+ * Each has: organization_id, device_id, name, tags, time, and type-specific value columns.
+ */
+const TELEMETRY_TABLES = [
+    { streamType: 'numeric', table: 'query_numeric' },
+    { streamType: 'text', table: 'query_text' },
+    { streamType: 'json', table: 'query_json' },
+    { streamType: 'location', table: 'query_location' },
+    { streamType: 'battery', table: 'query_battery' },
+    { streamType: 'health', table: 'query_health' },
+    { streamType: 'bitset', table: 'query_bitset' },
+    { streamType: 'numeric_set', table: 'query_numeric_set' },
+];
+/**
+ * Build a SQL query that returns per-stream per-device data presence.
+ *
+ * Returns columns: device_id, stream_name, stream_type, data_points, first_seen, last_seen
+ */
+export function buildPresenceSQL(options) {
+    const { days = 7, deviceIds, limit = 500, streamNames, streamTypes } = options;
+    // Filter to requested stream types or use all
+    const tables = streamTypes
+        ? TELEMETRY_TABLES.filter((t) => streamTypes.includes(t.streamType))
+        : TELEMETRY_TABLES;
+    if (tables.length === 0) {
+        throw new Error(`No matching stream types. Valid types: ${TELEMETRY_TABLES.map((t) => t.streamType).join(', ')}`);
+    }
+    const deviceFilter = deviceIds?.length
+        ? `AND device_id IN (${deviceIds.map((id) => `'${id}'`).join(', ')})`
+        : '';
+    const nameFilter = streamNames?.length
+        ? `AND name IN (${streamNames.map((n) => `'${n}'`).join(', ')})`
+        : '';
+    const subqueries = tables.map(({ streamType, table }) => `SELECT device_id, name AS stream_name, '${streamType}' AS stream_type, ` +
+        `count(*) AS data_points, min(time) AS first_seen, max(time) AS last_seen ` +
+        `FROM ${table} ` +
+        `WHERE time > now() - INTERVAL ${days} DAY ${deviceFilter} ${nameFilter} ` +
+        `GROUP BY device_id, name`);
+    return (`SELECT device_id, stream_name, stream_type, data_points, first_seen, last_seen FROM (\n` +
+        subqueries.join('\nUNION ALL\n') +
+        `\n) ORDER BY last_seen DESC LIMIT ${limit}`);
+}
+/**
+ * Build a SQL query that returns the last time any data was seen per device.
+ *
+ * Returns columns: device_id, last_seen, total_points, stream_count
+ */
+export function buildLastSeenSQL(options) {
+    const { days = 30, deviceIds } = options;
+    const deviceFilter = deviceIds?.length
+        ? `AND device_id IN (${deviceIds.map((id) => `'${id}'`).join(', ')})`
+        : '';
+    const subqueries = TELEMETRY_TABLES.map(({ table }) => `SELECT device_id, max(time) AS last_seen, count(*) AS data_points, count(DISTINCT name) AS stream_count ` +
+        `FROM ${table} ` +
+        `WHERE time > now() - INTERVAL ${days} DAY ${deviceFilter} ` +
+        `GROUP BY device_id`);
+    return (`SELECT device_id, max(last_seen) AS last_seen, sum(data_points) AS total_points, sum(stream_count) AS stream_count FROM (\n` +
+        subqueries.join('\nUNION ALL\n') +
+        `\n) GROUP BY device_id ORDER BY last_seen DESC`);
+}
+/**
+ * Normalize a timestamp string from analytics SQL (e.g. "2026-02-19 23:37:04.747")
+ * to ISO 8601 format ("2026-02-19T23:37:04.747Z").
+ */
+export function toIsoDateTime(sqlTimestamp) {
+    if (!sqlTimestamp)
+        return sqlTimestamp;
+    // Already ISO
+    if (sqlTimestamp.includes('T'))
+        return sqlTimestamp;
+    // Replace first space with T, append Z if no timezone
+    const iso = sqlTimestamp.replace(' ', 'T');
+    return iso.endsWith('Z') ? iso : iso + 'Z';
+}
+export function getFreshness(lastSeenIso) {
+    const lastSeen = new Date(lastSeenIso).getTime();
+    const now = Date.now();
+    const hoursAgo = (now - lastSeen) / (1000 * 60 * 60);
+    if (hoursAgo < 1)
+        return 'active';
+    if (hoursAgo < 24)
+        return 'recent';
+    if (hoursAgo < 7 * 24)
+        return 'stale';
+    return 'dormant';
+}
+//# sourceMappingURL=presence.js.map

package/dist/lib/presence.js.map

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