runtime-resolver 0.3.12 → 0.3.14

package/services/DenoVersionFetcher.js

@@ -0,0 +1,41 @@
+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 };

package/services/GitHubClient.js

@@ -0,0 +1,40 @@
+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 };

package/services/NodeReleaseCache.js

@@ -0,0 +1,41 @@
+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 };

package/services/NodeResolver.js

@@ -0,0 +1,44 @@
+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 };

package/services/NodeScheduleFetcher.js

@@ -0,0 +1,38 @@
+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 };

package/services/NodeVersionFetcher.js

@@ -0,0 +1,39 @@
+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 };

package/services/OctokitInstance.js

@@ -0,0 +1,44 @@
+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 };

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.9"
+    }
+  ]
+}

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__ };