import type * as kafka from "@distilled.cloud/aws/kafka";
import * as Binding from "alchemy/Binding";
import type * as Effect from "effect/Effect";
import type { ServerlessCluster } from "./ServerlessCluster.ts";
/**
* Runtime binding for the `ListTopics` operation (IAM action
* `kafka:ListTopics`), scoped to one {@link ServerlessCluster}.
*
* Lists the topics on the bound cluster through the MSK control plane,
* optionally filtered by name prefix. Provide the implementation with
* `Effect.provide(AWS.Kafka.ListTopicsHttp)`.
* ### Managing Topics
* **Example:** List the Cluster's Topics
* ```typescript
* const listTopics = yield* Kafka.ListTopics(cluster);
*
* const page = yield* listTopics({ TopicNameFilter: "orders" });
* // page.Topics → [{ TopicName: "orders", PartitionCount: 3, … }]
* ```
*
* @binding
*/
export interface ListTopics extends Binding.Service<
ListTopics,
"AWS.Kafka.ListTopics",
(
cluster: ServerlessCluster,
) => Effect.Effect<
(
request?: Omit<kafka.ListTopicsRequest, "ClusterArn">,
) => Effect.Effect<kafka.ListTopicsResponse, kafka.ListTopicsError>
>
> {}
export const ListTopics = Binding.Service<ListTopics>("AWS.Kafka.ListTopics");