import type * as agw2 from "@distilled.cloud/aws/apigatewayv2";
import * as Binding from "alchemy/Binding";
import type * as Effect from "effect/Effect";
import type { ApiGatewayV2Stage } from "./Stage.ts";
/**
* Runtime binding for resetting a stage's authorizer result cache
* (`apigateway:DELETE` on `/apis/{apiId}/stages/{stageName}/cache/authorizers`).
*
* Bind a {@link Stage} inside a function runtime to drop cached Lambda
* authorizer verdicts — e.g. immediately revoking access after a
* permission change, without waiting out `authorizerResultTtl`. Provide
* `ApiGatewayV2.ResetAuthorizersCacheHttp` on the Function effect to
* implement the binding.
*
* ### Flushing caches
* **Example:** Revoke cached authorizer verdicts
* ```typescript
* // init
* const resetAuthorizersCache = yield* ApiGatewayV2.ResetAuthorizersCache(stage);
*
* // runtime
* yield* resetAuthorizersCache();
* ```
*
* @binding
*/
export interface ResetAuthorizersCache extends Binding.Service<
ResetAuthorizersCache,
"AWS.ApiGatewayV2.ResetAuthorizersCache",
<S extends ApiGatewayV2Stage>(
stage: S,
) => Effect.Effect<
() => Effect.Effect<agw2.ResetAuthorizersCacheResponse, agw2.ResetAuthorizersCacheError>
>
> {}
export const ResetAuthorizersCache = Binding.Service<ResetAuthorizersCache>(
"AWS.ApiGatewayV2.ResetAuthorizersCache",
);