ovtools 0.0.0-stage → 1.0.0

package/dist/utils/browser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"browser.js","sourceRoot":"","sources":["../../src/utils/browser.ts"],"names":[],"mappings":";;AAEA,kCAeC;AAjBD,iDAAsC;AAEtC,SAAgB,WAAW,CAAC,GAAW;IACrC,IAAI,OAAO,CAAC,GAAG,CAAC,kBAAkB,KAAK,GAAG,IAAI,OAAO,CAAC,GAAG,CAAC,kBAAkB,KAAK,MAAM;QAAE,OAAO;IAChG,IAAI,CAAC;QACH,IAAI,OAAO,CAAC,QAAQ,KAAK,OAAO,EAAE,CAAC;YACjC,IAAA,qBAAK,EAAC,cAAc,EAAE,CAAC,GAAG,CAAC,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,KAAK,EAAE,QAAQ,EAAE,WAAW,EAAE,IAAI,EAAE,CAAC,CAAC,KAAK,EAAE,CAAC;YAC7F,OAAO;QACT,CAAC;QACD,IAAI,OAAO,CAAC,QAAQ,KAAK,QAAQ,EAAE,CAAC;YAClC,IAAA,qBAAK,EAAC,MAAM,EAAE,CAAC,GAAG,CAAC,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC,CAAC,KAAK,EAAE,CAAC;YAClE,OAAO;QACT,CAAC;QACD,IAAA,qBAAK,EAAC,UAAU,EAAE,CAAC,GAAG,CAAC,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC,CAAC,KAAK,EAAE,CAAC;IACxE,CAAC;IAAC,MAAM,CAAC;QACP,iEAAiE;IACnE,CAAC;AACH,CAAC"}

package/dist/utils/dashboard.d.ts

@@ -0,0 +1,16 @@
+import { SSHClient } from '../ssh/client';
+import { Logger } from '../utils/helpers';
+export interface DashboardOptions {
+    ip: string;
+    domain?: string;
+    sslMode?: 'auto' | 'cloudflare' | 'certbot';
+    certDir?: string;
+    email?: string;
+    reset?: boolean;
+}
+export declare function deployDashboard(client: SSHClient, logger: Logger, options: DashboardOptions, program?: string): Promise<{
+    healthy: boolean;
+    url: string;
+    host: string;
+}>;
+//# sourceMappingURL=dashboard.d.ts.map

package/dist/utils/dashboard.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dashboard.d.ts","sourceRoot":"","sources":["../../src/utils/dashboard.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,SAAS,EAAc,MAAM,eAAe,CAAC;AAEtD,OAAO,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAU1C,MAAM,WAAW,gBAAgB;IAC/B,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,GAAG,YAAY,GAAG,SAAS,CAAC;IAC5C,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED,wBAAsB,eAAe,CACnC,MAAM,EAAE,SAAS,EACjB,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,gBAAgB,EACzB,OAAO,SAAW,GACjB,OAAO,CAAC;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,GAAG,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC,CA0I1D"}

package/dist/utils/dashboard.js

