@vtechcom/hexcore 2.0.0-beta.1

package/dist/hydra/argv.js.map

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

package/dist/hydra/blockfrost-keys.js

@@ -0,0 +1,15 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.resolveBlockfrostKey = resolveBlockfrostKey;
+function resolveBlockfrostKey(nodeKey, headKey, serverKey) {
+    // Empty strings come from both SQLite columns and unset env vars; treat
+    // them as absent rather than writing a token file with nothing in it.
+    if (nodeKey)
+        return { key: nodeKey, source: 'node' };
+    if (headKey)
+        return { key: headKey, source: 'head' };
+    if (serverKey)
+        return { key: serverKey, source: 'server' };
+    return { key: null, source: 'none' };
+}
+//# sourceMappingURL=blockfrost-keys.js.map

package/dist/hydra/blockfrost-keys.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"blockfrost-keys.js","sourceRoot":"","sources":["../../src/hydra/blockfrost-keys.ts"],"names":[],"mappings":";;AAqBA,oDAWC;AAXD,SAAgB,oBAAoB,CAChC,OAAkC,EAClC,OAAkC,EAClC,SAAoC;IAEpC,wEAAwE;IACxE,sEAAsE;IACtE,IAAI,OAAO;QAAE,OAAO,EAAE,GAAG,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC;IACrD,IAAI,OAAO;QAAE,OAAO,EAAE,GAAG,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC;IACrD,IAAI,SAAS;QAAE,OAAO,EAAE,GAAG,EAAE,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC;IAC3D,OAAO,EAAE,GAAG,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC;AACzC,CAAC"}

package/dist/hydra/boot-progress.js

