sailfork / t3code-github / .repos/ alchemy-effect/ packages/ aws/ src/ ECR/ GetAuthorizationToken.ts

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

/**
 * Runtime binding for `ecr:GetAuthorizationToken`.
 *
 * Mints the temporary registry credential (`AWS:<password>` base64 token,
 * valid 12 hours) a Docker client presents to the account's private ECR
 * registry — a registry-level operation, so the binding takes no resource
 * and the grant is on `Resource: ["*"]` (the action supports no
 * resource-level permissions). Provide the implementation with
 * `Effect.provide(AWS.ECR.GetAuthorizationTokenHttp)`.
 *
 * The returned `authorizationToken` is wrapped in `Redacted` so it never
 * leaks into logs — unwrap with `Redacted.value(...)` at the point of use.
 *
 * ### Registry Authentication
 * **Example:** Decode Docker Login Credentials
 * ```typescript
 * import * as Redacted from "effect/Redacted";
 *
 * // init — registry-level binding takes no resource
 * const getAuthorizationToken = yield* AWS.ECR.GetAuthorizationToken();
 *
 * // runtime
 * const res = yield* getAuthorizationToken();
 * const data = res.authorizationData?.[0];
 * const token = data?.authorizationToken;
 * const decoded = Buffer.from(
 *   Redacted.isRedacted(token) ? Redacted.value(token) : (token ?? ""),
 *   "base64",
 * ).toString("utf8"); // "AWS:<password>" for `docker login`
 * ```
 *
 * @binding
 */
export interface GetAuthorizationToken extends Binding.Service<
  GetAuthorizationToken,
  "AWS.ECR.GetAuthorizationToken",
  () => Effect.Effect<
    () => Effect.Effect<ecr.GetAuthorizationTokenResponse, ecr.GetAuthorizationTokenError>
  >
> {}

export const GetAuthorizationToken = Binding.Service<GetAuthorizationToken>(
  "AWS.ECR.GetAuthorizationToken",
);