@voltro/cli 0.33.0 → 0.34.0

package/dist/inspectCmd-Bppy-GGw.js

@@ -0,0 +1,224 @@
+import { n as e } from "./cliOutput-D1tSBoRM.js";
+import { n as t, o as n, r, t as i } from "./inspectFetch-Cm8_wVvp.js";
+import { ansi as a } from "@voltro/logger";
+//#region src/inspectCmd.ts
+var o = {
+	app: {
+		path: "/_voltro/inspect/app",
+		method: "GET",
+		desc: "manifest meta (kind, name, store, …)"
+	},
+	routes: {
+		path: "/_voltro/inspect/routes",
+		method: "GET",
+		desc: "web page table (web apps only)"
+	},
+	rpc: {
+		path: "/_voltro/inspect/rpc",
+		method: "GET",
+		desc: "procedures + workflow descriptors"
+	},
+	metrics: {
+		path: "/_voltro/inspect/metrics",
+		method: "GET",
+		desc: "rolling rpc latency buckets"
+	},
+	cache: {
+		path: "/_voltro/inspect/cache",
+		method: "GET",
+		desc: "web data-cache stats (web apps only)"
+	},
+	schedules: {
+		path: "/_voltro/inspect/schedules",
+		method: "GET",
+		desc: "cron registrations + coordination mode"
+	},
+	aggregates: {
+		path: "/_voltro/inspect/aggregates",
+		method: "GET",
+		desc: "materialised aggregate views"
+	},
+	workflows: {
+		path: "/_voltro/inspect/workflows/runs",
+		method: "GET",
+		desc: "recorded workflow runs (+ `--failing`)"
+	},
+	invoke: {
+		path: "/_voltro/inspect/invoke",
+		method: "POST",
+		desc: "call a procedure (--tag --input)"
+	}
+}, s = 20, c = 200, l = (e) => e.consecutiveFailures > 0, u = (e) => {
+	let t = [], n = !1;
+	for (let r of e) {
+		if (r === "--failing") {
+			n = !0;
+			continue;
+		}
+		t.push(r);
+	}
+	return {
+		failingOnly: n,
+		rest: t
+	};
+}, d = async (e) => {
+	let t = await i(e, `/_voltro/inspect/workflows/runs?limit=${c}`);
+	if (t.kind !== "ok") return [];
+	let n = t.data.runs ?? [], r = /* @__PURE__ */ new Map();
+	for (let e of n) {
+		let t = r.get(e.tag);
+		t === void 0 ? r.set(e.tag, [e]) : t.push(e);
+	}
+	return [...r].map(([e, t]) => {
+		let n = 0;
+		for (let e of t) {
+			if (e.status === "failed") {
+				n++;
+				continue;
+			}
+			if (!(e.status === "running" || e.status === "suspended" || e.status === "cancelled")) break;
+		}
+		let r = t[0];
+		return {
+			name: e,
+			cron: "",
+			lastStatus: r?.status ?? null,
+			lastFiredAt: r?.startedAt ?? null,
+			consecutiveFailures: n,
+			totalRunsSeen: t.length,
+			lastError: t.find((e) => e.status === "failed")?.errorMessage ?? null
+		};
+	});
+}, f = async (e) => {
+	let t = await i(e, "/_voltro/inspect/schedules");
+	if (t.kind !== "ok") return [];
+	let n = t.data.schedules ?? [];
+	return await Promise.all(n.map(async (t) => {
+		let n = await i(e, `/_voltro/inspect/schedules/runs?name=${encodeURIComponent(t.name)}&limit=${s}`), r = n.kind === "ok" ? n.data.runs ?? [] : [], a = 0;
+		for (let e of r) {
+			if (e.status === "failed") {
+				a++;
+				continue;
+			}
+			if (!(e.status === "skipped" || e.status === "missed")) break;
+		}
+		let o = r[0];
+		return {
+			name: t.name,
+			cron: t.cron,
+			lastStatus: o?.status ?? null,
+			lastFiredAt: o?.firedAt ?? null,
+			consecutiveFailures: a,
+			totalRunsSeen: r.length,
+			lastError: r.find((e) => e.status === "failed")?.errorMessage ?? null
+		};
+	}));
+}, p = (t, n, r, i) => {
+	let o = r ? n.filter(l) : n;
+	if (i === "json") {
+		e({
+			process: t,
+			schedules: o
+		}, { pretty: !1 });
+		return;
+	}
+	if (console.log(a.bold(`# schedules @${t}`)), o.length === 0) {
+		console.log(a.dim(r ? "  no failing schedules" : "  no schedules registered"));
+		return;
+	}
+	for (let e of o) {
+		let t = l(e) ? a.red(`FAILING x${e.consecutiveFailures}`) : e.lastStatus === null ? a.dim("never run") : a.dim(e.lastStatus);
+		console.log(e.cron === "" ? `  ${e.name}  ${t}` : `  ${e.name}  ${a.dim(e.cron)}  ${t}`), e.consecutiveFailures > 0 && e.consecutiveFailures === e.totalRunsSeen && console.log(a.red(`    every recorded run failed (last ${e.totalRunsSeen})`)), e.lastError !== null && console.log(`    ${a.dim(e.lastError)}`);
+	}
+}, m = () => {
+	console.log("voltro inspect — query the live /_voltro/inspect/* surface of every running api"), console.log(""), console.log("Usage:"), console.log("  voltro inspect <subcommand> [--process NAME] [--format pretty|json]"), console.log(""), console.log("Subcommands:");
+	let e = Object.keys(o).reduce((e, t) => Math.max(e, t.length), 0);
+	for (let [t, n] of Object.entries(o)) console.log(`  ${t.padEnd(e + 2)}${n.method.padEnd(5)}${n.desc}`);
+	console.log(""), console.log("Examples:"), console.log("  voltro inspect app"), console.log("  voltro inspect schedules --failing      # exits 1 if any cron is broken"), console.log("  voltro inspect workflows --failing      # exits 1 if any workflow is broken"), console.log("  voltro inspect rpc --format json | jq '.[].data.procedures'"), console.log("  voltro inspect invoke --tag users.list --input '{}'");
+}, h = async () => {
+	let e = await n();
+	if (console.log(""), e.length === 0) {
+		console.log(a.dim("  (no live api processes — start one with `voltro dev`)"));
+		return;
+	}
+	console.log("Live api processes:");
+	for (let t of e) console.log(`  - ${t.name}  ${a.dim(t.url)}`);
+}, g = (e) => {
+	let t, n = {}, r;
+	for (let i = 0; i < e.length; i++) {
+		let a = e[i];
+		if (a === "--tag" || a === "--procedure" || a === "--proc") {
+			t = e[++i];
+			continue;
+		}
+		if (a === "--input") {
+			let t = e[++i];
+			if (t === void 0) {
+				r = "--input expects a JSON value";
+				continue;
+			}
+			try {
+				n = JSON.parse(t);
+			} catch {
+				r = `--input: invalid JSON '${t}'`;
+			}
+			continue;
+		}
+	}
+	return {
+		tag: t,
+		input: n,
+		inputError: r
+	};
+}, _ = (t) => {
+	let n = t.filter((e) => e.kind === "ok"), r = t.filter((e) => e.kind === "err").map((e) => ({
+		name: e.name,
+		error: e.error
+	}));
+	return e(r.length > 0 ? {
+		results: n.map((e) => ({
+			process: e.name,
+			data: e.data
+		})),
+		fetchErrors: r
+	} : { results: n.map((e) => ({
+		process: e.name,
+		data: e.data
+	})) }, { pretty: !1 }), +(n.length === 0);
+}, v = (t, n) => {
+	let r = !1;
+	for (let i of n) i.kind === "ok" ? (r = !0, console.log(a.bold(`# ${t} @${i.name}`)), e(i.data)) : console.error(a.dim(`# fetch failed: ${i.name}: ${i.error}`));
+	return +!r;
+}, y = async (e) => {
+	let [a, ...s] = e;
+	if (a === void 0 || a === "--help" || a === "-h" || a === "help") return m(), await h(), 0;
+	let c = o[a];
+	if (c === void 0) return console.error(`voltro inspect: unknown subcommand '${a}'`), m(), 2;
+	let y = t(s);
+	if ("error" in y) return console.error(`voltro inspect: ${y.error}`), 2;
+	let { process: b, target: x, rest: S } = r(y.rest), C = y.format, w = a === "schedules" || a === "workflows" ? u(S) : void 0, T;
+	if (a === "invoke") {
+		if (T = g(S), T.inputError !== void 0) return console.error(`voltro inspect invoke: ${T.inputError}`), 2;
+		if (T.tag === void 0) return console.error("voltro inspect invoke: --tag <procedureTag> is required"), 2;
+	}
+	let E = await n(b, x);
+	if (E.length === 0) return console.error(b === void 0 ? "voltro inspect: no live api processes found (start one with `voltro dev`)" : `voltro inspect: no live api named '${b}'`), 1;
+	if (w?.failingOnly === !0) {
+		let e = 0;
+		for (let t of E) {
+			let n = a === "workflows" ? await d(t) : await f(t);
+			e += n.filter(l).length, p(t.name, n, !0, C);
+		}
+		return +(e > 0);
+	}
+	let D = await Promise.all(E.map((e) => c.method === "POST" ? i(e, c.path, {
+		method: "POST",
+		body: {
+			tag: T.tag,
+			input: T.input
+		}
+	}) : i(e, c.path)));
+	return C === "json" ? _(D) : v(a, D);
+};
+//#endregion
+export { y as runInspectCommand };

