sailfork / t3code-github / .repos/ alchemy-effect/ packages/ fly/ src/ Sign.ts

import type { SignSecretKeyError } 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 { SecretKey } from "./SecretKey.ts";

export interface SignRequest {
  /** Bytes to sign. */
  plaintext: Uint8Array | ArrayLike<number>;
}

export interface SignResult {
  signature: Uint8Array;
}

/**
 * Sign with a Fly {@link SecretKey} (`nacl_sign`, `hs256`, `es256`,
 * …). The private key never leaves Fly KMS.
 *
 *
 * ### Sign a payload
 * The App and key name are fixed by `Sign(key)`. Provide
 * {@link SignHttp} on the Action or Service Effect.
 *
 * **Example:** Sign
 * ```typescript
 * const sign = yield* Fly.Sign(Signing);
 * const { signature } = yield* sign({
 *   plaintext: new TextEncoder().encode("release-manifest-v1"),
 * });
 * ```
 *
 * @binding
 * @product Secret Key
 */
export interface Sign extends Binding.Service<
  Sign,
  "Fly.Sign",
  (
    key: SecretKey,
  ) => Effect.Effect<
    (request: SignRequest) => Effect.Effect<SignResult, SignSecretKeyError, RuntimeContext>
  >
> {}

export const Sign = Binding.Service<Sign>("Fly.Sign");