runtime-resolver 0.3.11 → 0.3.13

package/layers/GitHubAppAuth.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"GitHubAppAuth.js","names":[],"sources":["../../../../src/layers/GitHubAppAuth.ts"],"sourcesContent":["import { createAppAuth } from \"@octokit/auth-app\";\nimport { Effect, Layer } from \"effect\";\nimport { Octokit } from \"octokit\";\nimport { AuthenticationError } from \"../errors/AuthenticationError.js\";\nimport { OctokitInstance } from \"../services/OctokitInstance.js\";\n\n/**\n * Configuration required to authenticate as a GitHub App installation.\n *\n * @see {@link GitHubAppAuth}\n * @public\n */\nexport interface GitHubAppAuthConfig {\n\treadonly appId: string;\n\treadonly privateKey: string;\n\treadonly installationId?: number;\n}\n\nconst resolveInstallationId = async (\n\tauth: (opts: { type: \"app\" }) => Promise<{ token: string }>,\n\tinstallationId?: number,\n): Promise<number> => {\n\tif (installationId) return installationId;\n\n\tconst { token: jwt } = await auth({ type: \"app\" });\n\n\tconst response = await fetch(\"https://api.github.com/app/installations?per_page=100\", {\n\t\theaders: {\n\t\t\tAuthorization: `Bearer ${jwt}`,\n\t\t\tAccept: \"application/vnd.github+json\",\n\t\t},\n\t});\n\n\tif (!response.ok) {\n\t\tthrow new Error(`Failed to list installations: ${response.status}`);\n\t}\n\n\tconst installations = (await response.json()) as Array<{ id: number }>;\n\n\tif (installations.length === 0) {\n\t\tthrow new Error(\"No installations found for this GitHub App\");\n\t}\n\n\t// Use the first installation. Most apps have a single installation;\n\t// callers with multiple should pass installationId explicitly.\n\treturn installations[0].id;\n};\n\n/**\n * Provides an {@link OctokitInstance} authenticated as a GitHub App installation.\n *\n * Accepts a {@link GitHubAppAuthConfig} and uses `@octokit/auth-app` to obtain\n * an installation access token. If `installationId` is omitted, the first\n * installation returned by the GitHub API is used automatically (suitable for\n * apps with a single installation). If authentication fails for any reason the\n * layer fails with an `AuthenticationError`.\n *\n * Use this auth method when your integration runs as a GitHub App rather than\n * as an individual user or a CI token.\n *\n * @param config - App credentials and optional installation ID.\n *\n * @see {@link GitHubAppAuthConfig}\n * @see {@link OctokitInstance}\n * @see {@link GitHubAutoAuth}\n * @see {@link GitHubTokenAuth}\n * @public\n */\nexport const GitHubAppAuth = (config: GitHubAppAuthConfig): Layer.Layer<OctokitInstance, AuthenticationError> =>\n\tLayer.effect(\n\t\tOctokitInstance,\n\t\tEffect.tryPromise({\n\t\t\ttry: async () => {\n\t\t\t\tconst auth = createAppAuth({\n\t\t\t\t\tappId: config.appId,\n\t\t\t\t\tprivateKey: config.privateKey,\n\t\t\t\t});\n\n\t\t\t\tconst resolvedId = await resolveInstallationId(auth, config.installationId);\n\n\t\t\t\tconst result = await auth({\n\t\t\t\t\ttype: \"installation\",\n\t\t\t\t\tinstallationId: resolvedId,\n\t\t\t\t});\n\n\t\t\t\treturn new Octokit({ auth: result.token });\n\t\t\t},\n\t\t\tcatch: (error) =>\n\t\t\t\tnew AuthenticationError({\n\t\t\t\t\tmethod: \"app\",\n\t\t\t\t\tmessage: error instanceof Error ? error.message : String(error),\n\t\t\t\t}),\n\t\t}),\n\t);\n"],"mappings":";;;;;;;AAkBA,MAAM,wBAAwB,OAC7B,MACA,mBACqB;CACrB,IAAI,gBAAgB,OAAO;CAE3B,MAAM,EAAE,OAAO,QAAQ,MAAM,KAAK,EAAE,MAAM,MAAM,CAAC;CAEjD,MAAM,WAAW,MAAM,MAAM,yDAAyD,EACrF,SAAS;EACR,eAAe,UAAU;EACzB,QAAQ;CACT,EACD,CAAC;CAED,IAAI,CAAC,SAAS,IACb,MAAM,IAAI,MAAM,iCAAiC,SAAS,QAAQ;CAGnE,MAAM,gBAAiB,MAAM,SAAS,KAAK;CAE3C,IAAI,cAAc,WAAW,GAC5B,MAAM,IAAI,MAAM,4CAA4C;CAK7D,OAAO,cAAc,EAAE,CAAC;AACzB;;;;;;;;;;;;;;;;;;;;;AAsBA,MAAa,iBAAiB,WAC7B,MAAM,OACL,iBACA,OAAO,WAAW;CACjB,KAAK,YAAY;EAChB,MAAM,OAAO,cAAc;GAC1B,OAAO,OAAO;GACd,YAAY,OAAO;EACpB,CAAC;EASD,OAAO,IAAI,QAAQ,EAAE,OAAM,MALN,KAAK;GACzB,MAAM;GACN,gBAAgB,MAJQ,sBAAsB,MAAM,OAAO,cAAc;EAK1E,CAAC,EAEgC,CAAC,MAAM,CAAC;CAC1C;CACA,QAAQ,UACP,IAAI,oBAAoB;EACvB,QAAQ;EACR,SAAS,iBAAiB,QAAQ,MAAM,UAAU,OAAO,KAAK;CAC/D,CAAC;AACH,CAAC,CACF"}

package/layers/GitHubAutoAuth.js

@@ -0,0 +1,71 @@
+import { OctokitInstance } from "../services/OctokitInstance.js";
+import { GitHubAppAuth } from "./GitHubAppAuth.js";
+import { Effect, Layer } from "effect";
+import { Octokit } from "octokit";
+
+//#region src/layers/GitHubAutoAuth.ts
+/**
+* Provides an {@link OctokitInstance} by auto-detecting the available
+* authentication credentials from environment variables at layer construction
+* time.
+*
+* Credentials are evaluated in the following priority order:
+* 1. **GitHub App** — when both `GITHUB_APP_ID` and `GITHUB_APP_PRIVATE_KEY`
+*    are set, authenticates as a GitHub App installation via {@link GitHubAppAuth}.
+*    `GITHUB_APP_INSTALLATION_ID` is optional; if absent the first installation
+*    is used automatically.
+* 2. **Personal Access Token** — when `GITHUB_PERSONAL_ACCESS_TOKEN` is set,
+*    authenticates with that token.
+* 3. **`GITHUB_TOKEN`** — when `GITHUB_TOKEN` is set (e.g., the default token
+*    injected in GitHub Actions), authenticates with that token.
+* 4. **Unauthenticated** — falls back to an unauthenticated Octokit instance
+*    when no credentials are found (lower rate limits apply).
+*
+* If both App and token credentials are present, App auth takes precedence and
+* a warning is logged. This layer fails with `AuthenticationError` only when
+* App credentials are present but the App authentication itself fails.
+*
+* Use this layer as the default auth strategy in most applications. Switch to
+* {@link GitHubTokenAuth} or {@link GitHubAppAuth} when you need explicit control
+* over which credential source is used.
+*
+* @example
+* ```ts
+* import { GitHubClientLive, GitHubAutoAuth } from "runtime-resolver";
+* import { Layer } from "effect";
+*
+* const GitHubLayer = GitHubClientLive.pipe(Layer.provide(GitHubAutoAuth));
+* ```
+*
+* @see {@link OctokitInstance}
+* @see {@link GitHubTokenAuth}
+* @see {@link GitHubAppAuth}
+* @public
+*/
+const GitHubAutoAuth = Layer.effect(OctokitInstance, Effect.gen(function* () {
+	const appId = process.env.GITHUB_APP_ID;
+	const privateKey = process.env.GITHUB_APP_PRIVATE_KEY;
+	const installationId = process.env.GITHUB_APP_INSTALLATION_ID;
+	const pat = process.env.GITHUB_PERSONAL_ACCESS_TOKEN;
+	const token = process.env.GITHUB_TOKEN;
+	const hasApp = appId && privateKey;
+	if (hasApp && (pat || token)) {
+		const tokenSource = pat ? "GITHUB_PERSONAL_ACCESS_TOKEN" : "GITHUB_TOKEN";
+		yield* Effect.logWarning(`Multiple GitHub credential sources found. Using GitHub App authentication (from GITHUB_APP_ID). Ignoring ${tokenSource}.`);
+	}
+	if (hasApp) {
+		const appLayer = GitHubAppAuth({
+			appId,
+			privateKey,
+			...installationId ? { installationId: Number(installationId) } : {}
+		});
+		return yield* Effect.provide(OctokitInstance, appLayer);
+	}
+	if (pat) return new Octokit({ auth: pat });
+	if (token) return new Octokit({ auth: token });
+	return new Octokit();
+}));
+
+//#endregion
+export { GitHubAutoAuth };
+//# sourceMappingURL=GitHubAutoAuth.js.map