@@ -0,0 +1,177 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.deployDashboard = deployDashboard;
+const path = __importStar(require("path"));
+const fs = __importStar(require("fs/promises"));
+const client_1 = require("../ssh/client");
+const constants_1 = require("../constants");
+const assets_1 = require("./assets");
+const REQUIRED = [
+    'server.py', 'index.html', 'app.js', 'styles.css', 'deploy-dashboard.sh',
+    'ssl-certbot.sh', 'nginx-octra.conf', 'octra-dashboard.service',
+    'prune-node-junk.sh', 'octra-node-prune.cron', 'octra-node-prune.service',
+    'octra-node-prune.timer',
+];
+async function deployDashboard(client, logger, options, program = 'manage') {
+    const log = (msg, level = 'info') => logger.log(msg, level, { host: client.host, program });
+    const domain = (options.domain || '').trim().toLowerCase();
+    if (domain && !/^[a-z0-9]([a-z0-9-]*[a-z0-9])?(\.[a-z0-9]([a-z0-9-]*[a-z0-9])?)+$/.test(domain)) {
+        throw new Error(`invalid domain '${domain}' (expected a host name such as node.example.com)`);
+    }
+    const sslMode = options.sslMode || 'auto';
+    if (sslMode === 'certbot' && !domain)
+        throw new Error("Let's Encrypt needs the domain (it must already point at the node)");
+    if (sslMode === 'cloudflare' && !options.certDir)
+        throw new Error('choose the folder that holds fullchain.pem and privkey.pem');
+    log('=== Deploy monitoring dashboard ===', 'step');
+    // --- TLS material ----------------------------------------------------
+    if (sslMode !== 'certbot' && options.certDir) {
+        for (const name of ['fullchain.pem', 'privkey.pem']) {
+            const file = path.join(options.certDir, name);
+            try {
+                await fs.access(file);
+            }
+            catch {
+                throw new Error(`certificate file missing: ${file}`);
+            }
+        }
+        const has = await client.exec('test -s /etc/ssl/octra/fullchain.pem && test -s /etc/ssl/octra/privkey.pem', { timeout: 60000 });
+        if (has.exitCode !== 0) {
+            log('Installing TLS material to /etc/ssl/octra/', 'step');
+            await client.exec('install -d -m 700 /etc/ssl/octra', { timeout: 60000 });
+            await client.uploadFile(path.join(options.certDir, 'fullchain.pem'), '/etc/ssl/octra/fullchain.pem', false);
+            await client.uploadFile(path.join(options.certDir, 'privkey.pem'), '/etc/ssl/octra/privkey.pem', false);
+            await client.exec('chmod 644 /etc/ssl/octra/fullchain.pem; chmod 600 /etc/ssl/octra/privkey.pem', { timeout: 60000 });
+            log('TLS material installed', 'ok');
+        }
+        else {
+            log('TLS material already present on the host - keeping it', 'info');
+        }
+    }
+    // --- sync assets (git bundle, single archive fallback) ---------------
+    const assets = new assets_1.AssetSync(client, logger, 'dashboard');
+    log('Syncing dashboard assets...', 'step');
+    const sync = await assets.syncDashboard(Boolean(options.reset));
+    log(sync.skipped
+        ? `dashboard files already up to date (${sync.head.slice(0, 12)}) - transfer skipped`
+        : `${sync.files} file(s) synced via ${sync.transport}`, 'ok');
+    const probeFiles = async () => client.exec(`for f in ${REQUIRED.map(client_1.shellQuote).join(' ')}; do test -f ${constants_1.REMOTE.dashboard}/$f || echo MISSING:$f; done`, { timeout: 60000 });
+    let probe = await probeFiles();
+    if (probe.stdout.includes('MISSING:')) {
+        log('dashboard files are incomplete after the checkpoint - forcing a full re-extract', 'warn');
+        await assets.syncDashboard(true);
+        probe = await probeFiles();
+    }
+    if (probe.stdout.includes('MISSING:')) {
+        throw new Error(`dashboard files are incomplete on ${client.host}: ${probe.stdout.trim()}`);
+    }
+    // --- force the published host name --------------------------------
+    // deploy-dashboard.sh keeps the server_name already live on the host, so a
+    // first deploy would stay on the template placeholder without this rewrite.
+    if (domain) {
+        const rewrite = [
+            `f=${constants_1.REMOTE.dashboard}/nginx-octra.conf`,
+            `[ -f "$f" ] || exit 2`,
+            `awk -v d=${(0, client_1.shellQuote)(domain)} '{ if ($0 ~ /^[[:space:]]*server_name[[:space:]]/) sub(/server_name[[:space:]]+[^;]+;/, "server_name " d ";"); print }' "$f" > "$f.tmp" && mv "$f.tmp" "$f"`,
+            `grep -qE '^[[:space:]]*server[[:space:]]*\\{' "$f" || exit 3`,
+            `s=/etc/nginx/sites-available/octra-dashboard`,
+            `if [ -f "$s" ]; then awk -v d=${(0, client_1.shellQuote)(domain)} '{ if ($0 ~ /^[[:space:]]*server_name[[:space:]]/) sub(/server_name[[:space:]]+[^;]+;/, "server_name " d ";"); print }' "$s" > "$s.tmp" && mv "$s.tmp" "$s"; fi`,
+            `sed -i "s|^# Domain  : .*|# Domain  : ${domain}   (edit server_name to your domain)|" "$f" || true`,
+        ].join('; ');
+        const result = await client.exec(rewrite, { timeout: 120000 });
+        if (result.exitCode !== 0) {
+            throw new Error(`nginx template rewrite failed for ${domain} (exit ${result.exitCode})`);
+        }
+        log(`nginx server_name forced to ${domain}`, 'ok');
+    }
+    // --- Let's Encrypt (helper is on the host now) ----------------------
+    if (sslMode === 'certbot') {
+        log(`Requesting a Let's Encrypt certificate for ${domain}...`, 'step');
+        let cmd = `bash ${constants_1.REMOTE.dashboard}/ssl-certbot.sh --domain ${(0, client_1.shellQuote)(domain)}`;
+        if (options.email)
+            cmd += ` --email ${(0, client_1.shellQuote)(options.email)}`;
+        const ssl = await client.exec(cmd, { timeout: 900000 });
+        if (ssl.exitCode !== 0) {
+            throw new Error(`certbot could not issue a certificate for ${domain}: ${ssl.stderr || ssl.stdout}`);
+        }
+    }
+    // --- install / restart ----------------------------------------------
+    log('Installing nginx site + systemd backend...', 'step');
+    const install = await client.exec(`bash ${constants_1.REMOTE.dashboard}/deploy-dashboard.sh`, {
+        timeout: 900000,
+        onLine: line => {
+            if (line.trim())
+                log(`    ${line}`, 'remote');
+        },
+    });
+    if (install.exitCode !== 0) {
+        const diag = await client.exec('systemctl status octra-dashboard --no-pager -n 20 || true; journalctl -u octra-dashboard -n 40 --no-pager || true', { timeout: 120000 });
+        for (const line of diag.stdout.split('\n'))
+            if (line.trim())
+                log(`    ${line}`, 'remote');
+        throw new Error('deploy-dashboard.sh reported errors - see the lines above');
+    }
+    // --- health check ----------------------------------------------------
+    let healthy = false;
+    for (let attempt = 1; attempt <= 6; attempt++) {
+        const probe = await client.exec('systemctl is-active --quiet octra-dashboard && curl -fsS -m 5 -o /dev/null http://127.0.0.1:9090/api/ping && echo BACKEND_OK', { timeout: 60000 });
+        if (probe.exitCode === 0) {
+            healthy = true;
+            break;
+        }
+        log(`waiting for octra-dashboard to answer /api/ping (${attempt}/6)...`, 'warn');
+        await new Promise(resolve => setTimeout(resolve, 5000));
+    }
+    // --- remove the retired manage drop-in/token -------------------------
+    if (healthy) {
+        await client.exec('changed=0; if [ -f /etc/systemd/system/octra-dashboard.service.d/manage.conf ]; then rm -f /etc/systemd/system/octra-dashboard.service.d/manage.conf; changed=1; fi; ' +
+            'if [ -f /opt/octra/dashboard/manage.token ]; then rm -f /opt/octra/dashboard/manage.token; changed=1; fi; ' +
+            'if [ "$changed" -eq 1 ]; then systemctl daemon-reload; systemctl restart octra-dashboard; sleep 2; fi; echo MANAGE_CLEANUP=done', { timeout: 300000 });
+    }
+    const host = domain || options.ip;
+    const scheme = domain ? 'https' : 'http';
+    if (!healthy) {
+        const diag = await client.exec('systemctl status octra-dashboard --no-pager -n 30 || true; journalctl -u octra-dashboard -n 40 --no-pager || true', { timeout: 120000 });
+        for (const line of diag.stdout.split('\n'))
+            if (line.trim())
+                log(`    ${line}`, 'remote');
+        throw new Error(`the dashboard backend did not answer /api/ping on ${client.host}`);
+    }
+    log(`monitoring dashboard live: ${scheme}://${host}/`, 'ok');
+    log(`API: ${scheme}://${host}/api/status`, 'info');
+    return { healthy, url: `${scheme}://${host}/`, host };
+}
+//# sourceMappingURL=dashboard.js.map

