@switchbot/openapi-cli 3.1.1 → 3.2.0

package/dist/devices/device-meta.js

@@ -1,56 +0,0 @@
-import fs from 'node:fs';
-import path from 'node:path';
-import os from 'node:os';
-import { getConfigPath } from '../utils/flags.js';
-function metaFilePath() {
-    const override = getConfigPath();
-    const dir = override
-        ? path.dirname(path.resolve(override))
-        : path.join(os.homedir(), '.switchbot');
-    return path.join(dir, 'device-meta.json');
-}
-export function getMetaFilePath() {
-    return metaFilePath();
-}
-export function loadDeviceMeta() {
-    const file = metaFilePath();
-    if (!fs.existsSync(file))
-        return { version: '1', devices: {} };
-    try {
-        const raw = fs.readFileSync(file, 'utf-8');
-        const parsed = JSON.parse(raw);
-        if (!parsed ||
-            parsed.version !== '1' ||
-            typeof parsed.devices !== 'object' ||
-            parsed.devices === null) {
-            return { version: '1', devices: {} };
-        }
-        return parsed;
-    }
-    catch {
-        return { version: '1', devices: {} };
-    }
-}
-export function saveDeviceMeta(meta) {
-    const file = metaFilePath();
-    const dir = path.dirname(file);
-    if (!fs.existsSync(dir))
-        fs.mkdirSync(dir, { recursive: true });
-    const tmp = `${file}.tmp-${process.pid}`;
-    fs.writeFileSync(tmp, JSON.stringify(meta, null, 2), { mode: 0o600 });
-    fs.renameSync(tmp, file);
-}
-export function getDeviceMeta(deviceId) {
-    const meta = loadDeviceMeta();
-    return meta.devices[deviceId] ?? null;
-}
-export function setDeviceMeta(deviceId, patch) {
-    const meta = loadDeviceMeta();
-    meta.devices[deviceId] = { ...meta.devices[deviceId], ...patch };
-    saveDeviceMeta(meta);
-}
-export function clearDeviceMeta(deviceId) {
-    const meta = loadDeviceMeta();
-    delete meta.devices[deviceId];
-    saveDeviceMeta(meta);
-}

package/dist/devices/history-agg.js

