sailfork / t3code-github / .repos/ alchemy-effect/ packages/ aws/ src/ Lambda/ RunMicrovm.ts

import type * as microvms from "@distilled.cloud/aws/lambda-microvms";
import * as Binding from "alchemy/Binding";
import type * as Effect from "effect/Effect";
import type { MicrovmImage } from "./MicrovmImage.ts";

export interface RunMicrovmRequest extends Omit<microvms.RunMicrovmRequest, "imageIdentifier"> {}

/**
 * Runtime binding for `RunMicrovm`.
 *
 * Bind it to a {@link MicrovmImage} inside a Lambda Function to get a callable
 * that launches a MicroVM from that image (the `imageIdentifier` is injected).
 * The response carries the MicroVM `endpoint`; connect to it with an
 * `X-aws-proxy-auth` token from {@link CreateAuthToken}.
 *
 * ### Running MicroVMs
 * **Example:** Run a MicroVM
 * ```typescript
 * const runMicrovm = yield* AWS.Lambda.RunMicrovm(Sandbox);
 *
 * const vm = yield* runMicrovm({
 *   idlePolicy: {
 *     maxIdleDurationSeconds: 900,
 *     suspendedDurationSeconds: 300,
 *     autoResumeEnabled: true,
 *   },
 * });
 * ```
 *
 * @binding
 */
export interface RunMicrovm extends Binding.Service<
  RunMicrovm,
  "AWS.Lambda.RunMicrovm",
  (
    image: MicrovmImage,
  ) => Effect.Effect<
    (
      request: RunMicrovmRequest,
    ) => Effect.Effect<microvms.RunMicrovmResponse, microvms.RunMicrovmError>
  >
> {}
export const RunMicrovm = Binding.Service<RunMicrovm>("AWS.Lambda.RunMicrovm");