The best way to control Claude Code, Codex and more from any computer or phone

main
ts 104 lines 4.07 KB
Raw
1 import type * as ci from "@distilled.cloud/aws/cognito-identity";
2 import * as Binding from "alchemy/Binding";
3 import type * as Effect from "effect/Effect";
4 import type { IdentityPool } from "./IdentityPool.ts";
5
6 export interface ListIdentitiesRequest extends Omit<ci.ListIdentitiesInput, "IdentityPoolId"> {}
7 export interface LookupDeveloperIdentityRequest extends Omit<
8 ci.LookupDeveloperIdentityInput,
9 "IdentityPoolId"
10 > {}
11 export interface MergeDeveloperIdentitiesRequest extends Omit<
12 ci.MergeDeveloperIdentitiesInput,
13 "IdentityPoolId"
14 > {}
15 export interface UnlinkDeveloperIdentityRequest extends Omit<
16 ci.UnlinkDeveloperIdentityInput,
17 "IdentityPoolId"
18 > {}
19 export interface GetOpenIdTokenForDeveloperIdentityRequest extends Omit<
20 ci.GetOpenIdTokenForDeveloperIdentityInput,
21 "IdentityPoolId"
22 > {}
23
24 /**
25 * The typed client returned by binding {@link IdentityPoolAdmin} to an
26 * `IdentityPool`. Pool-scoped calls automatically inject the identity pool
27 * ID and are authorized by IAM (`cognito-identity:*` on the pool's ARN).
28 */
29 export interface IdentityPoolAdminClient {
30 /** Fetch an identity's linked logins and metadata. */
31 describeIdentity: (
32 request: ci.DescribeIdentityInput,
33 ) => Effect.Effect<ci.IdentityDescription, ci.DescribeIdentityError>;
34 /** Page through the identities registered in the pool. */
35 listIdentities: (
36 request: ListIdentitiesRequest,
37 ) => Effect.Effect<ci.ListIdentitiesResponse, ci.ListIdentitiesError>;
38 /** Permanently delete identities from the pool. */
39 deleteIdentities: (
40 request: ci.DeleteIdentitiesInput,
41 ) => Effect.Effect<ci.DeleteIdentitiesResponse, ci.DeleteIdentitiesError>;
42 /** Look up an identity by developer user identifier (or vice versa). */
43 lookupDeveloperIdentity: (
44 request: LookupDeveloperIdentityRequest,
45 ) => Effect.Effect<ci.LookupDeveloperIdentityResponse, ci.LookupDeveloperIdentityError>;
46 /** Merge two developer-authenticated identities into one. */
47 mergeDeveloperIdentities: (
48 request: MergeDeveloperIdentitiesRequest,
49 ) => Effect.Effect<ci.MergeDeveloperIdentitiesResponse, ci.MergeDeveloperIdentitiesError>;
50 /** Unlink a developer user identifier from an identity. */
51 unlinkDeveloperIdentity: (
52 request: UnlinkDeveloperIdentityRequest,
53 ) => Effect.Effect<ci.UnlinkDeveloperIdentityResponse, ci.UnlinkDeveloperIdentityError>;
54 /** Mint an OpenID Connect token for a developer-authenticated identity
55 * (server-side developer provider flow). */
56 getOpenIdTokenForDeveloperIdentity: (
57 request: GetOpenIdTokenForDeveloperIdentityRequest,
58 ) => Effect.Effect<
59 ci.GetOpenIdTokenForDeveloperIdentityResponse,
60 ci.GetOpenIdTokenForDeveloperIdentityError
61 >;
62 }
63
64 /**
65 * Runtime binding for administrative Cognito identity pool operations —
66 * identity management and the developer-authenticated identities flow.
67 *
68 * Bind this to an `IdentityPool` inside a function runtime to get a typed
69 * client for listing/deleting identities and for developer-provider token
70 * minting. The binding grants the corresponding `cognito-identity:*` IAM
71 * actions scoped to the pool's ARN and injects the pool ID into pool-scoped
72 * calls.
73 * ### Managing Identities
74 * **Example:** List and Describe Identities
75 * ```typescript
76 * const identities = yield* Cognito.IdentityPoolAdmin(identityPool);
77 *
78 * const page = yield* identities.listIdentities({ MaxResults: 20 });
79 * const first = page.Identities?.[0];
80 * if (first?.IdentityId) {
81 * const detail = yield* identities.describeIdentity({
82 * IdentityId: first.IdentityId,
83 * });
84 * }
85 * ```
86 *
87 * ### Developer-Authenticated Identities
88 * **Example:** Mint a Token for a Backend-Authenticated User
89 * ```typescript
90 * const token = yield* identities.getOpenIdTokenForDeveloperIdentity({
91 * Logins: { "my.developer.provider": userId },
92 * });
93 * ```
94 *
95 * @binding
96 */
97 export interface IdentityPoolAdmin extends Binding.Service<
98 IdentityPoolAdmin,
99 "AWS.Cognito.IdentityPoolAdmin",
100 <P extends IdentityPool>(pool: P) => Effect.Effect<IdentityPoolAdminClient>
101 > {}
102 export const IdentityPoolAdmin = Binding.Service<IdentityPoolAdmin>(
103 "AWS.Cognito.IdentityPoolAdmin",
104 );