package/layers/GitHubAutoAuth.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"GitHubAutoAuth.js","names":[],"sources":["../../../../src/layers/GitHubAutoAuth.ts"],"sourcesContent":["import { Effect, Layer } from \"effect\";\nimport { Octokit } from \"octokit\";\nimport type { AuthenticationError } from \"../errors/AuthenticationError.js\";\nimport { OctokitInstance } from \"../services/OctokitInstance.js\";\nimport { GitHubAppAuth } from \"./GitHubAppAuth.js\";\n\n/**\n * Provides an {@link OctokitInstance} by auto-detecting the available\n * authentication credentials from environment variables at layer construction\n * time.\n *\n * Credentials are evaluated in the following priority order:\n * 1. **GitHub App** — when both `GITHUB_APP_ID` and `GITHUB_APP_PRIVATE_KEY`\n *    are set, authenticates as a GitHub App installation via {@link GitHubAppAuth}.\n *    `GITHUB_APP_INSTALLATION_ID` is optional; if absent the first installation\n *    is used automatically.\n * 2. **Personal Access Token** — when `GITHUB_PERSONAL_ACCESS_TOKEN` is set,\n *    authenticates with that token.\n * 3. **`GITHUB_TOKEN`** — when `GITHUB_TOKEN` is set (e.g., the default token\n *    injected in GitHub Actions), authenticates with that token.\n * 4. **Unauthenticated** — falls back to an unauthenticated Octokit instance\n *    when no credentials are found (lower rate limits apply).\n *\n * If both App and token credentials are present, App auth takes precedence and\n * a warning is logged. This layer fails with `AuthenticationError` only when\n * App credentials are present but the App authentication itself fails.\n *\n * Use this layer as the default auth strategy in most applications. Switch to\n * {@link GitHubTokenAuth} or {@link GitHubAppAuth} when you need explicit control\n * over which credential source is used.\n *\n * @example\n * ```ts\n * import { GitHubClientLive, GitHubAutoAuth } from \"runtime-resolver\";\n * import { Layer } from \"effect\";\n *\n * const GitHubLayer = GitHubClientLive.pipe(Layer.provide(GitHubAutoAuth));\n * ```\n *\n * @see {@link OctokitInstance}\n * @see {@link GitHubTokenAuth}\n * @see {@link GitHubAppAuth}\n * @public\n */\nexport const GitHubAutoAuth: Layer.Layer<OctokitInstance, AuthenticationError> = Layer.effect(\n\tOctokitInstance,\n\tEffect.gen(function* () {\n\t\tconst appId = process.env.GITHUB_APP_ID;\n\t\tconst privateKey = process.env.GITHUB_APP_PRIVATE_KEY;\n\t\tconst installationId = process.env.GITHUB_APP_INSTALLATION_ID;\n\t\tconst pat = process.env.GITHUB_PERSONAL_ACCESS_TOKEN;\n\t\tconst token = process.env.GITHUB_TOKEN;\n\n\t\tconst hasApp = appId && privateKey;\n\t\tconst hasToken = pat || token;\n\n\t\t// Warn when multiple credential sources are detected\n\t\tif (hasApp && hasToken) {\n\t\t\tconst tokenSource = pat ? \"GITHUB_PERSONAL_ACCESS_TOKEN\" : \"GITHUB_TOKEN\";\n\t\t\tyield* Effect.logWarning(\n\t\t\t\t`Multiple GitHub credential sources found. Using GitHub App authentication (from GITHUB_APP_ID). Ignoring ${tokenSource}.`,\n\t\t\t);\n\t\t}\n\n\t\t// Priority 1: App env vars\n\t\tif (hasApp) {\n\t\t\tconst appLayer = GitHubAppAuth({\n\t\t\t\tappId: appId,\n\t\t\t\tprivateKey: privateKey,\n\t\t\t\t...(installationId ? { installationId: Number(installationId) } : {}),\n\t\t\t});\n\t\t\treturn yield* Effect.provide(OctokitInstance, appLayer);\n\t\t}\n\n\t\t// Priority 2: Token env vars (PAT first, then GITHUB_TOKEN)\n\t\tif (pat) {\n\t\t\treturn new Octokit({ auth: pat });\n\t\t}\n\t\tif (token) {\n\t\t\treturn new Octokit({ auth: token });\n\t\t}\n\n\t\t// Priority 3: Unauthenticated\n\t\treturn new Octokit();\n\t}),\n);\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA4CA,MAAa,iBAAoE,MAAM,OACtF,iBACA,OAAO,IAAI,aAAa;CACvB,MAAM,QAAQ,QAAQ,IAAI;CAC1B,MAAM,aAAa,QAAQ,IAAI;CAC/B,MAAM,iBAAiB,QAAQ,IAAI;CACnC,MAAM,MAAM,QAAQ,IAAI;CACxB,MAAM,QAAQ,QAAQ,IAAI;CAE1B,MAAM,SAAS,SAAS;CAIxB,IAAI,WAHa,OAAO,QAGA;EACvB,MAAM,cAAc,MAAM,iCAAiC;EAC3D,OAAO,OAAO,WACb,4GAA4G,YAAY,EACzH;CACD;CAGA,IAAI,QAAQ;EACX,MAAM,WAAW,cAAc;GACvB;GACK;GACZ,GAAI,iBAAiB,EAAE,gBAAgB,OAAO,cAAc,EAAE,IAAI,CAAC;EACpE,CAAC;EACD,OAAO,OAAO,OAAO,QAAQ,iBAAiB,QAAQ;CACvD;CAGA,IAAI,KACH,OAAO,IAAI,QAAQ,EAAE,MAAM,IAAI,CAAC;CAEjC,IAAI,OACH,OAAO,IAAI,QAAQ,EAAE,MAAM,MAAM,CAAC;CAInC,OAAO,IAAI,QAAQ;AACpB,CAAC,CACF"}

package/layers/GitHubClientLive.js

@@ -0,0 +1,131 @@
+import { GitHubClient } from "../services/GitHubClient.js";
+import { OctokitInstance } from "../services/OctokitInstance.js";
+import { AuthenticationError } from "../errors/AuthenticationError.js";
+import { NetworkError } from "../errors/NetworkError.js";
+import { ParseError } from "../errors/ParseError.js";
+import { RateLimitError } from "../errors/RateLimitError.js";
+import { GitHubReleaseList, GitHubTagList } from "../schemas/github.js";
+import { Effect, Layer, Schema } from "effect";
+
+//#region src/layers/GitHubClientLive.ts
+const mapOctokitError = (error, url) => {
+	const err = error;
+	if (err.status === 401) return new AuthenticationError({
+		method: "token",
+		message: `GitHub API authentication failed for ${url}`
+	});
+	if (err.status === 403 || err.status === 429) {
+		const headers = err.response?.headers ?? {};
+		const retryAfterStr = headers["retry-after"];
+		return new RateLimitError({
+			...retryAfterStr ? { retryAfter: Number.parseInt(retryAfterStr, 10) } : {},
+			limit: headers["x-ratelimit-limit"] ? Number.parseInt(headers["x-ratelimit-limit"], 10) : 0,
+			remaining: headers["x-ratelimit-remaining"] ? Number.parseInt(headers["x-ratelimit-remaining"], 10) : 0,
+			message: `GitHub API rate limit exceeded for ${url}`
+		});
+	}
+	return new NetworkError({
+		url,
+		...err.status !== void 0 ? { status: err.status } : {},
+		message: error instanceof Error ? error.message : String(error)
+	});
+};
+const decodeTagList = Schema.decodeUnknown(GitHubTagList);
+const decodeReleaseList = Schema.decodeUnknown(GitHubReleaseList);
+/**
+* Provides the {@link GitHubClient} service backed by an {@link OctokitInstance}.
+*
+* This layer wraps an Octokit instance and exposes a typed, Effect-native API
+* for listing GitHub releases, listing tags, and fetching arbitrary JSON from
+* URLs. HTTP errors are mapped to typed domain errors (`NetworkError`,
+* `RateLimitError`, `AuthenticationError`) so they can be handled precisely in
+* calling code.
+*
+* Pair this layer with one of the auth layers to form a complete GitHub
+* integration stack:
+* - {@link GitHubAutoAuth} — auto-detects auth from environment variables
+* - {@link GitHubTokenAuth} — authenticates using a personal access token
+* - {@link GitHubAppAuth} — authenticates as a GitHub App installation
+*
+* @see {@link GitHubClient}
+* @see {@link OctokitInstance}
+* @see {@link GitHubAutoAuth}
+* @public
+*/
+const GitHubClientLive = Layer.effect(GitHubClient, Effect.gen(function* () {
+	const octokit = yield* OctokitInstance;
+	return {
+		listTags: (owner, repo, options) => Effect.gen(function* () {
+			const perPage = options?.perPage ?? 100;
+			const maxPages = options?.pages ?? Number.POSITIVE_INFINITY;
+			const allTags = [];
+			for (let page = 1; page <= maxPages; page++) {
+				const response = yield* Effect.tryPromise({
+					try: () => octokit.rest.repos.listTags({
+						owner,
+						repo,
+						per_page: perPage,
+						page
+					}),
+					catch: (error) => mapOctokitError(error, `repos/${owner}/${repo}/tags`)
+				});
+				const tags = yield* decodeTagList(response.data).pipe(Effect.mapError((e) => new ParseError({
+					source: `repos/${owner}/${repo}/tags`,
+					message: `Schema validation failed: ${e.message}`
+				})));
+				allTags.push(...tags);
+				if (response.data.length < perPage) break;
+			}
+			return allTags;
+		}),
+		listReleases: (owner, repo, options) => Effect.gen(function* () {
+			const perPage = options?.perPage ?? 100;
+			const maxPages = options?.pages ?? Number.POSITIVE_INFINITY;
+			const allReleases = [];
+			for (let page = 1; page <= maxPages; page++) {
+				const response = yield* Effect.tryPromise({
+					try: () => octokit.rest.repos.listReleases({
+						owner,
+						repo,
+						per_page: perPage,
+						page
+					}),
+					catch: (error) => mapOctokitError(error, `repos/${owner}/${repo}/releases`)
+				});
+				const releases = yield* decodeReleaseList(response.data).pipe(Effect.mapError((e) => new ParseError({
+					source: `repos/${owner}/${repo}/releases`,
+					message: `Schema validation failed: ${e.message}`
+				})));
+				allReleases.push(...releases);
+				if (response.data.length < perPage) break;
+			}
+			return allReleases;
+		}),
+		getJson: (url, schema) => Effect.gen(function* () {
+			const response = yield* Effect.tryPromise({
+				try: () => fetch(url),
+				catch: (error) => new NetworkError({
+					url,
+					message: error instanceof Error ? error.message : String(error)
+				})
+			});
+			if (!response.ok) yield* Effect.fail(new NetworkError({
+				url,
+				status: response.status,
+				message: `HTTP ${response.status}: ${response.statusText}`
+			}));
+			const json = yield* Effect.tryPromise({
+				try: () => response.json(),
+				catch: () => new ParseError({
+					source: url,
+					message: "Failed to parse JSON response"
+				})
+			});
+			return yield* schema.decode(json);
+		})
+	};
+}));
+
+//#endregion
+export { GitHubClientLive };
+//# sourceMappingURL=GitHubClientLive.js.map

