sailfork / t3code-github / .repos/ alchemy-effect/ packages/ gcp/ src/ SQL/ GetUser.ts

import type * as sqladmin from "@distilled.cloud/gcp/sqladmin_v1";
import * as Binding from "alchemy/Binding";
import type { RuntimeContext } from "alchemy/RuntimeContext";
import type * as Effect from "effect/Effect";
import type { User } from "./User.ts";

export interface GetUserRequest extends Omit<
  sqladmin.GetUsersRequest,
  "instance" | "project" | "name"
> {}

/**
 * Runtime binding for Cloud SQL `users.get`.
 *
 * Bind this operation to a {@link User} in a Function/Action init phase.
 * Provide {@link GetUserHttp}.
 *
 * Grants `roles/cloudsql.viewer` on the project, unconditioned: Cloud SQL
 * has no instance-level IAM policy, `cloudsql.users.get` is not matched by
 * an IAM Condition on the instance name, and no narrower predefined role
 * carries it.
 *
 * ### Observing Users
 * **Example:** Read the bound user
 * ```typescript
 * const getUser = yield* GCP.SQL.GetUser(appUser);
 * const live = yield* getUser();
 * ```
 *
 * @binding
 * @category SQL
 */
export interface GetUser extends Binding.Service<
  GetUser,
  "GCP.SQL.GetUser",
  (
    user: User,
  ) => Effect.Effect<
    (
      request?: GetUserRequest,
    ) => Effect.Effect<sqladmin.User, sqladmin.GetUsersError, RuntimeContext>
  >
> {}

export const GetUser = Binding.Service<GetUser>("GCP.SQL.GetUser");