import type * as glacier from "@distilled.cloud/aws/glacier";
import * as Binding from "alchemy/Binding";
import type * as Effect from "effect/Effect";
import type { Vault } from "./Vault.ts";
/**
* `DescribeJob` request with `accountId` and `vaultName` injected from the bound
* {@link Vault}.
*/
export interface DescribeJobRequest extends Omit<
glacier.DescribeJobInput,
"accountId" | "vaultName"
> {}
/**
* Runtime binding for the `DescribeJob` operation (IAM action
* `glacier:DescribeJob` on the vault ARN).
*
* Reads the status of a job previously started with {@link InitiateJob} on
* the bound {@link Vault} — its action, status code, and completion flag.
* Provide the implementation with
* `Effect.provide(AWS.Glacier.DescribeJobHttp)`.
* ### Retrieving Archives
* **Example:** Poll a retrieval job
* ```typescript
* const describeJob = yield* AWS.Glacier.DescribeJob(vault);
*
* const job = yield* describeJob({ jobId });
* if (job.Completed) {
* // fetch with GetJobOutput
* }
* ```
*
* @binding
*/
export interface DescribeJob extends Binding.Service<
DescribeJob,
"AWS.Glacier.DescribeJob",
(
vault: Vault,
) => Effect.Effect<
(
request: DescribeJobRequest,
) => Effect.Effect<glacier.GlacierJobDescription, glacier.DescribeJobError>
>
> {}
export const DescribeJob = Binding.Service<DescribeJob>("AWS.Glacier.DescribeJob");