package/dist/inspectFetch-Cm8_wVvp.js

@@ -0,0 +1,151 @@
+import { n as e } from "./runtimeRegistry-DMeKfTHP.js";
+//#region src/inspectFetch.ts
+var t = (e, t, n = !1) => {
+	let r = { ...e ?? {} }, i = t ?? process.env.VOLTRO_INSPECT_TOKEN;
+	if (i !== void 0 && i !== "" && (r.authorization = `Bearer ${i}`), n) {
+		let e = process.env.VOLTRO_INSPECT_WRITE_TOKEN;
+		e !== void 0 && e !== "" && (r["x-voltro-inspect-write"] = e);
+	}
+	return r;
+}, n = /* @__PURE__ */ new Set([
+	"POST",
+	"PUT",
+	"PATCH",
+	"DELETE"
+]), r = async (e, r, i) => {
+	let a = `${e.url.replace(/\/+$/, "")}${r.startsWith("/") ? r : `/${r}`}`, o = i?.method ?? "GET", s = i?.body !== void 0;
+	try {
+		let r = await fetch(a, {
+			method: o,
+			headers: t(s ? { "content-type": "application/json" } : void 0, e.inspectToken, n.has(o)),
+			...s ? { body: JSON.stringify(i.body) } : {}
+		}), c = await r.text(), l;
+		if (c.length > 0) try {
+			l = JSON.parse(c);
+		} catch {
+			l = c;
+		}
+		if (!r.ok) {
+			let t = l, i = typeof t == "object" && t ? String(t.message ?? t.reason ?? t.error ?? `HTTP ${r.status}`) : `HTTP ${r.status}`, a = n.has(o) && (process.env.VOLTRO_INSPECT_WRITE_TOKEN ?? "") === "" && /write/i.test(i);
+			return {
+				kind: "err",
+				name: e.name,
+				error: a ? `${i}\n  VOLTRO_INSPECT_WRITE_TOKEN is not set in this shell. \`voltro dev\` mints it into the project's \`.env.local\`; export it (or run from a shell that loaded it).` : i
+			};
+		}
+		return {
+			kind: "ok",
+			name: e.name,
+			status: r.status,
+			data: l
+		};
+	} catch (t) {
+		return {
+			kind: "err",
+			name: e.name,
+			error: t.message || String(t)
+		};
+	}
+}, i = (e, t = process.env) => {
+	let n = [], r, i;
+	for (let t = 0; t < e.length; t++) {
+		let a = e[t];
+		if (a === "--url") {
+			r = e[++t];
+			continue;
+		}
+		if (a.startsWith("--url=")) {
+			r = a.slice(6);
+			continue;
+		}
+		if (a === "--token") {
+			i = e[++t];
+			continue;
+		}
+		if (a.startsWith("--token=")) {
+			i = a.slice(8);
+			continue;
+		}
+		n.push(a);
+	}
+	if (r ??= t.VOLTRO_INSPECT_URL, r === void 0 || r === "") return {
+		target: void 0,
+		rest: n
+	};
+	let a;
+	try {
+		a = new URL(r);
+	} catch {
+		return {
+			target: void 0,
+			rest: n,
+			error: `--url: not a valid URL: "${r}"`
+		};
+	}
+	let o = i ?? t.VOLTRO_INSPECT_TOKEN;
+	return {
+		target: {
+			url: r.replace(/\/+$/, ""),
+			name: a.host,
+			...o !== void 0 && o !== "" ? { token: o } : {}
+		},
+		rest: n
+	};
+}, a = (e) => ({
+	id: `remote:${e.url}`,
+	name: e.name,
+	kind: "api",
+	url: e.url,
+	pid: 0,
+	registeredAt: (/* @__PURE__ */ new Date(0)).toISOString(),
+	heartbeatAt: (/* @__PURE__ */ new Date(0)).toISOString(),
+	status: "live",
+	logFile: "",
+	...e.token === void 0 ? {} : { inspectToken: e.token }
+}), o = async (t, n) => n === void 0 ? (await e()).apps.filter((e) => e.kind === "api" && e.status === "live" && e.url.length > 0 && (t === void 0 || e.name === t)) : [a(n)], s = (e) => {
+	let t = "pretty", n = [];
+	for (let r = 0; r < e.length; r++) {
+		let i = e[r];
+		if (i === "--format") {
+			let n = e[++r];
+			if (n !== "pretty" && n !== "json") return { error: "--format: must be 'pretty' | 'json'" };
+			t = n;
+			continue;
+		}
+		if (i === "--json" || i === "--format=json") {
+			t = "json";
+			continue;
+		}
+		if (i === "--format=pretty") {
+			t = "pretty";
+			continue;
+		}
+		n.push(i);
+	}
+	return {
+		format: t,
+		rest: n
+	};
+}, c = (e, t = process.env) => {
+	let { target: n, rest: r, error: a } = i(e, t), o, s = [];
+	for (let e = 0; e < r.length; e++) {
+		let t = r[e];
+		if (t === "--process") {
+			o = r[++e];
+			continue;
+		}
+		if (t.startsWith("--process=")) {
+			o = t.slice(10);
+			continue;
+		}
+		s.push(t);
+	}
+	return {
+		process: o,
+		target: n,
+		rest: s,
+		...a === void 0 ? {} : { error: a }
+	};
+};
+//#endregion
+export { a, i, s as n, o, c as r, r as t };

