import type * as cloudformation from "@distilled.cloud/aws/cloudformation";
import * as Binding from "alchemy/Binding";
import type * as Effect from "effect/Effect";
import type { Stack } from "./Stack.ts";
/**
* Runtime binding for the `DetectStackDrift` operation (IAM actions
* `cloudformation:DetectStackDrift` + `cloudformation:DetectStackResourceDrift`
* — AWS authorizes both on the per-stack call).
*
* Bind this operation to a {@link Stack} to start drift detection from inside
* a function runtime — e.g. a scheduled drift monitor. Detection runs
* asynchronously; poll the returned `StackDriftDetectionId` with
* {@link DescribeStackDriftDetectionStatus}. Note that CloudFormation reads
* the live state of the stack's resources with the caller's credentials, so
* the function also needs read access to the resource types in the template
* for the detection to complete. Provide the implementation with
* `Effect.provide(AWS.CloudFormation.DetectStackDriftHttp)`.
* ### Drift Detection
* **Example:** Start Drift Detection
* ```typescript
* const detectStackDrift = yield* AWS.CloudFormation.DetectStackDrift(stack);
*
* const { StackDriftDetectionId } = yield* detectStackDrift();
* ```
*
* @binding
*/
export interface DetectStackDrift extends Binding.Service<
DetectStackDrift,
"AWS.CloudFormation.DetectStackDrift",
(
stack: Stack,
) => Effect.Effect<
(
request?: Omit<cloudformation.DetectStackDriftInput, "StackName">,
) => Effect.Effect<cloudformation.DetectStackDriftOutput, cloudformation.DetectStackDriftError>
>
> {}
export const DetectStackDrift = Binding.Service<DetectStackDrift>(
"AWS.CloudFormation.DetectStackDrift",
);