sailfork / t3code-github / .repos/ alchemy-effect/ packages/ gcp/ src/ TPU/ GetQueuedResource.ts

import type * as tpu from "@distilled.cloud/gcp/tpu_v2";
import * as Binding from "alchemy/Binding";
import type { RuntimeContext } from "alchemy/RuntimeContext";
import type * as Effect from "effect/Effect";
import type { QueuedResource } from "./QueuedResource.ts";

export interface GetQueuedResourceRequest extends Omit<
  tpu.GetProjectsLocationsQueuedResourcesRequest,
  "name"
> {}

/**
 * Runtime binding for Cloud TPU `queuedResources.get`.
 *
 * Bind this operation to a {@link QueuedResource} in a Function/Action
 * init phase. Provide {@link GetQueuedResourceHttp}.
 *
 * Grants `roles/tpu.viewer` on the project because Cloud TPU has no
 * resource-level IAM.
 *
 * ### Observing Queued Resources
 * **Example:** Read the bound queued resource
 * ```typescript
 * const getQueued = yield* GCP.TPU.GetQueuedResource(request);
 * const live = yield* getQueued();
 * ```
 *
 * @binding
 * @category TPU
 */
export interface GetQueuedResource extends Binding.Service<
  GetQueuedResource,
  "GCP.TPU.GetQueuedResource",
  (
    resource: QueuedResource,
  ) => Effect.Effect<
    (
      request?: GetQueuedResourceRequest,
    ) => Effect.Effect<
      tpu.QueuedResource,
      tpu.GetProjectsLocationsQueuedResourcesError,
      RuntimeContext
    >
  >
> {}

export const GetQueuedResource = Binding.Service<GetQueuedResource>("GCP.TPU.GetQueuedResource");