diffpx 0.0.2

package/bin/diffpx.js

@@ -0,0 +1,32 @@
+#!/usr/bin/env node
+const crypto = require('crypto');
+const {loadConfig} = require('../src/configLoader');
+const {runJob} = require('../src/runner');
+
+(async () => {
+    const {config, devicesConfig, settings} = await loadConfig();
+
+    const ppKey = process.env.PP_KEY;
+    if (!ppKey) throw new Error('No API key found in .env or settings.yml');
+
+    const timestamp = new Date().toISOString().replace('T', ' ').split('.')[0];
+    const groupId = crypto.randomUUID();
+
+    const payload = {
+        timestamp,
+        groupId,
+        settings,
+        devices: devicesConfig,
+        snapshots: config
+    };
+
+    try {
+        await runJob({
+            ppKey,
+            payload
+        });
+    } catch (err) {
+        console.error('🔴 Error:', err.message);
+        process.exitCode = 1;
+    }
+})();

package/package.json

@@ -0,0 +1,24 @@
+{
+  "name": "diffpx",
+  "version": "0.0.2",
+  "bin": {
+    "diffpx": "bin/diffpx.js"
+  },
+  "scripts": {
+    "start": "node bin/diffpx.js"
+  },
+  "dependencies": {
+    "axios": "^1.7.4",
+    "cli-progress": "^3.12.0",
+    "dotenv": "^16.4.5",
+    "js-yaml": "^4.1.0"
+  },
+  "description": "",
+  "keywords": [],
+  "author": "",
+  "license": "ISC",
+  "files": [
+    "bin",
+    "src"
+  ]
+}

package/src/configLoader.js

@@ -0,0 +1,11 @@
+const fs = require('fs');
+const yaml = require('js-yaml');
+const validateConfig = require('./validateConfig');
+
+async function loadConfig() {
+    const { config, devicesConfig } = await validateConfig();
+    const settings = yaml.load(fs.readFileSync('settings.yml', 'utf8'));
+    return { config, devicesConfig, settings };
+}
+
+module.exports = { loadConfig };

package/src/runner.js

