import type * as SSM from "@distilled.cloud/aws/ssm";
import * as Binding from "alchemy/Binding";
import type * as Effect from "effect/Effect";
import type { Parameter } from "./Parameter.ts";
export interface GetParameterHistoryRequest extends Omit<SSM.GetParameterHistoryRequest, "Name"> {}
/**
* Runtime binding for `ssm:GetParameterHistory`.
*
* Bind this operation to a `Parameter` inside a function runtime to get a
* callable that retrieves the change history (all versions, labels, and
* metadata) of the bound parameter. The binding also grants `kms:Decrypt`
* on the parameter's encryption key so `WithDecryption: true` works on
* `SecureString` parameters.
* ### Reading Parameter History
* **Example:** List All Versions of a Parameter
* ```typescript
* const getHistory = yield* SSM.GetParameterHistory(config);
*
* const result = yield* getHistory();
* for (const version of result.Parameters ?? []) {
* yield* Effect.log(`v${version.Version}: ${version.Value}`);
* }
* ```
*
* @binding
*/
export interface GetParameterHistory extends Binding.Service<
GetParameterHistory,
"AWS.SSM.GetParameterHistory",
<P extends Parameter>(
parameter: P,
) => Effect.Effect<
(
request?: GetParameterHistoryRequest,
) => Effect.Effect<SSM.GetParameterHistoryResult, SSM.GetParameterHistoryError>
>
> {}
export const GetParameterHistory = Binding.Service<GetParameterHistory>(
"AWS.SSM.GetParameterHistory",
);