package/layers/GitHubClientLive.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"GitHubClientLive.js","names":[],"sources":["../../../../src/layers/GitHubClientLive.ts"],"sourcesContent":["import { Effect, Layer, Schema } from \"effect\";\nimport { AuthenticationError } from \"../errors/AuthenticationError.js\";\nimport { NetworkError } from \"../errors/NetworkError.js\";\nimport { ParseError } from \"../errors/ParseError.js\";\nimport { RateLimitError } from \"../errors/RateLimitError.js\";\nimport { GitHubReleaseList, GitHubTagList } from \"../schemas/github.js\";\nimport type { ListOptions } from \"../services/GitHubClient.js\";\nimport { GitHubClient } from \"../services/GitHubClient.js\";\nimport { OctokitInstance } from \"../services/OctokitInstance.js\";\n\nconst mapOctokitError = (error: unknown, url: string): NetworkError | RateLimitError | AuthenticationError => {\n\tconst err = error as { status?: number; response?: { headers?: Record<string, string> } };\n\n\tif (err.status === 401) {\n\t\treturn new AuthenticationError({\n\t\t\tmethod: \"token\",\n\t\t\tmessage: `GitHub API authentication failed for ${url}`,\n\t\t});\n\t}\n\n\tif (err.status === 403 || err.status === 429) {\n\t\tconst headers = err.response?.headers ?? {};\n\t\tconst retryAfterStr = headers[\"retry-after\"];\n\t\treturn new RateLimitError({\n\t\t\t...(retryAfterStr ? { retryAfter: Number.parseInt(retryAfterStr, 10) } : {}),\n\t\t\tlimit: headers[\"x-ratelimit-limit\"] ? Number.parseInt(headers[\"x-ratelimit-limit\"], 10) : 0,\n\t\t\tremaining: headers[\"x-ratelimit-remaining\"] ? Number.parseInt(headers[\"x-ratelimit-remaining\"], 10) : 0,\n\t\t\tmessage: `GitHub API rate limit exceeded for ${url}`,\n\t\t});\n\t}\n\n\treturn new NetworkError({\n\t\turl,\n\t\t...(err.status !== undefined ? { status: err.status } : {}),\n\t\tmessage: error instanceof Error ? error.message : String(error),\n\t});\n};\n\nconst decodeTagList = Schema.decodeUnknown(GitHubTagList);\nconst decodeReleaseList = Schema.decodeUnknown(GitHubReleaseList);\n\n/**\n * Provides the {@link GitHubClient} service backed by an {@link OctokitInstance}.\n *\n * This layer wraps an Octokit instance and exposes a typed, Effect-native API\n * for listing GitHub releases, listing tags, and fetching arbitrary JSON from\n * URLs. HTTP errors are mapped to typed domain errors (`NetworkError`,\n * `RateLimitError`, `AuthenticationError`) so they can be handled precisely in\n * calling code.\n *\n * Pair this layer with one of the auth layers to form a complete GitHub\n * integration stack:\n * - {@link GitHubAutoAuth} — auto-detects auth from environment variables\n * - {@link GitHubTokenAuth} — authenticates using a personal access token\n * - {@link GitHubAppAuth} — authenticates as a GitHub App installation\n *\n * @see {@link GitHubClient}\n * @see {@link OctokitInstance}\n * @see {@link GitHubAutoAuth}\n * @public\n */\nexport const GitHubClientLive: Layer.Layer<GitHubClient, never, OctokitInstance> = Layer.effect(\n\tGitHubClient,\n\tEffect.gen(function* () {\n\t\tconst octokit = yield* OctokitInstance;\n\n\t\treturn {\n\t\t\tlistTags: (owner, repo, options?: ListOptions) =>\n\t\t\t\tEffect.gen(function* () {\n\t\t\t\t\tconst perPage = options?.perPage ?? 100;\n\t\t\t\t\tconst maxPages = options?.pages ?? Number.POSITIVE_INFINITY;\n\t\t\t\t\tconst allTags: Array<(typeof GitHubTagList.Type)[number]> = [];\n\n\t\t\t\t\tfor (let page = 1; page <= maxPages; page++) {\n\t\t\t\t\t\tconst response = yield* Effect.tryPromise({\n\t\t\t\t\t\t\ttry: () =>\n\t\t\t\t\t\t\t\toctokit.rest.repos.listTags({\n\t\t\t\t\t\t\t\t\towner,\n\t\t\t\t\t\t\t\t\trepo,\n\t\t\t\t\t\t\t\t\tper_page: perPage,\n\t\t\t\t\t\t\t\t\tpage,\n\t\t\t\t\t\t\t\t}),\n\t\t\t\t\t\t\tcatch: (error) => mapOctokitError(error, `repos/${owner}/${repo}/tags`),\n\t\t\t\t\t\t});\n\n\t\t\t\t\t\tconst tags = yield* decodeTagList(response.data).pipe(\n\t\t\t\t\t\t\tEffect.mapError(\n\t\t\t\t\t\t\t\t(e) =>\n\t\t\t\t\t\t\t\t\tnew ParseError({\n\t\t\t\t\t\t\t\t\t\tsource: `repos/${owner}/${repo}/tags`,\n\t\t\t\t\t\t\t\t\t\tmessage: `Schema validation failed: ${e.message}`,\n\t\t\t\t\t\t\t\t\t}),\n\t\t\t\t\t\t\t),\n\t\t\t\t\t\t);\n\n\t\t\t\t\t\tallTags.push(...tags);\n\n\t\t\t\t\t\tif (response.data.length < perPage) break;\n\t\t\t\t\t}\n\n\t\t\t\t\treturn allTags;\n\t\t\t\t}),\n\n\t\t\tlistReleases: (owner, repo, options?: ListOptions) =>\n\t\t\t\tEffect.gen(function* () {\n\t\t\t\t\tconst perPage = options?.perPage ?? 100;\n\t\t\t\t\tconst maxPages = options?.pages ?? Number.POSITIVE_INFINITY;\n\t\t\t\t\tconst allReleases: Array<(typeof GitHubReleaseList.Type)[number]> = [];\n\n\t\t\t\t\tfor (let page = 1; page <= maxPages; page++) {\n\t\t\t\t\t\tconst response = yield* Effect.tryPromise({\n\t\t\t\t\t\t\ttry: () =>\n\t\t\t\t\t\t\t\toctokit.rest.repos.listReleases({\n\t\t\t\t\t\t\t\t\towner,\n\t\t\t\t\t\t\t\t\trepo,\n\t\t\t\t\t\t\t\t\tper_page: perPage,\n\t\t\t\t\t\t\t\t\tpage,\n\t\t\t\t\t\t\t\t}),\n\t\t\t\t\t\t\tcatch: (error) => mapOctokitError(error, `repos/${owner}/${repo}/releases`),\n\t\t\t\t\t\t});\n\n\t\t\t\t\t\tconst releases = yield* decodeReleaseList(response.data).pipe(\n\t\t\t\t\t\t\tEffect.mapError(\n\t\t\t\t\t\t\t\t(e) =>\n\t\t\t\t\t\t\t\t\tnew ParseError({\n\t\t\t\t\t\t\t\t\t\tsource: `repos/${owner}/${repo}/releases`,\n\t\t\t\t\t\t\t\t\t\tmessage: `Schema validation failed: ${e.message}`,\n\t\t\t\t\t\t\t\t\t}),\n\t\t\t\t\t\t\t),\n\t\t\t\t\t\t);\n\n\t\t\t\t\t\tallReleases.push(...releases);\n\n\t\t\t\t\t\tif (response.data.length < perPage) break;\n\t\t\t\t\t}\n\n\t\t\t\t\treturn allReleases;\n\t\t\t\t}),\n\n\t\t\tgetJson: <A>(url: string, schema: { readonly decode: (input: unknown) => Effect.Effect<A, ParseError> }) =>\n\t\t\t\tEffect.gen(function* () {\n\t\t\t\t\tconst response = yield* Effect.tryPromise({\n\t\t\t\t\t\ttry: () => fetch(url),\n\t\t\t\t\t\tcatch: (error) =>\n\t\t\t\t\t\t\tnew NetworkError({\n\t\t\t\t\t\t\t\turl,\n\t\t\t\t\t\t\t\tmessage: error instanceof Error ? error.message : String(error),\n\t\t\t\t\t\t\t}),\n\t\t\t\t\t});\n\n\t\t\t\t\tif (!response.ok) {\n\t\t\t\t\t\tyield* Effect.fail(\n\t\t\t\t\t\t\tnew NetworkError({\n\t\t\t\t\t\t\t\turl,\n\t\t\t\t\t\t\t\tstatus: response.status,\n\t\t\t\t\t\t\t\tmessage: `HTTP ${response.status}: ${response.statusText}`,\n\t\t\t\t\t\t\t}),\n\t\t\t\t\t\t);\n\t\t\t\t\t}\n\n\t\t\t\t\tconst json = yield* Effect.tryPromise({\n\t\t\t\t\t\ttry: () => response.json(),\n\t\t\t\t\t\tcatch: () =>\n\t\t\t\t\t\t\tnew ParseError({\n\t\t\t\t\t\t\t\tsource: url,\n\t\t\t\t\t\t\t\tmessage: \"Failed to parse JSON response\",\n\t\t\t\t\t\t\t}),\n\t\t\t\t\t});\n\n\t\t\t\t\treturn yield* schema.decode(json);\n\t\t\t\t}),\n\t\t};\n\t}),\n);\n"],"mappings":"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"}