@@ -0,0 +1,117 @@
+const cliProgress = require('cli-progress');
+const {pollRun, submitRun} = require('./upload');
+
+function normalizePxLabel(v) {
+    if (v === null || v === undefined) return '';
+    const s = String(v).trim();
+    if (!s) return '';
+    return s.endsWith('px') ? s : `${s}px`;
+}
+
+function getInitialSnapshotName(payload) {
+    const n = payload?.snapshots?.[0]?.name;
+    return n ? String(n) : 'snapshots';
+}
+
+function getInitialWidthName(payload) {
+    const w = payload?.settings?.width?.[0];
+    const label = normalizePxLabel(w);
+    return label || 'widths';
+}
+
+function getProgress(status) {
+    const p = status?.progress || status?.data?.progress || {};
+
+    const snapshotsTotal = Number(p.snapshotsTotal ?? p.outerTotal ?? p.totalSnapshots ?? p.total ?? 0) || 0;
+    const snapshotsDone = Number(p.snapshotsDone ?? p.outerDone ?? p.completedSnapshots ?? p.completed ?? 0) || 0;
+    const snapshotName = String(p.snapshotName ?? p.outerName ?? p.currentSnapshot ?? '') || '';
+
+    const widthsTotal = Number(p.widthsTotal ?? p.innerTotal ?? p.runsTotal ?? p.totalRuns ?? 0) || 0;
+    const widthsDone = Number(p.widthsDone ?? p.innerDone ?? p.runsDone ?? p.doneRuns ?? 0) || 0;
+    const widthLabel = String(p.widthLabel ?? p.runName ?? p.innerName ?? p.currentWidth ?? '') || '';
+
+    const state = String(status?.state || status?.status || '').toLowerCase();
+    const error = status?.error || status?.message || null;
+
+    return {
+        snapshotsTotal,
+        snapshotsDone,
+        snapshotName,
+        widthsTotal,
+        widthsDone,
+        widthLabel,
+        state,
+        error
+    };
+}
+
+async function runJob({ppKey, payload}) {
+    const multiBar = new cliProgress.MultiBar({
+        clearOnComplete: false,
+        hideCursor: true,
+        barCompleteChar: '█',
+        barIncompleteChar: '░',
+        format: '{name} [{bar}] {percentage}% | {value}/{total}'
+    }, cliProgress.Presets.shades_classic);
+
+    const initialSnapshotsTotal = Array.isArray(payload?.snapshots) ? payload.snapshots.length : 1;
+    const initialWidthsTotal = Array.isArray(payload?.settings?.width) ? payload.settings.width.length : 1;
+
+    const snapshotsBar = multiBar.create(
+        Math.max(1, initialSnapshotsTotal),
+        0,
+        {name: getInitialSnapshotName(payload)}
+    );
+
+    const widthsBar = multiBar.create(
+        Math.max(1, initialWidthsTotal),
+        0,
+        {name: getInitialWidthName(payload)}
+    );
+
+    let jobId = null;
+
+    try {
+        const res = await submitRun(ppKey, payload);
+        jobId = res?.jobId || res?.id || res?.job_id || res?.data?.jobId || null;
+        if (!jobId) {
+            throw new Error('Server did not return a job id');
+        }
+
+        const finalStatus = await pollRun(ppKey, jobId, {
+            intervalMs: Number(process.env.PP_POLL_INTERVAL_MS || 1000),
+            onStatus: (status) => {
+                const p = getProgress(status);
+
+                const snapshotLabel = p.snapshotName || getInitialSnapshotName(payload);
+                const widthLabel = normalizePxLabel(p.widthLabel) || getInitialWidthName(payload);
+
+                const snapTotal = p.snapshotsTotal > 0 ? p.snapshotsTotal : Math.max(1, initialSnapshotsTotal);
+                const snapDone = p.snapshotsTotal > 0 ? Math.min(p.snapshotsDone, p.snapshotsTotal) : snapshotsBar.value;
+
+                snapshotsBar.setTotal(snapTotal);
+                snapshotsBar.update(snapDone, {name: snapshotLabel});
+
+                const wTotal = p.widthsTotal > 0 ? p.widthsTotal : Math.max(1, initialWidthsTotal);
+                const wDone = p.widthsTotal > 0 ? Math.min(p.widthsDone, p.widthsTotal) : widthsBar.value;
+
+                widthsBar.setTotal(wTotal);
+                widthsBar.update(wDone, {name: widthLabel});
+            }
+        });
+
+        const finalState = String(finalStatus?.state || finalStatus?.status || '').toLowerCase();
+        if (finalState === 'error' || finalState === 'failed' || finalState === 'canceled' || finalState === 'cancelled') {
+            const msg = finalStatus?.error || finalStatus?.message || 'Job failed';
+            throw new Error(msg);
+        }
+
+        return finalStatus;
+    } finally {
+        snapshotsBar.stop();
+        widthsBar.stop();
+        multiBar.stop();
+    }
+}
+
+module.exports = {runJob};

package/src/upload.js

