runtime-resolver 0.3.12 → 0.3.13

package/layers/BunResolverLive.js

@@ -0,0 +1,86 @@
+import { BunReleaseCache } from "../services/BunReleaseCache.js";
+import { VersionNotFoundError } from "../errors/VersionNotFoundError.js";
+import { BunResolver } from "../services/BunResolver.js";
+import { Effect, Layer } from "effect";
+import { SemVer } from "semver-effect";
+
+//#region src/layers/BunResolverLive.ts
+/**
+* Provides the {@link BunResolver} service backed by a {@link BunReleaseCache}.
+*
+* This layer composes with any of the three Bun cache strategy layers to form
+* a complete resolver stack. It implements semver range filtering and increment
+* grouping (latest per major, latest per minor, or all patch versions) using
+* the releases already loaded into the cache.
+*
+* @example
+* ```ts
+* import { BunResolverLive, AutoBunCacheLive, BunVersionFetcherLive, GitHubClientLive, GitHubAutoAuth } from "runtime-resolver";
+* import type { ResolvedVersions } from "runtime-resolver";
+* import { BunResolver } from "runtime-resolver";
+* import { Effect, Layer } from "effect";
+*
+* const GitHubLayer = GitHubClientLive.pipe(Layer.provide(GitHubAutoAuth));
+* const CacheLayer = AutoBunCacheLive.pipe(Layer.provide(BunVersionFetcherLive.pipe(Layer.provide(GitHubLayer))));
+* const ResolverLayer = BunResolverLive.pipe(Layer.provide(CacheLayer));
+*
+* const program = Effect.gen(function* () {
+*   const resolver = yield* BunResolver;
+*   const result = yield* resolver.resolve({ semverRange: "^1.0.0" });
+*   console.log(result.latest);
+* });
+*
+* Effect.runPromise(program.pipe(Effect.provide(ResolverLayer)));
+* ```
+*
+* @see {@link BunResolver}
+* @see {@link BunReleaseCache}
+* @see {@link AutoBunCacheLive}
+* @see {@link FreshBunCacheLive}
+* @see {@link OfflineBunCacheLive}
+* @public
+*/
+const BunResolverLive = Layer.effect(BunResolver, Effect.gen(function* () {
+	const cache = yield* BunReleaseCache;
+	return { resolve: (options) => Effect.gen(function* () {
+		const semverRange = options?.semverRange ?? "*";
+		const increments = options?.increments ?? "latest";
+		const matching = yield* cache.filter(semverRange).pipe(Effect.catchAll(() => Effect.succeed([])));
+		let resultReleases;
+		if (increments === "latest") {
+			const groups = /* @__PURE__ */ new Map();
+			for (const r of matching) {
+				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 matching) {
+				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 = [...matching];
+		if (resultReleases.length === 0) return yield* Effect.fail(new VersionNotFoundError({
+			runtime: "bun",
+			constraint: semverRange,
+			message: `No Bun versions found matching "${semverRange}"`
+		}));
+		const versions = SemVer.rsort(resultReleases.map((r) => r.version)).map((v) => v.toString());
+		const latest = versions[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,
+			...resolvedDefault ? { default: resolvedDefault } : {}
+		};
+	}) };
+}));
+
+//#endregion
+export { BunResolverLive };
+//# sourceMappingURL=BunResolverLive.js.map

package/layers/BunResolverLive.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"BunResolverLive.js","names":[],"sources":["../../../../src/layers/BunResolverLive.ts"],"sourcesContent":["import { Effect, Layer } from \"effect\";\nimport { SemVer } from \"semver-effect\";\nimport { VersionNotFoundError } from \"../errors/VersionNotFoundError.js\";\nimport type { BunRelease } from \"../schemas/bun-release.js\";\nimport type { Increments } from \"../schemas/common.js\";\nimport { BunReleaseCache } from \"../services/BunReleaseCache.js\";\nimport type { BunResolverOptions } from \"../services/BunResolver.js\";\nimport { BunResolver } from \"../services/BunResolver.js\";\n\n/**\n * Provides the {@link BunResolver} service backed by a {@link BunReleaseCache}.\n *\n * This layer composes with any of the three Bun cache strategy layers to form\n * a complete resolver stack. It implements semver range filtering and increment\n * grouping (latest per major, latest per minor, or all patch versions) using\n * the releases already loaded into the cache.\n *\n * @example\n * ```ts\n * import { BunResolverLive, AutoBunCacheLive, BunVersionFetcherLive, GitHubClientLive, GitHubAutoAuth } from \"runtime-resolver\";\n * import type { ResolvedVersions } from \"runtime-resolver\";\n * import { BunResolver } from \"runtime-resolver\";\n * import { Effect, Layer } from \"effect\";\n *\n * const GitHubLayer = GitHubClientLive.pipe(Layer.provide(GitHubAutoAuth));\n * const CacheLayer = AutoBunCacheLive.pipe(Layer.provide(BunVersionFetcherLive.pipe(Layer.provide(GitHubLayer))));\n * const ResolverLayer = BunResolverLive.pipe(Layer.provide(CacheLayer));\n *\n * const program = Effect.gen(function* () {\n *   const resolver = yield* BunResolver;\n *   const result = yield* resolver.resolve({ semverRange: \"^1.0.0\" });\n *   console.log(result.latest);\n * });\n *\n * Effect.runPromise(program.pipe(Effect.provide(ResolverLayer)));\n * ```\n *\n * @see {@link BunResolver}\n * @see {@link BunReleaseCache}\n * @see {@link AutoBunCacheLive}\n * @see {@link FreshBunCacheLive}\n * @see {@link OfflineBunCacheLive}\n * @public\n */\nexport const BunResolverLive: Layer.Layer<BunResolver, never, BunReleaseCache> = Layer.effect(\n\tBunResolver,\n\tEffect.gen(function* () {\n\t\tconst cache = yield* BunReleaseCache;\n\n\t\treturn {\n\t\t\tresolve: (options?: BunResolverOptions) =>\n\t\t\t\tEffect.gen(function* () {\n\t\t\t\t\tconst semverRange = options?.semverRange ?? \"*\";\n\t\t\t\t\tconst increments: Increments = options?.increments ?? \"latest\";\n\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<BunRelease>)));\n\n\t\t\t\t\tlet resultReleases: BunRelease[];\n\t\t\t\t\tif (increments === \"latest\") {\n\t\t\t\t\t\tconst groups = new Map<number, BunRelease>();\n\t\t\t\t\t\tfor (const r of matching) {\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, BunRelease>();\n\t\t\t\t\t\tfor (const r of matching) {\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 = [...matching];\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: \"bun\",\n\t\t\t\t\t\t\t\tconstraint: semverRange,\n\t\t\t\t\t\t\t\tmessage: `No Bun versions found matching \"${semverRange}\"`,\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 sorted = SemVer.rsort(resultReleases.map((r) => r.version));\n\t\t\t\t\tconst versions = sorted.map((v) => v.toString());\n\t\t\t\t\tconst latest = versions[0];\n\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...(resolvedDefault ? { default: resolvedDefault } : {}),\n\t\t\t\t\t};\n\t\t\t\t}),\n\t\t};\n\t}),\n);\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA4CA,MAAa,kBAAoE,MAAM,OACtF,aACA,OAAO,IAAI,aAAa;CACvB,MAAM,QAAQ,OAAO;CAErB,OAAO,EACN,UAAU,YACT,OAAO,IAAI,aAAa;EACvB,MAAM,cAAc,SAAS,eAAe;EAC5C,MAAM,aAAyB,SAAS,cAAc;EAEtD,MAAM,WAAW,OAAO,MACtB,OAAO,WAAW,CAAC,CACnB,KAAK,OAAO,eAAe,OAAO,QAAQ,CAAC,CAA8B,CAAC,CAAC;EAE7E,IAAI;EACJ,IAAI,eAAe,UAAU;GAC5B,MAAM,yBAAS,IAAI,IAAwB;GAC3C,KAAK,MAAM,KAAK,UAAU;IACzB,MAAM,WAAW,OAAO,IAAI,EAAE,QAAQ,KAAK;IAC3C,IAAI,CAAC,YAAY,OAAO,GAAG,EAAE,SAAS,SAAS,OAAO,GACrD,OAAO,IAAI,EAAE,QAAQ,OAAO,CAAC;GAE/B;GACA,iBAAiB,CAAC,GAAG,OAAO,OAAO,CAAC;EACrC,OAAO,IAAI,eAAe,SAAS;GAClC,MAAM,yBAAS,IAAI,IAAwB;GAC3C,KAAK,MAAM,KAAK,UAAU;IACzB,MAAM,MAAM,GAAG,EAAE,QAAQ,MAAM,GAAG,EAAE,QAAQ;IAC5C,MAAM,WAAW,OAAO,IAAI,GAAG;IAC/B,IAAI,CAAC,YAAY,OAAO,GAAG,EAAE,SAAS,SAAS,OAAO,GACrD,OAAO,IAAI,KAAK,CAAC;GAEnB;GACA,iBAAiB,CAAC,GAAG,OAAO,OAAO,CAAC;EACrC,OACC,iBAAiB,CAAC,GAAG,QAAQ;EAG9B,IAAI,eAAe,WAAW,GAC7B,OAAO,OAAO,OAAO,KACpB,IAAI,qBAAqB;GACxB,SAAS;GACT,YAAY;GACZ,SAAS,mCAAmC,YAAY;EACzD,CAAC,CACF;EAID,MAAM,WADS,OAAO,MAAM,eAAe,KAAK,MAAM,EAAE,OAAO,CACzC,CAAC,CAAC,KAAK,MAAM,EAAE,SAAS,CAAC;EAC/C,MAAM,SAAS,SAAS;EAExB,IAAI;EACJ,IAAI,SAAS,gBACZ,kBAAkB,OAAO,MAAM,QAAQ,QAAQ,cAAc,CAAC,CAAC,KAC9D,OAAO,KAAK,MAAM,EAAE,QAAQ,SAAS,CAAC,GACtC,OAAO,eAAe,OAAO,QAAQ,MAAS,CAAC,CAChD;EAGD,OAAO;GACN,QAAQ;GACR;GACA;GACA,GAAI,kBAAkB,EAAE,SAAS,gBAAgB,IAAI,CAAC;EACvD;CACD,CAAC,EACH;AACD,CAAC,CACF"}

package/layers/BunVersionFetcherLive.js

@@ -0,0 +1,56 @@
+import { BunVersionFetcher } from "../services/BunVersionFetcher.js";
+import { retryOnRateLimit } from "../lib/retry.js";
+import { tryParseSemVer } from "../lib/semver.js";
+import { GitHubClient } from "../services/GitHubClient.js";
+import { Effect, Layer, Option } from "effect";
+
+//#region src/layers/BunVersionFetcherLive.ts
+/**
+* Strip bun- prefix and v/V prefix, parse to SemVer.
+*/
+const normalizeBunTag = (tagName) => {
+	const version = tagName.startsWith("bun-") ? tagName.slice(4) : tagName;
+	return tryParseSemVer(version.startsWith("v") || version.startsWith("V") ? version.slice(1) : version);
+};
+/**
+* Provides the {@link BunVersionFetcher} service using the live GitHub API.
+*
+* Fetches Bun releases from the `oven-sh/bun` GitHub repository using the
+* provided {@link GitHubClient}. Draft releases and pre-releases are excluded.
+* Tag names are normalized by stripping the `bun-` prefix and any leading `v`
+* or `V` before parsing as semver.
+*
+* This layer is a required dependency of {@link AutoBunCacheLive} and
+* {@link FreshBunCacheLive}. It is not needed by {@link OfflineBunCacheLive}.
+*
+* @see {@link BunVersionFetcher}
+* @see {@link GitHubClient}
+* @see {@link AutoBunCacheLive}
+* @see {@link FreshBunCacheLive}
+* @public
+*/
+const BunVersionFetcherLive = Layer.effect(BunVersionFetcher, Effect.gen(function* () {
+	const client = yield* GitHubClient;
+	return { fetch: () => Effect.gen(function* () {
+		const releases = yield* retryOnRateLimit(client.listReleases("oven-sh", "bun", {
+			perPage: 100,
+			pages: 3
+		}));
+		const fallbackDate = (/* @__PURE__ */ new Date()).toISOString().slice(0, 10);
+		const parsed = yield* Effect.forEach(releases.filter((r) => !r.draft && !r.prerelease), (release) => normalizeBunTag(release.tag_name).pipe(Effect.map((opt) => Option.isSome(opt) ? Option.some({
+			version: opt.value,
+			input: {
+				version: opt.value.toString(),
+				date: release.published_at ?? fallbackDate
+			}
+		}) : Option.none())), { concurrency: "unbounded" });
+		return {
+			versions: parsed.flatMap(Option.toArray).map(({ version }) => version),
+			inputs: parsed.flatMap(Option.toArray).map(({ input }) => input)
+		};
+	}) };
+}));
+
+//#endregion
+export { BunVersionFetcherLive };
+//# sourceMappingURL=BunVersionFetcherLive.js.map

package/layers/BunVersionFetcherLive.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"BunVersionFetcherLive.js","names":[],"sources":["../../../../src/layers/BunVersionFetcherLive.ts"],"sourcesContent":["import { Effect, Layer, Option } from \"effect\";\nimport { retryOnRateLimit } from \"../lib/retry.js\";\nimport { tryParseSemVer } from \"../lib/semver.js\";\nimport type { RuntimeReleaseInput } from \"../schemas/runtime-release.js\";\nimport { BunVersionFetcher } from \"../services/BunVersionFetcher.js\";\nimport { GitHubClient } from \"../services/GitHubClient.js\";\n\n/**\n * Strip bun- prefix and v/V prefix, parse to SemVer.\n */\nconst normalizeBunTag = (tagName: string): Effect.Effect<Option.Option<import(\"semver-effect\").SemVer>> => {\n\tconst version = tagName.startsWith(\"bun-\") ? tagName.slice(4) : tagName;\n\tconst stripped = version.startsWith(\"v\") || version.startsWith(\"V\") ? version.slice(1) : version;\n\treturn tryParseSemVer(stripped);\n};\n\n/**\n * Provides the {@link BunVersionFetcher} service using the live GitHub API.\n *\n * Fetches Bun releases from the `oven-sh/bun` GitHub repository using the\n * provided {@link GitHubClient}. Draft releases and pre-releases are excluded.\n * Tag names are normalized by stripping the `bun-` prefix and any leading `v`\n * or `V` before parsing as semver.\n *\n * This layer is a required dependency of {@link AutoBunCacheLive} and\n * {@link FreshBunCacheLive}. It is not needed by {@link OfflineBunCacheLive}.\n *\n * @see {@link BunVersionFetcher}\n * @see {@link GitHubClient}\n * @see {@link AutoBunCacheLive}\n * @see {@link FreshBunCacheLive}\n * @public\n */\nexport const BunVersionFetcherLive: Layer.Layer<BunVersionFetcher, never, GitHubClient> = Layer.effect(\n\tBunVersionFetcher,\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 releases = yield* retryOnRateLimit(client.listReleases(\"oven-sh\", \"bun\", { perPage: 100, pages: 3 }));\n\t\t\t\t\tconst fallbackDate = new Date().toISOString().slice(0, 10);\n\n\t\t\t\t\tconst parsed = yield* Effect.forEach(\n\t\t\t\t\t\treleases.filter((r) => !r.draft && !r.prerelease),\n\t\t\t\t\t\t(release) =>\n\t\t\t\t\t\t\tnormalizeBunTag(release.tag_name).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: opt.value.toString(),\n\t\t\t\t\t\t\t\t\t\t\t\t\tdate: release.published_at ?? fallbackDate,\n\t\t\t\t\t\t\t\t\t\t\t\t} satisfies RuntimeReleaseInput,\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{ 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":";;;;;;;;;;AAUA,MAAM,mBAAmB,YAAkF;CAC1G,MAAM,UAAU,QAAQ,WAAW,MAAM,IAAI,QAAQ,MAAM,CAAC,IAAI;CAEhE,OAAO,eADU,QAAQ,WAAW,GAAG,KAAK,QAAQ,WAAW,GAAG,IAAI,QAAQ,MAAM,CAAC,IAAI,OAC3D;AAC/B;;;;;;;;;;;;;;;;;;AAmBA,MAAa,wBAA6E,MAAM,OAC/F,mBACA,OAAO,IAAI,aAAa;CACvB,MAAM,SAAS,OAAO;CAEtB,OAAO,EACN,aACC,OAAO,IAAI,aAAa;EACvB,MAAM,WAAW,OAAO,iBAAiB,OAAO,aAAa,WAAW,OAAO;GAAE,SAAS;GAAK,OAAO;EAAE,CAAC,CAAC;EAC1G,MAAM,gCAAe,IAAI,KAAK,EAAC,CAAC,YAAY,CAAC,CAAC,MAAM,GAAG,EAAE;EAEzD,MAAM,SAAS,OAAO,OAAO,QAC5B,SAAS,QAAQ,MAAM,CAAC,EAAE,SAAS,CAAC,EAAE,UAAU,IAC/C,YACA,gBAAgB,QAAQ,QAAQ,CAAC,CAAC,KACjC,OAAO,KAAK,QACX,OAAO,OAAO,GAAG,IACd,OAAO,KAAK;GACZ,SAAS,IAAI;GACb,OAAO;IACN,SAAS,IAAI,MAAM,SAAS;IAC5B,MAAM,QAAQ,gBAAgB;GAC/B;EACD,CAAC,IACA,OAAO,KAAK,CAChB,CACD,GACD,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"}

package/layers/DenoReleaseCacheLive.js

@@ -0,0 +1,26 @@
+import { createRuntimeCache } from "./RuntimeCacheLive.js";
+import { DenoReleaseCache } from "../services/DenoReleaseCache.js";
+import { Layer } from "effect";
+
+//#region src/layers/DenoReleaseCacheLive.ts
+/**
+* Low-level layer that constructs the {@link DenoReleaseCache} service backed by
+* a `SemVerVersionCache` instance from `semver-effect`.
+*
+* This layer wires up the cache storage but does not populate it with any
+* release data. Callers are responsible for loading releases after construction.
+* In normal usage you should prefer the higher-level cache strategy layers
+* instead of using this layer directly:
+* - {@link AutoDenoCacheLive} — API with fallback to bundled defaults
+* - {@link FreshDenoCacheLive} — API only, fails if unavailable
+* - {@link OfflineDenoCacheLive} — bundled defaults only
+*
+* @see {@link DenoReleaseCache}
+* @see {@link createRuntimeCache}
+* @internal
+*/
+const DenoReleaseCacheLive = Layer.effect(DenoReleaseCache, createRuntimeCache());
+
+//#endregion
+export { DenoReleaseCacheLive };
+//# sourceMappingURL=DenoReleaseCacheLive.js.map

package/layers/DenoReleaseCacheLive.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"DenoReleaseCacheLive.js","names":[],"sources":["../../../../src/layers/DenoReleaseCacheLive.ts"],"sourcesContent":["import { Layer } from \"effect\";\nimport type { VersionCache as SemVerVersionCache } from \"semver-effect\";\nimport type { DenoRelease } from \"../schemas/deno-release.js\";\nimport { DenoReleaseCache } from \"../services/DenoReleaseCache.js\";\nimport { createRuntimeCache } from \"./RuntimeCacheLive.js\";\n\n/**\n * Low-level layer that constructs the {@link DenoReleaseCache} service backed by\n * a `SemVerVersionCache` instance from `semver-effect`.\n *\n * This layer wires up the cache storage but does not populate it with any\n * release data. Callers are responsible for loading releases after construction.\n * In normal usage you should prefer the higher-level cache strategy layers\n * instead of using this layer directly:\n * - {@link AutoDenoCacheLive} — API with fallback to bundled defaults\n * - {@link FreshDenoCacheLive} — API only, fails if unavailable\n * - {@link OfflineDenoCacheLive} — bundled defaults only\n *\n * @see {@link DenoReleaseCache}\n * @see {@link createRuntimeCache}\n * @internal\n */\nexport const DenoReleaseCacheLive: Layer.Layer<DenoReleaseCache, never, SemVerVersionCache> = Layer.effect(\n\tDenoReleaseCache,\n\tcreateRuntimeCache<DenoRelease>(),\n);\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;AAsBA,MAAa,uBAAiF,MAAM,OACnG,kBACA,mBAAgC,CACjC"}

package/layers/DenoResolverLive.js

@@ -0,0 +1,85 @@
+import { DenoReleaseCache } from "../services/DenoReleaseCache.js";
+import { VersionNotFoundError } from "../errors/VersionNotFoundError.js";
+import { DenoResolver } from "../services/DenoResolver.js";
+import { Effect, Layer } from "effect";
+import { SemVer } from "semver-effect";
+
+//#region src/layers/DenoResolverLive.ts
+/**
+* Provides the {@link DenoResolver} service backed by a {@link DenoReleaseCache}.
+*
+* This layer composes with any of the three Deno cache strategy layers to form
+* a complete resolver stack. It implements semver range filtering and increment
+* grouping (latest per major, latest per minor, or all patch versions) using
+* the releases already loaded into the cache.
+*
+* @example
+* ```ts
+* import { DenoResolverLive, AutoDenoCacheLive, DenoVersionFetcherLive, GitHubClientLive, GitHubAutoAuth } from "runtime-resolver";
+* import { DenoResolver } from "runtime-resolver";
+* import { Effect, Layer } from "effect";
+*
+* const GitHubLayer = GitHubClientLive.pipe(Layer.provide(GitHubAutoAuth));
+* const CacheLayer = AutoDenoCacheLive.pipe(Layer.provide(DenoVersionFetcherLive.pipe(Layer.provide(GitHubLayer))));
+* const ResolverLayer = DenoResolverLive.pipe(Layer.provide(CacheLayer));
+*
+* const program = Effect.gen(function* () {
+*   const resolver = yield* DenoResolver;
+*   const result = yield* resolver.resolve({ semverRange: "^2.0.0" });
+*   console.log(result.latest);
+* });
+*
+* Effect.runPromise(program.pipe(Effect.provide(ResolverLayer)));
+* ```
+*
+* @see {@link DenoResolver}
+* @see {@link DenoReleaseCache}
+* @see {@link AutoDenoCacheLive}
+* @see {@link FreshDenoCacheLive}
+* @see {@link OfflineDenoCacheLive}
+* @public
+*/
+const DenoResolverLive = Layer.effect(DenoResolver, Effect.gen(function* () {
+	const cache = yield* DenoReleaseCache;
+	return { resolve: (options) => Effect.gen(function* () {
+		const semverRange = options?.semverRange ?? "*";
+		const increments = options?.increments ?? "latest";
+		const matching = yield* cache.filter(semverRange).pipe(Effect.catchAll(() => Effect.succeed([])));
+		let resultReleases;
+		if (increments === "latest") {
+			const groups = /* @__PURE__ */ new Map();
+			for (const r of matching) {
+				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 matching) {
+				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 = [...matching];
+		if (resultReleases.length === 0) return yield* Effect.fail(new VersionNotFoundError({
+			runtime: "deno",
+			constraint: semverRange,
+			message: `No Deno versions found matching "${semverRange}"`
+		}));
+		const versions = SemVer.rsort(resultReleases.map((r) => r.version)).map((v) => v.toString());
+		const latest = versions[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,
+			...resolvedDefault ? { default: resolvedDefault } : {}
+		};
+	}) };
+}));
+
+//#endregion
+export { DenoResolverLive };
+//# sourceMappingURL=DenoResolverLive.js.map

package/layers/DenoResolverLive.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"DenoResolverLive.js","names":[],"sources":["../../../../src/layers/DenoResolverLive.ts"],"sourcesContent":["import { Effect, Layer } from \"effect\";\nimport { SemVer } from \"semver-effect\";\nimport { VersionNotFoundError } from \"../errors/VersionNotFoundError.js\";\nimport type { Increments } from \"../schemas/common.js\";\nimport type { DenoRelease } from \"../schemas/deno-release.js\";\nimport { DenoReleaseCache } from \"../services/DenoReleaseCache.js\";\nimport type { DenoResolverOptions } from \"../services/DenoResolver.js\";\nimport { DenoResolver } from \"../services/DenoResolver.js\";\n\n/**\n * Provides the {@link DenoResolver} service backed by a {@link DenoReleaseCache}.\n *\n * This layer composes with any of the three Deno cache strategy layers to form\n * a complete resolver stack. It implements semver range filtering and increment\n * grouping (latest per major, latest per minor, or all patch versions) using\n * the releases already loaded into the cache.\n *\n * @example\n * ```ts\n * import { DenoResolverLive, AutoDenoCacheLive, DenoVersionFetcherLive, GitHubClientLive, GitHubAutoAuth } from \"runtime-resolver\";\n * import { DenoResolver } from \"runtime-resolver\";\n * import { Effect, Layer } from \"effect\";\n *\n * const GitHubLayer = GitHubClientLive.pipe(Layer.provide(GitHubAutoAuth));\n * const CacheLayer = AutoDenoCacheLive.pipe(Layer.provide(DenoVersionFetcherLive.pipe(Layer.provide(GitHubLayer))));\n * const ResolverLayer = DenoResolverLive.pipe(Layer.provide(CacheLayer));\n *\n * const program = Effect.gen(function* () {\n *   const resolver = yield* DenoResolver;\n *   const result = yield* resolver.resolve({ semverRange: \"^2.0.0\" });\n *   console.log(result.latest);\n * });\n *\n * Effect.runPromise(program.pipe(Effect.provide(ResolverLayer)));\n * ```\n *\n * @see {@link DenoResolver}\n * @see {@link DenoReleaseCache}\n * @see {@link AutoDenoCacheLive}\n * @see {@link FreshDenoCacheLive}\n * @see {@link OfflineDenoCacheLive}\n * @public\n */\nexport const DenoResolverLive: Layer.Layer<DenoResolver, never, DenoReleaseCache> = Layer.effect(\n\tDenoResolver,\n\tEffect.gen(function* () {\n\t\tconst cache = yield* DenoReleaseCache;\n\n\t\treturn {\n\t\t\tresolve: (options?: DenoResolverOptions) =>\n\t\t\t\tEffect.gen(function* () {\n\t\t\t\t\tconst semverRange = options?.semverRange ?? \"*\";\n\t\t\t\t\tconst increments: Increments = options?.increments ?? \"latest\";\n\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<DenoRelease>)));\n\n\t\t\t\t\tlet resultReleases: DenoRelease[];\n\t\t\t\t\tif (increments === \"latest\") {\n\t\t\t\t\t\tconst groups = new Map<number, DenoRelease>();\n\t\t\t\t\t\tfor (const r of matching) {\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, DenoRelease>();\n\t\t\t\t\t\tfor (const r of matching) {\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 = [...matching];\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: \"deno\",\n\t\t\t\t\t\t\t\tconstraint: semverRange,\n\t\t\t\t\t\t\t\tmessage: `No Deno versions found matching \"${semverRange}\"`,\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 sorted = SemVer.rsort(resultReleases.map((r) => r.version));\n\t\t\t\t\tconst versions = sorted.map((v) => v.toString());\n\t\t\t\t\tconst latest = versions[0];\n\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...(resolvedDefault ? { default: resolvedDefault } : {}),\n\t\t\t\t\t};\n\t\t\t\t}),\n\t\t};\n\t}),\n);\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA2CA,MAAa,mBAAuE,MAAM,OACzF,cACA,OAAO,IAAI,aAAa;CACvB,MAAM,QAAQ,OAAO;CAErB,OAAO,EACN,UAAU,YACT,OAAO,IAAI,aAAa;EACvB,MAAM,cAAc,SAAS,eAAe;EAC5C,MAAM,aAAyB,SAAS,cAAc;EAEtD,MAAM,WAAW,OAAO,MACtB,OAAO,WAAW,CAAC,CACnB,KAAK,OAAO,eAAe,OAAO,QAAQ,CAAC,CAA+B,CAAC,CAAC;EAE9E,IAAI;EACJ,IAAI,eAAe,UAAU;GAC5B,MAAM,yBAAS,IAAI,IAAyB;GAC5C,KAAK,MAAM,KAAK,UAAU;IACzB,MAAM,WAAW,OAAO,IAAI,EAAE,QAAQ,KAAK;IAC3C,IAAI,CAAC,YAAY,OAAO,GAAG,EAAE,SAAS,SAAS,OAAO,GACrD,OAAO,IAAI,EAAE,QAAQ,OAAO,CAAC;GAE/B;GACA,iBAAiB,CAAC,GAAG,OAAO,OAAO,CAAC;EACrC,OAAO,IAAI,eAAe,SAAS;GAClC,MAAM,yBAAS,IAAI,IAAyB;GAC5C,KAAK,MAAM,KAAK,UAAU;IACzB,MAAM,MAAM,GAAG,EAAE,QAAQ,MAAM,GAAG,EAAE,QAAQ;IAC5C,MAAM,WAAW,OAAO,IAAI,GAAG;IAC/B,IAAI,CAAC,YAAY,OAAO,GAAG,EAAE,SAAS,SAAS,OAAO,GACrD,OAAO,IAAI,KAAK,CAAC;GAEnB;GACA,iBAAiB,CAAC,GAAG,OAAO,OAAO,CAAC;EACrC,OACC,iBAAiB,CAAC,GAAG,QAAQ;EAG9B,IAAI,eAAe,WAAW,GAC7B,OAAO,OAAO,OAAO,KACpB,IAAI,qBAAqB;GACxB,SAAS;GACT,YAAY;GACZ,SAAS,oCAAoC,YAAY;EAC1D,CAAC,CACF;EAID,MAAM,WADS,OAAO,MAAM,eAAe,KAAK,MAAM,EAAE,OAAO,CACzC,CAAC,CAAC,KAAK,MAAM,EAAE,SAAS,CAAC;EAC/C,MAAM,SAAS,SAAS;EAExB,IAAI;EACJ,IAAI,SAAS,gBACZ,kBAAkB,OAAO,MAAM,QAAQ,QAAQ,cAAc,CAAC,CAAC,KAC9D,OAAO,KAAK,MAAM,EAAE,QAAQ,SAAS,CAAC,GACtC,OAAO,eAAe,OAAO,QAAQ,MAAS,CAAC,CAChD;EAGD,OAAO;GACN,QAAQ;GACR;GACA;GACA,GAAI,kBAAkB,EAAE,SAAS,gBAAgB,IAAI,CAAC;EACvD;CACD,CAAC,EACH;AACD,CAAC,CACF"}

package/layers/DenoVersionFetcherLive.js

@@ -0,0 +1,52 @@
+import { DenoVersionFetcher } from "../services/DenoVersionFetcher.js";
+import { retryOnRateLimit } from "../lib/retry.js";
+import { tryParseSemVer } from "../lib/semver.js";
+import { GitHubClient } from "../services/GitHubClient.js";
+import { Effect, Layer, Option } from "effect";
+
+//#region src/layers/DenoVersionFetcherLive.ts
+/**
+* Provides the {@link DenoVersionFetcher} service using the live GitHub API.
+*
+* Fetches Deno releases from the `denoland/deno` GitHub repository using the
+* provided {@link GitHubClient}. Draft releases and pre-releases are excluded.
+* Tag names are normalized by stripping any leading `v` before parsing as
+* semver.
+*
+* This layer is a required dependency of {@link AutoDenoCacheLive} and
+* {@link FreshDenoCacheLive}. It is not needed by {@link OfflineDenoCacheLive}.
+*
+* @see {@link DenoVersionFetcher}
+* @see {@link GitHubClient}
+* @see {@link AutoDenoCacheLive}
+* @see {@link FreshDenoCacheLive}
+* @public
+*/
+const DenoVersionFetcherLive = Layer.effect(DenoVersionFetcher, Effect.gen(function* () {
+	const client = yield* GitHubClient;
+	return { fetch: () => Effect.gen(function* () {
+		const releases = yield* retryOnRateLimit(client.listReleases("denoland", "deno", {
+			perPage: 100,
+			pages: 3
+		}));
+		const fallbackDate = (/* @__PURE__ */ new Date()).toISOString().slice(0, 10);
+		const parsed = yield* Effect.forEach(releases.filter((r) => !r.draft && !r.prerelease), (release) => {
+			const stripped = release.tag_name.startsWith("v") ? release.tag_name.slice(1) : release.tag_name;
+			return tryParseSemVer(stripped).pipe(Effect.map((opt) => Option.isSome(opt) ? Option.some({
+				version: opt.value,
+				input: {
+					version: stripped,
+					date: release.published_at ?? fallbackDate
+				}
+			}) : Option.none()));
+		}, { concurrency: "unbounded" });
+		return {
+			versions: parsed.flatMap(Option.toArray).map(({ version }) => version),
+			inputs: parsed.flatMap(Option.toArray).map(({ input }) => input)
+		};
+	}) };
+}));
+
+//#endregion
+export { DenoVersionFetcherLive };
+//# sourceMappingURL=DenoVersionFetcherLive.js.map

package/layers/DenoVersionFetcherLive.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"DenoVersionFetcherLive.js","names":[],"sources":["../../../../src/layers/DenoVersionFetcherLive.ts"],"sourcesContent":["import { Effect, Layer, Option } from \"effect\";\nimport { retryOnRateLimit } from \"../lib/retry.js\";\nimport { tryParseSemVer } from \"../lib/semver.js\";\nimport type { RuntimeReleaseInput } from \"../schemas/runtime-release.js\";\nimport { DenoVersionFetcher } from \"../services/DenoVersionFetcher.js\";\nimport { GitHubClient } from \"../services/GitHubClient.js\";\n\n/**\n * Provides the {@link DenoVersionFetcher} service using the live GitHub API.\n *\n * Fetches Deno releases from the `denoland/deno` GitHub repository using the\n * provided {@link GitHubClient}. Draft releases and pre-releases are excluded.\n * Tag names are normalized by stripping any leading `v` before parsing as\n * semver.\n *\n * This layer is a required dependency of {@link AutoDenoCacheLive} and\n * {@link FreshDenoCacheLive}. It is not needed by {@link OfflineDenoCacheLive}.\n *\n * @see {@link DenoVersionFetcher}\n * @see {@link GitHubClient}\n * @see {@link AutoDenoCacheLive}\n * @see {@link FreshDenoCacheLive}\n * @public\n */\nexport const DenoVersionFetcherLive: Layer.Layer<DenoVersionFetcher, never, GitHubClient> = Layer.effect(\n\tDenoVersionFetcher,\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 releases = yield* retryOnRateLimit(client.listReleases(\"denoland\", \"deno\", { perPage: 100, pages: 3 }));\n\t\t\t\t\tconst fallbackDate = new Date().toISOString().slice(0, 10);\n\n\t\t\t\t\tconst parsed = yield* Effect.forEach(\n\t\t\t\t\t\treleases.filter((r) => !r.draft && !r.prerelease),\n\t\t\t\t\t\t(release) => {\n\t\t\t\t\t\t\tconst stripped = release.tag_name.startsWith(\"v\") ? release.tag_name.slice(1) : release.tag_name;\n\t\t\t\t\t\t\treturn tryParseSemVer(stripped).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: stripped,\n\t\t\t\t\t\t\t\t\t\t\t\t\tdate: release.published_at ?? fallbackDate,\n\t\t\t\t\t\t\t\t\t\t\t\t} satisfies RuntimeReleaseInput,\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":";;;;;;;;;;;;;;;;;;;;;;;;AAwBA,MAAa,yBAA+E,MAAM,OACjG,oBACA,OAAO,IAAI,aAAa;CACvB,MAAM,SAAS,OAAO;CAEtB,OAAO,EACN,aACC,OAAO,IAAI,aAAa;EACvB,MAAM,WAAW,OAAO,iBAAiB,OAAO,aAAa,YAAY,QAAQ;GAAE,SAAS;GAAK,OAAO;EAAE,CAAC,CAAC;EAC5G,MAAM,gCAAe,IAAI,KAAK,EAAC,CAAC,YAAY,CAAC,CAAC,MAAM,GAAG,EAAE;EAEzD,MAAM,SAAS,OAAO,OAAO,QAC5B,SAAS,QAAQ,MAAM,CAAC,EAAE,SAAS,CAAC,EAAE,UAAU,IAC/C,YAAY;GACZ,MAAM,WAAW,QAAQ,SAAS,WAAW,GAAG,IAAI,QAAQ,SAAS,MAAM,CAAC,IAAI,QAAQ;GACxF,OAAO,eAAe,QAAQ,CAAC,CAAC,KAC/B,OAAO,KAAK,QACX,OAAO,OAAO,GAAG,IACd,OAAO,KAAK;IACZ,SAAS,IAAI;IACb,OAAO;KACN,SAAS;KACT,MAAM,QAAQ,gBAAgB;IAC/B;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"}

package/layers/FreshBunCacheLive.js

@@ -0,0 +1,61 @@
+import { BunRelease } from "../schemas/bun-release.js";
+import { BunReleaseCache } from "../services/BunReleaseCache.js";
+import { BunVersionFetcher } from "../services/BunVersionFetcher.js";
+import { BunReleaseCacheLive } from "./BunReleaseCacheLive.js";
+import { FreshnessError } from "../errors/FreshnessError.js";
+import { Effect, Layer } from "effect";
+import { SemVerParserLive, VersionCacheLive } from "semver-effect";
+
+//#region src/layers/FreshBunCacheLive.ts
+const freshSetup = Effect.gen(function* () {
+	const cache = yield* BunReleaseCache;
+	const { inputs } = yield* (yield* BunVersionFetcher).fetch().pipe(Effect.catchTags({
+		AuthenticationError: (err) => Effect.fail(new FreshnessError({
+			strategy: "api",
+			message: `Fresh data required but authentication failed: ${err.message}`
+		})),
+		NetworkError: (err) => Effect.fail(new FreshnessError({
+			strategy: "api",
+			message: `Fresh data required but network unavailable: ${err.message}`
+		})),
+		ParseError: (err) => Effect.fail(new FreshnessError({
+			strategy: "api",
+			message: `Fresh data required but parse failed: ${err.message}`
+		})),
+		RateLimitError: (err) => Effect.fail(new FreshnessError({
+			strategy: "api",
+			message: `Fresh data required but rate limit exceeded: ${err.message}`
+		}))
+	}));
+	const releases = yield* Effect.all(inputs.map((input) => BunRelease.fromInput(input)), { concurrency: "unbounded" }).pipe(Effect.orElseSucceed(() => []));
+	yield* cache.load(releases);
+});
+const SemVerLayer = VersionCacheLive.pipe(Layer.provide(SemVerParserLive));
+const BaseCacheLayer = BunReleaseCacheLive.pipe(Layer.provide(SemVerLayer));
+/**
+* Provides the {@link BunReleaseCache} service using the "Fresh" cache strategy.
+*
+* Requires live release data from the GitHub API via {@link BunVersionFetcher}.
+* If the fetch fails for any reason — authentication errors, network errors,
+* parse errors, or rate-limit errors — the layer fails with a `FreshnessError`
+* rather than falling back to stale data.
+*
+* Use this strategy in contexts where working with outdated version data would
+* be incorrect or misleading, such as CI pipelines or tooling that must reflect
+* the true current state of Bun releases.
+*
+* The three Bun cache strategy layers are:
+* - {@link AutoBunCacheLive} — tries API first, falls back to bundled defaults on any error
+* - `FreshBunCacheLive` — requires live API data, fails with `FreshnessError` if unavailable
+* - {@link OfflineBunCacheLive} — uses only bundled defaults, no network I/O
+*
+* @see {@link BunReleaseCache}
+* @see {@link AutoBunCacheLive}
+* @see {@link OfflineBunCacheLive}
+* @public
+*/
+const FreshBunCacheLive = BaseCacheLayer.pipe(Layer.tap((ctx) => freshSetup.pipe(Effect.provide(ctx))));
+
+//#endregion
+export { FreshBunCacheLive };
+//# sourceMappingURL=FreshBunCacheLive.js.map

package/layers/FreshBunCacheLive.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"FreshBunCacheLive.js","names":["SemVerVersionCacheLive"],"sources":["../../../../src/layers/FreshBunCacheLive.ts"],"sourcesContent":["import { Effect, Layer } from \"effect\";\nimport { SemVerParserLive, VersionCacheLive as SemVerVersionCacheLive } from \"semver-effect\";\nimport { FreshnessError } from \"../errors/FreshnessError.js\";\nimport { BunRelease } from \"../schemas/bun-release.js\";\nimport { BunReleaseCache } from \"../services/BunReleaseCache.js\";\nimport { BunVersionFetcher } from \"../services/BunVersionFetcher.js\";\nimport { BunReleaseCacheLive } from \"./BunReleaseCacheLive.js\";\n\nconst freshSetup = Effect.gen(function* () {\n\tconst cache = yield* BunReleaseCache;\n\tconst fetcher = yield* BunVersionFetcher;\n\n\tconst { inputs } = yield* fetcher.fetch().pipe(\n\t\tEffect.catchTags({\n\t\t\tAuthenticationError: (err) =>\n\t\t\t\tEffect.fail(\n\t\t\t\t\tnew FreshnessError({\n\t\t\t\t\t\tstrategy: \"api\",\n\t\t\t\t\t\tmessage: `Fresh data required but authentication failed: ${err.message}`,\n\t\t\t\t\t}),\n\t\t\t\t),\n\t\t\tNetworkError: (err) =>\n\t\t\t\tEffect.fail(\n\t\t\t\t\tnew FreshnessError({\n\t\t\t\t\t\tstrategy: \"api\",\n\t\t\t\t\t\tmessage: `Fresh data required but network unavailable: ${err.message}`,\n\t\t\t\t\t}),\n\t\t\t\t),\n\t\t\tParseError: (err) =>\n\t\t\t\tEffect.fail(\n\t\t\t\t\tnew FreshnessError({ strategy: \"api\", message: `Fresh data required but parse failed: ${err.message}` }),\n\t\t\t\t),\n\t\t\tRateLimitError: (err) =>\n\t\t\t\tEffect.fail(\n\t\t\t\t\tnew FreshnessError({\n\t\t\t\t\t\tstrategy: \"api\",\n\t\t\t\t\t\tmessage: `Fresh data required but rate limit exceeded: ${err.message}`,\n\t\t\t\t\t}),\n\t\t\t\t),\n\t\t}),\n\t);\n\n\tconst releases = yield* Effect.all(\n\t\tinputs.map((input) => BunRelease.fromInput(input)),\n\t\t{ concurrency: \"unbounded\" },\n\t).pipe(Effect.orElseSucceed(() => [] as BunRelease[]));\n\tyield* cache.load(releases);\n});\n\nconst SemVerLayer = SemVerVersionCacheLive.pipe(Layer.provide(SemVerParserLive));\nconst BaseCacheLayer = BunReleaseCacheLive.pipe(Layer.provide(SemVerLayer));\n\n/**\n * Provides the {@link BunReleaseCache} service using the \"Fresh\" cache strategy.\n *\n * Requires live release data from the GitHub API via {@link BunVersionFetcher}.\n * If the fetch fails for any reason — authentication errors, network errors,\n * parse errors, or rate-limit errors — the layer fails with a `FreshnessError`\n * rather than falling back to stale data.\n *\n * Use this strategy in contexts where working with outdated version data would\n * be incorrect or misleading, such as CI pipelines or tooling that must reflect\n * the true current state of Bun releases.\n *\n * The three Bun cache strategy layers are:\n * - {@link AutoBunCacheLive} — tries API first, falls back to bundled defaults on any error\n * - `FreshBunCacheLive` — requires live API data, fails with `FreshnessError` if unavailable\n * - {@link OfflineBunCacheLive} — uses only bundled defaults, no network I/O\n *\n * @see {@link BunReleaseCache}\n * @see {@link AutoBunCacheLive}\n * @see {@link OfflineBunCacheLive}\n * @public\n */\nexport const FreshBunCacheLive: Layer.Layer<BunReleaseCache, FreshnessError, BunVersionFetcher> = BaseCacheLayer.pipe(\n\tLayer.tap((ctx) => freshSetup.pipe(Effect.provide(ctx))),\n);\n"],"mappings":";;;;;;;;;AAQA,MAAM,aAAa,OAAO,IAAI,aAAa;CAC1C,MAAM,QAAQ,OAAO;CAGrB,MAAM,EAAE,WAAW,QAAO,OAFH,kBAEU,CAAC,MAAM,CAAC,CAAC,KACzC,OAAO,UAAU;EAChB,sBAAsB,QACrB,OAAO,KACN,IAAI,eAAe;GAClB,UAAU;GACV,SAAS,kDAAkD,IAAI;EAChE,CAAC,CACF;EACD,eAAe,QACd,OAAO,KACN,IAAI,eAAe;GAClB,UAAU;GACV,SAAS,gDAAgD,IAAI;EAC9D,CAAC,CACF;EACD,aAAa,QACZ,OAAO,KACN,IAAI,eAAe;GAAE,UAAU;GAAO,SAAS,yCAAyC,IAAI;EAAU,CAAC,CACxG;EACD,iBAAiB,QAChB,OAAO,KACN,IAAI,eAAe;GAClB,UAAU;GACV,SAAS,gDAAgD,IAAI;EAC9D,CAAC,CACF;CACF,CAAC,CACF;CAEA,MAAM,WAAW,OAAO,OAAO,IAC9B,OAAO,KAAK,UAAU,WAAW,UAAU,KAAK,CAAC,GACjD,EAAE,aAAa,YAAY,CAC5B,CAAC,CAAC,KAAK,OAAO,oBAAoB,CAAC,CAAiB,CAAC;CACrD,OAAO,MAAM,KAAK,QAAQ;AAC3B,CAAC;AAED,MAAM,cAAcA,iBAAuB,KAAK,MAAM,QAAQ,gBAAgB,CAAC;AAC/E,MAAM,iBAAiB,oBAAoB,KAAK,MAAM,QAAQ,WAAW,CAAC;;;;;;;;;;;;;;;;;;;;;;;AAwB1E,MAAa,oBAAqF,eAAe,KAChH,MAAM,KAAK,QAAQ,WAAW,KAAK,OAAO,QAAQ,GAAG,CAAC,CAAC,CACxD"}

package/layers/FreshDenoCacheLive.js

@@ -0,0 +1,61 @@
+import { DenoRelease } from "../schemas/deno-release.js";
+import { DenoReleaseCache } from "../services/DenoReleaseCache.js";
+import { DenoVersionFetcher } from "../services/DenoVersionFetcher.js";
+import { DenoReleaseCacheLive } from "./DenoReleaseCacheLive.js";
+import { FreshnessError } from "../errors/FreshnessError.js";
+import { Effect, Layer } from "effect";
+import { SemVerParserLive, VersionCacheLive } from "semver-effect";
+
+//#region src/layers/FreshDenoCacheLive.ts
+const freshSetup = Effect.gen(function* () {
+	const cache = yield* DenoReleaseCache;
+	const { inputs } = yield* (yield* DenoVersionFetcher).fetch().pipe(Effect.catchTags({
+		AuthenticationError: (err) => Effect.fail(new FreshnessError({
+			strategy: "api",
+			message: `Fresh data required but authentication failed: ${err.message}`
+		})),
+		NetworkError: (err) => Effect.fail(new FreshnessError({
+			strategy: "api",
+			message: `Fresh data required but network unavailable: ${err.message}`
+		})),
+		ParseError: (err) => Effect.fail(new FreshnessError({
+			strategy: "api",
+			message: `Fresh data required but parse failed: ${err.message}`
+		})),
+		RateLimitError: (err) => Effect.fail(new FreshnessError({
+			strategy: "api",
+			message: `Fresh data required but rate limit exceeded: ${err.message}`
+		}))
+	}));
+	const releases = yield* Effect.all(inputs.map((input) => DenoRelease.fromInput(input)), { concurrency: "unbounded" }).pipe(Effect.orElseSucceed(() => []));
+	yield* cache.load(releases);
+});
+const SemVerLayer = VersionCacheLive.pipe(Layer.provide(SemVerParserLive));
+const BaseCacheLayer = DenoReleaseCacheLive.pipe(Layer.provide(SemVerLayer));
+/**
+* Provides the {@link DenoReleaseCache} service using the "Fresh" cache strategy.
+*
+* Requires live release data from the GitHub API via {@link DenoVersionFetcher}.
+* If the fetch fails for any reason — authentication errors, network errors,
+* parse errors, or rate-limit errors — the layer fails with a `FreshnessError`
+* rather than falling back to stale data.
+*
+* Use this strategy in contexts where working with outdated version data would
+* be incorrect or misleading, such as CI pipelines or tooling that must reflect
+* the true current state of Deno releases.
+*
+* The three Deno cache strategy layers are:
+* - {@link AutoDenoCacheLive} — tries API first, falls back to bundled defaults on any error
+* - `FreshDenoCacheLive` — requires live API data, fails with `FreshnessError` if unavailable
+* - {@link OfflineDenoCacheLive} — uses only bundled defaults, no network I/O
+*
+* @see {@link DenoReleaseCache}
+* @see {@link AutoDenoCacheLive}
+* @see {@link OfflineDenoCacheLive}
+* @public
+*/
+const FreshDenoCacheLive = BaseCacheLayer.pipe(Layer.tap((ctx) => freshSetup.pipe(Effect.provide(ctx))));
+
+//#endregion
+export { FreshDenoCacheLive };
+//# sourceMappingURL=FreshDenoCacheLive.js.map

package/layers/FreshDenoCacheLive.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"FreshDenoCacheLive.js","names":["SemVerVersionCacheLive"],"sources":["../../../../src/layers/FreshDenoCacheLive.ts"],"sourcesContent":["import { Effect, Layer } from \"effect\";\nimport { SemVerParserLive, VersionCacheLive as SemVerVersionCacheLive } from \"semver-effect\";\nimport { FreshnessError } from \"../errors/FreshnessError.js\";\nimport { DenoRelease } from \"../schemas/deno-release.js\";\nimport { DenoReleaseCache } from \"../services/DenoReleaseCache.js\";\nimport { DenoVersionFetcher } from \"../services/DenoVersionFetcher.js\";\nimport { DenoReleaseCacheLive } from \"./DenoReleaseCacheLive.js\";\n\nconst freshSetup = Effect.gen(function* () {\n\tconst cache = yield* DenoReleaseCache;\n\tconst fetcher = yield* DenoVersionFetcher;\n\n\tconst { inputs } = yield* fetcher.fetch().pipe(\n\t\tEffect.catchTags({\n\t\t\tAuthenticationError: (err) =>\n\t\t\t\tEffect.fail(\n\t\t\t\t\tnew FreshnessError({\n\t\t\t\t\t\tstrategy: \"api\",\n\t\t\t\t\t\tmessage: `Fresh data required but authentication failed: ${err.message}`,\n\t\t\t\t\t}),\n\t\t\t\t),\n\t\t\tNetworkError: (err) =>\n\t\t\t\tEffect.fail(\n\t\t\t\t\tnew FreshnessError({\n\t\t\t\t\t\tstrategy: \"api\",\n\t\t\t\t\t\tmessage: `Fresh data required but network unavailable: ${err.message}`,\n\t\t\t\t\t}),\n\t\t\t\t),\n\t\t\tParseError: (err) =>\n\t\t\t\tEffect.fail(\n\t\t\t\t\tnew FreshnessError({ strategy: \"api\", message: `Fresh data required but parse failed: ${err.message}` }),\n\t\t\t\t),\n\t\t\tRateLimitError: (err) =>\n\t\t\t\tEffect.fail(\n\t\t\t\t\tnew FreshnessError({\n\t\t\t\t\t\tstrategy: \"api\",\n\t\t\t\t\t\tmessage: `Fresh data required but rate limit exceeded: ${err.message}`,\n\t\t\t\t\t}),\n\t\t\t\t),\n\t\t}),\n\t);\n\n\tconst releases = yield* Effect.all(\n\t\tinputs.map((input) => DenoRelease.fromInput(input)),\n\t\t{ concurrency: \"unbounded\" },\n\t).pipe(Effect.orElseSucceed(() => [] as DenoRelease[]));\n\tyield* cache.load(releases);\n});\n\nconst SemVerLayer = SemVerVersionCacheLive.pipe(Layer.provide(SemVerParserLive));\nconst BaseCacheLayer = DenoReleaseCacheLive.pipe(Layer.provide(SemVerLayer));\n\n/**\n * Provides the {@link DenoReleaseCache} service using the \"Fresh\" cache strategy.\n *\n * Requires live release data from the GitHub API via {@link DenoVersionFetcher}.\n * If the fetch fails for any reason — authentication errors, network errors,\n * parse errors, or rate-limit errors — the layer fails with a `FreshnessError`\n * rather than falling back to stale data.\n *\n * Use this strategy in contexts where working with outdated version data would\n * be incorrect or misleading, such as CI pipelines or tooling that must reflect\n * the true current state of Deno releases.\n *\n * The three Deno cache strategy layers are:\n * - {@link AutoDenoCacheLive} — tries API first, falls back to bundled defaults on any error\n * - `FreshDenoCacheLive` — requires live API data, fails with `FreshnessError` if unavailable\n * - {@link OfflineDenoCacheLive} — uses only bundled defaults, no network I/O\n *\n * @see {@link DenoReleaseCache}\n * @see {@link AutoDenoCacheLive}\n * @see {@link OfflineDenoCacheLive}\n * @public\n */\nexport const FreshDenoCacheLive: Layer.Layer<DenoReleaseCache, FreshnessError, DenoVersionFetcher> =\n\tBaseCacheLayer.pipe(Layer.tap((ctx) => freshSetup.pipe(Effect.provide(ctx))));\n"],"mappings":";;;;;;;;;AAQA,MAAM,aAAa,OAAO,IAAI,aAAa;CAC1C,MAAM,QAAQ,OAAO;CAGrB,MAAM,EAAE,WAAW,QAAO,OAFH,mBAEU,CAAC,MAAM,CAAC,CAAC,KACzC,OAAO,UAAU;EAChB,sBAAsB,QACrB,OAAO,KACN,IAAI,eAAe;GAClB,UAAU;GACV,SAAS,kDAAkD,IAAI;EAChE,CAAC,CACF;EACD,eAAe,QACd,OAAO,KACN,IAAI,eAAe;GAClB,UAAU;GACV,SAAS,gDAAgD,IAAI;EAC9D,CAAC,CACF;EACD,aAAa,QACZ,OAAO,KACN,IAAI,eAAe;GAAE,UAAU;GAAO,SAAS,yCAAyC,IAAI;EAAU,CAAC,CACxG;EACD,iBAAiB,QAChB,OAAO,KACN,IAAI,eAAe;GAClB,UAAU;GACV,SAAS,gDAAgD,IAAI;EAC9D,CAAC,CACF;CACF,CAAC,CACF;CAEA,MAAM,WAAW,OAAO,OAAO,IAC9B,OAAO,KAAK,UAAU,YAAY,UAAU,KAAK,CAAC,GAClD,EAAE,aAAa,YAAY,CAC5B,CAAC,CAAC,KAAK,OAAO,oBAAoB,CAAC,CAAkB,CAAC;CACtD,OAAO,MAAM,KAAK,QAAQ;AAC3B,CAAC;AAED,MAAM,cAAcA,iBAAuB,KAAK,MAAM,QAAQ,gBAAgB,CAAC;AAC/E,MAAM,iBAAiB,qBAAqB,KAAK,MAAM,QAAQ,WAAW,CAAC;;;;;;;;;;;;;;;;;;;;;;;AAwB3E,MAAa,qBACZ,eAAe,KAAK,MAAM,KAAK,QAAQ,WAAW,KAAK,OAAO,QAAQ,GAAG,CAAC,CAAC,CAAC"}

package/layers/FreshNodeCacheLive.js

@@ -0,0 +1,56 @@
+import { NodeReleaseCache } from "../services/NodeReleaseCache.js";
+import { NodeScheduleFetcher } from "../services/NodeScheduleFetcher.js";
+import { NodeVersionFetcher } from "../services/NodeVersionFetcher.js";
+import { NodeReleaseCacheLive } from "./NodeReleaseCacheLive.js";
+import { FreshnessError } from "../errors/FreshnessError.js";
+import { Effect, Layer } from "effect";
+import { SemVerParserLive, VersionCacheLive } from "semver-effect";
+
+//#region src/layers/FreshNodeCacheLive.ts
+const freshSetup = Effect.gen(function* () {
+	const cache = yield* NodeReleaseCache;
+	const versionFetcher = yield* NodeVersionFetcher;
+	const scheduleFetcher = yield* NodeScheduleFetcher;
+	const [fetchResult, scheduleData] = yield* Effect.all([versionFetcher.fetch(), scheduleFetcher.fetch()]).pipe(Effect.catchTags({
+		NetworkError: (err) => Effect.fail(new FreshnessError({
+			strategy: "api",
+			message: `Fresh data required but network unavailable: ${err.message}`
+		})),
+		ParseError: (err) => Effect.fail(new FreshnessError({
+			strategy: "api",
+			message: `Fresh data required but response could not be parsed: ${err.message}`
+		}))
+	}));
+	yield* cache.updateSchedule(scheduleData);
+	yield* cache.loadFromInputs(fetchResult.inputs);
+});
+const SemVerLayer = VersionCacheLive.pipe(Layer.provide(SemVerParserLive));
+const BaseCacheLayer = NodeReleaseCacheLive.pipe(Layer.provide(SemVerLayer));
+/**
+* Provides the {@link NodeReleaseCache} service using the "Fresh" cache strategy.
+*
+* Requires live release data from `nodejs.org/dist/index.json` via
+* {@link NodeVersionFetcher} and the release schedule from the `nodejs/Release`
+* repository via {@link NodeScheduleFetcher}. If either fetch fails — due to
+* network errors or parse errors — the layer fails with a `FreshnessError`
+* rather than falling back to stale data.
+*
+* Use this strategy in contexts where working with outdated version data would
+* be incorrect or misleading, such as CI pipelines or tooling that must reflect
+* the true current state of Node.js releases and LTS schedule.
+*
+* The three Node cache strategy layers are:
+* - {@link AutoNodeCacheLive} — tries API first, falls back to bundled defaults on any error
+* - `FreshNodeCacheLive` — requires live API data, fails with `FreshnessError` if unavailable
+* - {@link OfflineNodeCacheLive} — uses only bundled defaults, no network I/O
+*
+* @see {@link NodeReleaseCache}
+* @see {@link AutoNodeCacheLive}
+* @see {@link OfflineNodeCacheLive}
+* @public
+*/
+const FreshNodeCacheLive = BaseCacheLayer.pipe(Layer.tap((ctx) => freshSetup.pipe(Effect.provide(ctx))));
+
+//#endregion
+export { FreshNodeCacheLive };
+//# sourceMappingURL=FreshNodeCacheLive.js.map

package/layers/FreshNodeCacheLive.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"FreshNodeCacheLive.js","names":["SemVerVersionCacheLive"],"sources":["../../../../src/layers/FreshNodeCacheLive.ts"],"sourcesContent":["import { Effect, Layer } from \"effect\";\nimport { SemVerParserLive, VersionCacheLive as SemVerVersionCacheLive } from \"semver-effect\";\nimport { FreshnessError } from \"../errors/FreshnessError.js\";\nimport { NodeReleaseCache } from \"../services/NodeReleaseCache.js\";\nimport { NodeScheduleFetcher } from \"../services/NodeScheduleFetcher.js\";\nimport { NodeVersionFetcher } from \"../services/NodeVersionFetcher.js\";\nimport { NodeReleaseCacheLive } from \"./NodeReleaseCacheLive.js\";\n\nconst freshSetup = Effect.gen(function* () {\n\tconst cache = yield* NodeReleaseCache;\n\tconst versionFetcher = yield* NodeVersionFetcher;\n\tconst scheduleFetcher = yield* NodeScheduleFetcher;\n\n\tconst [fetchResult, scheduleData] = yield* Effect.all([versionFetcher.fetch(), scheduleFetcher.fetch()]).pipe(\n\t\tEffect.catchTags({\n\t\t\tNetworkError: (err) =>\n\t\t\t\tEffect.fail(\n\t\t\t\t\tnew FreshnessError({\n\t\t\t\t\t\tstrategy: \"api\",\n\t\t\t\t\t\tmessage: `Fresh data required but network unavailable: ${err.message}`,\n\t\t\t\t\t}),\n\t\t\t\t),\n\t\t\tParseError: (err) =>\n\t\t\t\tEffect.fail(\n\t\t\t\t\tnew FreshnessError({\n\t\t\t\t\t\tstrategy: \"api\",\n\t\t\t\t\t\tmessage: `Fresh data required but response could not be parsed: ${err.message}`,\n\t\t\t\t\t}),\n\t\t\t\t),\n\t\t}),\n\t);\n\n\tyield* cache.updateSchedule(scheduleData);\n\tyield* cache.loadFromInputs(fetchResult.inputs);\n});\n\nconst SemVerLayer = SemVerVersionCacheLive.pipe(Layer.provide(SemVerParserLive));\nconst BaseCacheLayer = NodeReleaseCacheLive.pipe(Layer.provide(SemVerLayer));\n\n/**\n * Provides the {@link NodeReleaseCache} service using the \"Fresh\" cache strategy.\n *\n * Requires live release data from `nodejs.org/dist/index.json` via\n * {@link NodeVersionFetcher} and the release schedule from the `nodejs/Release`\n * repository via {@link NodeScheduleFetcher}. If either fetch fails — due to\n * network errors or parse errors — the layer fails with a `FreshnessError`\n * rather than falling back to stale data.\n *\n * Use this strategy in contexts where working with outdated version data would\n * be incorrect or misleading, such as CI pipelines or tooling that must reflect\n * the true current state of Node.js releases and LTS schedule.\n *\n * The three Node cache strategy layers are:\n * - {@link AutoNodeCacheLive} — tries API first, falls back to bundled defaults on any error\n * - `FreshNodeCacheLive` — requires live API data, fails with `FreshnessError` if unavailable\n * - {@link OfflineNodeCacheLive} — uses only bundled defaults, no network I/O\n *\n * @see {@link NodeReleaseCache}\n * @see {@link AutoNodeCacheLive}\n * @see {@link OfflineNodeCacheLive}\n * @public\n */\nexport const FreshNodeCacheLive: Layer.Layer<\n\tNodeReleaseCache,\n\tFreshnessError,\n\tNodeVersionFetcher | NodeScheduleFetcher\n> = BaseCacheLayer.pipe(Layer.tap((ctx) => freshSetup.pipe(Effect.provide(ctx))));\n"],"mappings":";;;;;;;;;AAQA,MAAM,aAAa,OAAO,IAAI,aAAa;CAC1C,MAAM,QAAQ,OAAO;CACrB,MAAM,iBAAiB,OAAO;CAC9B,MAAM,kBAAkB,OAAO;CAE/B,MAAM,CAAC,aAAa,gBAAgB,OAAO,OAAO,IAAI,CAAC,eAAe,MAAM,GAAG,gBAAgB,MAAM,CAAC,CAAC,CAAC,CAAC,KACxG,OAAO,UAAU;EAChB,eAAe,QACd,OAAO,KACN,IAAI,eAAe;GAClB,UAAU;GACV,SAAS,gDAAgD,IAAI;EAC9D,CAAC,CACF;EACD,aAAa,QACZ,OAAO,KACN,IAAI,eAAe;GAClB,UAAU;GACV,SAAS,yDAAyD,IAAI;EACvE,CAAC,CACF;CACF,CAAC,CACF;CAEA,OAAO,MAAM,eAAe,YAAY;CACxC,OAAO,MAAM,eAAe,YAAY,MAAM;AAC/C,CAAC;AAED,MAAM,cAAcA,iBAAuB,KAAK,MAAM,QAAQ,gBAAgB,CAAC;AAC/E,MAAM,iBAAiB,qBAAqB,KAAK,MAAM,QAAQ,WAAW,CAAC;;;;;;;;;;;;;;;;;;;;;;;;AAyB3E,MAAa,qBAIT,eAAe,KAAK,MAAM,KAAK,QAAQ,WAAW,KAAK,OAAO,QAAQ,GAAG,CAAC,CAAC,CAAC"}

package/layers/GitHubAppAuth.js

@@ -0,0 +1,59 @@
+import { OctokitInstance } from "../services/OctokitInstance.js";
+import { AuthenticationError } from "../errors/AuthenticationError.js";
+import { Effect, Layer } from "effect";
+import { Octokit } from "octokit";
+import { createAppAuth } from "@octokit/auth-app";
+
+//#region src/layers/GitHubAppAuth.ts
+const resolveInstallationId = async (auth, installationId) => {
+	if (installationId) return installationId;
+	const { token: jwt } = await auth({ type: "app" });
+	const response = await fetch("https://api.github.com/app/installations?per_page=100", { headers: {
+		Authorization: `Bearer ${jwt}`,
+		Accept: "application/vnd.github+json"
+	} });
+	if (!response.ok) throw new Error(`Failed to list installations: ${response.status}`);
+	const installations = await response.json();
+	if (installations.length === 0) throw new Error("No installations found for this GitHub App");
+	return installations[0].id;
+};
+/**
+* Provides an {@link OctokitInstance} authenticated as a GitHub App installation.
+*
+* Accepts a {@link GitHubAppAuthConfig} and uses `@octokit/auth-app` to obtain
+* an installation access token. If `installationId` is omitted, the first
+* installation returned by the GitHub API is used automatically (suitable for
+* apps with a single installation). If authentication fails for any reason the
+* layer fails with an `AuthenticationError`.
+*
+* Use this auth method when your integration runs as a GitHub App rather than
+* as an individual user or a CI token.
+*
+* @param config - App credentials and optional installation ID.
+*
+* @see {@link GitHubAppAuthConfig}
+* @see {@link OctokitInstance}
+* @see {@link GitHubAutoAuth}
+* @see {@link GitHubTokenAuth}
+* @public
+*/
+const GitHubAppAuth = (config) => Layer.effect(OctokitInstance, Effect.tryPromise({
+	try: async () => {
+		const auth = createAppAuth({
+			appId: config.appId,
+			privateKey: config.privateKey
+		});
+		return new Octokit({ auth: (await auth({
+			type: "installation",
+			installationId: await resolveInstallationId(auth, config.installationId)
+		})).token });
+	},
+	catch: (error) => new AuthenticationError({
+		method: "app",
+		message: error instanceof Error ? error.message : String(error)
+	})
+}));
+
+//#endregion
+export { GitHubAppAuth };
+//# sourceMappingURL=GitHubAppAuth.js.map