package/layers/GitHubTokenAuth.js

@@ -0,0 +1,51 @@
+import { OctokitInstance } from "../services/OctokitInstance.js";
+import { Effect, Layer } from "effect";
+import { Octokit } from "octokit";
+
+//#region src/layers/GitHubTokenAuth.ts
+const resolveToken = Effect.sync(() => process.env.GITHUB_PERSONAL_ACCESS_TOKEN || process.env.GITHUB_TOKEN || "");
+/**
+* Provides an {@link OctokitInstance} authenticated with a GitHub personal
+* access token read from the environment at layer construction time.
+*
+* The token is resolved by checking, in order:
+* 1. `GITHUB_PERSONAL_ACCESS_TOKEN` environment variable
+* 2. `GITHUB_TOKEN` environment variable
+*
+* If neither variable is set the layer constructs an unauthenticated Octokit
+* instance (lower rate limits apply). This layer never fails.
+*
+* Use {@link GitHubTokenAuthFromToken} when you have the token value available
+* programmatically at construction time.
+*
+* @see {@link OctokitInstance}
+* @see {@link GitHubTokenAuthFromToken}
+* @see {@link GitHubAutoAuth}
+* @see {@link GitHubAppAuth}
+* @public
+*/
+const GitHubTokenAuth = Layer.effect(OctokitInstance, Effect.gen(function* () {
+	const token = yield* resolveToken;
+	return new Octokit(token ? { auth: token } : {});
+}));
+/**
+* Provides an {@link OctokitInstance} authenticated with the given personal
+* access token string.
+*
+* Use this variant when the token is available as a value in your program
+* rather than read from an environment variable. The resulting layer never
+* fails.
+*
+* @param token - A GitHub personal access token string.
+*
+* @see {@link OctokitInstance}
+* @see {@link GitHubTokenAuth}
+* @see {@link GitHubAutoAuth}
+* @see {@link GitHubAppAuth}
+* @public
+*/
+const GitHubTokenAuthFromToken = (token) => Layer.succeed(OctokitInstance, new Octokit({ auth: token }));
+
+//#endregion
+export { GitHubTokenAuth, GitHubTokenAuthFromToken };
+//# sourceMappingURL=GitHubTokenAuth.js.map

package/layers/GitHubTokenAuth.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"GitHubTokenAuth.js","names":[],"sources":["../../../../src/layers/GitHubTokenAuth.ts"],"sourcesContent":["import { Effect, Layer } from \"effect\";\nimport { Octokit } from \"octokit\";\nimport { OctokitInstance } from \"../services/OctokitInstance.js\";\n\nconst resolveToken = Effect.sync(\n\t(): string => process.env.GITHUB_PERSONAL_ACCESS_TOKEN || process.env.GITHUB_TOKEN || \"\",\n);\n\n/**\n * Provides an {@link OctokitInstance} authenticated with a GitHub personal\n * access token read from the environment at layer construction time.\n *\n * The token is resolved by checking, in order:\n * 1. `GITHUB_PERSONAL_ACCESS_TOKEN` environment variable\n * 2. `GITHUB_TOKEN` environment variable\n *\n * If neither variable is set the layer constructs an unauthenticated Octokit\n * instance (lower rate limits apply). This layer never fails.\n *\n * Use {@link GitHubTokenAuthFromToken} when you have the token value available\n * programmatically at construction time.\n *\n * @see {@link OctokitInstance}\n * @see {@link GitHubTokenAuthFromToken}\n * @see {@link GitHubAutoAuth}\n * @see {@link GitHubAppAuth}\n * @public\n */\nexport const GitHubTokenAuth: Layer.Layer<OctokitInstance> = Layer.effect(\n\tOctokitInstance,\n\tEffect.gen(function* () {\n\t\tconst token = yield* resolveToken;\n\t\treturn new Octokit(token ? { auth: token } : {});\n\t}),\n);\n\n/**\n * Provides an {@link OctokitInstance} authenticated with the given personal\n * access token string.\n *\n * Use this variant when the token is available as a value in your program\n * rather than read from an environment variable. The resulting layer never\n * fails.\n *\n * @param token - A GitHub personal access token string.\n *\n * @see {@link OctokitInstance}\n * @see {@link GitHubTokenAuth}\n * @see {@link GitHubAutoAuth}\n * @see {@link GitHubAppAuth}\n * @public\n */\nexport const GitHubTokenAuthFromToken = (token: string): Layer.Layer<OctokitInstance> =>\n\tLayer.succeed(OctokitInstance, new Octokit({ auth: token }));\n"],"mappings":";;;;;AAIA,MAAM,eAAe,OAAO,WACb,QAAQ,IAAI,gCAAgC,QAAQ,IAAI,gBAAgB,EACvF;;;;;;;;;;;;;;;;;;;;;AAsBA,MAAa,kBAAgD,MAAM,OAClE,iBACA,OAAO,IAAI,aAAa;CACvB,MAAM,QAAQ,OAAO;CACrB,OAAO,IAAI,QAAQ,QAAQ,EAAE,MAAM,MAAM,IAAI,CAAC,CAAC;AAChD,CAAC,CACF;;;;;;;;;;;;;;;;;AAkBA,MAAa,4BAA4B,UACxC,MAAM,QAAQ,iBAAiB,IAAI,QAAQ,EAAE,MAAM,MAAM,CAAC,CAAC"}

package/layers/NodeReleaseCacheLive.js

@@ -0,0 +1,78 @@
+import { createRuntimeCache } from "./RuntimeCacheLive.js";
+import { NodeReleaseCache } from "../services/NodeReleaseCache.js";
+import { NodeRelease } from "../schemas/node-release.js";
+import { NodeSchedule } from "../schemas/node-schedule.js";
+import { Effect, Layer, Ref } from "effect";
+
+//#region src/layers/NodeReleaseCacheLive.ts
+/**
+* Low-level layer that constructs the {@link NodeReleaseCache} service backed by
+* a `SemVerVersionCache` instance from `semver-effect`.
+*
+* This layer is more complex than the Bun and Deno equivalents because it manages
+* additional LTS schedule state via an internal `Ref`. The schedule is stored
+* separately from the version list so that calling `updateSchedule` can
+* transparently rebuild all release objects with the latest phase information
+* without reloading data from the network.
+*
+* This layer wires up the cache storage but does not populate it with any
+* release data. Callers are responsible for calling `updateSchedule` and
+* `loadFromInputs` after construction. In normal usage you should prefer the
+* higher-level cache strategy layers instead of using this layer directly:
+* - {@link AutoNodeCacheLive} — API with fallback to bundled defaults
+* - {@link FreshNodeCacheLive} — API only, fails if unavailable
+* - {@link OfflineNodeCacheLive} — bundled defaults only
+*
+* @see {@link NodeReleaseCache}
+* @see {@link createRuntimeCache}
+* @internal
+*/
+const NodeReleaseCacheLive = Layer.effect(NodeReleaseCache, Effect.gen(function* () {
+	const scheduleRef = yield* Ref.make(NodeSchedule.fromData({}));
+	const inner = yield* createRuntimeCache();
+	let currentInputs = [];
+	const buildAndLoad = (inputs) => Effect.gen(function* () {
+		const releases = [];
+		for (const input of inputs) {
+			const release = yield* NodeRelease.fromInput(input, scheduleRef).pipe(Effect.catchAll(() => Effect.succeed(null)));
+			if (release) releases.push(release);
+		}
+		yield* inner.load(releases);
+	});
+	return {
+		load: (releases) => inner.load(releases),
+		resolve: (range) => inner.resolve(range),
+		releases: () => inner.releases(),
+		filter: (range) => inner.filter(range),
+		latest: () => inner.latest(),
+		latestByMajor: () => inner.latestByMajor(),
+		latestByMinor: () => inner.latestByMinor(),
+		updateSchedule: (data) => Effect.gen(function* () {
+			yield* Ref.set(scheduleRef, NodeSchedule.fromData(data));
+			if (currentInputs.length > 0) yield* buildAndLoad(currentInputs);
+		}),
+		loadFromInputs: (inputs) => Effect.gen(function* () {
+			currentInputs = inputs;
+			yield* buildAndLoad(inputs);
+		}),
+		ltsReleases: (now) => Effect.gen(function* () {
+			const all = yield* inner.releases();
+			const results = [];
+			for (const r of all) {
+				const phase = yield* r.phase(now);
+				if (phase === "active-lts" || phase === "maintenance-lts") results.push(r);
+			}
+			return results;
+		}),
+		currentReleases: (now) => Effect.gen(function* () {
+			const all = yield* inner.releases();
+			const results = [];
+			for (const r of all) if ((yield* r.phase(now)) === "current") results.push(r);
+			return results;
+		})
+	};
+}));
+
+//#endregion
+export { NodeReleaseCacheLive };
+//# sourceMappingURL=NodeReleaseCacheLive.js.map