package/dist/inspectMetrics-CfdKLh6t.js

@@ -0,0 +1,72 @@
+import { recordSample as e } from "@voltro/runtime";
+//#region src/inspectMetrics.ts
+var t = 5e3, n = 6e4, r = (e, t) => {
+	if (e.length === 0) return 0;
+	if (e.length === 1) return e[0];
+	let n = t * (e.length - 1), r = Math.floor(n), i = Math.ceil(n);
+	if (r === i) return e[r];
+	let a = n - r;
+	return e[r] * (1 - a) + e[i] * a;
+}, i = (e) => {
+	if (e.length === 0) return {
+		p50: 0,
+		p95: 0,
+		p99: 0,
+		mean: 0,
+		min: 0,
+		max: 0
+	};
+	let t = e.slice().sort((e, t) => e - t), n = 0;
+	for (let e of t) n += e;
+	return {
+		p50: r(t, .5),
+		p95: r(t, .95),
+		p99: r(t, .99),
+		mean: n / t.length,
+		min: t[0],
+		max: t[t.length - 1]
+	};
+}, a = (r = {}) => {
+	let a = r.maxSamples ?? t, o = r.defaultWindowMs ?? n, s = [];
+	return {
+		record(t) {
+			e(t), s.push({
+				...t,
+				ts: Date.now()
+			}), s.length > a && s.shift();
+		},
+		snapshot(e) {
+			let t = e ?? o, n = Date.now(), r = n - t, a = /* @__PURE__ */ new Map(), c = 0;
+			for (let e of s) {
+				if (e.ts < r) continue;
+				c++;
+				let t = `${e.kind}\u0000${e.tag}`, n = a.get(t);
+				n || (n = {
+					kind: e.kind,
+					tag: e.tag,
+					samples: []
+				}, a.set(t, n)), n.samples.push(e);
+			}
+			let l = [];
+			for (let e of a.values()) {
+				let t = e.samples.map((e) => e.durationMs), n = 0;
+				for (let t of e.samples) t.status === "error" && n++;
+				l.push({
+					kind: e.kind,
+					tag: e.tag,
+					count: e.samples.length,
+					errorCount: n,
+					latencyMs: i(t)
+				});
+			}
+			return l.sort((e, t) => t.count - e.count), {
+				windowMs: t,
+				capturedAt: n,
+				totalSamples: c,
+				buckets: l
+			};
+		}
+	};
+};
+//#endregion
+export { a as t };

