runtime-resolver 0.3.11 → 0.3.13

package/services/DenoResolver.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"DenoResolver.js","names":[],"sources":["../../../../src/services/DenoResolver.ts"],"sourcesContent":["import type { Effect } from \"effect\";\nimport { Context } from \"effect\";\nimport type { VersionNotFoundError } from \"../errors/VersionNotFoundError.js\";\nimport type { Increments, ResolvedVersions } from \"../schemas/common.js\";\n\n/**\n * Options accepted by {@link DenoResolver.resolve}.\n *\n * All fields are optional; omitting them causes the resolver to fall back to\n * its built-in defaults (latest stable release, `\"latest\"` increment\n * granularity).\n *\n * @see {@link DenoResolver}\n * @see {@link Increments}\n * @see {@link ResolvedVersions}\n *\n * @public\n */\nexport interface DenoResolverOptions {\n\t/**\n\t * A semver range string used to constrain which Deno releases are\n\t * considered (e.g. `\"^2.0.0\"` or `\">=1.40.0 <2.0.0\"`).\n\t *\n\t * When omitted all cached releases are eligible.\n\t */\n\treadonly semverRange?: string;\n\n\t/**\n\t * A fallback version string returned when no release satisfies\n\t * `semverRange`. Must be a valid semver version (e.g. `\"2.0.0\"`).\n\t *\n\t * When omitted and no match is found the effect fails with\n\t * {@link VersionNotFoundError}.\n\t */\n\treadonly defaultVersion?: string;\n\n\t/**\n\t * Controls the granularity of the version list included in\n\t * {@link ResolvedVersions.versions}.\n\t *\n\t * - `\"latest\"` — only the single highest matching version.\n\t * - `\"minor\"` — the latest patch for every minor line.\n\t * - `\"patch\"` — every individual patch release.\n\t *\n\t * Defaults to `\"latest\"` when omitted.\n\t *\n\t * @see {@link Increments}\n\t */\n\treadonly increments?: Increments;\n}\n\n/**\n * Union of all typed errors that {@link DenoResolver.resolve} can fail with.\n *\n * @see {@link VersionNotFoundError}\n *\n * @public\n */\nexport type DenoResolverError = VersionNotFoundError;\n\n/**\n * Service for resolving Deno runtime versions against the cached\n * release index.\n *\n * For a one-shot Promise-based API see {@link resolveDeno}.\n *\n * @example\n * ```typescript\n * import type { ResolvedVersions } from \"runtime-resolver\";\n * import { DenoResolver, DenoResolverLive } from \"runtime-resolver\";\n * import { Effect } from \"effect\";\n *\n * const program = Effect.gen(function* () {\n * \tconst resolver = yield* DenoResolver;\n * \tconst result = yield* resolver.resolve({ semverRange: \"^2.0.0\", increments: \"minor\" });\n * \tconsole.log(result.latest);\n * \tconsole.log(result.versions);\n * });\n *\n * Effect.runPromise(program.pipe(Effect.provide(DenoResolverLive)));\n * ```\n *\n * @see {@link DenoResolverLive}\n * @see {@link resolveDeno}\n * @see {@link DenoResolverOptions}\n * @see {@link ResolvedVersions}\n *\n * @public\n */\nexport class DenoResolver extends Context.Tag(\"runtime-resolver/DenoResolver\")<\n\tDenoResolver,\n\t{\n\t\t/**\n\t\t * Resolves Deno versions according to `options` and returns a\n\t\t * {@link ResolvedVersions} object containing the matching version list,\n\t\t * the latest version string, and the data source indicator.\n\t\t *\n\t\t * Fails with {@link DenoResolverError} when no version can be resolved and\n\t\t * no `defaultVersion` was provided.\n\t\t *\n\t\t * @param options - Optional resolution constraints.\n\t\t *\n\t\t * @see {@link DenoResolverOptions}\n\t\t */\n\t\treadonly resolve: (options?: DenoResolverOptions) => Effect.Effect<ResolvedVersions, DenoResolverError>;\n\t}\n>() {}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAyFA,IAAa,eAAb,cAAkC,QAAQ,IAAI,+BAA+B,CAAC,CAiB5E,CAAC,CAAC,CAAC"}

package/services/DenoVersionFetcher.js

@@ -0,0 +1,42 @@
+import { Context } from "effect";
+
+//#region src/services/DenoVersionFetcher.ts
+/**
+* Service for fetching Deno release data from the GitHub API.
+*
+* Retrieves both the parsed semver version list and the raw release input
+* records needed to populate a {@link DenoReleaseCache}. The live
+* implementation queries the `denoland/deno` GitHub repository via
+* {@link GitHubClient}.
+*
+* @example
+* ```typescript
+* import type { RuntimeReleaseInput } from "runtime-resolver";
+* import { DenoVersionFetcher, DenoVersionFetcherLive, GitHubAutoAuth } from "runtime-resolver";
+* import { Effect } from "effect";
+*
+* const program = Effect.gen(function* () {
+* 	const fetcher = yield* DenoVersionFetcher;
+* 	const { versions, inputs } = yield* fetcher.fetch();
+* 	console.log(`Fetched ${versions.length} Deno releases`);
+* });
+*
+* Effect.runPromise(
+* 	program.pipe(Effect.provide(DenoVersionFetcherLive), Effect.provide(GitHubAutoAuth)),
+* );
+* ```
+*
+* @see {@link DenoVersionFetcherLive}
+* @see {@link DenoReleaseCache}
+* @see {@link AuthenticationError}
+* @see {@link NetworkError}
+* @see {@link ParseError}
+* @see {@link RateLimitError}
+*
+* @public
+*/
+var DenoVersionFetcher = class extends Context.Tag("runtime-resolver/DenoVersionFetcher")() {};
+
+//#endregion
+export { DenoVersionFetcher };
+//# sourceMappingURL=DenoVersionFetcher.js.map

