runtime-resolver 0.3.12 → 0.3.14

package/bin/runtime-resolver.d.ts

@@ -0,0 +1 @@
+export { };

package/bin/runtime-resolver.js

@@ -1,269 +1,37 @@
 #!/usr/bin/env node
-import { Command, Options } from "@effect/cli";
+import { appIdOption, appInstallationIdOption, appPrivateKeyOption, bunDefaultOption, bunOption, denoDefaultOption, denoOption, incrementsOption, nodeDateOption, nodeDefaultOption, nodeOption, nodePhasesOption, prettyOption, resolveHandler, schemaOption, tokenOption } from "../cli/commands/resolve.js";
+import { Cause, Console, Effect } from "effect";
+import { Command } from "@effect/cli";
 import { NodeContext, NodeRuntime } from "@effect/platform-node";
-import { Cause, Console, Effect, Layer, Option } from "effect";
-import { readFileSync } from "node:fs";
-import { NodeScheduleFetcherLive, AutoDenoCacheLive, DenoVersionFetcherLive, AutoNodeCacheLive, BunResolver, NodeResolver, NodeVersionFetcherLive, NodeResolverLive, GitHubAutoAuth, BunResolverLive, BunVersionFetcherLive, GitHubClientLive, DenoResolverLive, GitHubTokenAuthFromToken, GitHubAppAuth, AutoBunCacheLive, DenoResolver } from "../711.js";
-const GitHubLayer = GitHubClientLive.pipe(Layer.provide(GitHubAutoAuth));
-const makeNodeLayer = (authOverride)=>{
-    const ghLayer = authOverride ? GitHubClientLive.pipe(Layer.provide(authOverride)) : GitHubLayer;
-    const fetchersLayer = Layer.merge(NodeVersionFetcherLive.pipe(Layer.provide(ghLayer)), NodeScheduleFetcherLive.pipe(Layer.provide(ghLayer)));
-    return NodeResolverLive.pipe(Layer.provide(AutoNodeCacheLive.pipe(Layer.provide(fetchersLayer))));
-};
-const makeBunLayer = (authOverride)=>{
-    const ghLayer = authOverride ? GitHubClientLive.pipe(Layer.provide(authOverride)) : GitHubLayer;
-    return BunResolverLive.pipe(Layer.provide(AutoBunCacheLive.pipe(Layer.provide(BunVersionFetcherLive.pipe(Layer.provide(ghLayer))))));
-};
-const makeDenoLayer = (authOverride)=>{
-    const ghLayer = authOverride ? GitHubClientLive.pipe(Layer.provide(authOverride)) : GitHubLayer;
-    return DenoResolverLive.pipe(Layer.provide(AutoDenoCacheLive.pipe(Layer.provide(DenoVersionFetcherLive.pipe(Layer.provide(ghLayer))))));
-};
-const SCHEMA_URL = "https://raw.githubusercontent.com/spencerbeggs/runtime-resolver/main/runtime-resolver.schema.json";
-const nodeOption = Options.text("node").pipe(Options.optional);
-const bunOption = Options.text("bun").pipe(Options.optional);
-const denoOption = Options.text("deno").pipe(Options.optional);
-const nodePhasesOption = Options.text("node-phases").pipe(Options.optional);
-const incrementsOption = Options.text("increments").pipe(Options.optional);
-const nodeDefaultOption = Options.text("node-default").pipe(Options.optional);
-const bunDefaultOption = Options.text("bun-default").pipe(Options.optional);
-const denoDefaultOption = Options.text("deno-default").pipe(Options.optional);
-const nodeDateOption = Options.text("node-date").pipe(Options.optional);
-const prettyOption = Options.boolean("pretty").pipe(Options.withDefault(false));
-const schemaOption = Options.boolean("schema").pipe(Options.withDefault(false));
-const tokenOption = Options.text("token").pipe(Options.optional);
-const appIdOption = Options.text("app-id").pipe(Options.optional);
-const appPrivateKeyOption = Options.text("app-private-key").pipe(Options.optional);
-const appInstallationIdOption = Options.text("app-installation-id").pipe(Options.optional);
-const VALID_PHASES = [
-    "current",
-    "active-lts",
-    "maintenance-lts",
-    "end-of-life"
-];
-const VALID_INCREMENTS = [
-    "latest",
-    "minor",
-    "patch"
-];
-const validatePhases = (raw)=>{
-    const phases = raw.split(",").map((s)=>s.trim());
-    for (const p of phases)if (!VALID_PHASES.includes(p)) throw new Error(`Invalid phase: "${p}". Valid values: ${VALID_PHASES.join(", ")}`);
-    return phases;
-};
-const validateIncrements = (raw)=>{
-    if (!VALID_INCREMENTS.includes(raw)) throw new Error(`Invalid increments value: "${raw}". Valid values: ${VALID_INCREMENTS.join(", ")}`);
-    return raw;
-};
-const serializeError = (error)=>{
-    if (error && "object" == typeof error && "_tag" in error && "message" in error) {
-        const { _tag, message, ...rest } = error;
-        return {
-            _tag,
-            message,
-            ...rest
-        };
-    }
-    return {
-        _tag: "UnknownError",
-        message: error instanceof Error ? error.message : String(error)
-    };
-};
-const toSuccess = (name, result)=>[
-        name,
-        {
-            ok: true,
-            source: result.source,
-            versions: [
-                ...result.versions
-            ],
-            latest: result.latest,
-            ...void 0 !== result.lts ? {
-                lts: result.lts
-            } : {},
-            ...void 0 !== result.default ? {
-                default: result.default
-            } : {}
-        }
-    ];
-const toError = (name, error)=>[
-        name,
-        {
-            ok: false,
-            error: serializeError(error)
-        }
-    ];
-const resolveNode = (semverRange, phases, increments, defaultVersion, date, authOverride)=>Effect.gen(function*() {
-        const resolver = yield* NodeResolver;
-        const result = yield* resolver.resolve({
-            semverRange,
-            ...phases ? {
-                phases
-            } : {},
-            ...increments ? {
-                increments
-            } : {},
-            ...defaultVersion ? {
-                defaultVersion
-            } : {},
-            ...date ? {
-                date
-            } : {}
-        });
-        return toSuccess("node", result);
-    }).pipe(Effect.provide(makeNodeLayer(authOverride)), Effect.catchAll((error)=>Effect.succeed(toError("node", error))));
-const resolveBun = (semverRange, increments, defaultVersion, authOverride)=>Effect.gen(function*() {
-        const resolver = yield* BunResolver;
-        const result = yield* resolver.resolve({
-            semverRange,
-            ...increments ? {
-                increments
-            } : {},
-            ...defaultVersion ? {
-                defaultVersion
-            } : {}
-        });
-        return toSuccess("bun", result);
-    }).pipe(Effect.provide(makeBunLayer(authOverride)), Effect.catchAll((error)=>Effect.succeed(toError("bun", error))));
-const resolveDeno = (semverRange, increments, defaultVersion, authOverride)=>Effect.gen(function*() {
-        const resolver = yield* DenoResolver;
-        const result = yield* resolver.resolve({
-            semverRange,
-            ...increments ? {
-                increments
-            } : {},
-            ...defaultVersion ? {
-                defaultVersion
-            } : {}
-        });
-        return toSuccess("deno", result);
-    }).pipe(Effect.provide(makeDenoLayer(authOverride)), Effect.catchAll((error)=>Effect.succeed(toError("deno", error))));
-const formatResponse = (ok, results, pretty)=>{
-    const response = {
-        $schema: SCHEMA_URL,
-        ok,
-        results
-    };
-    return JSON.stringify(response, null, pretty ? 2 : void 0);
-};
-const resolveHandler = (args)=>Effect.gen(function*() {
-        if (args.schema) {
-            const resolveFlags = [
-                args.node,
-                args.bun,
-                args.deno,
-                args.nodePhases,
-                args.increments,
-                args.nodeDefault,
-                args.bunDefault,
-                args.denoDefault,
-                args.nodeDate,
-                args.token,
-                args.appId,
-                args.appPrivateKey,
-                args.appInstallationId
-            ];
-            const hasResolveFlags = resolveFlags.some((f)=>Option.isSome(f));
-            if (hasResolveFlags) return void (yield* Console.error("Error: --schema cannot be combined with resolve flags (--node, --bun, --deno, etc.)"));
-            const { cliJsonSchema } = yield* Effect.promise(()=>import("../json-schema.js").then((m)=>m.json_schema_namespaceObject));
-            yield* Console.log(JSON.stringify(cliJsonSchema, null, 2));
-            return;
-        }
-        const hasToken = Option.isSome(args.token);
-        const hasAppId = Option.isSome(args.appId);
-        const hasAppPrivateKey = Option.isSome(args.appPrivateKey);
-        const hasAppInstallationId = Option.isSome(args.appInstallationId);
-        if (hasToken && (hasAppId || hasAppPrivateKey)) return void (yield* Console.error("Error: --token and --app-id/--app-private-key are mutually exclusive"));
-        if (hasAppId !== hasAppPrivateKey) return void (yield* Console.error("Error: --app-id and --app-private-key must both be provided"));
-        if (hasAppInstallationId && !hasAppId) return void (yield* Console.error("Error: --app-installation-id requires --app-id and --app-private-key"));
-        let resolvedPrivateKey;
-        if (hasAppPrivateKey) {
-            const keyValue = args.appPrivateKey.value;
-            if (keyValue.startsWith("@")) {
-                const filePath = keyValue.slice(1);
-                try {
-                    resolvedPrivateKey = readFileSync(filePath, "utf-8");
-                } catch  {
-                    yield* Console.error(`Error: Cannot read private key file: ${filePath}`);
-                    return;
-                }
-            } else resolvedPrivateKey = keyValue;
-        }
-        let authLayerOverride;
-        if (hasToken) authLayerOverride = GitHubTokenAuthFromToken(args.token.value);
-        else if (hasAppId && resolvedPrivateKey) authLayerOverride = GitHubAppAuth({
-            appId: args.appId.value,
-            privateKey: resolvedPrivateKey,
-            ...hasAppInstallationId ? {
-                installationId: Number(args.appInstallationId.value)
-            } : {}
-        });
-        const hasNode = Option.isSome(args.node);
-        const hasBun = Option.isSome(args.bun);
-        const hasDeno = Option.isSome(args.deno);
-        if (!hasNode && !hasBun && !hasDeno) return void (yield* Console.error("No runtime specified. Use --node, --bun, or --deno to resolve versions.\nRun with --help for usage information."));
-        let validatedPhases;
-        if (Option.isSome(args.nodePhases)) try {
-            validatedPhases = validatePhases(args.nodePhases.value);
-        } catch (e) {
-            yield* Console.error(e.message);
-            return;
-        }
-        let validatedIncrements;
-        if (Option.isSome(args.increments)) try {
-            validatedIncrements = validateIncrements(args.increments.value);
-        } catch (e) {
-            yield* Console.error(e.message);
-            return;
-        }
-        let nodeDate;
-        if (Option.isSome(args.nodeDate)) {
-            nodeDate = new Date(args.nodeDate.value);
-            if (Number.isNaN(nodeDate.getTime())) return void (yield* Console.error(`Invalid date: "${args.nodeDate.value}". Use ISO 8601 format (e.g. 2024-01-15).`));
-        }
-        const tasks = [];
-        if (hasNode) {
-            const nodeDefaultVersion = Option.isSome(args.nodeDefault) ? args.nodeDefault.value : void 0;
-            tasks.push(resolveNode(args.node.value, validatedPhases, validatedIncrements, nodeDefaultVersion, nodeDate, authLayerOverride));
-        }
-        if (hasBun) {
-            const bunDefaultVersion = Option.isSome(args.bunDefault) ? args.bunDefault.value : void 0;
-            tasks.push(resolveBun(args.bun.value, validatedIncrements, bunDefaultVersion, authLayerOverride));
-        }
-        if (hasDeno) {
-            const denoDefaultVersion = Option.isSome(args.denoDefault) ? args.denoDefault.value : void 0;
-            tasks.push(resolveDeno(args.deno.value, validatedIncrements, denoDefaultVersion, authLayerOverride));
-        }
-        const entries = yield* Effect.all(tasks, {
-            concurrency: "unbounded"
-        });
-        const results = Object.fromEntries(entries);
-        const hasError = Object.values(results).some((r)=>!r.ok);
-        yield* Console.log(formatResponse(!hasError, results, args.pretty));
-    });
+
+//#region src/cli/index.ts
+/* v8 ignore start - CLI entry point requires integration testing */
 const rootCommand = Command.make("runtime-resolver", {
-    node: nodeOption,
-    bun: bunOption,
-    deno: denoOption,
-    nodePhases: nodePhasesOption,
-    increments: incrementsOption,
-    nodeDefault: nodeDefaultOption,
-    bunDefault: bunDefaultOption,
-    denoDefault: denoDefaultOption,
-    nodeDate: nodeDateOption,
-    pretty: prettyOption,
-    schema: schemaOption,
-    token: tokenOption,
-    appId: appIdOption,
-    appPrivateKey: appPrivateKeyOption,
-    appInstallationId: appInstallationIdOption
+	node: nodeOption,
+	bun: bunOption,
+	deno: denoOption,
+	nodePhases: nodePhasesOption,
+	increments: incrementsOption,
+	nodeDefault: nodeDefaultOption,
+	bunDefault: bunDefaultOption,
+	denoDefault: denoDefaultOption,
+	nodeDate: nodeDateOption,
+	pretty: prettyOption,
+	schema: schemaOption,
+	token: tokenOption,
+	appId: appIdOption,
+	appPrivateKey: appPrivateKeyOption,
+	appInstallationId: appInstallationIdOption
 }, resolveHandler);
 const cli = Command.run(rootCommand, {
-    name: "runtime-resolver",
-    version: "0.3.12"
+	name: "runtime-resolver",
+	version: "0.3.14"
 });
