import type * as ci from "@distilled.cloud/aws/cognito-identity";
import * as Binding from "alchemy/Binding";
import type * as Effect from "effect/Effect";
import type { IdentityPool } from "./IdentityPool.ts";
export interface GetIdRequest extends Omit<ci.GetIdInput, "IdentityPoolId"> {}
/**
* The typed client returned by binding {@link IdentityPoolAuth} to an
* `IdentityPool`. `getId` automatically injects the identity pool ID; the
* remaining calls operate on the returned identity ID.
*/
export interface IdentityPoolAuthClient {
/** Mint (or look up) an identity ID for a set of logins — or for a guest
* when the pool allows unauthenticated identities. */
getId: (request?: GetIdRequest) => Effect.Effect<ci.GetIdResponse, ci.GetIdError>;
/** Exchange an identity ID (+ logins) for temporary AWS credentials. */
getCredentialsForIdentity: (
request: ci.GetCredentialsForIdentityInput,
) => Effect.Effect<ci.GetCredentialsForIdentityResponse, ci.GetCredentialsForIdentityError>;
/** Exchange an identity ID (+ logins) for an OpenID Connect token
* (basic/classic flow — requires `allowClassicFlow`). */
getOpenIdToken: (
request: ci.GetOpenIdTokenInput,
) => Effect.Effect<ci.GetOpenIdTokenResponse, ci.GetOpenIdTokenError>;
/** Unlink a federated login from an identity. */
unlinkIdentity: (
request: ci.UnlinkIdentityInput,
) => Effect.Effect<ci.UnlinkIdentityResponse, ci.UnlinkIdentityError>;
}
/**
* Runtime binding for the public (token-based) Cognito identity pool flows —
* the credentials-vending data plane.
*
* Bind this to an `IdentityPool` inside a function runtime to exchange user
* pool / social / OIDC tokens (or nothing, for guest access) for an identity
* ID and temporary AWS credentials. These operations are unauthenticated
* (Cognito does not evaluate IAM for them), so the binding grants no IAM
* policy — it injects the identity pool ID into `getId`.
* ### Vending AWS Credentials
* **Example:** Guest (Unauthenticated) Credentials
* ```typescript
* const identity = yield* Cognito.IdentityPoolAuth(identityPool);
*
* const { IdentityId } = yield* identity.getId();
* const creds = yield* identity.getCredentialsForIdentity({
* IdentityId: IdentityId!,
* });
* ```
*
* **Example:** Credentials for a User Pool Sign-In
* ```typescript
* const provider = `cognito-idp.${region}.amazonaws.com/${userPoolId}`;
* const { IdentityId } = yield* identity.getId({
* Logins: { [provider]: idToken },
* });
* const creds = yield* identity.getCredentialsForIdentity({
* IdentityId: IdentityId!,
* Logins: { [provider]: idToken },
* });
* ```
*
* @binding
*/
export interface IdentityPoolAuth extends Binding.Service<
IdentityPoolAuth,
"AWS.Cognito.IdentityPoolAuth",
<P extends IdentityPool>(pool: P) => Effect.Effect<IdentityPoolAuthClient>
> {}
export const IdentityPoolAuth = Binding.Service<IdentityPoolAuth>("AWS.Cognito.IdentityPoolAuth");