@@ -0,0 +1,165 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BOOT_STEPS = exports.BootTracker = exports.BootRun = void 0;
+/**
+ * The phases, in the order `start()` walks them.
+ *
+ * Labels say what is happening to the machine, not which function is running:
+ * the audience is someone watching a head come up, not someone reading this
+ * file.
+ */
+const STEPS = [
+    { key: 'docker', label: 'Reaching the Docker daemon' },
+    { key: 'image', label: 'Fetching the hydra-node image' },
+    { key: 'flags', label: 'Settling which flags this version accepts' },
+    { key: 'config', label: 'Writing keys and ledger configuration' },
+    { key: 'containers', label: 'Creating the node containers' },
+    { key: 'ready', label: 'Waiting for every node to greet' },
+];
+exports.BOOT_STEPS = STEPS;
+/** Bounded so a chatty node cannot grow this without limit. */
+const MAX_LOG_LINES = 500;
+class BootRun {
+    progress;
+    /** Last line taken from each container, to append only what is new. */
+    lastLine = new Map();
+    constructor(headId, startedAt) {
+        this.progress = {
+            headId,
+            status: 'running',
+            startedAt,
+            steps: STEPS.map(s => ({ ...s, state: 'pending' })),
+            logs: [],
+        };
+    }
+    get snapshot() {
+        // Copied on the way out: the caller serialises it while this run may
+        // still be mutating.
+        return {
+            ...this.progress,
+            steps: this.progress.steps.map(s => ({ ...s })),
+            logs: [...this.progress.logs],
+        };
+    }
+    /**
+     * Enter a phase. Everything before it is marked done, so a step that
+     * finishes without its own call — the ones that are just a few awaits —
+     * cannot be left showing as active forever.
+     */
+    step(key, detail) {
+        const at = new Date().toISOString();
+        let seen = false;
+        for (const step of this.progress.steps) {
+            if (step.key === key) {
+                seen = true;
+                step.state = 'active';
+                step.startedAt = at;
+                if (detail)
+                    step.detail = detail;
+            }
+            else if (!seen) {
+                if (step.state === 'active' || step.state === 'pending') {
+                    step.state = 'done';
+                    step.endedAt ??= at;
+                }
+            }
+        }
+        this.log(STEPS.find(s => s.key === key)?.label ?? key);
+    }
+    /** Update the live sub-status of a step without logging a line for it. */
+    detail(key, detail) {
+        const step = this.progress.steps.find(s => s.key === key);
+        if (step)
+            step.detail = detail;
+    }
+    log(message, level = 'info', source = 'hexcore') {
+        this.push({ at: new Date().toISOString(), level, source, message });
+    }
+    push(line) {
+        this.progress.logs.push(line);
+        if (this.progress.logs.length > MAX_LOG_LINES) {
+            this.progress.logs.splice(0, this.progress.logs.length - MAX_LOG_LINES);
+        }
+    }
+    /**
+     * Append whatever a container has printed since the last look.
+     *
+     * Docker's `logs --tail` is a sliding window, so the previous batch and this
+     * one overlap. Resuming after the last line we kept is what stops the pane
+     * repeating itself; when that line has already scrolled out of the window we
+     * take the whole batch, which duplicates less than dropping would lose.
+     *
+     * A start that shows nothing for half a minute and then dumps ten lines at
+     * once is NOT a bug here. hydra-node's stdout is not a TTY under Docker, so
+     * it block-buffers: on a measured boot, ten lines spanning 35s of the node's
+     * own timestamps reached Docker in a single flush. Nothing polls its way out
+     * of that. `at` below is therefore when WE saw the line, not when the node
+     * wrote it — each line carries hydra-node's own timestamp inside the JSON.
+     */
+    appendContainerLogs(source, raw) {
+        const lines = raw.split('\n').filter(l => l.trim().length > 0);
+        if (lines.length === 0)
+            return;
+        const previous = this.lastLine.get(source);
+        const from = previous ? lines.lastIndexOf(previous) + 1 : 0;
+        const fresh = from > 0 || !previous ? lines.slice(from) : lines;
+        for (const message of fresh) {
+            this.push({
+                at: new Date().toISOString(),
+                // hydra-node logs JSON; anything it labels an error is one.
+                level: /"(error|Error)"|\bexception\b/i.test(message) ? 'error' : 'info',
+                source,
+                message: message.length > 2000 ? `${message.slice(0, 2000)}…` : message,
+            });
+        }
+        this.lastLine.set(source, lines[lines.length - 1]);
+    }
+    succeed(message) {
+        const at = new Date().toISOString();
+        for (const step of this.progress.steps) {
+            if (step.state !== 'failed') {
+                step.state = 'done';
+                step.endedAt ??= at;
+            }
+        }
+        this.progress.status = 'succeeded';
+        this.progress.endedAt = at;
+        this.log(message);
+    }
+    /** Fail the step that was in flight, so the pane points at what gave up. */
+    fail(error) {
+        const at = new Date().toISOString();
+        const active = this.progress.steps.find(s => s.state === 'active');
+        if (active) {
+            active.state = 'failed';
+            active.detail = error;
+            active.endedAt = at;
+        }
+        this.progress.status = 'failed';
+        this.progress.endedAt = at;
+        this.progress.error = error;
+        this.log(error, 'error');
+    }
+}
+exports.BootRun = BootRun;
+/**
+ * The latest run per head. Only one is kept: a finished run is still worth
+ * showing — it is how someone reads back a failure — but the one before it is
+ * not, and keeping a history here would be a memory leak with no reader.
+ */
+class BootTracker {
+    runs = new Map();
+    begin(headId) {
+        const run = new BootRun(headId, new Date().toISOString());
+        this.runs.set(headId, run);
+        return run;
+    }
+    get(headId) {
+        return this.runs.get(headId)?.snapshot;
+    }
+    forget(headId) {
+        this.runs.delete(headId);
+    }
+}
+exports.BootTracker = BootTracker;
+//# sourceMappingURL=boot-progress.js.map

package/dist/hydra/boot-progress.js.map

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

package/dist/hydra/capabilities.js