package/services/DenoVersionFetcher.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"DenoVersionFetcher.js","names":[],"sources":["../../../../src/services/DenoVersionFetcher.ts"],"sourcesContent":["import type { Effect } from \"effect\";\nimport { Context } from \"effect\";\nimport type { SemVer } from \"semver-effect\";\nimport type { AuthenticationError } from \"../errors/AuthenticationError.js\";\nimport type { NetworkError } from \"../errors/NetworkError.js\";\nimport type { ParseError } from \"../errors/ParseError.js\";\nimport type { RateLimitError } from \"../errors/RateLimitError.js\";\nimport type { RuntimeReleaseInput } from \"../schemas/runtime-release.js\";\n\n/**\n * Service for fetching Deno release data from the GitHub API.\n *\n * Retrieves both the parsed semver version list and the raw release input\n * records needed to populate a {@link DenoReleaseCache}. The live\n * implementation queries the `denoland/deno` GitHub repository via\n * {@link GitHubClient}.\n *\n * @example\n * ```typescript\n * import type { RuntimeReleaseInput } from \"runtime-resolver\";\n * import { DenoVersionFetcher, DenoVersionFetcherLive, GitHubAutoAuth } from \"runtime-resolver\";\n * import { Effect } from \"effect\";\n *\n * const program = Effect.gen(function* () {\n * \tconst fetcher = yield* DenoVersionFetcher;\n * \tconst { versions, inputs } = yield* fetcher.fetch();\n * \tconsole.log(`Fetched ${versions.length} Deno releases`);\n * });\n *\n * Effect.runPromise(\n * \tprogram.pipe(Effect.provide(DenoVersionFetcherLive), Effect.provide(GitHubAutoAuth)),\n * );\n * ```\n *\n * @see {@link DenoVersionFetcherLive}\n * @see {@link DenoReleaseCache}\n * @see {@link AuthenticationError}\n * @see {@link NetworkError}\n * @see {@link ParseError}\n * @see {@link RateLimitError}\n *\n * @public\n */\nexport class DenoVersionFetcher extends Context.Tag(\"runtime-resolver/DenoVersionFetcher\")<\n\tDenoVersionFetcher,\n\t{\n\t\t/**\n\t\t * Fetches all available Deno releases from the GitHub API and returns both\n\t\t * the parsed semver version objects and the raw release input records.\n\t\t *\n\t\t * Fails with:\n\t\t * - {@link AuthenticationError} — missing or invalid GitHub credentials.\n\t\t * - {@link NetworkError} — the upstream request could not be completed.\n\t\t * - {@link ParseError} — the response payload could not be decoded.\n\t\t * - {@link RateLimitError} — the GitHub API rate limit was exceeded.\n\t\t */\n\t\treadonly fetch: () => Effect.Effect<\n\t\t\t{\n\t\t\t\treadonly versions: ReadonlyArray<SemVer>;\n\t\t\t\treadonly inputs: ReadonlyArray<RuntimeReleaseInput>;\n\t\t\t},\n\t\t\tAuthenticationError | NetworkError | ParseError | RateLimitError\n\t\t>;\n\t}\n>() {}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA2CA,IAAa,qBAAb,cAAwC,QAAQ,IAAI,qCAAqC,CAAC,CAqBxF,CAAC,CAAC,CAAC"}

package/services/GitHubClient.js

@@ -0,0 +1,41 @@
+import { Context } from "effect";
+
+//#region src/services/GitHubClient.ts
+/**
+* Service for GitHub REST API operations used by the version
+* fetcher services.
+*
+* Abstracts over pagination and authentication so that higher-level services
+* such as {@link BunVersionFetcher}, {@link DenoVersionFetcher}, and
+* {@link NodeScheduleFetcher} remain independent of the underlying HTTP
+* transport. The live implementation is provided by {@link GitHubClientLive}
+* and requires an {@link OctokitInstance} in its dependency graph.
+*
+* @example
+* ```typescript
+* import type { GitHubTag } from "runtime-resolver";
+* import { GitHubClient, GitHubClientLive, GitHubAutoAuth } from "runtime-resolver";
+* import { Effect } from "effect";
+*
+* const program = Effect.gen(function* () {
+* 	const client = yield* GitHubClient;
+* 	const tags = yield* client.listTags("oven-sh", "bun", { perPage: 100 });
+* 	console.log(`Found ${tags.length} tags`);
+* });
+*
+* Effect.runPromise(
+* 	program.pipe(Effect.provide(GitHubClientLive), Effect.provide(GitHubAutoAuth)),
+* );
+* ```
+*
+* @see {@link GitHubClientLive}
+* @see {@link OctokitInstance}
+* @see {@link ListOptions}
+*
+* @public
+*/
+var GitHubClient = class extends Context.Tag("runtime-resolver/GitHubClient")() {};
+
+//#endregion
+export { GitHubClient };
+//# sourceMappingURL=GitHubClient.js.map

