sailfork / t3code-github / .repos/ alchemy-effect/ packages/ aws/ src/ ACM/ RenewCertificate.ts

import type * as acm from "@distilled.cloud/aws/acm";
import * as Binding from "alchemy/Binding";
import type * as Effect from "effect/Effect";
import type { Certificate } from "./Certificate.ts";

/**
 * Runtime binding for `acm:RenewCertificate`.
 *
 * Bind this operation to a {@link Certificate} to get a callable that forces
 * managed renewal of an eligible certificate — typically an exported
 * certificate whose renewal is not fully automatic. Useful in rotation
 * functions that renew and then re-export a certificate. Provide the
 * implementation with `Effect.provide(AWS.ACM.RenewCertificateHttp)`.
 * ### Renewing Certificates
 * **Example:** Force a Managed Renewal
 * ```typescript
 * // init — bind the operation to the certificate
 * const renewCertificate = yield* AWS.ACM.RenewCertificate(certificate);
 *
 * // runtime
 * yield* renewCertificate();
 * ```
 *
 * @binding
 */
export interface RenewCertificate extends Binding.Service<
  RenewCertificate,
  "AWS.ACM.RenewCertificate",
  (
    certificate: Certificate,
  ) => Effect.Effect<() => Effect.Effect<acm.RenewCertificateResponse, acm.RenewCertificateError>>
> {}

export const RenewCertificate = Binding.Service<RenewCertificate>("AWS.ACM.RenewCertificate");