@@ -1,138 +0,0 @@
-import fs from 'node:fs';
-import readline from 'node:readline';
-import { jsonlFilesForDevice, parseDurationToMs, resolveRange } from './history-query.js';
-export const ALL_AGG_FNS = ['count', 'min', 'max', 'avg', 'sum', 'p50', 'p95'];
-export const DEFAULT_AGGS = ['count', 'avg'];
-export const DEFAULT_SAMPLE_CAP = 10_000;
-export const MAX_SAMPLE_CAP = 100_000;
-export async function aggregateDeviceHistory(deviceId, opts) {
-    const { fromMs, toMs } = resolveRange(opts);
-    const aggs = (opts.aggs && opts.aggs.length > 0) ? opts.aggs : [...DEFAULT_AGGS];
-    const needQuantile = aggs.includes('p50') || aggs.includes('p95');
-    let bucketMs = null;
-    if (opts.bucket !== undefined) {
-        bucketMs = parseDurationToMs(opts.bucket);
-        if (bucketMs === null) {
-            throw new Error(`Invalid --bucket "${opts.bucket}". Expected e.g. "15m", "1h", "1d".`);
-        }
-    }
-    const sampleCap = Math.max(1, Math.min(opts.maxBucketSamples ?? DEFAULT_SAMPLE_CAP, MAX_SAMPLE_CAP));
-    let partial = false;
-    const notes = [];
-    // bucketKey (epoch ms; 0 when no --bucket) → metric name → Acc
-    const buckets = new Map();
-    for (const file of jsonlFilesForDevice(deviceId)) {
-        try {
-            const st = fs.statSync(file);
-            if (st.mtimeMs < fromMs)
-                continue;
-        }
-        catch {
-            continue;
-        }
-        const stream = fs.createReadStream(file, { encoding: 'utf-8' });
-        const rl = readline.createInterface({ input: stream, crlfDelay: Infinity });
-        for await (const line of rl) {
-            if (!line)
-                continue;
-            let rec;
-            try {
-                rec = JSON.parse(line);
-            }
-            catch {
-                continue;
-            }
-            const tMs = Date.parse(rec.t);
-            if (!Number.isFinite(tMs) || tMs < fromMs || tMs > toMs)
-                continue;
-            const key = bucketMs !== null ? Math.floor(tMs / bucketMs) * bucketMs : 0;
-            let bkt = buckets.get(key);
-            if (!bkt) {
-                bkt = new Map();
-                buckets.set(key, bkt);
-            }
-            for (const metric of opts.metrics) {
-                const v = rec.payload?.[metric];
-                if (typeof v !== 'number' || !Number.isFinite(v))
-                    continue;
-                let acc = bkt.get(metric);
-                if (!acc) {
-                    acc = {
-                        min: v,
-                        max: v,
-                        sum: 0,
-                        count: 0,
-                        samples: needQuantile ? [] : null,
-                        sampleCapHit: false,
-                    };
-                    bkt.set(metric, acc);
-                }
-                acc.min = Math.min(acc.min, v);
-                acc.max = Math.max(acc.max, v);
-                acc.sum += v;
-                acc.count += 1;
-                if (acc.samples) {
-                    if (acc.samples.length < sampleCap) {
-                        acc.samples.push(v);
-                    }
-                    else if (!acc.sampleCapHit) {
-                        acc.sampleCapHit = true;
-                        partial = true;
-                        notes.push(`bucket ${new Date(key).toISOString()} metric ${metric}: sample cap ${sampleCap} reached, quantiles approximate`);
-                    }
-                }
-            }
-        }
-    }
-    return finalize(deviceId, opts, aggs, buckets, partial, notes, fromMs, toMs);
-}
-function finalize(deviceId, opts, aggs, buckets, partial, notes, fromMs, toMs) {
-    const fromIso = Number.isFinite(fromMs) ? new Date(fromMs).toISOString() : new Date(0).toISOString();
-    const toIso = Number.isFinite(toMs) ? new Date(toMs).toISOString() : new Date(Date.now()).toISOString();
-    const keys = [...buckets.keys()].sort((a, b) => a - b);
-    const outBuckets = [];
-    for (const key of keys) {
-        const perMetric = buckets.get(key);
-        const metricsOut = {};
-        for (const [metric, acc] of perMetric.entries()) {
-            if (acc.count === 0)
-                continue;
-            const r = {};
-            if (aggs.includes('count'))
-                r.count = acc.count;
-            if (aggs.includes('min'))
-                r.min = acc.min;
-            if (aggs.includes('max'))
-                r.max = acc.max;
-            if (aggs.includes('avg'))
-                r.avg = acc.sum / acc.count;
-            if (aggs.includes('sum'))
-                r.sum = acc.sum;
-            if ((aggs.includes('p50') || aggs.includes('p95')) && acc.samples) {
-                const sorted = [...acc.samples].sort((a, b) => a - b);
-                if (aggs.includes('p50'))
-                    r.p50 = sorted[Math.floor(0.5 * (sorted.length - 1))];
-                if (aggs.includes('p95'))
-                    r.p95 = sorted[Math.floor(0.95 * (sorted.length - 1))];
-            }
-            metricsOut[metric] = r;
-        }
-        if (Object.keys(metricsOut).length === 0)
-            continue;
-        outBuckets.push({
-            t: new Date(key).toISOString(),
-            metrics: metricsOut,
-        });
-    }
-    return {
-        deviceId,
-        bucket: opts.bucket,
-        from: fromIso,
-        to: toIso,
-        metrics: [...opts.metrics],
-        aggs: [...aggs],
-        buckets: outBuckets,
-        partial,
-        notes,
-    };
-}

package/dist/devices/history-query.js