package/dist/loadEnv-D9nEOClM.js

@@ -0,0 +1,44 @@
+import { dirname as e, isAbsolute as t, resolve as n } from "node:path";
+import { existsSync as r, readFileSync as i, statSync as a } from "node:fs";
+import { createLogger as o } from "@voltro/logger";
+//#region src/loadEnv.ts
+var s = o({ scope: "voltro:cli" }), c = (e, t) => {
+	if (t?.code !== "EACCES") return "";
+	if (typeof process.getuid != "function") return " — permission denied";
+	try {
+		let t = a(e);
+		return ` — permission denied: the file is owned by uid ${t.uid} (mode ${(t.mode & 511).toString(8)}) and this process is uid ${process.getuid()}. A container running as root with the workspace bind-mounted writes files the host user cannot read; run it as \`--user <your-uid>:<your-gid>\`, or delete the file and let the owning user recreate it.`;
+	} catch {
+		return " — permission denied (and the file could not be stat-ed either)";
+	}
+}, l = [], u = (a) => {
+	l.length = 0;
+	let o = a[1] && !a[1].startsWith("-") ? a[1] : void 0, u = o ? t(o) ? o : n(process.cwd(), o) : process.cwd(), d = [], f = u;
+	for (;;) {
+		d.push(f);
+		let t = e(f);
+		if (t === f) break;
+		f = t;
+	}
+	for (let e of d) for (let t of [".env.local", ".env"]) {
+		let a = n(e, t);
+		if (r(a)) {
+			l.push(a);
+			try {
+				let e = i(a, "utf8");
+				for (let t of e.split(/\r?\n/)) {
+					let e = t.trim();
+					if (e === "" || e.startsWith("#")) continue;
+					let n = e.indexOf("=");
+					if (n < 1) continue;
+					let r = e.slice(0, n).trim(), i = e.slice(n + 1).trim();
+					(i.startsWith("\"") && i.endsWith("\"") || i.startsWith("'") && i.endsWith("'")) && (i = i.slice(1, -1)), process.env[r] === void 0 && (process.env[r] = i);
+				}
+			} catch (e) {
+				s.warn(`failed to load env file (continuing)${c(a, e)}`, { path: a }, e);
+			}
+		}
+	}
+};
+//#endregion
+export { l as n, u as t };