-const main = Effect.suspend(()=>cli(process.argv)).pipe(Effect.provide(NodeContext.layer), Effect.catchAllCause((cause)=>{
-    const defects = Cause.defects(cause);
-    if (defects.length > 0) return Console.error(Cause.pretty(cause)).pipe(Effect.andThen(Effect.failCause(cause)));
-    return Effect.failCause(cause);
+const main = Effect.suspend(() => cli(process.argv)).pipe(Effect.provide(NodeContext.layer), Effect.catchAllCause((cause) => {
+	if (Cause.defects(cause).length > 0) return Console.error(Cause.pretty(cause)).pipe(Effect.andThen(Effect.failCause(cause)));
+	return Effect.failCause(cause);
 }));
 NodeRuntime.runMain(main);
+
+//#endregion
+export {  };

package/cli/commands/resolve.js

@@ -0,0 +1,239 @@
+import { AutoBunCacheLive } from "../../layers/AutoBunCacheLive.js";
+import { AutoDenoCacheLive } from "../../layers/AutoDenoCacheLive.js";
+import { AutoNodeCacheLive } from "../../layers/AutoNodeCacheLive.js";
+import { BunResolver } from "../../services/BunResolver.js";
+import { BunResolverLive } from "../../layers/BunResolverLive.js";
+import { BunVersionFetcherLive } from "../../layers/BunVersionFetcherLive.js";
+import { DenoResolver } from "../../services/DenoResolver.js";
+import { DenoResolverLive } from "../../layers/DenoResolverLive.js";
+import { DenoVersionFetcherLive } from "../../layers/DenoVersionFetcherLive.js";
+import { GitHubAppAuth } from "../../layers/GitHubAppAuth.js";
+import { GitHubAutoAuth } from "../../layers/GitHubAutoAuth.js";
+import { GitHubClientLive } from "../../layers/GitHubClientLive.js";
+import { NodeResolver } from "../../services/NodeResolver.js";
+import { NodeResolverLive } from "../../layers/NodeResolverLive.js";
+import { NodeScheduleFetcherLive } from "../../layers/NodeScheduleFetcherLive.js";
+import { NodeVersionFetcherLive } from "../../layers/NodeVersionFetcherLive.js";
+import { GitHubTokenAuthFromToken } from "../../layers/GitHubTokenAuth.js";
+import { Console, Effect, Layer, Option } from "effect";
+import { Options } from "@effect/cli";
+import { readFileSync } from "node:fs";
+
+//#region src/cli/commands/resolve.ts
+/* v8 ignore start */
+const GitHubLayer = GitHubClientLive.pipe(Layer.provide(GitHubAutoAuth));
+const makeNodeLayer = (authOverride) => {
+	const ghLayer = authOverride ? GitHubClientLive.pipe(Layer.provide(authOverride)) : GitHubLayer;
+	const fetchersLayer = Layer.merge(NodeVersionFetcherLive.pipe(Layer.provide(ghLayer)), NodeScheduleFetcherLive.pipe(Layer.provide(ghLayer)));
+	return NodeResolverLive.pipe(Layer.provide(AutoNodeCacheLive.pipe(Layer.provide(fetchersLayer))));
+};
+const makeBunLayer = (authOverride) => {
+	const ghLayer = authOverride ? GitHubClientLive.pipe(Layer.provide(authOverride)) : GitHubLayer;
+	return BunResolverLive.pipe(Layer.provide(AutoBunCacheLive.pipe(Layer.provide(BunVersionFetcherLive.pipe(Layer.provide(ghLayer))))));
+};
+const makeDenoLayer = (authOverride) => {
+	const ghLayer = authOverride ? GitHubClientLive.pipe(Layer.provide(authOverride)) : GitHubLayer;
+	return DenoResolverLive.pipe(Layer.provide(AutoDenoCacheLive.pipe(Layer.provide(DenoVersionFetcherLive.pipe(Layer.provide(ghLayer))))));
+};
+const SCHEMA_URL = "https://raw.githubusercontent.com/spencerbeggs/runtime-resolver/main/runtime-resolver.schema.json";
+const nodeOption = Options.text("node").pipe(Options.optional);
+const bunOption = Options.text("bun").pipe(Options.optional);
+const denoOption = Options.text("deno").pipe(Options.optional);
+const nodePhasesOption = Options.text("node-phases").pipe(Options.optional);
+const incrementsOption = Options.text("increments").pipe(Options.optional);
+const nodeDefaultOption = Options.text("node-default").pipe(Options.optional);
+const bunDefaultOption = Options.text("bun-default").pipe(Options.optional);
+const denoDefaultOption = Options.text("deno-default").pipe(Options.optional);
+const nodeDateOption = Options.text("node-date").pipe(Options.optional);
+const prettyOption = Options.boolean("pretty").pipe(Options.withDefault(false));
+const schemaOption = Options.boolean("schema").pipe(Options.withDefault(false));
+const tokenOption = Options.text("token").pipe(Options.optional);
+const appIdOption = Options.text("app-id").pipe(Options.optional);
+const appPrivateKeyOption = Options.text("app-private-key").pipe(Options.optional);
+const appInstallationIdOption = Options.text("app-installation-id").pipe(Options.optional);
+const VALID_PHASES = [
+	"current",
+	"active-lts",
+	"maintenance-lts",
+	"end-of-life"
+];
+const VALID_INCREMENTS = [
+	"latest",
+	"minor",
+	"patch"
+];
+const validatePhases = (raw) => {
+	const phases = raw.split(",").map((s) => s.trim());
+	for (const p of phases) if (!VALID_PHASES.includes(p)) throw new Error(`Invalid phase: "${p}". Valid values: ${VALID_PHASES.join(", ")}`);
+	return phases;
+};
+const validateIncrements = (raw) => {
+	if (!VALID_INCREMENTS.includes(raw)) throw new Error(`Invalid increments value: "${raw}". Valid values: ${VALID_INCREMENTS.join(", ")}`);
+	return raw;
+};
+const serializeError = (error) => {
+	if (error && typeof error === "object" && "_tag" in error && "message" in error) {
+		const { _tag, message, ...rest } = error;
+		return {
+			_tag,
+			message,
+			...rest
+		};
+	}
+	return {
+		_tag: "UnknownError",
+		message: error instanceof Error ? error.message : String(error)
+	};
+};
+const toSuccess = (name, result) => [name, {
+	ok: true,
+	source: result.source,
+	versions: [...result.versions],
+	latest: result.latest,
+	...result.lts !== void 0 ? { lts: result.lts } : {},
+	...result.default !== void 0 ? { default: result.default } : {}
+}];
+const toError = (name, error) => [name, {
+	ok: false,
+	error: serializeError(error)
+}];
+const resolveNode = (semverRange, phases, increments, defaultVersion, date, authOverride) => Effect.gen(function* () {
+	return toSuccess("node", yield* (yield* NodeResolver).resolve({
+		semverRange,
+		...phases ? { phases } : {},
+		...increments ? { increments } : {},
+		...defaultVersion ? { defaultVersion } : {},
+		...date ? { date } : {}
+	}));
+}).pipe(Effect.provide(makeNodeLayer(authOverride)), Effect.catchAll((error) => Effect.succeed(toError("node", error))));
+const resolveBun = (semverRange, increments, defaultVersion, authOverride) => Effect.gen(function* () {
+	return toSuccess("bun", yield* (yield* BunResolver).resolve({
+		semverRange,
+		...increments ? { increments } : {},
+		...defaultVersion ? { defaultVersion } : {}
+	}));
+}).pipe(Effect.provide(makeBunLayer(authOverride)), Effect.catchAll((error) => Effect.succeed(toError("bun", error))));
+const resolveDeno = (semverRange, increments, defaultVersion, authOverride) => Effect.gen(function* () {
+	return toSuccess("deno", yield* (yield* DenoResolver).resolve({
+		semverRange,
+		...increments ? { increments } : {},
+		...defaultVersion ? { defaultVersion } : {}
+	}));
+}).pipe(Effect.provide(makeDenoLayer(authOverride)), Effect.catchAll((error) => Effect.succeed(toError("deno", error))));
+const formatResponse = (ok, results, pretty) => {
+	return JSON.stringify({
+		$schema: SCHEMA_URL,
+		ok,
+		results
+	}, null, pretty ? 2 : void 0);
+};
+const resolveHandler = (args) => Effect.gen(function* () {
+	if (args.schema) {
+		if ([
+			args.node,
+			args.bun,
+			args.deno,
+			args.nodePhases,
+			args.increments,
+			args.nodeDefault,
+			args.bunDefault,
+			args.denoDefault,
+			args.nodeDate,
+			args.token,
+			args.appId,
+			args.appPrivateKey,
+			args.appInstallationId
+		].some((f) => Option.isSome(f))) {
+			yield* Console.error("Error: --schema cannot be combined with resolve flags (--node, --bun, --deno, etc.)");
+			return;
+		}
+		const { cliJsonSchema } = yield* Effect.promise(() => import("../schemas/json-schema.js"));
+		yield* Console.log(JSON.stringify(cliJsonSchema, null, 2));
+		return;
+	}
+	const hasToken = Option.isSome(args.token);
+	const hasAppId = Option.isSome(args.appId);
+	const hasAppPrivateKey = Option.isSome(args.appPrivateKey);
+	const hasAppInstallationId = Option.isSome(args.appInstallationId);
+	if (hasToken && (hasAppId || hasAppPrivateKey)) {
+		yield* Console.error("Error: --token and --app-id/--app-private-key are mutually exclusive");
+		return;
+	}
+	if (hasAppId !== hasAppPrivateKey) {
+		yield* Console.error("Error: --app-id and --app-private-key must both be provided");
+		return;
+	}
+	if (hasAppInstallationId && !hasAppId) {
+		yield* Console.error("Error: --app-installation-id requires --app-id and --app-private-key");
+		return;
+	}
+	let resolvedPrivateKey;
+	if (hasAppPrivateKey) {
+		const keyValue = args.appPrivateKey.value;
+		if (keyValue.startsWith("@")) {
+			const filePath = keyValue.slice(1);
+			try {
+				resolvedPrivateKey = readFileSync(filePath, "utf-8");
+			} catch {
+				yield* Console.error(`Error: Cannot read private key file: ${filePath}`);
+				return;
+			}
+		} else resolvedPrivateKey = keyValue;
+	}
+	let authLayerOverride;
+	if (hasToken) authLayerOverride = GitHubTokenAuthFromToken(args.token.value);
+	else if (hasAppId && resolvedPrivateKey) authLayerOverride = GitHubAppAuth({
+		appId: args.appId.value,
+		privateKey: resolvedPrivateKey,
+		...hasAppInstallationId ? { installationId: Number(args.appInstallationId.value) } : {}
+	});
+	const hasNode = Option.isSome(args.node);
+	const hasBun = Option.isSome(args.bun);
+	const hasDeno = Option.isSome(args.deno);
+	if (!hasNode && !hasBun && !hasDeno) {
+		yield* Console.error("No runtime specified. Use --node, --bun, or --deno to resolve versions.\nRun with --help for usage information.");
+		return;
+	}
+	let validatedPhases;
+	if (Option.isSome(args.nodePhases)) try {
+		validatedPhases = validatePhases(args.nodePhases.value);
+	} catch (e) {
+		yield* Console.error(e.message);
+		return;
+	}
+	let validatedIncrements;
+	if (Option.isSome(args.increments)) try {
+		validatedIncrements = validateIncrements(args.increments.value);
+	} catch (e) {
+		yield* Console.error(e.message);
+		return;
+	}
+	let nodeDate;
+	if (Option.isSome(args.nodeDate)) {
+		nodeDate = new Date(args.nodeDate.value);
+		if (Number.isNaN(nodeDate.getTime())) {
+			yield* Console.error(`Invalid date: "${args.nodeDate.value}". Use ISO 8601 format (e.g. 2024-01-15).`);
+			return;
+		}
+	}
+	const tasks = [];
+	if (hasNode) {
+		const nodeDefaultVersion = Option.isSome(args.nodeDefault) ? args.nodeDefault.value : void 0;
+		tasks.push(resolveNode(args.node.value, validatedPhases, validatedIncrements, nodeDefaultVersion, nodeDate, authLayerOverride));
+	}
+	if (hasBun) {
+		const bunDefaultVersion = Option.isSome(args.bunDefault) ? args.bunDefault.value : void 0;
+		tasks.push(resolveBun(args.bun.value, validatedIncrements, bunDefaultVersion, authLayerOverride));
+	}
+	if (hasDeno) {
+		const denoDefaultVersion = Option.isSome(args.denoDefault) ? args.denoDefault.value : void 0;
+		tasks.push(resolveDeno(args.deno.value, validatedIncrements, denoDefaultVersion, authLayerOverride));
+	}
+	const entries = yield* Effect.all(tasks, { concurrency: "unbounded" });
+	const results = Object.fromEntries(entries);
+	const hasError = Object.values(results).some((r) => !r.ok);
+	yield* Console.log(formatResponse(!hasError, results, args.pretty));
+});
+
+//#endregion
+export { appIdOption, appInstallationIdOption, appPrivateKeyOption, bunDefaultOption, bunOption, denoDefaultOption, denoOption, incrementsOption, nodeDateOption, nodeDefaultOption, nodeOption, nodePhasesOption, prettyOption, resolveHandler, schemaOption, tokenOption };

package/cli/schemas/json-schema.js

@@ -0,0 +1,12 @@
+import { CliResponse } from "./response.js";
+import { JSONSchema } from "effect";
+
+//#region src/cli/schemas/json-schema.ts
+/**
+* JSON Schema for the CLI response envelope.
+* Used by --schema flag and can be published alongside the package.
+*/
+const cliJsonSchema = JSONSchema.make(CliResponse);
+
+//#endregion
+export { cliJsonSchema };

package/cli/schemas/response.js

@@ -0,0 +1,86 @@
+import { Schema } from "effect";
+
+//#region src/cli/schemas/response.ts
+/**
+* Structured error in CLI output. Uses _tag to identify the error type.
+* Additional fields vary by error type and are passed through as-is.
+*/
+const CliErrorDetail = Schema.Struct({
+	_tag: Schema.String.annotations({ description: "Error type identifier (e.g. RateLimitError, SemverError)" }),
+	message: Schema.String.annotations({ description: "Human-readable error message" })
+}).pipe(Schema.extend(Schema.Record({
+	key: Schema.String,
+	value: Schema.Unknown.annotations({
+		description: "Additional error-specific metadata",
+		title: "ErrorMetadata"
+	})
+})), Schema.annotations({
+	identifier: "CliErrorDetail",
+	description: "Structured error with type tag, message, and optional metadata"
+}));
+/**
+* Successful resolution for a single runtime.
+*/
+const CliRuntimeSuccess = Schema.Struct({
+	ok: Schema.Literal(true).annotations({ description: "Indicates successful resolution" }),
+	source: Schema.String.annotations({ description: "Data source: 'api' or 'cache'" }),
+	versions: Schema.Array(Schema.String.annotations({ description: "Semver version string" })).annotations({ description: "All resolved versions matching the semver range" }),
+	latest: Schema.String.annotations({ description: "Most recent version matching the range" }),
+	lts: Schema.optional(Schema.String.annotations({ description: "Current LTS version (Node.js only)" })),
+	default: Schema.optional(Schema.String.annotations({ description: "Default recommended version" }))
+}).annotations({
+	identifier: "CliRuntimeSuccess",
+	description: "Successful version resolution for a single runtime"
+});
+/**
+* Failed resolution for a single runtime.
+*/
+const CliRuntimeError = Schema.Struct({
+	ok: Schema.Literal(false).annotations({ description: "Indicates failed resolution" }),
+	error: CliErrorDetail
+}).annotations({
+	identifier: "CliRuntimeError",
+	description: "Failed version resolution for a single runtime"
+});
+/**
+* Per-runtime result: success or error.
+*/
+const CliRuntimeResult = Schema.Union(CliRuntimeSuccess, CliRuntimeError).annotations({
+	identifier: "CliRuntimeResult",
+	description: "Per-runtime resolution result: either success with versions or error with details"
+});
+const CliResultsMap = Schema.Record({
+	key: Schema.String.annotations({ description: "Runtime name (node, bun, or deno)" }),
+	value: CliRuntimeResult
+}).annotations({ description: "Map of runtime name to resolution result" });
+/**
+* Full CLI success response — all runtimes resolved.
+*/
+const CliSuccessResponse = Schema.Struct({
+	ok: Schema.Literal(true).annotations({ description: "True when all requested runtimes resolved successfully" }),
+	results: CliResultsMap
+}).annotations({
+	identifier: "CliSuccessResponse",
+	description: "All requested runtimes resolved successfully"
+});
+/**
+* Full CLI error response — at least one runtime failed.
+*/
+const CliErrorResponse = Schema.Struct({
+	ok: Schema.Literal(false).annotations({ description: "False when one or more requested runtimes failed to resolve" }),
+	results: CliResultsMap
+}).annotations({
+	identifier: "CliErrorResponse",
+	description: "One or more requested runtimes failed to resolve"
+});
+/**
+* Top-level CLI response envelope.
+*/
+const CliResponse = Schema.Union(CliSuccessResponse, CliErrorResponse).annotations({
+	identifier: "CliResponse",
+	title: "RuntimeResolverResponse",
+	description: "CLI response envelope. Contains an ok discriminator and a results map with per-runtime resolution outcomes."
+});
+
+//#endregion
+export { CliResponse };