import type { AppSecret, GetSecretError } from "@distilled.cloud/fly-io/machines";
import * as Binding from "alchemy/Binding";
import type { RuntimeContext } from "alchemy/RuntimeContext";
import type * as Effect from "effect/Effect";
import type { Secret } from "./Secret.ts";
/**
* Fetch one Fly.io App secret. The App and name are fixed by
* `GetSecret(secret)`. Calls take no `app_name`.
*
*
* ### Read a secret
* Bind the client in init. Call it from `fetch` or an Action body.
* Provide {@link GetSecretHttp}. Alchemy transports the bound App name,
* secret name, and deployment's org token automatically. There is no
* need to configure `FLY_SECRET_*` environment variables.
*
* Fly only returns plaintext from a Machine in the same App. From a
* deploy-time Action you get metadata (name, digest, timestamps).
*
* **Example:** GetSecret
* ```typescript
* export default class Api extends Fly.Service<Api>()(
* "Api",
* { app: Site, main: import.meta.url, port: 3000 },
* Effect.gen(function* () {
* const get = yield* Fly.GetSecret(ApiToken);
*
* return {
* fetch: Effect.gen(function* () {
* const got = yield* get().pipe(Effect.orDie);
* return HttpServerResponse.json({ name: got.name });
* }),
* };
* }).pipe(Effect.provide(Fly.GetSecretHttp)),
* ) {}
* ```
*
* @binding
* @product Secret
*/
export interface GetSecret extends Binding.Service<
GetSecret,
"Fly.GetSecret",
(secret: Secret) => Effect.Effect<() => Effect.Effect<AppSecret, GetSecretError, RuntimeContext>>
> {}
export const GetSecret = Binding.Service<GetSecret>("Fly.GetSecret");