import type { Url } from "@alchemy.run/redis";
import * as Binding from "alchemy/Binding";
import type { Resource } from "alchemy/Resource";
import * as Config from "effect/Config";
import * as Effect from "effect/Effect";
import * as Redacted from "effect/Redacted";
import type { ServiceBinding } from "./MountVolume.ts";
import { REDIS_URL_ENV, RedisUrlMissing, type Redis } from "./Redis.ts";
/**
* Shared scaffolding for Upstash Redis bindings.
*
* Each `{Op}Http.ts` is a thin `Layer.effect` over {@link makeRedisBinding}.
* Deploy-time registers the Redis add-on on the host so Service reconcile
* can attach it. The URL travels as `yield* redis.url` (RuntimeContext
* set/get). `REDIS_URL` written as an App secret is a fallback, not the
* primary path.
*
* The RESP client lives in `@alchemy.run/redis`. This file only wires the
* Fly host binding.
*
* NOT exported from `index.ts`.
*/
const isFlyHost = (value: unknown): value is Resource<string, any, any, ServiceBinding> =>
typeof value === "object" &&
value !== null &&
((value as { Type?: string }).Type === "Fly.Service" ||
(value as { Type?: string }).Type === "Fly.Machine");
const asPlain = (value: unknown): string | undefined => {
if (typeof value === "string" && value.length > 0) return value;
if (Redacted.isRedacted(value)) return value.pipe(Redacted.value, asPlain);
return undefined;
};
const redisUrlFromEnv = Config.Redacted(REDIS_URL_ENV).pipe(
Effect.map((value) => Redacted.value(value)),
);
export const makeRedisBinding = <Client>(options: { makeClient: (url: Url) => Client }) =>
Effect.succeed(
Effect.fn(function* (redis: Redis) {
if (!globalThis.__ALCHEMY_RUNTIME__) {
const host = yield* Binding.Host;
if (isFlyHost(host)) {
yield* host.bind`${redis}`({
redis: { name: redis.name, id: redis.redisId },
});
}
}
const urlFromResource = yield* redis.url;
const missing = new RedisUrlMissing({
resourceName: asPlain(redis.name) ?? redis.LogicalId,
});
const url: Url = Effect.gen(function* () {
const fromOutput = asPlain(yield* urlFromResource);
if (fromOutput !== undefined) return fromOutput;
return yield* redisUrlFromEnv.pipe(Effect.mapError(() => missing));
});
return options.makeClient(url);
}),
);