package/services/GitHubClient.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"GitHubClient.js","names":[],"sources":["../../../../src/services/GitHubClient.ts"],"sourcesContent":["import type { Effect } from \"effect\";\nimport { Context } from \"effect\";\nimport type { AuthenticationError } from \"../errors/AuthenticationError.js\";\nimport type { NetworkError } from \"../errors/NetworkError.js\";\nimport type { ParseError } from \"../errors/ParseError.js\";\nimport type { RateLimitError } from \"../errors/RateLimitError.js\";\nimport type { GitHubRelease, GitHubTag } from \"../schemas/github.js\";\n\n/**\n * Pagination options shared by all list operations on {@link GitHubClient}.\n *\n * @see {@link GitHubClient}\n *\n * @public\n */\nexport interface ListOptions {\n\t/**\n\t * Number of items to request per page. Defaults to the GitHub API maximum\n\t * of `100` when omitted.\n\t */\n\treadonly perPage?: number;\n\n\t/**\n\t * Maximum number of pages to fetch. When omitted all pages are fetched\n\t * until the API returns an empty result set.\n\t */\n\treadonly pages?: number;\n}\n\n/**\n * Service for GitHub REST API operations used by the version\n * fetcher services.\n *\n * Abstracts over pagination and authentication so that higher-level services\n * such as {@link BunVersionFetcher}, {@link DenoVersionFetcher}, and\n * {@link NodeScheduleFetcher} remain independent of the underlying HTTP\n * transport. The live implementation is provided by {@link GitHubClientLive}\n * and requires an {@link OctokitInstance} in its dependency graph.\n *\n * @example\n * ```typescript\n * import type { GitHubTag } from \"runtime-resolver\";\n * import { GitHubClient, GitHubClientLive, GitHubAutoAuth } from \"runtime-resolver\";\n * import { Effect } from \"effect\";\n *\n * const program = Effect.gen(function* () {\n * \tconst client = yield* GitHubClient;\n * \tconst tags = yield* client.listTags(\"oven-sh\", \"bun\", { perPage: 100 });\n * \tconsole.log(`Found ${tags.length} tags`);\n * });\n *\n * Effect.runPromise(\n * \tprogram.pipe(Effect.provide(GitHubClientLive), Effect.provide(GitHubAutoAuth)),\n * );\n * ```\n *\n * @see {@link GitHubClientLive}\n * @see {@link OctokitInstance}\n * @see {@link ListOptions}\n *\n * @public\n */\nexport class GitHubClient extends Context.Tag(\"runtime-resolver/GitHubClient\")<\n\tGitHubClient,\n\t{\n\t\t/**\n\t\t * Lists all git tags for the given repository, automatically paginating\n\t\t * through results according to `options`.\n\t\t *\n\t\t * Fails with:\n\t\t * - {@link AuthenticationError} — missing or invalid GitHub credentials.\n\t\t * - {@link NetworkError} — the upstream request could not be completed.\n\t\t * - {@link RateLimitError} — the GitHub API rate limit was exceeded.\n\t\t * - {@link ParseError} — a response page could not be decoded.\n\t\t *\n\t\t * @param owner - GitHub organisation or user name (e.g. `\"oven-sh\"`).\n\t\t * @param repo - Repository name (e.g. `\"bun\"`).\n\t\t * @param options - Optional pagination controls.\n\t\t */\n\t\treadonly listTags: (\n\t\t\towner: string,\n\t\t\trepo: string,\n\t\t\toptions?: ListOptions,\n\t\t) => Effect.Effect<ReadonlyArray<GitHubTag>, AuthenticationError | NetworkError | RateLimitError | ParseError>;\n\n\t\t/**\n\t\t * Lists all GitHub Releases for the given repository, automatically\n\t\t * paginating through results according to `options`.\n\t\t *\n\t\t * Fails with:\n\t\t * - {@link AuthenticationError} — missing or invalid GitHub credentials.\n\t\t * - {@link NetworkError} — the upstream request could not be completed.\n\t\t * - {@link RateLimitError} — the GitHub API rate limit was exceeded.\n\t\t * - {@link ParseError} — a response page could not be decoded.\n\t\t *\n\t\t * @param owner - GitHub organisation or user name (e.g. `\"denoland\"`).\n\t\t * @param repo - Repository name (e.g. `\"deno\"`).\n\t\t * @param options - Optional pagination controls.\n\t\t */\n\t\treadonly listReleases: (\n\t\t\towner: string,\n\t\t\trepo: string,\n\t\t\toptions?: ListOptions,\n\t\t) => Effect.Effect<ReadonlyArray<GitHubRelease>, AuthenticationError | NetworkError | RateLimitError | ParseError>;\n\n\t\t/**\n\t\t * Fetches arbitrary JSON from `url` and decodes it with the provided\n\t\t * schema, returning the typed result.\n\t\t *\n\t\t * Useful for endpoints outside the standard Octokit REST methods (e.g.\n\t\t * raw GitHub content URLs).\n\t\t *\n\t\t * Fails with:\n\t\t * - {@link NetworkError} — the upstream request could not be completed.\n\t\t * - {@link ParseError} — the response body could not be decoded by `schema`.\n\t\t *\n\t\t * @typeParam A - The decoded output type produced by `schema`.\n\t\t * @param url - Fully qualified URL to fetch.\n\t\t * @param schema - An object with a `decode` method compatible with\n\t\t * Effect Schema's `decodeUnknown`.\n\t\t */\n\t\treadonly getJson: <A>(\n\t\t\turl: string,\n\t\t\tschema: {\n\t\t\t\treadonly decode: (input: unknown) => Effect.Effect<A, ParseError>;\n\t\t\t},\n\t\t) => Effect.Effect<A, NetworkError | ParseError>;\n\t}\n>() {}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA8DA,IAAa,eAAb,cAAkC,QAAQ,IAAI,+BAA+B,CAAC,CAkE5E,CAAC,CAAC,CAAC"}

package/services/NodeReleaseCache.js

