@monocle.sh/cli 0.1.0 → 0.2.0

package/dist/cli.mjs

@@ -1,5 +1,5 @@
 #!/usr/bin/env node
-import { i as uploadSourcemaps, t as UploadError } from "./upload-DJfE9Qcx.mjs";
+import { i as uploadSourcemaps, t as UploadError } from "./upload-D2WShd9A.mjs";
 import { join } from "node:path";
 import { readFileSync, readdirSync, rmSync } from "node:fs";
 import pc from "picocolors";
@@ -38,7 +38,11 @@ program.command("sourcemaps").description("Manage source maps").command("upload"
 		process.exit(1);
 	}
 });
-program.command("dev").description("Start local DevTools server for development observability").option("--port <port>", "Port for the DevTools server", "4200").option("--host <host>", "Host to bind to", "0.0.0.0").option("--open", "Open browser automatically").option("--clean", "Reset all stored data before starting").option("--db-path <path>", "Custom path for DuckDB database").action(async (options) => {
+/**
+* `monocle studio` command group — local DevTools server and data access.
+*/
+const studio = program.command("studio").description("Local DevTools server for development observability");
+studio.command("dev").description("Start the local Studio server").option("--port <port>", "Port for the Studio server", "4200").option("--host <host>", "Host to bind to", "0.0.0.0").option("--open", "Open browser automatically").option("--clean", "Reset all stored data before starting").option("--db-path <path>", "Custom path for DuckDB database").action(async (options) => {
 	const port = Number.parseInt(options.port, 10);
 	if (options.clean) {
 		const configDir = join(homedir(), ".config", "monocle");
@@ -68,6 +72,18 @@ program.command("dev").description("Start local DevTools server for development
 		process.exit(1);
 	}
 });
+studio.command("traces").description("List recent traces from Studio").option("-p, --port <port>", "Studio server port", "4200").option("-f, --format <format>", "Output format: pretty, json, short", "pretty").option("-n, --limit <limit>", "Number of traces to fetch", "25").option("-s, --service <service>", "Filter by service name").option("--trace-id <traceId>", "Filter by trace ID").action(async (options) => {
+	const { fetchTraces } = await import("./fetch-DZ9BsQle.mjs");
+	await fetchTraces(options);
+});
+studio.command("logs").description("List recent logs from Studio").option("-p, --port <port>", "Studio server port", "4200").option("-f, --format <format>", "Output format: pretty, json, short", "pretty").option("-n, --limit <limit>", "Number of logs to fetch", "50").option("--severity <severity>", "Filter by severity (error, warn, info, debug)").option("--search <search>", "Search in log body and attributes").option("--trace-id <traceId>", "Filter by trace ID").action(async (options) => {
+	const { fetchLogs } = await import("./fetch-DZ9BsQle.mjs");
+	await fetchLogs(options);
+});
+studio.command("errors").description("List recent errors and exceptions from Studio").option("-p, --port <port>", "Studio server port", "4200").option("-f, --format <format>", "Output format: pretty, json, short", "pretty").option("-n, --limit <limit>", "Number of errors to fetch", "25").option("--trace-id <traceId>", "Filter by trace ID").action(async (options) => {
+	const { fetchErrors } = await import("./fetch-DZ9BsQle.mjs");
+	await fetchErrors(options);
+});
 program.parse();
 //#endregion
 export {};

package/dist/fetch-DZ9BsQle.mjs

@@ -0,0 +1,189 @@
+import pc from "picocolors";
+import ky from "ky";
+//#region src/studio/formatters.ts
+/**
+* Format a unix nanosecond timestamp to a HH:mm:ss.SSS string.
+*/
+function formatTimestamp(unixNano) {
+	return (/* @__PURE__ */ new Date(Number(BigInt(unixNano)) / 1e6)).toISOString().slice(11, 23);
+}
+/**
+* Return a colorizer based on log severity level.
+*/
+function severityColor(severity) {
+	const s = (severity ?? "").toUpperCase();
+	if (s === "ERROR" || s === "FATAL") return pc.red;
+	if (s === "WARN" || s === "WARNING") return pc.yellow;
+	if (s === "INFO") return pc.cyan;
+	if (s === "DEBUG" || s === "TRACE") return pc.dim;
+	return pc.white;
+}
+/**
+* Format a log entry for terminal output.
+* Supports pretty, short, and json formats.
+*/
+function formatLog(log, format) {
+	if (format === "json") return JSON.stringify(log);
+	const time = formatTimestamp(log.timestampUnix);
+	const severity = (log.severityText ?? "INFO").toUpperCase().padEnd(5);
+	const color = severityColor(log.severityText);
+	const service = log.serviceName ?? "unknown";
+	const body = log.body ?? "";
+	if (format === "short") return `${pc.dim(time)} ${color(severity)} ${service} ${body}`;
+	const parts = [];
+	parts.push(`${pc.dim(time)} ${color(pc.bold(severity))} ${pc.dim("·")} ${pc.bold(service)}`);
+	parts.push(`  ${body}`);
+	if (log.traceId) parts.push(`  ${pc.dim(`trace=${log.traceId.slice(0, 8)}`)}`);
+	return parts.join("\n");
+}
+//#endregion
+//#region src/studio/studio_api.ts
+/**
+* HTTP client for the Monocle Studio local server.
+* Wraps ky to query traces, logs, and exceptions from the running instance.
+*/
+var StudioApi = class {
+	#client;
+	constructor(port) {
+		this.#client = ky.create({ prefixUrl: `http://localhost:${port}` });
+	}
+	/**
+	* Fetch traces from the Studio server.
+	*/
+	async traces(params = {}) {
+		return this.#fetch("api/traces", params);
+	}
+	/**
+	* Fetch logs from the Studio server.
+	*/
+	async logs(params = {}) {
+		return this.#fetch("api/logs", params);
+	}
+	/**
+	* Fetch exceptions from the Studio server.
+	*/
+	async exceptions(params = {}) {
+		return this.#fetch("api/exceptions", params);
+	}
+	/**
+	* Generic GET request against the Studio API.
+	* Filters out undefined params and exits the process on connection failure.
+	*/
+	async #fetch(path, params = {}) {
+		const searchParams = Object.fromEntries(Object.entries(params).filter((entry) => !!entry[1]));
+		try {
+			return (await this.#client.get(path, { searchParams }).json()).data;
+		} catch {
+			console.error(pc.red(`Could not connect to Monocle Studio`));
+			console.error(pc.dim(`Make sure the server is running: monocle studio dev`));
+			process.exit(1);
+		}
+	}
+};
+//#endregion
+//#region src/studio/fetch.ts
+/**
+* Print data as formatted JSON to stdout.
+*/
+function printJson(data) {
+	console.log(JSON.stringify(data, null, 2));
+}
+/**
+* Format a duration in milliseconds to a human-readable string.
+*/
+function formatDuration(ms) {
+	if (ms < 1) return `${(ms * 1e3).toFixed(0)}µs`;
+	if (ms < 1e3) return `${ms.toFixed(1)}ms`;
+	return `${(ms / 1e3).toFixed(2)}s`;
+}
+/**
+* Return a picocolors colorizer based on HTTP status code range.
+*/
+function httpStatusColor(code) {
+	if (code >= 500) return pc.red;
+	if (code >= 400) return pc.yellow;
+	if (code >= 200) return pc.green;
+	return pc.dim;
+}
+/**
+* Print a single trace to stdout in the given format.
+*/
+function printTrace(trace, format) {
+	const time = trace.startTime?.slice(11, 23) ?? "";
+	const duration = formatDuration(trace.durationMs);
+	if (format === "short") {
+		const status = trace.httpStatus ? ` ${trace.httpStatus}` : "";
+		console.log(`${pc.dim(time)} ${pc.magenta("TRC")} ${trace.serviceName ?? "unknown"} ${trace.method ?? ""} ${trace.path ?? trace.rootSpanName}${status} ${pc.dim(duration)}`);
+		return;
+	}
+	console.log(`${pc.dim(time)} ${pc.magenta(pc.bold("TRACE"))} ${pc.dim("·")} ${pc.bold(trace.serviceName ?? "unknown")} ${pc.dim(trace.traceId.slice(0, 8))}`);
+	if (trace.method) {
+		const statusStr = httpStatusColor(trace.httpStatus)(String(trace.httpStatus ?? ""));
+		console.log(`  ${pc.bold(trace.method)} ${trace.path ?? trace.rootSpanName} ${statusStr} ${pc.dim(duration)} ${pc.dim(`(${trace.spanCount} spans)`)}`);
+	} else console.log(`  ${trace.rootSpanName} ${pc.dim(duration)}`);
+	console.log();
+}
+/**
+* Print a single error/exception to stdout in the given format.
+*/
+function printError(error, format) {
+	const time = error.timestamp?.slice(11, 23) ?? "";
+	const service = error.serviceName ?? "unknown";
+	if (format === "short") {
+		console.log(`${pc.dim(time)} ${pc.red("ERR")} ${service} ${error.exceptionType ?? "Error"}: ${error.exceptionMessage ?? ""}`);
+		return;
+	}
+	console.log(`${pc.dim(time)} ${pc.red(pc.bold("ERROR"))} ${pc.dim("·")} ${pc.bold(service)}`);
+	console.log(`  ${pc.red(error.exceptionType ?? "Error")}: ${error.exceptionMessage ?? ""}`);
+	if (error.exceptionStacktrace) {
+		const lines = error.exceptionStacktrace.split("\n");
+		for (const line of lines.slice(0, 5)) console.log(`  ${pc.dim(line)}`);
+		if (lines.length > 5) console.log(`  ${pc.dim("...")}`);
+	}
+	console.log(`  ${pc.dim(`trace=${error.traceId.slice(0, 8)} span=${error.spanName}`)}`);
+	console.log();
+}
+/**
+* Fetch and print traces from the Studio server.
+*/
+async function fetchTraces(options) {
+	const data = await new StudioApi(Number.parseInt(options.port, 10)).traces({
+		limit: options.limit,
+		service: options.service,
+		traceId: options.traceId
+	});
+	if (!data.length) return console.log(pc.dim("  No traces found."));
+	if (options.format === "json") return printJson(data);
+	for (const trace of data) printTrace(trace, options.format);
+}
+/**
+* Fetch and print logs from the Studio server.
+*/
+async function fetchLogs(options) {
+	const data = await new StudioApi(Number.parseInt(options.port, 10)).logs({
+		limit: options.limit,
+		severity: options.severity,
+		search: options.search,
+		traceId: options.traceId
+	});
+	if (!data.length) return console.log(pc.dim("  No logs found."));
+	if (options.format === "json") return printJson(data);
+	for (const log of data) {
+		const output = formatLog(log, options.format);
+		if (output) console.log(output);
+	}
+}
+/**
+* Fetch and print exceptions from the Studio server.
+*/
+async function fetchErrors(options) {
+	const data = await new StudioApi(Number.parseInt(options.port, 10)).exceptions({
+		limit: options.limit,
+		traceId: options.traceId
+	});
+	if (!data.length) return console.log(pc.dim("  No errors found."));
+	if (options.format === "json") return printJson(data);
+	for (const error of data) printError(error, options.format);
+}
+//#endregion
+export { fetchErrors, fetchLogs, fetchTraces };

package/dist/index.mjs

@@ -1,2 +1,2 @@
-import { a as validateSourcemap, i as uploadSourcemaps, n as findSourcemapFiles, r as loadAndValidateSourcemap, t as UploadError } from "./upload-DJfE9Qcx.mjs";
+import { a as validateSourcemap, i as uploadSourcemaps, n as findSourcemapFiles, r as loadAndValidateSourcemap, t as UploadError } from "./upload-D2WShd9A.mjs";
 export { UploadError, findSourcemapFiles, loadAndValidateSourcemap, uploadSourcemaps, validateSourcemap };

package/dist/{upload-DJfE9Qcx.mjs → upload-D2WShd9A.mjs}

@@ -1,9 +1,9 @@
 import * as path from "node:path";
 import * as fs from "node:fs";
 import pc from "picocolors";
-import ora from "ora";
+import { Spinner } from "picospinner";
 import ky, { HTTPError, TimeoutError } from "ky";
-import fg from "fast-glob";
+import { glob } from "tinyglobby";
 //#region src/upload.ts
 const MAX_FILE_SIZE = 50 * 1024 * 1024;
 const UPLOAD_TIMEOUT = 12e4;
@@ -12,7 +12,8 @@ const UPLOAD_TIMEOUT = 12e4;
 */
 async function uploadSourcemaps(options) {
 	const { patterns, apiKey, release, apiUrl, dryRun } = options;
-	const spinner = ora("Finding source map files...").start();
+	const spinner = new Spinner("Finding source map files...");
+	spinner.start();
 	const filePaths = await findSourcemapFiles(patterns);
 	if (filePaths.length === 0) {
 		spinner.fail("No source map files found");
@@ -20,7 +21,7 @@ async function uploadSourcemaps(options) {
 		console.error(pc.dim("Make sure the glob patterns match .map files in your build output"));
 		throw new UploadError("No source map files found");
 	}
-	spinner.text = `Validating ${filePaths.length} source map file(s)...`;
+	spinner.setText(`Validating ${filePaths.length} source map file(s)...`);
 	const files = [];
 	for (const filePath of filePaths) {
 		const file = loadAndValidateSourcemap(filePath);
@@ -38,14 +39,15 @@ async function uploadSourcemaps(options) {
 			count: 0
 		};
 	}
-	spinner.start(`Uploading to ${sanitizeUrl(apiUrl)}...`);
+	spinner.setText(`Uploading to ${sanitizeUrl(apiUrl)}...`);
+	spinner.start();
 	const result = await uploadFiles({
 		files,
 		apiKey,
 		release,
 		apiUrl,
 		onProgress: (current, total) => {
-			spinner.text = `Uploading file ${current}/${total} to ${sanitizeUrl(apiUrl)}...`;
+			spinner.setText(`Uploading file ${current}/${total} to ${sanitizeUrl(apiUrl)}...`);
 		}
 	});
 	spinner.succeed(`Uploaded ${result.count} source map(s) for release ${pc.cyan(release)}`);
@@ -55,11 +57,11 @@ async function uploadSourcemaps(options) {
 * Find source map files matching the given glob patterns.
 */
 async function findSourcemapFiles(patterns) {
-	return (await fg(patterns, {
+	return (await glob(patterns, {
 		onlyFiles: true,
 		absolute: true,
-		ignore: ["**/node_modules/**"]
-	})).filter((file) => file.endsWith(".map"));
+		expandDirectories: false
+	})).filter((file) => file.endsWith(".map") && !file.includes("/node_modules/"));
 }
 /**
 * Load and validate a source map file. Returns the file with its content.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@monocle.sh/cli",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "description": "Monocle CLI - upload source maps and manage your Monocle projects",
   "keywords": [
     "cli",
@@ -28,10 +28,10 @@
   },
   "dependencies": {
     "commander": "^14.0.3",
-    "fast-glob": "^3.3.3",
     "ky": "^1.14.3",
-    "ora": "^9.3.0",
-    "picocolors": "^1.1.1"
+    "picocolors": "^1.1.1",
+    "picospinner": "^3.0.0",
+    "tinyglobby": "^0.2.14"
   },
   "devDependencies": {
     "@adonisjs/tsconfig": "^2.0.0",
@@ -40,7 +40,7 @@
     "@japa/runner": "^5.3.0",
     "@poppinss/ts-exec": "^1.4.4",
     "release-it": "^19.2.4",
-    "@monocle.sh/studio": "0.1.0"
+    "@monocle.sh/studio": "0.2.0"
   },
   "engines": {
     "node": ">=22.0.0"