package/layers/NodeReleaseCacheLive.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"NodeReleaseCacheLive.js","names":[],"sources":["../../../../src/layers/NodeReleaseCacheLive.ts"],"sourcesContent":["import type { DateTime } from \"effect\";\nimport { Effect, Layer, Ref } from \"effect\";\nimport type { VersionCache as SemVerVersionCache } from \"semver-effect\";\nimport type { NodeReleaseInput } from \"../schemas/node-release.js\";\nimport { NodeRelease } from \"../schemas/node-release.js\";\nimport type { NodeScheduleData } from \"../schemas/node-schedule.js\";\nimport { NodeSchedule } from \"../schemas/node-schedule.js\";\nimport { NodeReleaseCache } from \"../services/NodeReleaseCache.js\";\nimport { createRuntimeCache } from \"./RuntimeCacheLive.js\";\n\n/**\n * Low-level layer that constructs the {@link NodeReleaseCache} service backed by\n * a `SemVerVersionCache` instance from `semver-effect`.\n *\n * This layer is more complex than the Bun and Deno equivalents because it manages\n * additional LTS schedule state via an internal `Ref`. The schedule is stored\n * separately from the version list so that calling `updateSchedule` can\n * transparently rebuild all release objects with the latest phase information\n * without reloading data from the network.\n *\n * This layer wires up the cache storage but does not populate it with any\n * release data. Callers are responsible for calling `updateSchedule` and\n * `loadFromInputs` after construction. In normal usage you should prefer the\n * higher-level cache strategy layers instead of using this layer directly:\n * - {@link AutoNodeCacheLive} — API with fallback to bundled defaults\n * - {@link FreshNodeCacheLive} — API only, fails if unavailable\n * - {@link OfflineNodeCacheLive} — bundled defaults only\n *\n * @see {@link NodeReleaseCache}\n * @see {@link createRuntimeCache}\n * @internal\n */\nexport const NodeReleaseCacheLive: Layer.Layer<NodeReleaseCache, never, SemVerVersionCache> = Layer.effect(\n\tNodeReleaseCache,\n\tEffect.gen(function* () {\n\t\tconst scheduleRef = yield* Ref.make(NodeSchedule.fromData({}));\n\t\tconst inner = yield* createRuntimeCache<NodeRelease>();\n\n\t\t// Held separately so we can rebuild releases when schedule updates\n\t\tlet currentInputs: ReadonlyArray<NodeReleaseInput> = [];\n\n\t\tconst buildAndLoad = (inputs: ReadonlyArray<NodeReleaseInput>) =>\n\t\t\tEffect.gen(function* () {\n\t\t\t\tconst releases: NodeRelease[] = [];\n\t\t\t\tfor (const input of inputs) {\n\t\t\t\t\tconst release = yield* NodeRelease.fromInput(input, scheduleRef).pipe(\n\t\t\t\t\t\tEffect.catchAll(() => Effect.succeed(null)),\n\t\t\t\t\t);\n\t\t\t\t\tif (release) releases.push(release);\n\t\t\t\t}\n\t\t\t\tyield* inner.load(releases);\n\t\t\t});\n\n\t\treturn {\n\t\t\t// -- RuntimeCache<NodeRelease> delegation --\n\t\t\tload: (releases) => inner.load(releases),\n\t\t\tresolve: (range) => inner.resolve(range),\n\t\t\treleases: () => inner.releases(),\n\t\t\tfilter: (range) => inner.filter(range),\n\t\t\tlatest: () => inner.latest(),\n\t\t\tlatestByMajor: () => inner.latestByMajor(),\n\t\t\tlatestByMinor: () => inner.latestByMinor(),\n\n\t\t\t// -- Node-specific --\n\t\t\tupdateSchedule: (data: NodeScheduleData) =>\n\t\t\t\tEffect.gen(function* () {\n\t\t\t\t\tyield* Ref.set(scheduleRef, NodeSchedule.fromData(data));\n\t\t\t\t\t// Rebuild releases if we have stored inputs\n\t\t\t\t\tif (currentInputs.length > 0) {\n\t\t\t\t\t\tyield* buildAndLoad(currentInputs);\n\t\t\t\t\t}\n\t\t\t\t}),\n\n\t\t\tloadFromInputs: (inputs: ReadonlyArray<NodeReleaseInput>) =>\n\t\t\t\tEffect.gen(function* () {\n\t\t\t\t\tcurrentInputs = inputs;\n\t\t\t\t\tyield* buildAndLoad(inputs);\n\t\t\t\t}),\n\n\t\t\tltsReleases: (now?: DateTime.DateTime) =>\n\t\t\t\tEffect.gen(function* () {\n\t\t\t\t\tconst all = yield* inner.releases();\n\t\t\t\t\tconst results: NodeRelease[] = [];\n\t\t\t\t\tfor (const r of all) {\n\t\t\t\t\t\tconst phase = yield* r.phase(now);\n\t\t\t\t\t\tif (phase === \"active-lts\" || phase === \"maintenance-lts\") {\n\t\t\t\t\t\t\tresults.push(r);\n\t\t\t\t\t\t}\n\t\t\t\t\t}\n\t\t\t\t\treturn results;\n\t\t\t\t}),\n\n\t\t\tcurrentReleases: (now?: DateTime.DateTime) =>\n\t\t\t\tEffect.gen(function* () {\n\t\t\t\t\tconst all = yield* inner.releases();\n\t\t\t\t\tconst results: NodeRelease[] = [];\n\t\t\t\t\tfor (const r of all) {\n\t\t\t\t\t\tconst phase = yield* r.phase(now);\n\t\t\t\t\t\tif (phase === \"current\") {\n\t\t\t\t\t\t\tresults.push(r);\n\t\t\t\t\t\t}\n\t\t\t\t\t}\n\t\t\t\t\treturn results;\n\t\t\t\t}),\n\t\t};\n\t}),\n);\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAgCA,MAAa,uBAAiF,MAAM,OACnG,kBACA,OAAO,IAAI,aAAa;CACvB,MAAM,cAAc,OAAO,IAAI,KAAK,aAAa,SAAS,CAAC,CAAC,CAAC;CAC7D,MAAM,QAAQ,OAAO,mBAAgC;CAGrD,IAAI,gBAAiD,CAAC;CAEtD,MAAM,gBAAgB,WACrB,OAAO,IAAI,aAAa;EACvB,MAAM,WAA0B,CAAC;EACjC,KAAK,MAAM,SAAS,QAAQ;GAC3B,MAAM,UAAU,OAAO,YAAY,UAAU,OAAO,WAAW,CAAC,CAAC,KAChE,OAAO,eAAe,OAAO,QAAQ,IAAI,CAAC,CAC3C;GACA,IAAI,SAAS,SAAS,KAAK,OAAO;EACnC;EACA,OAAO,MAAM,KAAK,QAAQ;CAC3B,CAAC;CAEF,OAAO;EAEN,OAAO,aAAa,MAAM,KAAK,QAAQ;EACvC,UAAU,UAAU,MAAM,QAAQ,KAAK;EACvC,gBAAgB,MAAM,SAAS;EAC/B,SAAS,UAAU,MAAM,OAAO,KAAK;EACrC,cAAc,MAAM,OAAO;EAC3B,qBAAqB,MAAM,cAAc;EACzC,qBAAqB,MAAM,cAAc;EAGzC,iBAAiB,SAChB,OAAO,IAAI,aAAa;GACvB,OAAO,IAAI,IAAI,aAAa,aAAa,SAAS,IAAI,CAAC;GAEvD,IAAI,cAAc,SAAS,GAC1B,OAAO,aAAa,aAAa;EAEnC,CAAC;EAEF,iBAAiB,WAChB,OAAO,IAAI,aAAa;GACvB,gBAAgB;GAChB,OAAO,aAAa,MAAM;EAC3B,CAAC;EAEF,cAAc,QACb,OAAO,IAAI,aAAa;GACvB,MAAM,MAAM,OAAO,MAAM,SAAS;GAClC,MAAM,UAAyB,CAAC;GAChC,KAAK,MAAM,KAAK,KAAK;IACpB,MAAM,QAAQ,OAAO,EAAE,MAAM,GAAG;IAChC,IAAI,UAAU,gBAAgB,UAAU,mBACvC,QAAQ,KAAK,CAAC;GAEhB;GACA,OAAO;EACR,CAAC;EAEF,kBAAkB,QACjB,OAAO,IAAI,aAAa;GACvB,MAAM,MAAM,OAAO,MAAM,SAAS;GAClC,MAAM,UAAyB,CAAC;GAChC,KAAK,MAAM,KAAK,KAEf,KAAI,OADiB,EAAE,MAAM,GAAG,OAClB,WACb,QAAQ,KAAK,CAAC;GAGhB,OAAO;EACR,CAAC;CACH;AACD,CAAC,CACF"}

package/layers/NodeResolverLive.js