@@ -0,0 +1,42 @@
+import { Context } from "effect";
+
+//#region src/services/NodeReleaseCache.ts
+/**
+* Node.js-specific cache service that extends {@link RuntimeCache} with
+* additional operations for lifecycle schedule data and LTS / current
+* release filtering.
+*
+* Unlike the Bun and Deno equivalents this service is not a plain type alias
+* — it adds four Node-specific methods on top of the generic cache contract.
+*
+* @example
+* ```typescript
+* import type { NodeRelease } from "runtime-resolver";
+* import { NodeReleaseCache, OfflineNodeCacheLive } from "runtime-resolver";
+* import { Effect } from "effect";
+*
+* const program = Effect.gen(function* () {
+* 	const cache = yield* NodeReleaseCache;
+* 	const lts = yield* cache.ltsReleases();
+* 	for (const release of lts) {
+* 		console.log(release.version.toString(), release.phase);
+* 	}
+* });
+*
+* Effect.runPromise(program.pipe(Effect.provide(OfflineNodeCacheLive)));
+* ```
+*
+* @see {@link NodeRelease}
+* @see {@link NodeScheduleData}
+* @see {@link RuntimeCache}
+* @see {@link AutoNodeCacheLive}
+* @see {@link FreshNodeCacheLive}
+* @see {@link OfflineNodeCacheLive}
+*
+* @public
+*/
+var NodeReleaseCache = class extends Context.Tag("runtime-resolver/NodeReleaseCache")() {};
+
+//#endregion
+export { NodeReleaseCache };
+//# sourceMappingURL=NodeReleaseCache.js.map

package/services/NodeReleaseCache.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"NodeReleaseCache.js","names":[],"sources":["../../../../src/services/NodeReleaseCache.ts"],"sourcesContent":["import type { DateTime, Effect } from \"effect\";\nimport { Context } from \"effect\";\nimport type { NodeRelease, NodeReleaseInput } from \"../schemas/node-release.js\";\nimport type { NodeScheduleData } from \"../schemas/node-schedule.js\";\nimport type { RuntimeCache } from \"./RuntimeCache.js\";\n\n/**\n * Node.js-specific cache service that extends {@link RuntimeCache} with\n * additional operations for lifecycle schedule data and LTS / current\n * release filtering.\n *\n * Unlike the Bun and Deno equivalents this service is not a plain type alias\n * — it adds four Node-specific methods on top of the generic cache contract.\n *\n * @example\n * ```typescript\n * import type { NodeRelease } from \"runtime-resolver\";\n * import { NodeReleaseCache, OfflineNodeCacheLive } from \"runtime-resolver\";\n * import { Effect } from \"effect\";\n *\n * const program = Effect.gen(function* () {\n * \tconst cache = yield* NodeReleaseCache;\n * \tconst lts = yield* cache.ltsReleases();\n * \tfor (const release of lts) {\n * \t\tconsole.log(release.version.toString(), release.phase);\n * \t}\n * });\n *\n * Effect.runPromise(program.pipe(Effect.provide(OfflineNodeCacheLive)));\n * ```\n *\n * @see {@link NodeRelease}\n * @see {@link NodeScheduleData}\n * @see {@link RuntimeCache}\n * @see {@link AutoNodeCacheLive}\n * @see {@link FreshNodeCacheLive}\n * @see {@link OfflineNodeCacheLive}\n *\n * @public\n */\nexport class NodeReleaseCache extends Context.Tag(\"runtime-resolver/NodeReleaseCache\")<\n\tNodeReleaseCache,\n\tRuntimeCache<NodeRelease> & {\n\t\t/**\n\t\t * Merges Node.js release-schedule data into the cache, updating lifecycle\n\t\t * phase information (LTS dates, end-of-life dates, etc.) for every major\n\t\t * release line.\n\t\t *\n\t\t * @param data - Parsed schedule payload, typically fetched via\n\t\t * {@link NodeScheduleFetcher}.\n\t\t *\n\t\t * @see {@link NodeScheduleData}\n\t\t */\n\t\treadonly updateSchedule: (data: NodeScheduleData) => Effect.Effect<void>;\n\n\t\t/**\n\t\t * Populates the cache from raw {@link NodeReleaseInput} records (as\n\t\t * returned by the Node.js release index JSON) rather than from already-\n\t\t * decoded {@link NodeRelease} objects.\n\t\t *\n\t\t * Prefer this over `load` when consuming data directly from the Node.js\n\t\t * distribution server.\n\t\t *\n\t\t * @param inputs - An array of un-decoded release index entries.\n\t\t *\n\t\t * @see {@link NodeReleaseInput}\n\t\t */\n\t\treadonly loadFromInputs: (inputs: ReadonlyArray<NodeReleaseInput>) => Effect.Effect<void>;\n\n\t\t/**\n\t\t * Returns all cached releases whose lifecycle phase is `\"active-lts\"` or\n\t\t * `\"maintenance-lts\"` as of the given point in time.\n\t\t *\n\t\t * When `now` is omitted the current wall-clock time is used.\n\t\t *\n\t\t * @param now - Optional reference timestamp for phase evaluation.\n\t\t *\n\t\t * @see {@link NodeRelease}\n\t\t */\n\t\treadonly ltsReleases: (now?: DateTime.DateTime) => Effect.Effect<ReadonlyArray<NodeRelease>>;\n\n\t\t/**\n\t\t * Returns all cached releases whose lifecycle phase is `\"current\"` as of\n\t\t * the given point in time.\n\t\t *\n\t\t * When `now` is omitted the current wall-clock time is used.\n\t\t *\n\t\t * @param now - Optional reference timestamp for phase evaluation.\n\t\t *\n\t\t * @see {@link NodeRelease}\n\t\t */\n\t\treadonly currentReleases: (now?: DateTime.DateTime) => Effect.Effect<ReadonlyArray<NodeRelease>>;\n\t}\n>() {}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAwCA,IAAa,mBAAb,cAAsC,QAAQ,IAAI,mCAAmC,CAAC,CAqDpF,CAAC,CAAC,CAAC"}

