1import type * as ecr from "@distilled.cloud/aws/ecr";
2import type * as Effect from "effect/Effect";
3import * as Binding from "../../Binding.ts";
4import type { Repository } from "./Repository.ts";
5
6/**
7 * Request for {@link DescribeImages} — `repositoryName` is injected from the
8 * bound {@link Repository} (the registry defaults to the caller's account).
9 */
10export interface DescribeImagesRequest extends Omit<
11 ecr.DescribeImagesRequest,
12 "registryId" | "repositoryName"
13> {}
14
15/**
16 * Runtime binding for `ecr:DescribeImages`.
17 *
18 * Returns metadata (digest, tags, size, push time, scan status) about the images in the bound repository. Provide the implementation with
19 * `Effect.provide(AWS.ECR.DescribeImagesHttp)`.
20 * ### Reading Images
21 * **Example:** Describe Tagged Images
22 * ```typescript
23 * const describeImages = yield* AWS.ECR.DescribeImages(repository);
24 *
25 * const res = yield* describeImages({ imageIds: [{ imageTag: "latest" }] });
26 * console.log(res.imageDetails?.[0]?.imageDigest);
27 * ```
28 *
29 * @binding
30 */
31export interface DescribeImages extends Binding.Service<
32 DescribeImages,
33 "AWS.ECR.DescribeImages",
34 (
35 repository: Repository,
36 ) => Effect.Effect<
37 (
38 request?: DescribeImagesRequest,
39 ) => Effect.Effect<ecr.DescribeImagesResponse, ecr.DescribeImagesError>
40 >
41> {}
42
43export const DescribeImages = Binding.Service<DescribeImages>(
44 "AWS.ECR.DescribeImages",
45);