@@ -1,181 +0,0 @@
-import fs from 'node:fs';
-import path from 'node:path';
-import os from 'node:os';
-import readline from 'node:readline';
-const DEFAULT_LIMIT = 1000;
-function historyDir() {
-    return path.join(os.homedir(), '.switchbot', 'device-history');
-}
-/**
- * Parse a duration shortcut like "7d", "12h", "30m", "45s" into milliseconds.
- * Returns null on malformed input (caller throws UsageError).
- */
-export function parseDurationToMs(spec) {
-    const m = spec.trim().match(/^(\d+)(ms|s|m|h|d)$/i);
-    if (!m)
-        return null;
-    const n = Number(m[1]);
-    const unit = m[2].toLowerCase();
-    const factor = unit === 'ms' ? 1 : unit === 's' ? 1_000 : unit === 'm' ? 60_000 : unit === 'h' ? 3_600_000 : 86_400_000;
-    return n * factor;
-}
-/** Parse ISO-8601 (with Z or offset) or Date-parseable string → ms, else null. */
-export function parseInstantToMs(spec) {
-    const ms = Date.parse(spec);
-    return Number.isFinite(ms) ? ms : null;
-}
-export function resolveRange(opts) {
-    let fromMs = Number.NEGATIVE_INFINITY;
-    let toMs = Number.POSITIVE_INFINITY;
-    if (opts.since && (opts.from || opts.to)) {
-        throw new Error('--since is mutually exclusive with --from/--to.');
-    }
-    if (opts.since) {
-        const durMs = parseDurationToMs(opts.since);
-        if (durMs === null) {
-            throw new Error(`Invalid --since value "${opts.since}". Expected e.g. "30s", "15m", "1h", "7d".`);
-        }
-        fromMs = Date.now() - durMs;
-    }
-    else {
-        if (opts.from) {
-            const parsed = parseInstantToMs(opts.from);
-            if (parsed === null)
-                throw new Error(`Invalid --from value "${opts.from}". Expected ISO-8601 timestamp.`);
-            fromMs = parsed;
-        }
-        if (opts.to) {
-            const parsed = parseInstantToMs(opts.to);
-            if (parsed === null)
-                throw new Error(`Invalid --to value "${opts.to}". Expected ISO-8601 timestamp.`);
-            toMs = parsed;
-        }
-        if (fromMs > toMs)
-            throw new Error('--from must be <= --to.');
-    }
-    return { fromMs, toMs };
-}
-/** Return jsonl candidate files for a device, oldest-first. */
-export function jsonlFilesForDevice(deviceId, baseDir = historyDir()) {
-    const out = [];
-    if (!fs.existsSync(baseDir))
-        return out;
-    // Oldest-first so range walks can bail early once a line overshoots `toMs`.
-    for (let i = 3; i >= 1; i--) {
-        const p = path.join(baseDir, `${deviceId}.jsonl.${i}`);
-        if (fs.existsSync(p))
-            out.push(p);
-    }
-    const current = path.join(baseDir, `${deviceId}.jsonl`);
-    if (fs.existsSync(current))
-        out.push(current);
-    return out;
-}
-function projectFields(record, fields) {
-    if (fields.length === 0)
-        return record;
-    const projected = {};
-    const payload = (record.payload ?? {});
-    for (const f of fields) {
-        if (f in payload)
-            projected[f] = payload[f];
-    }
-    return { t: record.t, topic: record.topic, deviceType: record.deviceType, payload: projected };
-}
-/**
- * Stream-read the JSONL rotation files for `deviceId` and return records
- * within [fromMs, toMs]. Parse failures are silently dropped (best-effort).
- *
- * Files whose mtime < fromMs are skipped whole (coarse but sound: the newest
- * record in the file is <= mtime, so nothing in it can match).
- */
-export async function queryDeviceHistory(deviceId, opts = {}) {
-    const { fromMs, toMs } = resolveRange(opts);
-    const limit = Math.max(0, opts.limit ?? DEFAULT_LIMIT);
-    const fields = opts.fields ?? [];
-    const files = jsonlFilesForDevice(deviceId);
-    const out = [];
-    for (const file of files) {
-        try {
-            const stat = fs.statSync(file);
-            if (stat.mtimeMs < fromMs)
-                continue;
-        }
-        catch {
-            continue;
-        }
-        const stream = fs.createReadStream(file, { encoding: 'utf-8' });
-        const rl = readline.createInterface({ input: stream, crlfDelay: Infinity });
-        for await (const line of rl) {
-            if (!line)
-                continue;
-            let rec;
-            try {
-                rec = JSON.parse(line);
-            }
-            catch {
-                continue;
-            }
-            const tMs = Date.parse(rec.t);
-            if (!Number.isFinite(tMs))
-                continue;
-            if (tMs < fromMs || tMs > toMs)
-                continue;
-            out.push(projectFields(rec, fields));
-            if (out.length >= limit) {
-                rl.close();
-                stream.destroy();
-                return out;
-            }
-        }
-    }
-    return out;
-}
-export function queryDeviceHistoryStats(deviceId) {
-    const dir = historyDir();
-    const files = jsonlFilesForDevice(deviceId);
-    let totalBytes = 0;
-    let oldest = null;
-    let newest = null;
-    let count = 0;
-    for (const file of files) {
-        try {
-            totalBytes += fs.statSync(file).size;
-        }
-        catch { /* */ }
-    }
-    // Walk the oldest file's head + current file's tail for oldest/newest + count.
-    // Counting is O(records) here, acceptable for "stats" which isn't a hot path.
-    for (const file of files) {
-        try {
-            const lines = fs.readFileSync(file, 'utf-8').split('\n');
-            for (const line of lines) {
-                if (!line)
-                    continue;
-                count += 1;
-                try {
-                    const rec = JSON.parse(line);
-                    const tMs = Date.parse(rec.t);
-                    if (Number.isFinite(tMs)) {
-                        if (oldest === null || tMs < oldest)
-                            oldest = tMs;
-                        if (newest === null || tMs > newest)
-                            newest = tMs;
-                    }
-                }
-                catch { /* */ }
-            }
-        }
-        catch { /* */ }
-    }
-    return {
-        deviceId,
-        fileCount: files.length,
-        totalBytes,
-        recordCount: count,
-        oldest: oldest !== null ? new Date(oldest).toISOString() : undefined,
-        newest: newest !== null ? new Date(newest).toISOString() : undefined,
-        jsonlFiles: files.map((f) => path.basename(f)),
-        historyDir: dir,
-    };
-}