package/services/NodeResolver.js

@@ -0,0 +1,45 @@
+import { Context } from "effect";
+
+//#region src/services/NodeResolver.ts
+/**
+* Service for resolving Node.js runtime versions against the cached
+* release index.
+*
+* Unlike {@link BunResolver} and {@link DenoResolver}, this service is
+* lifecycle-aware: results can be filtered by {@link NodePhase} and evaluated
+* against a specific reference date.
+*
+* For a one-shot Promise-based API see {@link resolveNode}.
+*
+* @example
+* ```typescript
+* import type { ResolvedVersions } from "runtime-resolver";
+* import { NodeResolver, NodeResolverLive } from "runtime-resolver";
+* import { Effect } from "effect";
+*
+* const program = Effect.gen(function* () {
+* 	const resolver = yield* NodeResolver;
+* 	const result = yield* resolver.resolve({
+* 		semverRange: "^20.0.0",
+* 		phases: ["active-lts"],
+* 		increments: "minor",
+* 	});
+* 	console.log(result.latest);
+* 	console.log(result.lts);
+* });
+*
+* Effect.runPromise(program.pipe(Effect.provide(NodeResolverLive)));
+* ```
+*
+* @see {@link NodeResolverLive}
+* @see {@link resolveNode}
+* @see {@link NodeResolverOptions}
+* @see {@link ResolvedVersions}
+*
+* @public
+*/
+var NodeResolver = class extends Context.Tag("runtime-resolver/NodeResolver")() {};
+
+//#endregion
+export { NodeResolver };
+//# sourceMappingURL=NodeResolver.js.map

package/services/NodeResolver.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"NodeResolver.js","names":[],"sources":["../../../../src/services/NodeResolver.ts"],"sourcesContent":["import type { Effect } from \"effect\";\nimport { Context } from \"effect\";\nimport type { VersionNotFoundError } from \"../errors/VersionNotFoundError.js\";\nimport type { Increments, NodePhase, ResolvedVersions } from \"../schemas/common.js\";\n\n/**\n * Options accepted by {@link NodeResolver.resolve}.\n *\n * All fields are optional; omitting them causes the resolver to fall back to\n * its built-in defaults (all lifecycle phases, latest stable release,\n * `\"latest\"` increment granularity, current wall-clock date).\n *\n * @see {@link NodeResolver}\n * @see {@link NodePhase}\n * @see {@link Increments}\n * @see {@link ResolvedVersions}\n *\n * @public\n */\nexport interface NodeResolverOptions {\n\t/**\n\t * A semver range string used to constrain which Node.js releases are\n\t * considered (e.g. `\"^20.0.0\"` or `\">=18.0.0 <22.0.0\"`).\n\t *\n\t * When omitted all cached releases are eligible.\n\t */\n\treadonly semverRange?: string;\n\n\t/**\n\t * A fallback version string returned when no release satisfies\n\t * `semverRange`. Must be a valid semver version (e.g. `\"20.0.0\"`).\n\t *\n\t * When omitted and no match is found the effect fails with\n\t * {@link VersionNotFoundError}.\n\t */\n\treadonly defaultVersion?: string;\n\n\t/**\n\t * Restricts resolution to releases whose lifecycle phase is included in\n\t * this list. For example, passing `[\"active-lts\"]` excludes `\"current\"`\n\t * and `\"maintenance-lts\"` releases from consideration.\n\t *\n\t * When omitted all phases are eligible.\n\t *\n\t * @see {@link NodePhase}\n\t */\n\treadonly phases?: ReadonlyArray<NodePhase>;\n\n\t/**\n\t * Controls the granularity of the version list included in\n\t * {@link ResolvedVersions.versions}.\n\t *\n\t * - `\"latest\"` — only the single highest matching version.\n\t * - `\"minor\"` — the latest patch for every minor line.\n\t * - `\"patch\"` — every individual patch release.\n\t *\n\t * Defaults to `\"latest\"` when omitted.\n\t *\n\t * @see {@link Increments}\n\t */\n\treadonly increments?: Increments;\n\n\t/**\n\t * Reference date used when evaluating Node.js lifecycle phases. Releases\n\t * whose LTS or end-of-life boundaries fall relative to this date are\n\t * classified accordingly.\n\t *\n\t * When omitted the current wall-clock date is used.\n\t */\n\treadonly date?: Date;\n}\n\n/**\n * Union of all typed errors that {@link NodeResolver.resolve} can fail with.\n *\n * @see {@link VersionNotFoundError}\n *\n * @public\n */\nexport type NodeResolverError = VersionNotFoundError;\n\n/**\n * Service for resolving Node.js runtime versions against the cached\n * release index.\n *\n * Unlike {@link BunResolver} and {@link DenoResolver}, this service is\n * lifecycle-aware: results can be filtered by {@link NodePhase} and evaluated\n * against a specific reference date.\n *\n * For a one-shot Promise-based API see {@link resolveNode}.\n *\n * @example\n * ```typescript\n * import type { ResolvedVersions } from \"runtime-resolver\";\n * import { NodeResolver, NodeResolverLive } from \"runtime-resolver\";\n * import { Effect } from \"effect\";\n *\n * const program = Effect.gen(function* () {\n * \tconst resolver = yield* NodeResolver;\n * \tconst result = yield* resolver.resolve({\n * \t\tsemverRange: \"^20.0.0\",\n * \t\tphases: [\"active-lts\"],\n * \t\tincrements: \"minor\",\n * \t});\n * \tconsole.log(result.latest);\n * \tconsole.log(result.lts);\n * });\n *\n * Effect.runPromise(program.pipe(Effect.provide(NodeResolverLive)));\n * ```\n *\n * @see {@link NodeResolverLive}\n * @see {@link resolveNode}\n * @see {@link NodeResolverOptions}\n * @see {@link ResolvedVersions}\n *\n * @public\n */\nexport class NodeResolver extends Context.Tag(\"runtime-resolver/NodeResolver\")<\n\tNodeResolver,\n\t{\n\t\t/**\n\t\t * Resolves Node.js versions according to `options` and returns a\n\t\t * {@link ResolvedVersions} object containing the matching version list,\n\t\t * the latest version string, optional LTS version string, and the data\n\t\t * source indicator.\n\t\t *\n\t\t * Fails with {@link NodeResolverError} when no version can be resolved and\n\t\t * no `defaultVersion` was provided.\n\t\t *\n\t\t * @param options - Optional resolution constraints.\n\t\t *\n\t\t * @see {@link NodeResolverOptions}\n\t\t */\n\t\treadonly resolve: (options?: NodeResolverOptions) => Effect.Effect<ResolvedVersions, NodeResolverError>;\n\t}\n>() {}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAsHA,IAAa,eAAb,cAAkC,QAAQ,IAAI,+BAA+B,CAAC,CAkB5E,CAAC,CAAC,CAAC"}