package/dist/logFileSink-C_D2wRN1.js

@@ -0,0 +1,105 @@
+import { join as e } from "node:path";
+import { closeSync as t, mkdirSync as n, openSync as r, promises as i, readdirSync as a, statSync as o, unlinkSync as s, writeSync as c } from "node:fs";
+import { addSink as l } from "@voltro/logger";
+import { homedir as u } from "node:os";
+//#region src/logFileSink.ts
+var d = e(u(), ".voltro", "logs"), f = () => {
+	let e = Number(process.env.VOLTRO_LOG_FILE_TTL_MS);
+	return Number.isFinite(e) && e > 0 ? e : 3600 * 1e3;
+}, p = !1, m = () => {
+	if (p) return;
+	p = !0;
+	let t = Date.now() - f(), n = [];
+	try {
+		n = a(d);
+	} catch {
+		return;
+	}
+	for (let r of n) {
+		if (!r.endsWith(".log")) continue;
+		let n = e(d, r);
+		try {
+			o(n).mtimeMs < t && s(n);
+		} catch {}
+	}
+}, h = (e) => e.replace(/[^a-zA-Z0-9._-]/g, "_").slice(0, 80), g = (t, n) => e(d, `${h(t)}-${n}.log`), _ = (t) => {
+	let n = h(t), r = [];
+	try {
+		r = a(d);
+	} catch {
+		return;
+	}
+	let i = r.filter((e) => e.startsWith(`${n}-`) && e.endsWith(".log"));
+	if (i.length === 0) return;
+	let s, c = -1;
+	for (let t of i) {
+		let n = e(d, t);
+		try {
+			let e = o(n);
+			e.mtimeMs > c && (c = e.mtimeMs, s = n);
+		} catch {}
+	}
+	return s;
+}, v = (e) => {
+	try {
+		n(d, { recursive: !0 });
+	} catch {}
+	m();
+	let i = g(e, process.pid), a = r(i, "w"), o = (e) => {
+		let t = {
+			ts: e.ts.getTime(),
+			level: e.level,
+			source: e.scope === "client" ? "client" : "server",
+			message: e.message,
+			fields: e.fields
+		};
+		e.scope !== void 0 && (t.scope = e.scope);
+		try {
+			return JSON.stringify(t) + "\n";
+		} catch {
+			return JSON.stringify({
+				ts: e.ts.getTime(),
+				level: e.level,
+				source: t.source,
+				message: e.message,
+				fields: {},
+				...e.scope === void 0 ? {} : { scope: e.scope }
+			}) + "\n";
+		}
+	}, s = !1, u = l((e) => {
+		if (!s) try {
+			c(a, o(e));
+		} catch {}
+	}), f = () => {
+		if (!s) {
+			s = !0;
+			try {
+				t(a);
+			} catch {}
+		}
+	};
+	process.once("exit", f);
+	let p = () => f();
+	return process.on("uncaughtException", p), process.on("unhandledRejection", p), {
+		path: i,
+		dispose: async () => {
+			u(), f(), process.off("exit", f), process.off("uncaughtException", p), process.off("unhandledRejection", p);
+		}
+	};
+}, y = async (e, t) => {
+	let n;
+	try {
+		n = await i.readFile(e, "utf8");
+	} catch {
+		return [];
+	}
+	let r = n.split("\n"), a = [], o = t?.since ?? 0;
+	for (let e of r) if (e.length !== 0) try {
+		let t = JSON.parse(e);
+		if (typeof t.ts != "number" || t.ts < o) continue;
+		a.push(t);
+	} catch {}
+	return t?.max !== void 0 && a.length > t.max ? a.slice(a.length - t.max) : a;
+};
+//#endregion
+export { v as n, y as r, _ as t };