runtime-resolver 0.3.22 → 1.0.0

package/cli/commands/resolve.js

@@ -1,242 +0,0 @@
-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* () {
-	const result = yield* (yield* NodeResolver).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 result = yield* (yield* BunResolver).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 result = yield* (yield* DenoResolver).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) => {
-	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

@@ -1,12 +0,0 @@
-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

@@ -1,86 +0,0 @@
-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 { CliErrorDetail, CliErrorResponse, CliResponse, CliRuntimeError, CliRuntimeResult, CliRuntimeSuccess, CliSuccessResponse };