package/services/NodeScheduleFetcher.js

@@ -0,0 +1,39 @@
+import { Context } from "effect";
+
+//#region src/services/NodeScheduleFetcher.ts
+/**
+* Service for fetching the official Node.js release schedule.
+*
+* The schedule maps each major release line to its LTS start date and
+* end-of-life date, and is used by {@link NodeReleaseCache} to assign
+* lifecycle phases to individual releases. The live implementation fetches
+* from the `nodejs/Release` GitHub repository via a plain HTTP request.
+*
+* @example
+* ```typescript
+* import type { NodeScheduleData } from "runtime-resolver";
+* import { NodeScheduleFetcher, NodeScheduleFetcherLive } from "runtime-resolver";
+* import { Effect } from "effect";
+*
+* const program = Effect.gen(function* () {
+* 	const fetcher = yield* NodeScheduleFetcher;
+* 	const schedule = yield* fetcher.fetch();
+* 	console.log(Object.keys(schedule).length, "major release lines");
+* });
+*
+* Effect.runPromise(program.pipe(Effect.provide(NodeScheduleFetcherLive)));
+* ```
+*
+* @see {@link NodeScheduleFetcherLive}
+* @see {@link NodeReleaseCache}
+* @see {@link NodeScheduleData}
+* @see {@link NetworkError}
+* @see {@link ParseError}
+*
+* @public
+*/
+var NodeScheduleFetcher = class extends Context.Tag("runtime-resolver/NodeScheduleFetcher")() {};
+
+//#endregion
+export { NodeScheduleFetcher };
+//# sourceMappingURL=NodeScheduleFetcher.js.map

package/services/NodeScheduleFetcher.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"NodeScheduleFetcher.js","names":[],"sources":["../../../../src/services/NodeScheduleFetcher.ts"],"sourcesContent":["import type { Effect } from \"effect\";\nimport { Context } from \"effect\";\nimport type { NetworkError } from \"../errors/NetworkError.js\";\nimport type { ParseError } from \"../errors/ParseError.js\";\nimport type { NodeScheduleData } from \"../schemas/node-schedule.js\";\n\n/**\n * Service for fetching the official Node.js release schedule.\n *\n * The schedule maps each major release line to its LTS start date and\n * end-of-life date, and is used by {@link NodeReleaseCache} to assign\n * lifecycle phases to individual releases. The live implementation fetches\n * from the `nodejs/Release` GitHub repository via a plain HTTP request.\n *\n * @example\n * ```typescript\n * import type { NodeScheduleData } from \"runtime-resolver\";\n * import { NodeScheduleFetcher, NodeScheduleFetcherLive } from \"runtime-resolver\";\n * import { Effect } from \"effect\";\n *\n * const program = Effect.gen(function* () {\n * \tconst fetcher = yield* NodeScheduleFetcher;\n * \tconst schedule = yield* fetcher.fetch();\n * \tconsole.log(Object.keys(schedule).length, \"major release lines\");\n * });\n *\n * Effect.runPromise(program.pipe(Effect.provide(NodeScheduleFetcherLive)));\n * ```\n *\n * @see {@link NodeScheduleFetcherLive}\n * @see {@link NodeReleaseCache}\n * @see {@link NodeScheduleData}\n * @see {@link NetworkError}\n * @see {@link ParseError}\n *\n * @public\n */\nexport class NodeScheduleFetcher extends Context.Tag(\"runtime-resolver/NodeScheduleFetcher\")<\n\tNodeScheduleFetcher,\n\t{\n\t\t/**\n\t\t * Fetches and decodes the Node.js release schedule JSON, returning a\n\t\t * typed {@link NodeScheduleData} map keyed by major release line.\n\t\t *\n\t\t * Fails with:\n\t\t * - {@link NetworkError} — the upstream request could not be completed.\n\t\t * - {@link ParseError} — the response payload could not be decoded.\n\t\t */\n\t\treadonly fetch: () => Effect.Effect<NodeScheduleData, NetworkError | ParseError>;\n\t}\n>() {}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAqCA,IAAa,sBAAb,cAAyC,QAAQ,IAAI,sCAAsC,CAAC,CAa1F,CAAC,CAAC,CAAC"}

