sailfork / t3code-github / .repos/ alchemy-effect/ packages/ aws/ src/ Kinesis/ DescribeStreamSummary.ts

import * as Kinesis from "@distilled.cloud/aws/kinesis";
import * as Binding from "alchemy/Binding";
import * as Effect from "effect/Effect";
import type { Stream } from "./Stream.ts";

export interface DescribeStreamSummaryRequest extends Omit<
  Kinesis.DescribeStreamSummaryInput,
  "StreamName" | "StreamARN"
> {}

/**
 * Runtime binding for `kinesis:DescribeStreamSummary`.
 *
 * Bind this operation to a `Stream` to read its status, mode, retention,
 * encryption, and open shard count without paginating the full shard map.
 * Provide the implementation with
 * `Effect.provide(AWS.Kinesis.DescribeStreamSummaryHttp)`.
 * ### Inspecting Streams
 * **Example:** Read the Stream Summary
 * ```typescript
 * // init
 * const describeStreamSummary = yield* AWS.Kinesis.DescribeStreamSummary(stream);
 *
 * // runtime
 * const result = yield* describeStreamSummary();
 * const summary = result.StreamDescriptionSummary;
 * yield* Effect.log(`${summary.StreamStatus}: ${summary.OpenShardCount} shards`);
 * ```
 *
 * @binding
 */
export interface DescribeStreamSummary extends Binding.Service<
  DescribeStreamSummary,
  "AWS.Kinesis.DescribeStreamSummary",
  (
    stream: Stream,
  ) => Effect.Effect<
    (
      request?: DescribeStreamSummaryRequest,
    ) => Effect.Effect<Kinesis.DescribeStreamSummaryOutput, Kinesis.DescribeStreamSummaryError>
  >
> {}

export const DescribeStreamSummary = Binding.Service<DescribeStreamSummary>(
  "AWS.Kinesis.DescribeStreamSummary",
);