runtime-resolver 0.3.13 → 0.3.14

package/services/NodeReleaseCache.js.map

@@ -1 +0,0 @@
-{"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.map

@@ -1 +0,0 @@
-{"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.map

@@ -1 +0,0 @@
-{"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.map

@@ -1 +0,0 @@
-{"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.map

@@ -1 +0,0 @@
-{"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"}