@@ -0,0 +1,80 @@
+const axios = require('axios');
+require('dotenv').config();
+
+const ppUrl = process.env.PP_URL || '';
+
+const sleep = (ms) => new Promise((r) => setTimeout(r, ms));
+
+function axiosErrorMessage(err) {
+    const status = err?.response?.status;
+    const statusText = err?.response?.statusText;
+
+    const data = err?.response?.data;
+    const body = typeof data === 'string'
+        ? ((data.match(/<pre>([\s\S]*?)<\/pre>/i)?.[1] || data).replace(/<[^>]*>/g, ' ').replace(/\s+/g, ' ').trim())
+        : '';
+
+    return [status ? `HTTP ${status}${statusText ? ` ${statusText}` : ''}` : '', body || '']
+        .filter(Boolean)
+        .join(' | ');
+}
+
+async function submitRun(ppKey, payload) {
+    if (!ppUrl) {
+        throw new Error('PP_URL not configured');
+    }
+
+    try {
+        const res = await axios.post(`${ppUrl}/runs`, payload, {
+            headers: {
+                'Content-Type': 'application/json',
+                Authorization: `Bearer ${ppKey}`
+            },
+            maxBodyLength: Infinity
+        });
+
+        return res.data;
+    } catch (err) {
+        throw new Error(axiosErrorMessage(err));
+    }
+}
+
+async function fetchJobStatus(ppKey, jobId) {
+    if (!ppUrl) {
+        throw new Error('PP_URL not configured');
+    }
+
+    try {
+        const res = await axios.get(`${ppUrl}/runs/${encodeURIComponent(jobId)}`, {
+            headers: {
+                Authorization: `Bearer ${ppKey}`
+            }
+        });
+
+        return res.data;
+    } catch (err) {
+        throw new Error(axiosErrorMessage(err));
+    }
+}
+
+async function pollRun(ppKey, jobId, {intervalMs = 1000, onStatus} = {}) {
+    for (;;) {
+        const status = await fetchJobStatus(ppKey, jobId);
+        if (onStatus) onStatus(status);
+
+        const state = String(status?.state || status?.status || '').toLowerCase();
+        if (state === 'done' || state === 'finished' || state === 'success' || state === 'completed') {
+            return status;
+        }
+        if (state === 'error' || state === 'failed' || state === 'canceled' || state === 'cancelled') {
+            return status;
+        }
+
+        await sleep(intervalMs);
+    }
+}
+
+module.exports = {
+    submitRun,
+    pollRun
+};

package/src/validateConfig.js

@@ -0,0 +1,72 @@
+const fs = require('fs');
+const yaml = require('js-yaml');
+const axios = require('axios');
+require('dotenv').config({ override: false });
+
+async function validateConfig() {
+    const errors = [];
+
+    const ppKey = process.env.PP_KEY;
+    const ppUrl = process.env.PP_URL;
+
+    if (!ppKey) errors.push("🔴 Missing PP_KEY in .env");
+    if (!ppUrl) errors.push("🔴 Missing PP_URL in .env");
+
+    if (errors.length > 0) {
+        console.error("🔴 Configuration check failed:");
+        for (const err of errors) console.error("   " + err);
+        process.exit(1);
+    }
+
+    try {
+        await axios.get(`${ ppUrl }/auth/ping`, {
+            headers: { Authorization: `Bearer ${ ppKey }` },
+            timeout: 5000
+        });
+    } catch (err) {
+        const msg = err.response?.data?.error || err.message;
+        if (String(msg).includes("ECONNREFUSED") || String(msg).includes("ENOTFOUND")) {
+            console.error("🔴 API validation failed: Connection to server failed. Make sure PP_URL in .env is correct");
+        } else {
+            console.error("🔴 API validation failed:", msg);
+        }
+        process.exit(1);
+    }
+
+    const config = yaml.load(fs.readFileSync('snapshots.yml', 'utf8'));
+    const devicesList = yaml.load(fs.readFileSync('devices.yml', 'utf8'));
+
+    const devicesConfig = {};
+    for (const d of devicesList) devicesConfig[d.name] = d;
+
+    const seenNames = new Set();
+    const configErrors = [];
+
+    for (const entry of config) {
+        if (seenNames.has(entry.name)) {
+            configErrors.push(`🔴 Duplicate snapshot name "${ entry.name }" found in snapshots.yml`);
+        } else {
+            seenNames.add(entry.name);
+        }
+
+        if (entry.devices && entry.devices.length > 0) {
+            for (const d of entry.devices) {
+                if (!devicesConfig[d]) {
+                    configErrors.push(`🔴 Snapshot "${ entry.name }": Device "${ d }" not found in devices.yml`);
+                }
+            }
+        }
+    }
+
+    if (configErrors.length > 0) {
+        console.error("🔴 Configuration check failed:");
+        for (const err of configErrors) console.error("   " + err);
+        process.exit(1);
+    } else {
+        console.log("🟢 Configuration check passed.");
+    }
+
+    return { config, devicesConfig };
+}
+
+module.exports = validateConfig;