@@ -0,0 +1,131 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+var NodeCapabilitiesService_1;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.NodeCapabilitiesService = void 0;
+exports.hasFlag = hasFlag;
+/**
+ * What the configured hydra-node image actually supports.
+ *
+ * Flags differ across the versions people run. Concretely, 0.22.x has
+ * `--blockfrost` and `--network` but NOT `--unsynced-period` or the Blockfrost
+ * timeout knobs, which arrived in the 2.x line. Passing an unknown flag makes
+ * hydra-node exit during option parsing, so the container dies immediately and
+ * the head reports a generic "node never became ready" — the failure mode this
+ * whole module exists to avoid.
+ *
+ * Two sources answer that question, in order:
+ *
+ *  1. `HYDRA_VERSION_PROFILES` in @hexcore/shared — the versions this build
+ *     declares support for. A profile wins when it claims the tag, because it
+ *     also carries the argv values that version wants, which `--help` cannot
+ *     tell us. Supporting a new hydra-node release is therefore a code change.
+ *  2. Probing the image: run `hydra-node --help` once and read which flags it
+ *     prints. This is what keeps a fork, a `master` tag, or a release newer
+ *     than this build bootable instead of refused.
+ */
+const common_1 = require("@nestjs/common");
+const shared_1 = require("@hexcore/shared");
+const docker_service_1 = require("../docker/docker.service");
+/** Assume the widest support if probing fails, minus anything version-gated. */
+const CONSERVATIVE = {
+    unsyncedPeriod: false,
+    blockfrostTimeouts: false,
+    network: true,
+    blockfrost: true,
+    // Offline mode predates every version this build supports, so assuming it
+    // costs nothing — and an image that truly lacks it fails at option parsing
+    // either way, since there is no online argv to fall back to.
+    offline: true,
+};
+let NodeCapabilitiesService = NodeCapabilitiesService_1 = class NodeCapabilitiesService {
+    docker;
+    logger = new common_1.Logger(NodeCapabilitiesService_1.name);
+    /** Probing spawns a container, so cache per image tag. */
+    cache = new Map();
+    constructor(docker) {
+        this.docker = docker;
+    }
+    /**
+     * Flags + argv values for an image.
+     *
+     * A declared profile short-circuits the probe entirely: it is the reviewed
+     * answer for that version, and it costs no container run.
+     */
+    async resolve(image, overrides = {}) {
+        const profile = (0, shared_1.findVersionProfile)(image);
+        if (profile) {
+            return {
+                caps: { version: profile.label, ...profile.flags },
+                args: (0, shared_1.resolveHydraArgs)(profile, overrides),
+                source: 'profile',
+                profileId: profile.id,
+            };
+        }
+        this.logger.log(`${image} matches no version profile — probing the image for its flag set`);
+        const caps = await this.detect(image);
+        return {
+            caps,
+            args: (0, shared_1.resolveHydraArgs)(undefined, overrides),
+            source: caps.version === 'unknown' ? 'fallback' : 'probe',
+        };
+    }
+    async detect(image) {
+        const cached = this.cache.get(image);
+        if (cached)
+            return cached;
+        let caps;
+        try {
+            const help = await this.docker.runOnce(image, ['--help']);
+            const version = (await this.docker.runOnce(image, ['--version'])).trim().split('\n')[0] ?? 'unknown';
+            caps = {
+                version,
+                // Match the flag at a word boundary: '--blockfrost' is a prefix
+                // of '--blockfrost-query-timeout', so a naive includes() would
+                // report the timeout flags as present on 0.22.x.
+                unsyncedPeriod: hasFlag(help, 'unsynced-period'),
+                blockfrostTimeouts: hasFlag(help, 'blockfrost-query-timeout'),
+                network: hasFlag(help, 'network'),
+                blockfrost: hasFlag(help, 'blockfrost'),
+                offline: hasFlag(help, 'offline-head-seed'),
+            };
+            this.logger.log(`hydra-node ${version} capabilities: ` +
+                `unsynced-period=${caps.unsyncedPeriod} ` +
+                `blockfrost-timeouts=${caps.blockfrostTimeouts} ` +
+                `network=${caps.network}`);
+        }
+        catch (err) {
+            // A failed probe must not block a boot that would otherwise work,
+            // so fall back to the flags every supported version accepts.
+            this.logger.warn(`could not probe ${image} for supported flags (${err.message}); ` +
+                'assuming a conservative flag set');
+            caps = { version: 'unknown', ...CONSERVATIVE };
+        }
+        this.cache.set(image, caps);
+        return caps;
+    }
+};
+exports.NodeCapabilitiesService = NodeCapabilitiesService;
+exports.NodeCapabilitiesService = NodeCapabilitiesService = NodeCapabilitiesService_1 = __decorate([
+    (0, common_1.Injectable)(),
+    __metadata("design:paramtypes", [docker_service_1.DockerService])
+], NodeCapabilitiesService);
+/**
+ * True when `--<flag>` appears as a whole option in the help text.
+ *
+ * The trailing boundary matters: hydra-node prints `--blockfrost FILE` and
+ * `--blockfrost-query-timeout SECONDS`, and a substring test for the former
+ * would also match the latter.
+ */
+function hasFlag(helpText, flag) {
+    return new RegExp(`--${flag}(?![\\w-])`).test(helpText);
+}
+//# sourceMappingURL=capabilities.js.map

package/dist/hydra/capabilities.js.map

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