sailfork / t3code-github / .repos/ alchemy-effect/ packages/ aws/ src/ CodeBuild/ StartCommandExecution.ts

import type * as SVC from "@distilled.cloud/aws/codebuild";
import * as Binding from "alchemy/Binding";
import type * as Effect from "effect/Effect";
import type { Project } from "./Project.ts";

/**
 * Runtime binding for `codebuild:StartCommandExecution` — runs a shell
 * command in a running sandbox of the bound project. Poll the result with
 * {@link BatchGetCommandExecutions}.
 * ### Sandboxes
 * **Example:** Run a Command in a Sandbox
 * ```typescript
 * const startCommandExecution = yield* AWS.CodeBuild.StartCommandExecution(project);
 *
 * const { commandExecution } = yield* startCommandExecution({
 *   sandboxId,
 *   command: "echo hello",
 * });
 * ```
 *
 * @binding
 */
export interface StartCommandExecution extends Binding.Service<
  StartCommandExecution,
  "AWS.CodeBuild.StartCommandExecution",
  <P extends Project>(
    project: P,
  ) => Effect.Effect<
    (
      request: SVC.StartCommandExecutionInput,
    ) => Effect.Effect<SVC.StartCommandExecutionOutput, SVC.StartCommandExecutionError>
  >
> {}
export const StartCommandExecution = Binding.Service<StartCommandExecution>(
  "AWS.CodeBuild.StartCommandExecution",
);