@@ -0,0 +1,108 @@
+import { NodeReleaseCache } from "../services/NodeReleaseCache.js";
+import { VersionNotFoundError } from "../errors/VersionNotFoundError.js";
+import { NodeResolver } from "../services/NodeResolver.js";
+import { DateTime, Effect, Layer } from "effect";
+import { SemVer } from "semver-effect";
+
+//#region src/layers/NodeResolverLive.ts
+/**
+* Provides the {@link NodeResolver} service backed by a {@link NodeReleaseCache}.
+*
+* This layer composes with any of the three Node cache strategy layers to form
+* a complete resolver stack. In addition to semver range filtering and increment
+* grouping, it supports filtering by Node.js release phase (e.g., `"current"`,
+* `"active-lts"`, `"maintenance-lts"`, `"end-of-life"`) and automatically
+* determines the current LTS version from the loaded schedule data.
+*
+* @example
+* ```ts
+* import {
+*   NodeResolverLive, AutoNodeCacheLive,
+*   NodeVersionFetcherLive, NodeScheduleFetcherLive,
+*   GitHubClientLive, GitHubAutoAuth,
+* } from "runtime-resolver";
+* import { NodeResolver } from "runtime-resolver";
+* import { Effect, Layer } from "effect";
+*
+* const GitHubLayer = GitHubClientLive.pipe(Layer.provide(GitHubAutoAuth));
+* const FetchersLayer = Layer.merge(
+*   NodeVersionFetcherLive.pipe(Layer.provide(GitHubLayer)),
+*   NodeScheduleFetcherLive.pipe(Layer.provide(GitHubLayer)),
+* );
+* const CacheLayer = AutoNodeCacheLive.pipe(Layer.provide(FetchersLayer));
+* const ResolverLayer = NodeResolverLive.pipe(Layer.provide(CacheLayer));
+*
+* const program = Effect.gen(function* () {
+*   const resolver = yield* NodeResolver;
+*   // Resolve only active-LTS and maintenance-LTS releases in the ^20 range
+*   const result = yield* resolver.resolve({
+*     semverRange: "^20.0.0",
+*     phases: ["active-lts", "maintenance-lts"],
+*   });
+*   console.log(result.lts);
+* });
+*
+* Effect.runPromise(program.pipe(Effect.provide(ResolverLayer)));
+* ```
+*
+* @see {@link NodeResolver}
+* @see {@link NodeReleaseCache}
+* @see {@link AutoNodeCacheLive}
+* @see {@link FreshNodeCacheLive}
+* @see {@link OfflineNodeCacheLive}
+* @public
+*/
+const NodeResolverLive = Layer.effect(NodeResolver, Effect.gen(function* () {
+	const cache = yield* NodeReleaseCache;
+	return { resolve: (options) => Effect.gen(function* () {
+		const semverRange = options?.semverRange ?? "*";
+		const phases = options?.phases ?? ["current", "active-lts"];
+		const increments = options?.increments ?? "latest";
+		const now = options?.date ? DateTime.unsafeMake(options.date) : DateTime.unsafeMake(/* @__PURE__ */ new Date());
+		const matching = yield* cache.filter(semverRange).pipe(Effect.catchAll(() => Effect.succeed([])));
+		const phaseFiltered = [];
+		for (const r of matching) {
+			const phase = yield* r.phase(now);
+			if (phase && phases.includes(phase)) phaseFiltered.push(r);
+		}
+		let resultReleases;
+		if (increments === "latest") {
+			const groups = /* @__PURE__ */ new Map();
+			for (const r of phaseFiltered) {
+				const existing = groups.get(r.version.major);
+				if (!existing || SemVer.gt(r.version, existing.version)) groups.set(r.version.major, r);
+			}
+			resultReleases = [...groups.values()];
+		} else if (increments === "minor") {
+			const groups = /* @__PURE__ */ new Map();
+			for (const r of phaseFiltered) {
+				const key = `${r.version.major}.${r.version.minor}`;
+				const existing = groups.get(key);
+				if (!existing || SemVer.gt(r.version, existing.version)) groups.set(key, r);
+			}
+			resultReleases = [...groups.values()];
+		} else resultReleases = phaseFiltered;
+		if (resultReleases.length === 0) return yield* Effect.fail(new VersionNotFoundError({
+			runtime: "node",
+			constraint: semverRange,
+			message: `No Node.js versions found matching "${semverRange}" with phases [${phases.join(", ")}]`
+		}));
+		const versions = SemVer.rsort(resultReleases.map((r) => r.version)).map((v) => resultReleases.find((r) => SemVer.equal(r.version, v))).filter((r) => r !== void 0).map((r) => r.version.toString());
+		const latest = versions[0];
+		const ltsVersions = (yield* cache.ltsReleases(now)).filter((r) => versions.includes(r.version.toString())).map((r) => r.version);
+		const lts = ltsVersions.length > 0 ? SemVer.rsort(ltsVersions)[0].toString() : void 0;
+		let resolvedDefault;
+		if (options?.defaultVersion) resolvedDefault = yield* cache.resolve(options.defaultVersion).pipe(Effect.map((r) => r.version.toString()), Effect.catchAll(() => Effect.succeed(void 0)));
+		return {
+			source: "api",
+			versions,
+			latest,
+			...lts ? { lts } : {},
+			...resolvedDefault ? { default: resolvedDefault } : { ...lts ? { default: lts } : {} }
+		};
+	}) };
+}));
+
+//#endregion
+export { NodeResolverLive };
+//# sourceMappingURL=NodeResolverLive.js.map

package/layers/NodeResolverLive.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"NodeResolverLive.js","names":[],"sources":["../../../../src/layers/NodeResolverLive.ts"],"sourcesContent":["import { DateTime, Effect, Layer } from \"effect\";\nimport { SemVer } from \"semver-effect\";\nimport { VersionNotFoundError } from \"../errors/VersionNotFoundError.js\";\nimport type { Increments, NodePhase } from \"../schemas/common.js\";\nimport type { NodeRelease } from \"../schemas/node-release.js\";\nimport { NodeReleaseCache } from \"../services/NodeReleaseCache.js\";\nimport type { NodeResolverOptions } from \"../services/NodeResolver.js\";\nimport { NodeResolver } from \"../services/NodeResolver.js\";\n\n/**\n * Provides the {@link NodeResolver} service backed by a {@link NodeReleaseCache}.\n *\n * This layer composes with any of the three Node cache strategy layers to form\n * a complete resolver stack. In addition to semver range filtering and increment\n * grouping, it supports filtering by Node.js release phase (e.g., `\"current\"`,\n * `\"active-lts\"`, `\"maintenance-lts\"`, `\"end-of-life\"`) and automatically\n * determines the current LTS version from the loaded schedule data.\n *\n * @example\n * ```ts\n * import {\n *   NodeResolverLive, AutoNodeCacheLive,\n *   NodeVersionFetcherLive, NodeScheduleFetcherLive,\n *   GitHubClientLive, GitHubAutoAuth,\n * } from \"runtime-resolver\";\n * import { NodeResolver } from \"runtime-resolver\";\n * import { Effect, Layer } from \"effect\";\n *\n * const GitHubLayer = GitHubClientLive.pipe(Layer.provide(GitHubAutoAuth));\n * const FetchersLayer = Layer.merge(\n *   NodeVersionFetcherLive.pipe(Layer.provide(GitHubLayer)),\n *   NodeScheduleFetcherLive.pipe(Layer.provide(GitHubLayer)),\n * );\n * const CacheLayer = AutoNodeCacheLive.pipe(Layer.provide(FetchersLayer));\n * const ResolverLayer = NodeResolverLive.pipe(Layer.provide(CacheLayer));\n *\n * const program = Effect.gen(function* () {\n *   const resolver = yield* NodeResolver;\n *   // Resolve only active-LTS and maintenance-LTS releases in the ^20 range\n *   const result = yield* resolver.resolve({\n *     semverRange: \"^20.0.0\",\n *     phases: [\"active-lts\", \"maintenance-lts\"],\n *   });\n *   console.log(result.lts);\n * });\n *\n * Effect.runPromise(program.pipe(Effect.provide(ResolverLayer)));\n * ```\n *\n * @see {@link NodeResolver}\n * @see {@link NodeReleaseCache}\n * @see {@link AutoNodeCacheLive}\n * @see {@link FreshNodeCacheLive}\n * @see {@link OfflineNodeCacheLive}\n * @public\n */\nexport const NodeResolverLive: Layer.Layer<NodeResolver, never, NodeReleaseCache> = Layer.effect(\n\tNodeResolver,\n\tEffect.gen(function* () {\n\t\tconst cache = yield* NodeReleaseCache;\n\n\t\treturn {\n\t\t\tresolve: (options?: NodeResolverOptions) =>\n\t\t\t\tEffect.gen(function* () {\n\t\t\t\t\tconst semverRange = options?.semverRange ?? \"*\";\n\t\t\t\t\tconst phases: ReadonlyArray<NodePhase> = options?.phases ?? [\"current\", \"active-lts\"];\n\t\t\t\t\tconst increments: Increments = options?.increments ?? \"latest\";\n\t\t\t\t\tconst now = options?.date ? DateTime.unsafeMake(options.date) : DateTime.unsafeMake(new Date());\n\n\t\t\t\t\t// Get all releases matching range\n\t\t\t\t\tconst matching = yield* cache\n\t\t\t\t\t\t.filter(semverRange)\n\t\t\t\t\t\t.pipe(Effect.catchAll(() => Effect.succeed([] as ReadonlyArray<NodeRelease>)));\n\n\t\t\t\t\t// Filter by phase\n\t\t\t\t\tconst phaseFiltered: NodeRelease[] = [];\n\t\t\t\t\tfor (const r of matching) {\n\t\t\t\t\t\tconst phase = yield* r.phase(now);\n\t\t\t\t\t\tif (phase && phases.includes(phase)) {\n\t\t\t\t\t\t\tphaseFiltered.push(r);\n\t\t\t\t\t\t}\n\t\t\t\t\t}\n\n\t\t\t\t\t// Apply increments\n\t\t\t\t\tlet resultReleases: NodeRelease[];\n\t\t\t\t\tif (increments === \"latest\") {\n\t\t\t\t\t\tconst groups = new Map<number, NodeRelease>();\n\t\t\t\t\t\tfor (const r of phaseFiltered) {\n\t\t\t\t\t\t\tconst existing = groups.get(r.version.major);\n\t\t\t\t\t\t\tif (!existing || SemVer.gt(r.version, existing.version)) {\n\t\t\t\t\t\t\t\tgroups.set(r.version.major, r);\n\t\t\t\t\t\t\t}\n\t\t\t\t\t\t}\n\t\t\t\t\t\tresultReleases = [...groups.values()];\n\t\t\t\t\t} else if (increments === \"minor\") {\n\t\t\t\t\t\tconst groups = new Map<string, NodeRelease>();\n\t\t\t\t\t\tfor (const r of phaseFiltered) {\n\t\t\t\t\t\t\tconst key = `${r.version.major}.${r.version.minor}`;\n\t\t\t\t\t\t\tconst existing = groups.get(key);\n\t\t\t\t\t\t\tif (!existing || SemVer.gt(r.version, existing.version)) {\n\t\t\t\t\t\t\t\tgroups.set(key, r);\n\t\t\t\t\t\t\t}\n\t\t\t\t\t\t}\n\t\t\t\t\t\tresultReleases = [...groups.values()];\n\t\t\t\t\t} else {\n\t\t\t\t\t\tresultReleases = phaseFiltered;\n\t\t\t\t\t}\n\n\t\t\t\t\tif (resultReleases.length === 0) {\n\t\t\t\t\t\treturn yield* Effect.fail(\n\t\t\t\t\t\t\tnew VersionNotFoundError({\n\t\t\t\t\t\t\t\truntime: \"node\",\n\t\t\t\t\t\t\t\tconstraint: semverRange,\n\t\t\t\t\t\t\t\tmessage: `No Node.js versions found matching \"${semverRange}\" with phases [${phases.join(\", \")}]`,\n\t\t\t\t\t\t\t}),\n\t\t\t\t\t\t);\n\t\t\t\t\t}\n\n\t\t\t\t\t// Sort descending\n\t\t\t\t\tconst sorted = SemVer.rsort(resultReleases.map((r) => r.version));\n\t\t\t\t\tconst sortedReleases = sorted\n\t\t\t\t\t\t.map((v) => resultReleases.find((r) => SemVer.equal(r.version, v)))\n\t\t\t\t\t\t.filter((r): r is NodeRelease => r !== undefined);\n\n\t\t\t\t\tconst versions = sortedReleases.map((r) => r.version.toString());\n\t\t\t\t\tconst latest = versions[0];\n\n\t\t\t\t\t// Determine LTS\n\t\t\t\t\tconst ltsReleases = yield* cache.ltsReleases(now);\n\t\t\t\t\tconst ltsVersions = ltsReleases.filter((r) => versions.includes(r.version.toString())).map((r) => r.version);\n\t\t\t\t\tconst lts = ltsVersions.length > 0 ? SemVer.rsort(ltsVersions)[0].toString() : undefined;\n\n\t\t\t\t\t// Handle default version\n\t\t\t\t\tlet resolvedDefault: string | undefined;\n\t\t\t\t\tif (options?.defaultVersion) {\n\t\t\t\t\t\tresolvedDefault = yield* cache.resolve(options.defaultVersion).pipe(\n\t\t\t\t\t\t\tEffect.map((r) => r.version.toString()),\n\t\t\t\t\t\t\tEffect.catchAll(() => Effect.succeed(undefined)),\n\t\t\t\t\t\t);\n\t\t\t\t\t}\n\n\t\t\t\t\treturn {\n\t\t\t\t\t\tsource: \"api\" as const,\n\t\t\t\t\t\tversions,\n\t\t\t\t\t\tlatest,\n\t\t\t\t\t\t...(lts ? { lts } : {}),\n\t\t\t\t\t\t...(resolvedDefault ? { default: resolvedDefault } : { ...(lts ? { default: lts } : {}) }),\n\t\t\t\t\t};\n\t\t\t\t}),\n\t\t};\n\t}),\n);\n"],"mappings":"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"}