package/services/NodeVersionFetcher.js

@@ -0,0 +1,40 @@
+import { Context } from "effect";
+
+//#region src/services/NodeVersionFetcher.ts
+/**
+* Service for fetching Node.js release data from the official
+* Node.js distribution index.
+*
+* Retrieves both the parsed semver version list and the raw
+* {@link NodeReleaseInput} records needed to populate a
+* {@link NodeReleaseCache}. The live implementation fetches from
+* `https://nodejs.org/dist/index.json` via a plain HTTP request — no GitHub
+* credentials are required.
+*
+* @example
+* ```typescript
+* import type { NodeReleaseInput } from "runtime-resolver";
+* import { NodeVersionFetcher, NodeVersionFetcherLive } from "runtime-resolver";
+* import { Effect } from "effect";
+*
+* const program = Effect.gen(function* () {
+* 	const fetcher = yield* NodeVersionFetcher;
+* 	const { versions, inputs } = yield* fetcher.fetch();
+* 	console.log(`Fetched ${versions.length} Node.js releases`);
+* });
+*
+* Effect.runPromise(program.pipe(Effect.provide(NodeVersionFetcherLive)));
+* ```
+*
+* @see {@link NodeVersionFetcherLive}
+* @see {@link NodeReleaseCache}
+* @see {@link NetworkError}
+* @see {@link ParseError}
+*
+* @public
+*/
+var NodeVersionFetcher = class extends Context.Tag("runtime-resolver/NodeVersionFetcher")() {};
+
+//#endregion
+export { NodeVersionFetcher };
+//# sourceMappingURL=NodeVersionFetcher.js.map

package/services/NodeVersionFetcher.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"NodeVersionFetcher.js","names":[],"sources":["../../../../src/services/NodeVersionFetcher.ts"],"sourcesContent":["import type { Effect } from \"effect\";\nimport { Context } from \"effect\";\nimport type { SemVer } from \"semver-effect\";\nimport type { NetworkError } from \"../errors/NetworkError.js\";\nimport type { ParseError } from \"../errors/ParseError.js\";\nimport type { NodeReleaseInput } from \"../schemas/node-release.js\";\n\n/**\n * Service for fetching Node.js release data from the official\n * Node.js distribution index.\n *\n * Retrieves both the parsed semver version list and the raw\n * {@link NodeReleaseInput} records needed to populate a\n * {@link NodeReleaseCache}. The live implementation fetches from\n * `https://nodejs.org/dist/index.json` via a plain HTTP request — no GitHub\n * credentials are required.\n *\n * @example\n * ```typescript\n * import type { NodeReleaseInput } from \"runtime-resolver\";\n * import { NodeVersionFetcher, NodeVersionFetcherLive } from \"runtime-resolver\";\n * import { Effect } from \"effect\";\n *\n * const program = Effect.gen(function* () {\n * \tconst fetcher = yield* NodeVersionFetcher;\n * \tconst { versions, inputs } = yield* fetcher.fetch();\n * \tconsole.log(`Fetched ${versions.length} Node.js releases`);\n * });\n *\n * Effect.runPromise(program.pipe(Effect.provide(NodeVersionFetcherLive)));\n * ```\n *\n * @see {@link NodeVersionFetcherLive}\n * @see {@link NodeReleaseCache}\n * @see {@link NetworkError}\n * @see {@link ParseError}\n *\n * @public\n */\nexport class NodeVersionFetcher extends Context.Tag(\"runtime-resolver/NodeVersionFetcher\")<\n\tNodeVersionFetcher,\n\t{\n\t\t/**\n\t\t * Fetches all available Node.js releases from the distribution index and\n\t\t * returns both the parsed semver version objects and the raw release input\n\t\t * records.\n\t\t *\n\t\t * Fails with:\n\t\t * - {@link NetworkError} — the upstream request could not be completed.\n\t\t * - {@link ParseError} — the response payload could not be decoded.\n\t\t */\n\t\treadonly fetch: () => Effect.Effect<\n\t\t\t{\n\t\t\t\treadonly versions: ReadonlyArray<SemVer>;\n\t\t\t\treadonly inputs: ReadonlyArray<NodeReleaseInput>;\n\t\t\t},\n\t\t\tNetworkError | ParseError\n\t\t>;\n\t}\n>() {}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAuCA,IAAa,qBAAb,cAAwC,QAAQ,IAAI,qCAAqC,CAAC,CAoBxF,CAAC,CAAC,CAAC"}

package/services/OctokitInstance.js

@@ -0,0 +1,45 @@
+import { Context } from "effect";
+
+//#region src/services/OctokitInstance.ts
+/**
+* Thin wrapper around the subset of Octokit's REST client used by
+* {@link GitHubClient}.
+*
+* Exposing only the repository methods actually consumed by this library
+* keeps the surface area narrow and makes the interface straightforward to
+* stub in tests without pulling in the full Octokit type.
+*
+* An `OctokitInstance` is provided to the dependency graph by one of the
+* three authentication layers: {@link GitHubTokenAuth}, {@link GitHubAppAuth},
+* or {@link GitHubAutoAuth}.
+*
+* @example
+* ```typescript
+* import { OctokitInstance, GitHubClientLive, GitHubAutoAuth } from "runtime-resolver";
+* import { Effect } from "effect";
+*
+* const program = Effect.gen(function* () {
+* 	const octokit = yield* OctokitInstance;
+* 	const response = await octokit.rest.repos.listTags({
+* 		owner: "oven-sh",
+* 		repo: "bun",
+* 		per_page: 10,
+* 	});
+* 	console.log(response.data.length);
+* });
+*
+* Effect.runPromise(program.pipe(Effect.provide(GitHubAutoAuth)));
+* ```
+*
+* @see {@link GitHubClientLive}
+* @see {@link GitHubTokenAuth}
+* @see {@link GitHubAppAuth}
+* @see {@link GitHubAutoAuth}
+*
+* @public
+*/
+var OctokitInstance = class extends Context.Tag("runtime-resolver/OctokitInstance")() {};
+
+//#endregion
+export { OctokitInstance };
+//# sourceMappingURL=OctokitInstance.js.map