package/dist/utils/dashboard.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dashboard.js","sourceRoot":"","sources":["../../src/utils/dashboard.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAuBA,0CA+IC;AAtKD,2CAA6B;AAC7B,gDAAkC;AAClC,0CAAsD;AACtD,4CAAsC;AAEtC,qCAAqC;AAErC,MAAM,QAAQ,GAAG;IACf,WAAW,EAAE,YAAY,EAAE,QAAQ,EAAE,YAAY,EAAE,qBAAqB;IACxE,gBAAgB,EAAE,kBAAkB,EAAE,yBAAyB;IAC/D,oBAAoB,EAAE,uBAAuB,EAAE,0BAA0B;IACzE,wBAAwB;CACzB,CAAC;AAWK,KAAK,UAAU,eAAe,CACnC,MAAiB,EACjB,MAAc,EACd,OAAyB,EACzB,OAAO,GAAG,QAAQ;IAElB,MAAM,GAAG,GAAG,CAAC,GAAW,EAAE,QAA8D,MAAM,EAAE,EAAE,CAChG,MAAM,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,OAAO,EAAE,CAAC,CAAC;IACzD,MAAM,MAAM,GAAG,CAAC,OAAO,CAAC,MAAM,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IAC3D,IAAI,MAAM,IAAI,CAAC,mEAAmE,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC;QAChG,MAAM,IAAI,KAAK,CAAC,mBAAmB,MAAM,mDAAmD,CAAC,CAAC;IAChG,CAAC;IACD,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,IAAI,MAAM,CAAC;IAC1C,IAAI,OAAO,KAAK,SAAS,IAAI,CAAC,MAAM;QAAE,MAAM,IAAI,KAAK,CAAC,oEAAoE,CAAC,CAAC;IAC5H,IAAI,OAAO,KAAK,YAAY,IAAI,CAAC,OAAO,CAAC,OAAO;QAAE,MAAM,IAAI,KAAK,CAAC,4DAA4D,CAAC,CAAC;IAEhI,GAAG,CAAC,qCAAqC,EAAE,MAAM,CAAC,CAAC;IAEnD,wEAAwE;IACxE,IAAI,OAAO,KAAK,SAAS,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC;QAC7C,KAAK,MAAM,IAAI,IAAI,CAAC,eAAe,EAAE,aAAa,CAAC,EAAE,CAAC;YACpD,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;YAC9C,IAAI,CAAC;gBACH,MAAM,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;YACxB,CAAC;YAAC,MAAM,CAAC;gBACP,MAAM,IAAI,KAAK,CAAC,6BAA6B,IAAI,EAAE,CAAC,CAAC;YACvD,CAAC;QACH,CAAC;QACD,MAAM,GAAG,GAAG,MAAM,MAAM,CAAC,IAAI,CAAC,4EAA4E,EAAE,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC,CAAC;QAChI,IAAI,GAAG,CAAC,QAAQ,KAAK,CAAC,EAAE,CAAC;YACvB,GAAG,CAAC,4CAA4C,EAAE,MAAM,CAAC,CAAC;YAC1D,MAAM,MAAM,CAAC,IAAI,CAAC,kCAAkC,EAAE,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC,CAAC;YAC1E,MAAM,MAAM,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,eAAe,CAAC,EAAE,8BAA8B,EAAE,KAAK,CAAC,CAAC;YAC5G,MAAM,MAAM,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,aAAa,CAAC,EAAE,4BAA4B,EAAE,KAAK,CAAC,CAAC;YACxG,MAAM,MAAM,CAAC,IAAI,CAAC,8EAA8E,EAAE,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC,CAAC;YACtH,GAAG,CAAC,wBAAwB,EAAE,IAAI,CAAC,CAAC;QACtC,CAAC;aAAM,CAAC;YACN,GAAG,CAAC,uDAAuD,EAAE,MAAM,CAAC,CAAC;QACvE,CAAC;IACH,CAAC;IAED,wEAAwE;IACxE,MAAM,MAAM,GAAG,IAAI,kBAAS,CAAC,MAAM,EAAE,MAAM,EAAE,WAAW,CAAC,CAAC;IAC1D,GAAG,CAAC,6BAA6B,EAAE,MAAM,CAAC,CAAC;IAC3C,MAAM,IAAI,GAAG,MAAM,MAAM,CAAC,aAAa,CAAC,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC;IAChE,GAAG,CAAC,IAAI,CAAC,OAAO;QACd,CAAC,CAAC,uCAAuC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,sBAAsB;QACrF,CAAC,CAAC,GAAG,IAAI,CAAC,KAAK,uBAAuB,IAAI,CAAC,SAAS,EAAE,EAAE,IAAI,CAAC,CAAC;IAEhE,MAAM,UAAU,GAAG,KAAK,IAAI,EAAE,CAAC,MAAM,CAAC,IAAI,CACxC,YAAY,QAAQ,CAAC,GAAG,CAAC,mBAAU,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,gBAAgB,kBAAM,CAAC,SAAS,8BAA8B,EAC5G,EAAE,OAAO,EAAE,KAAK,EAAE,CACnB,CAAC;IACF,IAAI,KAAK,GAAG,MAAM,UAAU,EAAE,CAAC;IAC/B,IAAI,KAAK,CAAC,MAAM,CAAC,QAAQ,CAAC,UAAU,CAAC,EAAE,CAAC;QACtC,GAAG,CAAC,iFAAiF,EAAE,MAAM,CAAC,CAAC;QAC/F,MAAM,MAAM,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC;QACjC,KAAK,GAAG,MAAM,UAAU,EAAE,CAAC;IAC7B,CAAC;IACD,IAAI,KAAK,CAAC,MAAM,CAAC,QAAQ,CAAC,UAAU,CAAC,EAAE,CAAC;QACtC,MAAM,IAAI,KAAK,CAAC,qCAAqC,MAAM,CAAC,IAAI,KAAK,KAAK,CAAC,MAAM,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;IAC9F,CAAC;IAED,qEAAqE;IACrE,2EAA2E;IAC3E,4EAA4E;IAC5E,IAAI,MAAM,EAAE,CAAC;QACX,MAAM,OAAO,GAAG;YACd,KAAK,kBAAM,CAAC,SAAS,mBAAmB;YACxC,uBAAuB;YACvB,YAAY,IAAA,mBAAU,EAAC,MAAM,CAAC,8JAA8J;YAC5L,8DAA8D;YAC9D,8CAA8C;YAC9C,iCAAiC,IAAA,mBAAU,EAAC,MAAM,CAAC,kKAAkK;YACrN,yCAAyC,MAAM,qDAAqD;SACrG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACb,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC,CAAC;QAC/D,IAAI,MAAM,CAAC,QAAQ,KAAK,CAAC,EAAE,CAAC;YAC1B,MAAM,IAAI,KAAK,CAAC,qCAAqC,MAAM,UAAU,MAAM,CAAC,QAAQ,GAAG,CAAC,CAAC;QAC3F,CAAC;QACD,GAAG,CAAC,+BAA+B,MAAM,EAAE,EAAE,IAAI,CAAC,CAAC;IACrD,CAAC;IAED,uEAAuE;IACvE,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;QAC1B,GAAG,CAAC,8CAA8C,MAAM,KAAK,EAAE,MAAM,CAAC,CAAC;QACvE,IAAI,GAAG,GAAG,QAAQ,kBAAM,CAAC,SAAS,4BAA4B,IAAA,mBAAU,EAAC,MAAM,CAAC,EAAE,CAAC;QACnF,IAAI,OAAO,CAAC,KAAK;YAAE,GAAG,IAAI,YAAY,IAAA,mBAAU,EAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QAClE,MAAM,GAAG,GAAG,MAAM,MAAM,CAAC,IAAI,CAAC,GAAG,EAAE,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC,CAAC;QACxD,IAAI,GAAG,CAAC,QAAQ,KAAK,CAAC,EAAE,CAAC;YACvB,MAAM,IAAI,KAAK,CAAC,6CAA6C,MAAM,KAAK,GAAG,CAAC,MAAM,IAAI,GAAG,CAAC,MAAM,EAAE,CAAC,CAAC;QACtG,CAAC;IACH,CAAC;IAED,uEAAuE;IACvE,GAAG,CAAC,4CAA4C,EAAE,MAAM,CAAC,CAAC;IAC1D,MAAM,OAAO,GAAG,MAAM,MAAM,CAAC,IAAI,CAAC,QAAQ,kBAAM,CAAC,SAAS,sBAAsB,EAAE;QAChF,OAAO,EAAE,MAAM;QACf,MAAM,EAAE,IAAI,CAAC,EAAE;YACb,IAAI,IAAI,CAAC,IAAI,EAAE;gBAAE,GAAG,CAAC,OAAO,IAAI,EAAE,EAAE,QAAQ,CAAC,CAAC;QAChD,CAAC;KACF,CAAC,CAAC;IACH,IAAI,OAAO,CAAC,QAAQ,KAAK,CAAC,EAAE,CAAC;QAC3B,MAAM,IAAI,GAAG,MAAM,MAAM,CAAC,IAAI,CAAC,mHAAmH,EAAE,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC,CAAC;QACzK,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC;YAAE,IAAI,IAAI,CAAC,IAAI,EAAE;gBAAE,GAAG,CAAC,OAAO,IAAI,EAAE,EAAE,QAAQ,CAAC,CAAC;QAC1F,MAAM,IAAI,KAAK,CAAC,2DAA2D,CAAC,CAAC;IAC/E,CAAC;IAED,wEAAwE;IACxE,IAAI,OAAO,GAAG,KAAK,CAAC;IACpB,KAAK,IAAI,OAAO,GAAG,CAAC,EAAE,OAAO,IAAI,CAAC,EAAE,OAAO,EAAE,EAAE,CAAC;QAC9C,MAAM,KAAK,GAAG,MAAM,MAAM,CAAC,IAAI,CAC7B,8HAA8H,EAC9H,EAAE,OAAO,EAAE,KAAK,EAAE,CACnB,CAAC;QACF,IAAI,KAAK,CAAC,QAAQ,KAAK,CAAC,EAAE,CAAC;YACzB,OAAO,GAAG,IAAI,CAAC;YACf,MAAM;QACR,CAAC;QACD,GAAG,CAAC,oDAAoD,OAAO,QAAQ,EAAE,MAAM,CAAC,CAAC;QACjF,MAAM,IAAI,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC,CAAC;IAC1D,CAAC;IAED,wEAAwE;IACxE,IAAI,OAAO,EAAE,CAAC;QACZ,MAAM,MAAM,CAAC,IAAI,CACf,uKAAuK;YACvK,4GAA4G;YAC5G,iIAAiI,EACjI,EAAE,OAAO,EAAE,MAAM,EAAE,CACpB,CAAC;IACJ,CAAC;IAED,MAAM,IAAI,GAAG,MAAM,IAAI,OAAO,CAAC,EAAE,CAAC;IAClC,MAAM,MAAM,GAAG,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC;IACzC,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,MAAM,IAAI,GAAG,MAAM,MAAM,CAAC,IAAI,CAAC,mHAAmH,EAAE,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC,CAAC;QACzK,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC;YAAE,IAAI,IAAI,CAAC,IAAI,EAAE;gBAAE,GAAG,CAAC,OAAO,IAAI,EAAE,EAAE,QAAQ,CAAC,CAAC;QAC1F,MAAM,IAAI,KAAK,CAAC,qDAAqD,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC;IACtF,CAAC;IACD,GAAG,CAAC,8BAA8B,MAAM,MAAM,IAAI,GAAG,EAAE,IAAI,CAAC,CAAC;IAC7D,GAAG,CAAC,QAAQ,MAAM,MAAM,IAAI,aAAa,EAAE,MAAM,CAAC,CAAC;IACnD,OAAO,EAAE,OAAO,EAAE,GAAG,EAAE,GAAG,MAAM,MAAM,IAAI,GAAG,EAAE,IAAI,EAAE,CAAC;AACxD,CAAC"}

