sailfork / t3code-github / .repos/ alchemy-effect/ packages/ aws/ src/ Rekognition/ DetectLabels.ts

import type * as rekognition from "@distilled.cloud/aws/rekognition";
import * as Binding from "alchemy/Binding";
import type * as Effect from "effect/Effect";

/**
 * Runtime binding for `rekognition:DetectLabels` — detect real-world
 * entities (objects, scenes, concepts) in a JPEG or PNG image.
 *
 * Rekognition is a pure pay-per-call service with no resource to manage:
 * the binding takes no arguments and grants the function
 * `rekognition:DetectLabels` (the action has no resource-level IAM).
 * Pass the image as raw bytes (`Image.Bytes`) or as an S3 object
 * reference (`Image.S3Object`) — raw distilled types, no marshalling.
 * Provide the implementation with
 * `Effect.provide(AWS.Rekognition.DetectLabelsHttp)`.
 *
 * ### Detecting Labels
 * **Example:** Detect Labels in Image Bytes
 * ```typescript
 * // init
 * const detectLabels = yield* AWS.Rekognition.DetectLabels();
 *
 * // runtime
 * const result = yield* detectLabels({
 *   Image: { Bytes: imageBytes },
 *   MaxLabels: 10,
 *   MinConfidence: 50,
 * });
 * const names = (result.Labels ?? []).map((label) => label.Name);
 * ```
 *
 * @binding
 */
export interface DetectLabels extends Binding.Service<
  DetectLabels,
  "AWS.Rekognition.DetectLabels",
  () => Effect.Effect<
    (
      request: rekognition.DetectLabelsRequest,
    ) => Effect.Effect<rekognition.DetectLabelsResponse, rekognition.DetectLabelsError>
  >
> {}
export const DetectLabels = Binding.Service<DetectLabels>("AWS.Rekognition.DetectLabels");