@confluentinc/mcp-confluent 1.0.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Confluent Inc.
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,302 @@
+# mcp-confluent
+
+An MCP server implementation that enables AI assistants to interact with Confluent Kafka and Confluent Cloud REST APIs. This server allows AI tools like Claude Desktop and Goose CLI to manage Kafka topics, connectors, and Flink SQL statements through natural language interactions.
+
+## Demo
+
+### Goose CLI
+
+![Goose CLI Demo](assets/goose-cli-demo.gif)
+
+### Claude Desktop
+
+![Claude Desktop Demo](assets/claude-desktop-demo.gif)
+
+## Table of Contents
+
+- [mcp-confluent](#mcp-confluent)
+  - [Demo](#demo)
+    - [Goose CLI](#goose-cli)
+    - [Claude Desktop](#claude-desktop)
+  - [Table of Contents](#table-of-contents)
+  - [User Guide](#user-guide)
+    - [Getting Started](#getting-started)
+    - [Configuration](#configuration)
+    - [Environment Variables Reference](#environment-variables-reference)
+    - [Usage](#usage)
+    - [Configuring Claude Desktop](#configuring-claude-desktop)
+    - [Configuring Goose CLI](#configuring-goose-cli)
+  - [Developer Guide](#developer-guide)
+    - [Project Structure](#project-structure)
+    - [Building and Running](#building-and-running)
+    - [Testing](#testing)
+      - [MCP Inspector](#mcp-inspector)
+    - [Adding a New Tool](#adding-a-new-tool)
+    - [Generating Types](#generating-types)
+    - [Contributing](#contributing)
+
+## User Guide
+
+### Getting Started
+
+1. **Create a `.env` file:**  Copy the example `.env` file structure (shown below) into a new file named `.env` in the root of your project.
+2. **Populate the `.env` file:** Fill in the necessary values for your Confluent Cloud environment.  See the [Configuration](#configuration) section for details on each variable.
+3. **Install Node.js** (if not already installed)
+   - We recommend using [NVM](https://github.com/nvm-sh/nvm) (Node Version Manager) to manage Node.js versions
+   - Install and use Node.js:
+
+    ```bash
+    nvm install 22
+    nvm use 22
+    ```
+
+### Configuration
+
+Create a `.env` file in the root directory of your project with the following configuration:
+
+<details>
+<summary>Example .env file structure</summary>
+
+```properties
+# .env file
+BOOTSTRAP_SERVERS="pkc-v12gj.us-east4.gcp.confluent.cloud:9092"
+KAFKA_API_KEY="..."
+KAFKA_API_SECRET="..."
+KAFKA_REST_ENDPOINT="https://pkc-v12gj.us-east4.gcp.confluent.cloud:443"
+KAFKA_CLUSTER_ID=""
+KAFKA_ENV_ID="env-..."
+FLINK_ENV_ID="env-..."
+FLINK_ORG_ID=""
+FLINK_REST_ENDPOINT="https://flink.us-east4.gcp.confluent.cloud"
+FLINK_ENV_NAME=""
+FLINK_DATABASE_NAME=""
+FLINK_API_KEY=""
+FLINK_API_SECRET=""
+FLINK_COMPUTE_POOL_ID="lfcp-..."
+CONFLUENT_CLOUD_API_KEY=""
+CONFLUENT_CLOUD_API_SECRET=""
+CONFLUENT_CLOUD_REST_ENDPOINT="https://api.confluent.cloud"
+SCHEMA_REGISTRY_API_KEY="..."
+SCHEMA_REGISTRY_API_SECRET="..."
+SCHEMA_REGISTRY_ENDPOINT="https://psrc-zv01y.northamerica-northeast2.gcp.confluent.cloud"
+```
+</details>
+
+### Environment Variables Reference
+
+| Variable                      | Description                                                                                                                               | Default Value | Required |
+| ----------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------- | ------------- | -------- |
+| BOOTSTRAP_SERVERS             | List of Kafka broker addresses in the format host1:port1,host2:port2 used to establish initial connection to the Kafka cluster (string)   |               | Yes      |
+| CONFIG_PATH                   | File system path to store and retrieve conversation-based configurations for session persistence (Future Implementation) (string)         |               | Yes      |
+| CONFLUENT_CLOUD_API_KEY       | Master API key for Confluent Cloud platform administration, enabling management of resources across your organization (string (min: 1))   |               | Yes      |
+| CONFLUENT_CLOUD_API_SECRET    | Master API secret paired with CONFLUENT_CLOUD_API_KEY for comprehensive Confluent Cloud platform administration (string (min: 1))         |               | Yes      |
+| FLINK_API_KEY                 | Authentication key for accessing Confluent Cloud's Flink services, including compute pools and SQL statement management (string (min: 1)) |               | Yes      |
+| FLINK_API_SECRET              | Secret token paired with FLINK_API_KEY for authenticated access to Confluent Cloud's Flink services (string (min: 1))                     |               | Yes      |
+| KAFKA_API_KEY                 | Authentication credential (username) required to establish secure connection with the Kafka cluster (string (min: 1))                     |               | Yes      |
+| KAFKA_API_SECRET              | Authentication credential (password) paired with KAFKA_API_KEY for secure Kafka cluster access (string (min: 1))                          |               | Yes      |
+| SCHEMA_REGISTRY_API_KEY       | Authentication key for accessing Schema Registry services to manage and validate data schemas (string (min: 1))                           |               | Yes      |
+| SCHEMA_REGISTRY_API_SECRET    | Authentication secret paired with SCHEMA_REGISTRY_API_KEY for secure Schema Registry access (string (min: 1))                             |               | Yes      |
+| CONFLUENT_CLOUD_REST_ENDPOINT | Base URL for Confluent Cloud's REST API services (default)                                                                                |               | No       |
+| FLINK_COMPUTE_POOL_ID         | Unique identifier for the Flink compute pool, must start with 'lfcp-' prefix (string)                                                     |               | No       |
+| FLINK_DATABASE_NAME           | Name of the associated Kafka cluster used as a database reference in Flink SQL operations (string (min: 1))                               |               | No       |
+| FLINK_ENV_ID                  | Unique identifier for the Flink environment, must start with 'env-' prefix (string)                                                       |               | No       |
+| FLINK_ENV_NAME                | Human-readable name for the Flink environment used for identification and display purposes (string (min: 1))                              |               | No       |
+| FLINK_ORG_ID                  | Organization identifier within Confluent Cloud for Flink resource management (string (min: 1))                                            |               | No       |
+| FLINK_REST_ENDPOINT           | Base URL for Confluent Cloud's Flink REST API endpoints used for SQL statement and compute pool management (string)                       |               | No       |
+| KAFKA_CLUSTER_ID              | Unique identifier for the Kafka cluster within Confluent Cloud ecosystem (string (min: 1))                                                |               | No       |
+| KAFKA_ENV_ID                  | Environment identifier for Kafka cluster, must start with 'env-' prefix (string)                                                          |               | No       |
+| KAFKA_REST_ENDPOINT           | REST API endpoint for Kafka cluster management and administration (string)                                                                |               | No       |
+| SCHEMA_REGISTRY_ENDPOINT      | URL endpoint for accessing Schema Registry services to manage data schemas (string)                                                       |               | No       |
+
+### Usage
+
+This MCP server is designed to be used with various MCP clients, such as Claude Desktop or Goose CLI/Desktop.  The specific configuration and interaction will depend on the client you are using.  However, the general steps are:
+
+1. **Build:** Follow the instructions in the [Developer Guide](#developer-guide) to build and run the server from source. This typically involves:
+    - Installing dependencies (`npm install`)
+    - Building the project (`npm run build` or `npm run dev`)
+
+2. **Configure your MCP Client:**  Each client will have its own way of specifying the MCP server's address and any required credentials.  You'll need to configure your client (e.g., Claude, Goose) to connect to the address where this server is running (likely `localhost` with a specific port). The port the server runs on may be configured by an environment variable.
+
+3. **Start the MCP Client:**  Once your client is configured to connect to the MCP server, you can start your mcp client and on startup - it will stand up an instance of this MCP server locally.  This instance will be responsible for managing data schemas and interacting with Confluent Cloud on your behalf.
+
+4. **Interact with Confluent through the Client:** Once the client is connected, you can use the client's interface to interact with Confluent Cloud resources.  The client will send requests to this MCP server, which will then interact with Confluent Cloud on your behalf.
+
+### Configuring Claude Desktop
+
+See [here](https://modelcontextprotocol.io/quickstart/user) for more details about installing Claude Desktop and MCP servers.
+
+To configure Claude Desktop to use this MCP server:
+
+1. **Open Claude Desktop Configuration**
+   - On Mac: `~/Library/Application Support/Claude/claude_desktop_config.json`
+   - On Windows: `%APPDATA%\Claude\claude_desktop_config.json`
+
+2. **Edit Configuration File**
+   - Open the config file in your preferred text editor
+   - Add or modify the configuration using one of the following methods:
+
+   <details>
+   <summary>Option 1: Run from source</summary>
+
+   ```json
+   {
+     "mcpServers": {
+       "confluent": {
+         "command": "node",
+         "args": [
+           "--env-file",
+           "/path/to/confluent-mcp-server/.env",
+           "/path/to/confluent-mcp-server/dist/index.js"
+         ]
+       }
+     }
+   }
+   ```
+   </details>
+
+   <details>
+   <summary>Option 2: Run from npx</summary>
+
+   ```json
+   {
+     "mcpServers": {
+       "confluent": {
+         "command": "npx",
+         "args": [
+           "-y"
+           "@confluentinc/mcp-confluent",
+           "-e",
+           "/path/to/confluent-mcp-server/.env"
+         ]
+       }
+     }
+   }
+   ```
+   </details>
+
+   Replace `/path/to/confluent-mcp-server/` with the actual path where you've installed this MCP server.
+
+1. **Restart Claude Desktop**
+   - Close and reopen Claude Desktop for the changes to take effect
+   - The MCP server will automatically start when Claude Desktop launches
+
+Now Claude Desktop will be configured to use your local MCP server for Confluent interactions.
+
+![Claude Tools](assets/claude-tools.png)
+
+### Configuring Goose CLI
+
+See [here](https://block.github.io/goose/docs/quickstart#install-an-extension) for detailed instructions on how to install the Goose CLI.
+
+Once installed, follow these steps:
+
+1. **Run the Configuration Command:**
+   ```bash
+   goose configure
+   ```
+
+2. **Follow the Interactive Prompts:**
+   - Select `Add extension`
+   - Choose `Command-line Extension`
+   - Enter `mcp-confluent` as the extension name
+   - Choose one of the following configuration methods:
+
+   <details>
+   <summary>Option 1: Run from source</summary>
+
+   ```bash
+   node --env-file /path/to/confluent-mcp-server/.env /path/to/confluent-mcp-server/dist/index.js
+   ```
+   </details>
+
+   <details>
+   <summary>Option 2: Run from npx</summary>
+
+   ```bash
+   npx -y @confluentinc/mcp-confluent -e /path/to/confluent-mcp-server/.env
+   ```
+   </details>
+
+   - When asked about requiring sudo/admin privileges, select `No`
+
+Replace `/path/to/confluent-mcp-server/` with the actual path where you've installed this MCP server.
+
+![Goose Configure](assets/goose-configure.png)
+
+## Developer Guide
+
+### Project Structure
+
+```sh
+/
+├── src/                 # Source code
+│   ├── confluent/       # Code related to Confluent integration (API clients, etc.)
+│   ├── tools/           # Tool implementations (each tool in a separate file)
+│   ├── index.ts         # Main entry point for the server
+│   └── ...              # Other server logic, utilities, etc.
+├── dist/                # Compiled output (TypeScript -> JavaScript)
+├── openapi.json         # OpenAPI specification for Confluent Cloud
+├── .env                 # Environment variables (example - should be copied and filled)
+├── README.md            # This file
+└── package.json         # Node.js project metadata and dependencies
+```
+
+### Building and Running
+
+1. **Install Dependencies:**
+
+    ```bash
+    npm install
+    ```
+
+2. **Development Mode (watch for changes):**
+
+    ```bash
+    npm run dev
+    ```
+
+    This command compiles the TypeScript code to JavaScript and automatically rebuilds when changes are detected in the `src/` directory.
+
+3. **Production Build (one-time compilation):**
+
+    ```bash
+    npm run build
+    ```
+
+4. **Start the Server:**
+
+    ```bash
+    npm run start
+    ```
+
+### Testing
+
+#### MCP Inspector
+
+For testing MCP servers, you can use [MCP Inspector](https://modelcontextprotocol.io/docs/tools/inspector) which is an interactive developer tool for testing and debugging MCP servers.
+
+```bash
+# make sure you've already built the project either in dev mode or by running npm run build
+npx @modelcontextprotocol/inspector node --env-file $PATH_TO_PROJECT/.env /$PATH_TO_PROJECT/dist/index.js
+```
+
+### Adding a New Tool
+
+1. Add a new enum to the enum class `ToolName`.
+2. Add your new tool to the handlers map in the `ToolFactory` class.
+3. Create a new file, exporting the class that extends `BaseToolHandler`.
+    1. Implement the `handle` method of the base class.
+    2. Implement the `getToolConfig` method of the base class.
+4. Once satisfied, add it to the set of `enabledTools` in `index.ts`.
+
+### Generating Types
+
+```bash
+# as of v7.5.2 there is a bug when using allOf w/ required https://github.com/openapi-ts/openapi-typescript/issues/1474. need --empty-objects-unknown flag to avoid it
+npx openapi-typescript ./openapi.json -o ./src/confluent/openapi-schema.d.ts --empty-objects-unknown
+```
+
+### Contributing
+
+Bug reports and feedback is appreciated in the form of Github Issues. For guidelines on contributing please see [CONTRIBUTING.md](CONTRIBUTING.MD)

package/dist/cli.d.ts

@@ -0,0 +1,14 @@
+export interface CLIOptions {
+    envFile?: string;
+}
+/**
+ * Parse command line arguments with strong typing
+ * @returns Parsed CLI options
+ */
+export declare function parseCliArgs(): CLIOptions;
+/**
+ * Load environment variables from file if specified in options
+ * @param options CLI options containing envFile path
+ */
+export declare function loadEnvironmentVariables(options: CLIOptions): void;
+//# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"AAMA,MAAM,WAAW,UAAU;IACzB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;;GAGG;AACH,wBAAgB,YAAY,IAAI,UAAU,CAwBzC;AAED;;;GAGG;AACH,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,UAAU,GAAG,IAAI,CAsBlE"}

package/dist/cli.js

@@ -0,0 +1,53 @@
+import { Command } from "@commander-js/extra-typings";
+import * as dotenv from "dotenv";
+import fs from "fs";
+import path from "path";
+/**
+ * Parse command line arguments with strong typing
+ * @returns Parsed CLI options
+ */
+export function parseCliArgs() {
+    const program = new Command()
+        .name("mcp-confluent")
+        .description("Confluent MCP Server - Model Context Protocol implementation for Confluent Cloud")
+        .version(process.env.npm_package_version ?? "dev")
+        .option("-e, --env-file <path>", "Load environment variables from file")
+        .action((options) => {
+        if (options.envFile) {
+            loadEnvironmentVariables(options);
+        }
+    })
+        .allowExcessArguments(false)
+        .exitOverride();
+    try {
+        // Parse arguments and get options (no need for generic type parameter with extra-typings)
+        return program.parse().opts();
+    }
+    catch {
+        // This block is reached when --help or --version is called
+        // as these will throw an error due to exitOverride()
+        process.exit(0);
+    }
+}
+/**
+ * Load environment variables from file if specified in options
+ * @param options CLI options containing envFile path
+ */
+export function loadEnvironmentVariables(options) {
+    if (options.envFile) {
+        const envPath = path.resolve(options.envFile);
+        // Check if file exists
+        if (!fs.existsSync(envPath)) {
+            console.error(`Environment file not found: ${envPath}`);
+            return;
+        }
+        // Load environment variables from file
+        const result = dotenv.config({ path: envPath });
+        if (result.error) {
+            console.error(`Error loading environment variables: ${result.error.message}`);
+            return;
+        }
+        console.error(`Loaded environment variables from ${envPath}`);
+    }
+}
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,6BAA6B,CAAC;AACtD,OAAO,KAAK,MAAM,MAAM,QAAQ,CAAC;AACjC,OAAO,EAAE,MAAM,IAAI,CAAC;AACpB,OAAO,IAAI,MAAM,MAAM,CAAC;AAOxB;;;GAGG;AACH,MAAM,UAAU,YAAY;IAC1B,MAAM,OAAO,GAAG,IAAI,OAAO,EAAE;SAC1B,IAAI,CAAC,eAAe,CAAC;SACrB,WAAW,CACV,kFAAkF,CACnF;SACA,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,mBAAmB,IAAI,KAAK,CAAC;SACjD,MAAM,CAAC,uBAAuB,EAAE,sCAAsC,CAAC;SACvE,MAAM,CAAC,CAAC,OAAO,EAAE,EAAE;QAClB,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC;YACpB,wBAAwB,CAAC,OAAO,CAAC,CAAC;QACpC,CAAC;IACH,CAAC,CAAC;SACD,oBAAoB,CAAC,KAAK,CAAC;SAC3B,YAAY,EAAE,CAAC;IAElB,IAAI,CAAC;QACH,0FAA0F;QAC1F,OAAO,OAAO,CAAC,KAAK,EAAE,CAAC,IAAI,EAAE,CAAC;IAChC,CAAC;IAAC,MAAM,CAAC;QACP,2DAA2D;QAC3D,qDAAqD;QACrD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,wBAAwB,CAAC,OAAmB;IAC1D,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC;QACpB,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;QAE9C,uBAAuB;QACvB,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,OAAO,CAAC,EAAE,CAAC;YAC5B,OAAO,CAAC,KAAK,CAAC,+BAA+B,OAAO,EAAE,CAAC,CAAC;YACxD,OAAO;QACT,CAAC;QAED,uCAAuC;QACvC,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,CAAC;QAEhD,IAAI,MAAM,CAAC,KAAK,EAAE,CAAC;YACjB,OAAO,CAAC,KAAK,CACX,wCAAwC,MAAM,CAAC,KAAK,CAAC,OAAO,EAAE,CAC/D,CAAC;YACF,OAAO;QACT,CAAC;QAED,OAAO,CAAC,KAAK,CAAC,qCAAqC,OAAO,EAAE,CAAC,CAAC;IAChE,CAAC;AACH,CAAC"}

package/dist/confluent/client-manager.d.ts

@@ -0,0 +1,93 @@
+/**
+ * @fileoverview Provides client management functionality for Kafka and Confluent Cloud services.
+ */
+import { KafkaJS } from "@confluentinc/kafka-javascript";
+import { paths } from "@src/confluent/openapi-schema.js";
+import { Client } from "openapi-fetch";
+/**
+ * Interface for managing Kafka client connections and operations.
+ */
+export interface KafkaClientManager {
+    /** Gets the main Kafka client instance */
+    getKafkaClient(): KafkaJS.Kafka;
+    /** Gets a connected admin client for Kafka administration operations */
+    getAdminClient(): Promise<KafkaJS.Admin>;
+    /** Gets a connected producer client for publishing messages */
+    getProducer(): Promise<KafkaJS.Producer>;
+    /** Gets a connected consumer client for subscribing to topics */
+    getConsumer(): Promise<KafkaJS.Consumer>;
+    /** Disconnects and cleans up all client connections */
+    disconnect(): Promise<void>;
+}
+/**
+ * Interface for managing Confluent Cloud REST client connections.
+ */
+export interface ConfluentCloudRestClientManager {
+    /** Gets a configured REST client for Confluent Cloud Flink operations */
+    getConfluentCloudFlinkRestClient(): Client<paths, `${string}/${string}`>;
+    /** Gets a configured REST client for general Confluent Cloud operations */
+    getConfluentCloudRestClient(): Client<paths, `${string}/${string}`>;
+    /** Gets a configured REST client for Confluent Cloud Schema Registry operations */
+    getConfluentCloudSchemaRegistryRestClient(): Client<paths, `${string}/${string}`>;
+    /** Gets a configured REST client for Confluent Cloud Kafka operations */
+    getConfluentCloudKafkaRestClient(): Client<paths, `${string}/${string}`>;
+    setConfluentCloudRestEndpoint(endpoint: string): void;
+    setConfluentCloudFlinkEndpoint(endpoint: string): void;
+    setConfluentCloudSchemaRegistryEndpoint(endpoint: string): void;
+    setConfluentCloudKafkaRestEndpoint(endpoint: string): void;
+}
+export interface ClientManager extends KafkaClientManager, ConfluentCloudRestClientManager {
+}
+/**
+ * Default implementation of client management for Kafka and Confluent Cloud services.
+ * Manages lifecycle and lazy initialization of various client connections.
+ */
+export declare class DefaultClientManager implements ClientManager {
+    private confluentCloudBaseUrl;
+    private confluentCloudFlinkBaseUrl;
+    private confluentCloudSchemaRegistryBaseUrl;
+    private confluentCloudKafkaRestBaseUrl;
+    private readonly kafkaClient;
+    private readonly adminClient;
+    private readonly producer;
+    private readonly confluentCloudFlinkRestClient;
+    private readonly confluentCloudRestClient;
+    private readonly confluentCloudSchemaRegistryRestClient;
+    private readonly confluentCloudKafkaRestClient;
+    /**
+     * Creates a new DefaultClientManager instance.
+     * @param config - Configuration options for KafkaJS client
+     * @param confluentCloudBaseUrl - Base URL for Confluent Cloud REST API
+     * @param confluentCloudFlinkBaseUrl - Base URL for Flink REST API
+     * @param confluentCloudSchemaRegistryBaseUrl - Base URL for Schema Registry REST API
+     * @param confluentCloudKafkaRestBaseUrl - Base URL for Kafka REST API
+     */
+    constructor(config: KafkaJS.CommonConstructorConfig, confluentCloudBaseUrl?: string, confluentCloudFlinkBaseUrl?: string, confluentCloudSchemaRegistryBaseUrl?: string, confluentCloudKafkaRestBaseUrl?: string);
+    /**
+     * a function that sets a new confluent cloud rest endpoint.
+     * Closes the current client first.
+     * @param endpoint the endpoint to set
+     */
+    setConfluentCloudRestEndpoint(endpoint: string): void;
+    setConfluentCloudFlinkEndpoint(endpoint: string): void;
+    setConfluentCloudSchemaRegistryEndpoint(endpoint: string): void;
+    setConfluentCloudKafkaRestEndpoint(endpoint: string): void;
+    getConsumer(): Promise<KafkaJS.Consumer>;
+    /** @inheritdoc */
+    getKafkaClient(): KafkaJS.Kafka;
+    /** @inheritdoc */
+    getConfluentCloudFlinkRestClient(): Client<paths, `${string}/${string}`>;
+    /** @inheritdoc */
+    getConfluentCloudRestClient(): Client<paths, `${string}/${string}`>;
+    /** @inheritdoc */
+    getConfluentCloudSchemaRegistryRestClient(): Client<paths, `${string}/${string}`>;
+    /** @inheritdoc */
+    getConfluentCloudKafkaRestClient(): Client<paths, `${string}/${string}`>;
+    /** @inheritdoc */
+    getAdminClient(): Promise<KafkaJS.Admin>;
+    /** @inheritdoc */
+    getProducer(): Promise<KafkaJS.Producer>;
+    /** @inheritdoc */
+    disconnect(): Promise<void>;
+}
+//# sourceMappingURL=client-manager.d.ts.map

package/dist/confluent/client-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client-manager.d.ts","sourceRoot":"","sources":["../../src/confluent/client-manager.ts"],"names":[],"mappings":"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"}

package/dist/confluent/client-manager.js

@@ -0,0 +1,148 @@
+/**
+ * @fileoverview Provides client management functionality for Kafka and Confluent Cloud services.
+ */
+import { KafkaJS } from "@confluentinc/kafka-javascript";
+import { confluentCloudAuthMiddleware, confluentCloudFlinkAuthMiddleware, confluentCloudKafkaAuthMiddleware, confluentCloudSchemaRegistryAuthMiddleware, } from "../confluent/middleware.js";
+import { AsyncLazy, Lazy } from "../lazy.js";
+import createClient from "openapi-fetch";
+/**
+ * Default implementation of client management for Kafka and Confluent Cloud services.
+ * Manages lifecycle and lazy initialization of various client connections.
+ */
+export class DefaultClientManager {
+    confluentCloudBaseUrl;
+    confluentCloudFlinkBaseUrl;
+    confluentCloudSchemaRegistryBaseUrl;
+    confluentCloudKafkaRestBaseUrl;
+    kafkaClient;
+    adminClient;
+    producer;
+    confluentCloudFlinkRestClient;
+    confluentCloudRestClient;
+    confluentCloudSchemaRegistryRestClient;
+    confluentCloudKafkaRestClient;
+    /**
+     * Creates a new DefaultClientManager instance.
+     * @param config - Configuration options for KafkaJS client
+     * @param confluentCloudBaseUrl - Base URL for Confluent Cloud REST API
+     * @param confluentCloudFlinkBaseUrl - Base URL for Flink REST API
+     * @param confluentCloudSchemaRegistryBaseUrl - Base URL for Schema Registry REST API
+     * @param confluentCloudKafkaRestBaseUrl - Base URL for Kafka REST API
+     */
+    constructor(config, confluentCloudBaseUrl, confluentCloudFlinkBaseUrl, confluentCloudSchemaRegistryBaseUrl, confluentCloudKafkaRestBaseUrl) {
+        this.confluentCloudBaseUrl = confluentCloudBaseUrl || "";
+        this.confluentCloudFlinkBaseUrl = confluentCloudFlinkBaseUrl || "";
+        this.confluentCloudSchemaRegistryBaseUrl =
+            confluentCloudSchemaRegistryBaseUrl || "";
+        this.confluentCloudKafkaRestBaseUrl = confluentCloudKafkaRestBaseUrl || "";
+        this.kafkaClient = new Lazy(() => new KafkaJS.Kafka(config));
+        this.adminClient = new AsyncLazy(async () => {
+            console.error("Connecting Kafka Admin");
+            const admin = this.kafkaClient.get().admin();
+            await admin.connect();
+            return admin;
+        }, (admin) => admin.disconnect());
+        this.producer = new AsyncLazy(async () => {
+            console.error("Connecting Kafka Producer");
+            const producer = this.kafkaClient.get().producer({
+                kafkaJS: {
+                    acks: 1,
+                    compression: KafkaJS.CompressionTypes.GZIP,
+                },
+            });
+            await producer.connect();
+            return producer;
+        }, (producer) => producer.disconnect());
+        this.confluentCloudRestClient = new Lazy(() => {
+            console.error(`Initializing Confluent Cloud REST client for base URL ${this.confluentCloudBaseUrl}`);
+            const client = createClient({
+                baseUrl: this.confluentCloudBaseUrl,
+            });
+            client.use(confluentCloudAuthMiddleware);
+            return client;
+        });
+        this.confluentCloudFlinkRestClient = new Lazy(() => {
+            console.error(`Initializing Confluent Cloud Flink REST client for base URL ${this.confluentCloudFlinkBaseUrl}`);
+            const client = createClient({
+                baseUrl: this.confluentCloudFlinkBaseUrl,
+            });
+            client.use(confluentCloudFlinkAuthMiddleware);
+            return client;
+        });
+        this.confluentCloudSchemaRegistryRestClient = new Lazy(() => {
+            console.error(`Initializing Confluent Cloud Schema Registry REST client for base URL ${this.confluentCloudSchemaRegistryBaseUrl}`);
+            const client = createClient({
+                baseUrl: this.confluentCloudSchemaRegistryBaseUrl,
+            });
+            client.use(confluentCloudSchemaRegistryAuthMiddleware);
+            return client;
+        });
+        this.confluentCloudKafkaRestClient = new Lazy(() => {
+            console.error(`Initializing Confluent Cloud Kafka REST client for base URL ${this.confluentCloudKafkaRestBaseUrl}`);
+            const client = createClient({
+                baseUrl: this.confluentCloudKafkaRestBaseUrl,
+            });
+            client.use(confluentCloudKafkaAuthMiddleware);
+            return client;
+        });
+    }
+    /**
+     * a function that sets a new confluent cloud rest endpoint.
+     * Closes the current client first.
+     * @param endpoint the endpoint to set
+     */
+    setConfluentCloudRestEndpoint(endpoint) {
+        this.confluentCloudRestClient.close();
+        this.confluentCloudBaseUrl = endpoint;
+    }
+    setConfluentCloudFlinkEndpoint(endpoint) {
+        this.confluentCloudFlinkRestClient.close();
+        this.confluentCloudFlinkBaseUrl = endpoint;
+    }
+    setConfluentCloudSchemaRegistryEndpoint(endpoint) {
+        this.confluentCloudSchemaRegistryRestClient.close();
+        this.confluentCloudSchemaRegistryBaseUrl = endpoint;
+    }
+    setConfluentCloudKafkaRestEndpoint(endpoint) {
+        this.confluentCloudKafkaRestClient.close();
+        this.confluentCloudKafkaRestBaseUrl = endpoint;
+    }
+    getConsumer() {
+        throw new Error("Method not implemented.");
+    }
+    /** @inheritdoc */
+    getKafkaClient() {
+        return this.kafkaClient.get();
+    }
+    /** @inheritdoc */
+    getConfluentCloudFlinkRestClient() {
+        return this.confluentCloudFlinkRestClient.get();
+    }
+    /** @inheritdoc */
+    getConfluentCloudRestClient() {
+        return this.confluentCloudRestClient.get();
+    }
+    /** @inheritdoc */
+    getConfluentCloudSchemaRegistryRestClient() {
+        return this.confluentCloudSchemaRegistryRestClient.get();
+    }
+    /** @inheritdoc */
+    getConfluentCloudKafkaRestClient() {
+        return this.confluentCloudKafkaRestClient.get();
+    }
+    /** @inheritdoc */
+    async getAdminClient() {
+        return this.adminClient.get();
+    }
+    /** @inheritdoc */
+    async getProducer() {
+        return this.producer.get();
+    }
+    /** @inheritdoc */
+    async disconnect() {
+        await this.adminClient.close();
+        await this.producer.close();
+        this.kafkaClient.close();
+    }
+}
+//# sourceMappingURL=client-manager.js.map

package/dist/confluent/client-manager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client-manager.js","sourceRoot":"","sources":["../../src/confluent/client-manager.ts"],"names":[],"mappings":"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"}