package/services/OctokitInstance.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"OctokitInstance.js","names":[],"sources":["../../../../src/services/OctokitInstance.ts"],"sourcesContent":["import { Context } from \"effect\";\n\n/**\n * Thin wrapper around the subset of Octokit's REST client used by\n * {@link GitHubClient}.\n *\n * Exposing only the repository methods actually consumed by this library\n * keeps the surface area narrow and makes the interface straightforward to\n * stub in tests without pulling in the full Octokit type.\n *\n * An `OctokitInstance` is provided to the dependency graph by one of the\n * three authentication layers: {@link GitHubTokenAuth}, {@link GitHubAppAuth},\n * or {@link GitHubAutoAuth}.\n *\n * @example\n * ```typescript\n * import { OctokitInstance, GitHubClientLive, GitHubAutoAuth } from \"runtime-resolver\";\n * import { Effect } from \"effect\";\n *\n * const program = Effect.gen(function* () {\n * \tconst octokit = yield* OctokitInstance;\n * \tconst response = await octokit.rest.repos.listTags({\n * \t\towner: \"oven-sh\",\n * \t\trepo: \"bun\",\n * \t\tper_page: 10,\n * \t});\n * \tconsole.log(response.data.length);\n * });\n *\n * Effect.runPromise(program.pipe(Effect.provide(GitHubAutoAuth)));\n * ```\n *\n * @see {@link GitHubClientLive}\n * @see {@link GitHubTokenAuth}\n * @see {@link GitHubAppAuth}\n * @see {@link GitHubAutoAuth}\n *\n * @public\n */\nexport class OctokitInstance extends Context.Tag(\"runtime-resolver/OctokitInstance\")<\n\tOctokitInstance,\n\t{\n\t\treadonly rest: {\n\t\t\treadonly repos: {\n\t\t\t\t/**\n\t\t\t\t * Lists git tags for a repository, corresponding to\n\t\t\t\t * `GET /repos/{owner}/{repo}/tags`.\n\t\t\t\t *\n\t\t\t\t * @param params - Owner, repo, and optional pagination parameters.\n\t\t\t\t */\n\t\t\t\treadonly listTags: (params: {\n\t\t\t\t\towner: string;\n\t\t\t\t\trepo: string;\n\t\t\t\t\tper_page?: number;\n\t\t\t\t\tpage?: number;\n\t\t\t\t}) => Promise<{ data: Array<unknown> }>;\n\n\t\t\t\t/**\n\t\t\t\t * Lists GitHub Releases for a repository, corresponding to\n\t\t\t\t * `GET /repos/{owner}/{repo}/releases`.\n\t\t\t\t *\n\t\t\t\t * @param params - Owner, repo, and optional pagination parameters.\n\t\t\t\t */\n\t\t\t\treadonly listReleases: (params: {\n\t\t\t\t\towner: string;\n\t\t\t\t\trepo: string;\n\t\t\t\t\tper_page?: number;\n\t\t\t\t\tpage?: number;\n\t\t\t\t}) => Promise<{ data: Array<unknown> }>;\n\t\t\t};\n\t\t};\n\t}\n>() {}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAuCA,IAAa,kBAAb,cAAqC,QAAQ,IAAI,kCAAkC,CAAC,CAiClF,CAAC,CAAC,CAAC"}

package/tsdoc-metadata.json

@@ -1,11 +1,11 @@
-// This file is read by tools that parse documentation comments conforming to the TSDoc standard.
-// It should be published with your NPM package.  It should not be tracked by Git.
-{
-  "tsdocVersion": "0.12",
-  "toolPackages": [
-    {
-      "packageName": "@microsoft/api-extractor",
-      "packageVersion": "7.58.7"
-    }
-  ]
-}
+// This file is read by tools that parse documentation comments conforming to the TSDoc standard.
+// It should be published with your NPM package.  It should not be tracked by Git.
+{
+  "tsdocVersion": "0.12",
+  "toolPackages": [
+    {
+      "packageName": "@microsoft/api-extractor",
+      "packageVersion": "7.58.8"
+    }
+  ]
+}

package/612.js

@@ -1,23 +0,0 @@
-var __webpack_require__ = {};
-(()=>{
-    __webpack_require__.d = (exports, definition)=>{
-        for(var key in definition)if (__webpack_require__.o(definition, key) && !__webpack_require__.o(exports, key)) Object.defineProperty(exports, key, {
-            enumerable: true,
-            get: definition[key]
-        });
-    };
-})();
-(()=>{
-    __webpack_require__.o = (obj, prop)=>Object.prototype.hasOwnProperty.call(obj, prop);
-})();
-(()=>{
-    __webpack_require__.r = (exports)=>{
-        if ("u" > typeof Symbol && Symbol.toStringTag) Object.defineProperty(exports, Symbol.toStringTag, {
-            value: 'Module'
-        });
-        Object.defineProperty(exports, '__esModule', {
-            value: true
-        });
-    };
-})();
-export { __webpack_require__ };