package/dist/utils/helpers.d.ts

@@ -0,0 +1,29 @@
+import type { LogEntry, LogLevel } from '../types';
+export declare function ensureDir(dirPath: string): Promise<void>;
+export declare function readJSON<T>(filePath: string): Promise<T | null>;
+export declare function writeJSON(filePath: string, data: unknown): Promise<void>;
+export declare function cleanLine(line: string): string;
+export declare function formatBytes(bytes: number): string;
+export declare function formatDuration(seconds: number): string;
+export declare function timestamp(): string;
+export type LogListener = (entry: LogEntry) => void;
+export declare class Logger {
+    private logFile;
+    private buffer;
+    private listeners;
+    private seq;
+    private writeChain;
+    private echo;
+    constructor(logFile: string, echo?: boolean);
+    log(message: string, level?: LogLevel, meta?: {
+        host?: string;
+        program?: string;
+    }): void;
+    private appendFile;
+    subscribe(listener: LogListener): () => void;
+    entriesSince(sinceSeq?: number, limit?: number): LogEntry[];
+    lastSeq(): number;
+    flush(): Promise<void>;
+}
+export declare function createLogger(name: string, echo?: boolean): Logger;
+//# sourceMappingURL=helpers.d.ts.map

package/dist/utils/helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"helpers.d.ts","sourceRoot":"","sources":["../../src/utils/helpers.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAC;AAGnD,wBAAsB,SAAS,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAE9D;AAED,wBAAsB,QAAQ,CAAC,CAAC,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC,CAQrE;AAED,wBAAsB,SAAS,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAgB9E;AAED,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAU9C;AAED,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAMjD;AAED,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAMtD;AAED,wBAAgB,SAAS,IAAI,MAAM,CAElC;AAED,MAAM,MAAM,WAAW,GAAG,CAAC,KAAK,EAAE,QAAQ,KAAK,IAAI,CAAC;AAsBpD,qBAAa,MAAM;IACjB,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,MAAM,CAAkB;IAChC,OAAO,CAAC,SAAS,CAA0B;IAC3C,OAAO,CAAC,GAAG,CAAK;IAChB,OAAO,CAAC,UAAU,CAAoC;IACtD,OAAO,CAAC,IAAI,CAAU;gBAEV,OAAO,EAAE,MAAM,EAAE,IAAI,UAAO;IAKxC,GAAG,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,GAAE,QAAiB,EAAE,IAAI,GAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAO,GAAG,IAAI;IA6BpG,OAAO,CAAC,UAAU;IAUlB,SAAS,CAAC,QAAQ,EAAE,WAAW,GAAG,MAAM,IAAI;IAK5C,YAAY,CAAC,QAAQ,SAAI,EAAE,KAAK,SAAO,GAAG,QAAQ,EAAE;IAKpD,OAAO,IAAI,MAAM;IAIX,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAG7B;AAED,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,UAAO,GAAG,MAAM,CAG9D"}

