sailfork / t3code-github / .repos/ alchemy-effect/ packages/ aws/ src/ CodeBuild/ StartBuild.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";

export interface StartBuildRequest extends Omit<SVC.StartBuildInput, "projectName"> {}

/**
 * Runtime binding for `codebuild:StartBuild` — lets a workload kick off a
 * build of a CodeBuild project (optionally overriding the source version,
 * environment variables, buildspec, etc.).
 *
 * The response carries the created `build` including its `id`, which can be
 * polled with the {@link BatchGetBuilds} binding.
 * ### Starting Builds
 * **Example:** Start a Build
 * ```typescript
 * const startBuild = yield* AWS.CodeBuild.StartBuild(project);
 *
 * const { build } = yield* startBuild({
 *   environmentVariablesOverride: [
 *     { name: "COMMIT", value: sha, type: "PLAINTEXT" },
 *   ],
 * });
 * ```
 *
 * @binding
 */
export interface StartBuild extends Binding.Service<
  StartBuild,
  "AWS.CodeBuild.StartBuild",
  <P extends Project>(
    project: P,
  ) => Effect.Effect<
    (request?: StartBuildRequest) => Effect.Effect<SVC.StartBuildOutput, SVC.StartBuildError>
  >
> {}
export const StartBuild = Binding.Service<StartBuild>("AWS.CodeBuild.StartBuild");