package/layers/NodeScheduleFetcherLive.js

@@ -0,0 +1,38 @@
+import { NodeScheduleFetcher } from "../services/NodeScheduleFetcher.js";
+import { GitHubClient } from "../services/GitHubClient.js";
+import { ParseError } from "../errors/ParseError.js";
+import { NodeReleaseSchedule } from "../schemas/node.js";
+import { Effect, Layer, Schema } from "effect";
+
+//#region src/layers/NodeScheduleFetcherLive.ts
+const NODE_SCHEDULE_URL = "https://raw.githubusercontent.com/nodejs/Release/refs/heads/main/schedule.json";
+const decodeSchedule = (input) => Schema.decodeUnknown(NodeReleaseSchedule)(input).pipe(Effect.mapError((e) => new ParseError({
+	source: NODE_SCHEDULE_URL,
+	message: `Schema validation failed: ${e.message}`
+})), Effect.map((data) => data));
+/**
+* Provides the {@link NodeScheduleFetcher} service using the live Node.js release schedule.
+*
+* Fetches the Node.js release schedule from the raw GitHub content URL for
+* `nodejs/Release` (`schedule.json` on the `main` branch) using the HTTP client
+* on the provided {@link GitHubClient} service. The schedule data maps major
+* version codenames to their start, LTS, and end-of-life dates and is used by
+* {@link NodeReleaseCache} to compute per-release lifecycle phases.
+*
+* This layer is a required dependency of {@link AutoNodeCacheLive} and
+* {@link FreshNodeCacheLive}. It is not needed by {@link OfflineNodeCacheLive}.
+*
+* @see {@link NodeScheduleFetcher}
+* @see {@link GitHubClient}
+* @see {@link AutoNodeCacheLive}
+* @see {@link FreshNodeCacheLive}
+* @public
+*/
+const NodeScheduleFetcherLive = Layer.effect(NodeScheduleFetcher, Effect.gen(function* () {
+	const client = yield* GitHubClient;
+	return { fetch: () => client.getJson(NODE_SCHEDULE_URL, { decode: decodeSchedule }) };
+}));
+
+//#endregion
+export { NodeScheduleFetcherLive };
+//# sourceMappingURL=NodeScheduleFetcherLive.js.map

package/layers/NodeScheduleFetcherLive.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"NodeScheduleFetcherLive.js","names":[],"sources":["../../../../src/layers/NodeScheduleFetcherLive.ts"],"sourcesContent":["import { Effect, Layer, Schema } from \"effect\";\nimport { ParseError } from \"../errors/ParseError.js\";\nimport { NodeReleaseSchedule } from \"../schemas/node.js\";\nimport type { NodeScheduleData } from \"../schemas/node-schedule.js\";\nimport { GitHubClient } from \"../services/GitHubClient.js\";\nimport { NodeScheduleFetcher } from \"../services/NodeScheduleFetcher.js\";\n\nconst NODE_SCHEDULE_URL = \"https://raw.githubusercontent.com/nodejs/Release/refs/heads/main/schedule.json\";\n\nconst decodeSchedule = (input: unknown): Effect.Effect<NodeScheduleData, ParseError> =>\n\tSchema.decodeUnknown(NodeReleaseSchedule)(input).pipe(\n\t\tEffect.mapError(\n\t\t\t(e) =>\n\t\t\t\tnew ParseError({\n\t\t\t\t\tsource: NODE_SCHEDULE_URL,\n\t\t\t\t\tmessage: `Schema validation failed: ${e.message}`,\n\t\t\t\t}),\n\t\t),\n\t\tEffect.map((data) => data as NodeScheduleData),\n\t);\n\n/**\n * Provides the {@link NodeScheduleFetcher} service using the live Node.js release schedule.\n *\n * Fetches the Node.js release schedule from the raw GitHub content URL for\n * `nodejs/Release` (`schedule.json` on the `main` branch) using the HTTP client\n * on the provided {@link GitHubClient} service. The schedule data maps major\n * version codenames to their start, LTS, and end-of-life dates and is used by\n * {@link NodeReleaseCache} to compute per-release lifecycle phases.\n *\n * This layer is a required dependency of {@link AutoNodeCacheLive} and\n * {@link FreshNodeCacheLive}. It is not needed by {@link OfflineNodeCacheLive}.\n *\n * @see {@link NodeScheduleFetcher}\n * @see {@link GitHubClient}\n * @see {@link AutoNodeCacheLive}\n * @see {@link FreshNodeCacheLive}\n * @public\n */\nexport const NodeScheduleFetcherLive: Layer.Layer<NodeScheduleFetcher, never, GitHubClient> = Layer.effect(\n\tNodeScheduleFetcher,\n\tEffect.gen(function* () {\n\t\tconst client = yield* GitHubClient;\n\t\treturn {\n\t\t\tfetch: () => client.getJson(NODE_SCHEDULE_URL, { decode: decodeSchedule }),\n\t\t};\n\t}),\n);\n"],"mappings":";;;;;;;AAOA,MAAM,oBAAoB;AAE1B,MAAM,kBAAkB,UACvB,OAAO,cAAc,mBAAmB,CAAC,CAAC,KAAK,CAAC,CAAC,KAChD,OAAO,UACL,MACA,IAAI,WAAW;CACd,QAAQ;CACR,SAAS,6BAA6B,EAAE;AACzC,CAAC,CACH,GACA,OAAO,KAAK,SAAS,IAAwB,CAC9C;;;;;;;;;;;;;;;;;;;AAoBD,MAAa,0BAAiF,MAAM,OACnG,qBACA,OAAO,IAAI,aAAa;CACvB,MAAM,SAAS,OAAO;CACtB,OAAO,EACN,aAAa,OAAO,QAAQ,mBAAmB,EAAE,QAAQ,eAAe,CAAC,EAC1E;AACD,CAAC,CACF"}

package/layers/NodeVersionFetcherLive.js