package/dist/utils/helpers.js

@@ -0,0 +1,204 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Logger = void 0;
+exports.ensureDir = ensureDir;
+exports.readJSON = readJSON;
+exports.writeJSON = writeJSON;
+exports.cleanLine = cleanLine;
+exports.formatBytes = formatBytes;
+exports.formatDuration = formatDuration;
+exports.timestamp = timestamp;
+exports.createLogger = createLogger;
+const fs = __importStar(require("fs/promises"));
+const path = __importStar(require("path"));
+const constants_1 = require("../constants");
+async function ensureDir(dirPath) {
+    await fs.mkdir(dirPath, { recursive: true });
+}
+async function readJSON(filePath) {
+    try {
+        const content = await fs.readFile(filePath, 'utf8');
+        return JSON.parse(content);
+    }
+    catch (err) {
+        if (err && err.code === 'ENOENT')
+            return null;
+        throw err;
+    }
+}
+async function writeJSON(filePath, data) {
+    await ensureDir(path.dirname(filePath));
+    const body = JSON.stringify(data, null, 2) + '\n';
+    const tmp = `${filePath}.tmp-${process.pid}-${Date.now()}`;
+    await fs.writeFile(tmp, body, 'utf8');
+    try {
+        await fs.rename(tmp, filePath);
+    }
+    catch (err) {
+        if (err && (err.code === 'EEXIST' || err.code === 'EPERM')) {
+            await fs.rm(filePath, { force: true });
+            await fs.rename(tmp, filePath);
+        }
+        else {
+            await fs.rm(tmp, { force: true });
+            throw err;
+        }
+    }
+}
+function cleanLine(line) {
+    let clean = String(line).replace(/\x1b\[[0-9;]*[A-Za-z]/g, '');
+    clean = clean.replace(/[─│┌┐└┘├┤┬┴┼]/g, '-');
+    clean = clean.replace(/[═║╔╗╚╝╠╣╦╩╬]/g, '=');
+    clean = clean.replace(/…/g, '...');
+    clean = clean.replace(/[\u2013\u2014\u2015\u2212\u00b7]/g, '-');
+    clean = clean.replace(/\u2192/g, '->');
+    clean = clean.replace(/[^\x09\x20-\x7E]/g, '');
+    clean = clean.replace(/[\x00-\x08\x0b-\x0c\x0e-\x1f\x7f]/g, '');
+    return clean.replace(/\r$/, '').trimEnd();
+}
+function formatBytes(bytes) {
+    if (!Number.isFinite(bytes) || bytes < 0)
+        return '?';
+    if (bytes < 1024)
+        return `${bytes} B`;
+    if (bytes < 1024 * 1024)
+        return `${(bytes / 1024).toFixed(1)} KB`;
+    if (bytes < 1024 * 1024 * 1024)
+        return `${(bytes / (1024 * 1024)).toFixed(1)} MB`;
+    return `${(bytes / (1024 * 1024 * 1024)).toFixed(2)} GB`;
+}
+function formatDuration(seconds) {
+    if (!Number.isFinite(seconds) || seconds < 0)
+        return '-';
+    if (seconds < 90)
+        return `${Math.round(seconds)}s`;
+    const m = Math.round(seconds / 60);
+    if (m < 60)
+        return `${m}m`;
+    return `${Math.floor(m / 60)}h ${String(m % 60).padStart(2, '0')}m`;
+}
+function timestamp() {
+    return new Date().toISOString();
+}
+const LEVEL_TAG = {
+    info: 'INFO',
+    ok: 'OK',
+    warn: 'WARN',
+    error: 'ERROR',
+    step: 'STEP',
+    remote: 'REMO',
+    data: 'DATA',
+};
+const CONSOLE_COLOR = {
+    info: '\x1b[36m',
+    ok: '\x1b[32m',
+    warn: '\x1b[33m',
+    error: '\x1b[31m',
+    step: '\x1b[1;35m',
+    remote: '\x1b[90m',
+    data: '\x1b[37m',
+};
+class Logger {
+    logFile;
+    buffer = [];
+    listeners = new Set();
+    seq = 0;
+    writeChain = Promise.resolve();
+    echo;
+    constructor(logFile, echo = true) {
+        this.logFile = logFile;
+        this.echo = echo;
+    }
+    log(message, level = 'info', meta = {}) {
+        const line = cleanLine(message);
+        if (!line && level !== 'data')
+            return;
+        const entry = {
+            seq: ++this.seq,
+            ts: Date.now() / 1000,
+            level,
+            line,
+            host: meta.host,
+            program: meta.program,
+        };
+        this.buffer.push(entry);
+        if (this.buffer.length > 6000)
+            this.buffer.splice(0, this.buffer.length - 6000);
+        if (this.echo) {
+            const color = process.stdout.isTTY ? (CONSOLE_COLOR[level] || '') : '';
+            const reset = color ? '\x1b[0m' : '';
+            process.stdout.write(`${color}[${LEVEL_TAG[level]}]${reset} ${line}\n`);
+        }
+        for (const listener of this.listeners) {
+            try {
+                listener(entry);
+            }
+            catch {
+                // a broken subscriber must never break the run
+            }
+        }
+        this.appendFile(entry);
+    }
+    appendFile(entry) {
+        const text = `[${new Date(entry.ts * 1000).toISOString()}] [${LEVEL_TAG[entry.level]}] ${entry.line}\n`;
+        this.writeChain = this.writeChain
+            .then(async () => {
+            await ensureDir(path.dirname(this.logFile));
+            await fs.appendFile(this.logFile, text, 'utf8');
+        })
+            .catch(() => undefined);
+    }
+    subscribe(listener) {
+        this.listeners.add(listener);
+        return () => this.listeners.delete(listener);
+    }
+    entriesSince(sinceSeq = 0, limit = 3000) {
+        const rows = this.buffer.filter(e => e.seq > sinceSeq);
+        return rows.slice(Math.max(0, rows.length - limit));
+    }
+    lastSeq() {
+        return this.seq;
+    }
+    async flush() {
+        await this.writeChain;
+    }
+}
+exports.Logger = Logger;
+function createLogger(name, echo = true) {
+    const stamp = new Date().toISOString().replace(/[:.]/g, '-').slice(0, 19);
+    return new Logger(path.join(constants_1.LOGS_DIR, `${name}-${stamp}.log`), echo);
+}
+//# sourceMappingURL=helpers.js.map

package/dist/utils/helpers.js.map

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

package/dist/utils/scripts.d.ts

@@ -0,0 +1,60 @@
+import { SSHClient } from '../ssh/client';
+import { AssetLogger } from './assets';
+export interface PushResult {
+    manifest: string;
+    skipped: boolean;
+    files: number;
+    transport: 'git' | 'tar' | 'clone';
+}
+export declare class ScriptManager {
+    private client;
+    private logger;
+    constructor(client: SSHClient, logger?: AssetLogger);
+    pushScripts(dirs?: string[]): Promise<PushResult>;
+    runDetached(options: {
+        program: 'deploy' | 'migrate' | 'manage' | 'upgrade';
+        unit: string;
+        script: string;
+        workDir?: string;
+        env?: Record<string, string>;
+        outFile?: string;
+        statusFile?: string;
+        label?: string;
+        onLog?: (line: string) => void;
+    }): Promise<string>;
+    followStatus(options: {
+        program: 'deploy' | 'migrate' | 'manage' | 'upgrade';
+        unit: string;
+        timeoutSec: number;
+        outFile?: string;
+        statusFile?: string;
+        onLine?: (line: string) => void;
+        progressRe?: RegExp;
+        pollSec?: number;
+    }): Promise<{
+        state: string;
+        detail: string;
+        soft: boolean;
+    }>;
+    waitForScript(options: {
+        program: 'deploy' | 'migrate' | 'manage' | 'upgrade';
+        script: string;
+        unit: string;
+        env?: Record<string, string>;
+        timeoutSec: number;
+        workDir?: string;
+        outFile?: string;
+        statusFile?: string;
+        onLine?: (line: string) => void;
+    }): Promise<{
+        state: string;
+        detail: string;
+        soft: boolean;
+    }>;
+    remoteStatus(program: 'deploy' | 'migrate' | 'manage' | 'upgrade'): Promise<{
+        state: string;
+        detail: string;
+    }>;
+}
+export declare function createScriptManager(client: SSHClient, logger?: AssetLogger): ScriptManager;
+//# sourceMappingURL=scripts.d.ts.map

package/dist/utils/scripts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scripts.d.ts","sourceRoot":"","sources":["../../src/utils/scripts.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAc,MAAM,eAAe,CAAC;AAEtD,OAAO,EAAa,WAAW,EAAE,MAAM,UAAU,CAAC;AAElD,MAAM,WAAW,UAAU;IACzB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,KAAK,GAAG,KAAK,GAAG,OAAO,CAAC;CACpC;AAED,qBAAa,aAAa;IACxB,OAAO,CAAC,MAAM,CAAY;IAC1B,OAAO,CAAC,MAAM,CAAc;gBAEhB,MAAM,EAAE,SAAS,EAAE,MAAM,CAAC,EAAE,WAAW;IAK7C,WAAW,CAAC,IAAI,GAAE,MAAM,EAAe,GAAG,OAAO,CAAC,UAAU,CAAC;IAY7D,WAAW,CAAC,OAAO,EAAE;QACzB,OAAO,EAAE,QAAQ,GAAG,SAAS,GAAG,QAAQ,GAAG,SAAS,CAAC;QACrD,IAAI,EAAE,MAAM,CAAC;QACb,MAAM,EAAE,MAAM,CAAC;QACf,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QAC7B,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,KAAK,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;KAChC,GAAG,OAAO,CAAC,MAAM,CAAC;IA4Bb,YAAY,CAAC,OAAO,EAAE;QAC1B,OAAO,EAAE,QAAQ,GAAG,SAAS,GAAG,QAAQ,GAAG,SAAS,CAAC;QACrD,IAAI,EAAE,MAAM,CAAC;QACb,UAAU,EAAE,MAAM,CAAC;QACnB,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,MAAM,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;QAChC,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,OAAO,CAAC,EAAE,MAAM,CAAC;KAClB,GAAG,OAAO,CAAC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,OAAO,CAAA;KAAE,CAAC;IAoGvD,aAAa,CAAC,OAAO,EAAE;QAC3B,OAAO,EAAE,QAAQ,GAAG,SAAS,GAAG,QAAQ,GAAG,SAAS,CAAC;QACrD,MAAM,EAAE,MAAM,CAAC;QACf,IAAI,EAAE,MAAM,CAAC;QACb,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QAC7B,UAAU,EAAE,MAAM,CAAC;QACnB,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,MAAM,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;KACjC,GAAG,OAAO,CAAC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,OAAO,CAAA;KAAE,CAAC;IAKvD,YAAY,CAAC,OAAO,EAAE,QAAQ,GAAG,SAAS,GAAG,QAAQ,GAAG,SAAS,GAAG,OAAO,CAAC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;CAQrH;AAED,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,aAAa,CAE1F"}