@@ -0,0 +1,56 @@
+import { NodeVersionFetcher } from "../services/NodeVersionFetcher.js";
+import { tryParseSemVer } from "../lib/semver.js";
+import { GitHubClient } from "../services/GitHubClient.js";
+import { ParseError } from "../errors/ParseError.js";
+import { NodeDistIndex } from "../schemas/node.js";
+import { Effect, Layer, Option, Schema } from "effect";
+
+//#region src/layers/NodeVersionFetcherLive.ts
+const NODE_DIST_URL = "https://nodejs.org/dist/index.json";
+const decodeDistIndex = (input) => Schema.decodeUnknown(NodeDistIndex)(input).pipe(Effect.mapError((e) => new ParseError({
+	source: NODE_DIST_URL,
+	message: `Schema validation failed: ${e.message}`
+})));
+/**
+* Provides the {@link NodeVersionFetcher} service using the live Node.js dist index.
+*
+* Fetches the full Node.js version list from `https://nodejs.org/dist/index.json`
+* using the HTTP client on the provided {@link GitHubClient} service. Version
+* strings are normalized by stripping the leading `v` before parsing as semver.
+* Entries with non-string `npm` fields (present in very old releases prior to
+* v0.6.3) are substituted with the sentinel version `"0.0.0"`.
+*
+* This layer is a required dependency of {@link AutoNodeCacheLive} and
+* {@link FreshNodeCacheLive}. It is not needed by {@link OfflineNodeCacheLive}.
+*
+* @see {@link NodeVersionFetcher}
+* @see {@link GitHubClient}
+* @see {@link AutoNodeCacheLive}
+* @see {@link FreshNodeCacheLive}
+* @public
+*/
+const NodeVersionFetcherLive = Layer.effect(NodeVersionFetcher, Effect.gen(function* () {
+	const client = yield* GitHubClient;
+	return { fetch: () => Effect.gen(function* () {
+		const allVersions = yield* client.getJson(NODE_DIST_URL, { decode: decodeDistIndex });
+		const parsed = yield* Effect.forEach(allVersions, (entry) => {
+			const clean = entry.version.replace(/^v/, "");
+			return tryParseSemVer(clean).pipe(Effect.map((opt) => Option.isSome(opt) ? Option.some({
+				version: opt.value,
+				input: {
+					version: clean,
+					npm: typeof entry.npm === "string" ? entry.npm : "0.0.0",
+					date: entry.date
+				}
+			}) : Option.none()));
+		}, { concurrency: "unbounded" });
+		return {
+			versions: parsed.flatMap(Option.toArray).map(({ version }) => version),
+			inputs: parsed.flatMap(Option.toArray).map(({ input }) => input)
+		};
+	}) };
+}));
+
+//#endregion
+export { NodeVersionFetcherLive };
+//# sourceMappingURL=NodeVersionFetcherLive.js.map

package/layers/NodeVersionFetcherLive.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"NodeVersionFetcherLive.js","names":[],"sources":["../../../../src/layers/NodeVersionFetcherLive.ts"],"sourcesContent":["import { Effect, Layer, Option, Schema } from \"effect\";\nimport { ParseError } from \"../errors/ParseError.js\";\nimport { tryParseSemVer } from \"../lib/semver.js\";\nimport { NodeDistIndex } from \"../schemas/node.js\";\nimport type { NodeReleaseInput } from \"../schemas/node-release.js\";\nimport { GitHubClient } from \"../services/GitHubClient.js\";\nimport { NodeVersionFetcher } from \"../services/NodeVersionFetcher.js\";\n\nconst NODE_DIST_URL = \"https://nodejs.org/dist/index.json\";\n\nconst decodeDistIndex = (input: unknown) =>\n\tSchema.decodeUnknown(NodeDistIndex)(input).pipe(\n\t\tEffect.mapError(\n\t\t\t(e) =>\n\t\t\t\tnew ParseError({\n\t\t\t\t\tsource: NODE_DIST_URL,\n\t\t\t\t\tmessage: `Schema validation failed: ${e.message}`,\n\t\t\t\t}),\n\t\t),\n\t);\n\n/**\n * Provides the {@link NodeVersionFetcher} service using the live Node.js dist index.\n *\n * Fetches the full Node.js version list from `https://nodejs.org/dist/index.json`\n * using the HTTP client on the provided {@link GitHubClient} service. Version\n * strings are normalized by stripping the leading `v` before parsing as semver.\n * Entries with non-string `npm` fields (present in very old releases prior to\n * v0.6.3) are substituted with the sentinel version `\"0.0.0\"`.\n *\n * This layer is a required dependency of {@link AutoNodeCacheLive} and\n * {@link FreshNodeCacheLive}. It is not needed by {@link OfflineNodeCacheLive}.\n *\n * @see {@link NodeVersionFetcher}\n * @see {@link GitHubClient}\n * @see {@link AutoNodeCacheLive}\n * @see {@link FreshNodeCacheLive}\n * @public\n */\nexport const NodeVersionFetcherLive: Layer.Layer<NodeVersionFetcher, never, GitHubClient> = Layer.effect(\n\tNodeVersionFetcher,\n\tEffect.gen(function* () {\n\t\tconst client = yield* GitHubClient;\n\n\t\treturn {\n\t\t\tfetch: () =>\n\t\t\t\tEffect.gen(function* () {\n\t\t\t\t\tconst allVersions = yield* client.getJson(NODE_DIST_URL, {\n\t\t\t\t\t\tdecode: decodeDistIndex,\n\t\t\t\t\t});\n\n\t\t\t\t\tconst parsed = yield* Effect.forEach(\n\t\t\t\t\t\tallVersions,\n\t\t\t\t\t\t(entry) => {\n\t\t\t\t\t\t\tconst clean = entry.version.replace(/^v/, \"\");\n\t\t\t\t\t\t\treturn tryParseSemVer(clean).pipe(\n\t\t\t\t\t\t\t\tEffect.map((opt) =>\n\t\t\t\t\t\t\t\t\tOption.isSome(opt)\n\t\t\t\t\t\t\t\t\t\t? Option.some({\n\t\t\t\t\t\t\t\t\t\t\t\tversion: opt.value,\n\t\t\t\t\t\t\t\t\t\t\t\tinput: {\n\t\t\t\t\t\t\t\t\t\t\t\t\tversion: clean,\n\t\t\t\t\t\t\t\t\t\t\t\t\t// Older entries (pre-v0.6.3) carry npm:false. Use \"0.0.0\" as a sentinel\n\t\t\t\t\t\t\t\t\t\t\t\t\t// since npm version is only informational and never used in comparisons.\n\t\t\t\t\t\t\t\t\t\t\t\t\tnpm: typeof entry.npm === \"string\" ? entry.npm : \"0.0.0\",\n\t\t\t\t\t\t\t\t\t\t\t\t\tdate: entry.date,\n\t\t\t\t\t\t\t\t\t\t\t\t} satisfies NodeReleaseInput,\n\t\t\t\t\t\t\t\t\t\t\t})\n\t\t\t\t\t\t\t\t\t\t: Option.none(),\n\t\t\t\t\t\t\t\t),\n\t\t\t\t\t\t\t);\n\t\t\t\t\t\t},\n\t\t\t\t\t\t{ concurrency: \"unbounded\" },\n\t\t\t\t\t);\n\n\t\t\t\t\tconst versions = parsed.flatMap(Option.toArray).map(({ version }) => version);\n\t\t\t\t\tconst inputs = parsed.flatMap(Option.toArray).map(({ input }) => input);\n\n\t\t\t\t\treturn { versions, inputs };\n\t\t\t\t}),\n\t\t};\n\t}),\n);\n"],"mappings":";;;;;;;;AAQA,MAAM,gBAAgB;AAEtB,MAAM,mBAAmB,UACxB,OAAO,cAAc,aAAa,CAAC,CAAC,KAAK,CAAC,CAAC,KAC1C,OAAO,UACL,MACA,IAAI,WAAW;CACd,QAAQ;CACR,SAAS,6BAA6B,EAAE;AACzC,CAAC,CACH,CACD;;;;;;;;;;;;;;;;;;;AAoBD,MAAa,yBAA+E,MAAM,OACjG,oBACA,OAAO,IAAI,aAAa;CACvB,MAAM,SAAS,OAAO;CAEtB,OAAO,EACN,aACC,OAAO,IAAI,aAAa;EACvB,MAAM,cAAc,OAAO,OAAO,QAAQ,eAAe,EACxD,QAAQ,gBACT,CAAC;EAED,MAAM,SAAS,OAAO,OAAO,QAC5B,cACC,UAAU;GACV,MAAM,QAAQ,MAAM,QAAQ,QAAQ,MAAM,EAAE;GAC5C,OAAO,eAAe,KAAK,CAAC,CAAC,KAC5B,OAAO,KAAK,QACX,OAAO,OAAO,GAAG,IACd,OAAO,KAAK;IACZ,SAAS,IAAI;IACb,OAAO;KACN,SAAS;KAGT,KAAK,OAAO,MAAM,QAAQ,WAAW,MAAM,MAAM;KACjD,MAAM,MAAM;IACb;GACD,CAAC,IACA,OAAO,KAAK,CAChB,CACD;EACD,GACA,EAAE,aAAa,YAAY,CAC5B;EAKA,OAAO;GAAE,UAHQ,OAAO,QAAQ,OAAO,OAAO,CAAC,CAAC,KAAK,EAAE,cAAc,OAGrD;GAAG,QAFJ,OAAO,QAAQ,OAAO,OAAO,CAAC,CAAC,KAAK,EAAE,YAAY,KAEzC;EAAE;CAC3B,CAAC,EACH;AACD,CAAC,CACF"}