@platformatic/kafka 2.10.0 → 2.12.0

package/dist/apis/enumerations.js

@@ -24,7 +24,13 @@ export const allowedGroupProtocols = Object.values(GroupProtocols);
 // ./consumer/fetch.ts
 export const FetchIsolationLevels = { READ_UNCOMMITTED: 0, READ_COMMITTED: 1 };
 export const allowedFetchIsolationLevels = Object.values(FetchIsolationLevels);
-export const ListOffsetTimestamps = { LATEST: -1n, EARLIEST: -2n };
+export const ListOffsetTimestamps = {
+    LATEST: -1n,
+    EARLIEST: -2n,
+    MAX: -3n,
+    EARLIEST_LOCAL: -4n,
+    LATEST_TIERED: -5n
+};
 export const allowedListOffsetTimestamps = Object.values(ListOffsetTimestamps);
 // Admin API
 // ./admin/*-acls.ts - See: https://cwiki.apache.org/confluence/display/KAFKA/KIP-140%3A+Add+administrative+RPCs+for+adding%2C+deleting%2C+and+listing+ACLs
@@ -65,6 +71,8 @@ export const allowedAclPermissionTypes = Object.values(AclPermissionTypes);
 // ./admin/*-configs.ts
 export const ConfigSources = {
     UNKNOWN: 0,
+    DYNAMIC_TOPIC_CONFIG: 1,
+    /** @deprecated Use ConfigSources.DYNAMIC_TOPIC_CONFIG, which is the name Kafka uses for this source. */
     TOPIC_CONFIG: 1,
     DYNAMIC_BROKER_CONFIG: 2,
     DYNAMIC_DEFAULT_BROKER_CONFIG: 3,
@@ -74,7 +82,9 @@ export const ConfigSources = {
     CLIENT_METRICS_CONFIG: 7,
     GROUP_CONFIG: 8
 };
-export const allowedConfigSources = Object.values(ConfigSources);
+// DYNAMIC_TOPIC_CONFIG and its TOPIC_CONFIG alias share the value 1, so the values must be deduplicated:
+// a JSON Schema enum requires unique items and a duplicate would also break any value to label lookup.
+export const allowedConfigSources = Array.from(new Set(Object.values(ConfigSources)));
 export const ConfigResourceTypes = {
     UNKNOWN: 0,
     TOPIC: 2,
@@ -102,12 +112,14 @@ export const allowedIncrementalAlterConfigOperationTypes = Object.values(Increme
 // ./admin/*-client-quotas.ts
 export const ClientQuotaMatchTypes = { EXACT: 0, DEFAULT: 1, ANY: 2 };
 export const allowedClientQuotaMatchTypes = Object.values(ClientQuotaMatchTypes);
-export const ClientQuotaEntityTypes = { CLIENT_ID: 'client-id', USER: 'user' };
+export const ClientQuotaEntityTypes = { CLIENT_ID: 'client-id', USER: 'user', IP: 'ip' };
 export const allowedClientQuotaEntityTypes = Object.values(ClientQuotaEntityTypes);
 export const ClientQuotaKeys = {
     PRODUCER_BYTE_RATE: 'producer_byte_rate',
     CONSUMER_BYTE_RATE: 'consumer_byte_rate',
-    REQUEST_PERCENTAGE: 'request_percentage'
+    REQUEST_PERCENTAGE: 'request_percentage',
+    CONNECTION_CREATION_RATE: 'connection_creation_rate',
+    CONTROLLER_MUTATION_RATE: 'controller_mutation_rate'
 };
 export const allowedClientQuotaKeys = Object.values(ClientQuotaKeys);
 // ./admin/*-scram-credentials.ts
@@ -117,7 +129,37 @@ export const allowedScramMechanisms = Object.values(ScramMechanisms);
 export const DescribeClusterEndpointTypes = { BROKERS: 1, CONTROLLERS: 2 };
 export const allowedDescribeClusterEndpointTypes = Object.values(DescribeClusterEndpointTypes);
 // ./admin/list-groups.ts
-export const ConsumerGroupStates = ['PREPARING_REBALANCE', 'COMPLETING_REBALANCE', 'STABLE', 'DEAD', 'EMPTY'];
+// These are the values Kafka puts on the wire and therefore the values reported back to callers.
+// Note that brokers match the ListGroups states filter case insensitively but not underscore
+// insensitively, so 'PREPARING_REBALANCE' never matches anything: see legacyConsumerGroupStates.
+export const ConsumerGroupStates = [
+    'Unknown',
+    'PreparingRebalance',
+    'CompletingRebalance',
+    'Stable',
+    'Dead',
+    'Empty',
+    'Assigning',
+    'Reconciling',
+    'NotReady'
+];
+// The names of the constants in Kafka's Java ConsumerGroupState enum, which this package used to
+// report and accept. They are still accepted as filters, but are translated to the wire values above.
+export const KafkaConsumerGroupStates = [
+    'PREPARING_REBALANCE',
+    'COMPLETING_REBALANCE',
+    'STABLE',
+    'DEAD',
+    'EMPTY'
+];
+export const legacyConsumerGroupStates = {
+    PREPARING_REBALANCE: 'PreparingRebalance',
+    COMPLETING_REBALANCE: 'CompletingRebalance',
+    STABLE: 'Stable',
+    DEAD: 'Dead',
+    EMPTY: 'Empty'
+};
+export const GroupTypes = ['classic', 'consumer', 'share', 'streams'];
 // ./admin/list-transactions.ts
 export const TransactionStates = [
     'EMPTY',
@@ -128,6 +170,16 @@ export const TransactionStates = [
     'COMPLETE_COMMIT',
     'COMPLETE_ABORT'
 ];
+export const KafkaTransactionStates = [
+    'Empty',
+    'Ongoing',
+    'PrepareCommit',
+    'PrepareAbort',
+    'CompleteCommit',
+    'CompleteAbort',
+    'Dead',
+    'PrepareEpochFence'
+];
 // ./admin/update-features.ts
 export const FeatureUpgradeTypes = { UPGRADE: 1, SAFE_DOWNGRADE: 2, UNSAFE_DOWNGRADE: 3 };
 export const allowedFeatureUpgradeTypes = Object.values(FeatureUpgradeTypes);

package/dist/apis/index.d.ts

@@ -1,6 +1,7 @@
 export * from './callbacks.ts';
 export * from './definitions.ts';
 export * from './enumerations.ts';
+export * from './tagged-fields.ts';
 export * from './types.ts';
 export * from './admin/index.ts';
 export * from './consumer/index.ts';

package/dist/apis/index.js

@@ -2,6 +2,7 @@
 export * from "./callbacks.js";
 export * from "./definitions.js";
 export * from "./enumerations.js";
+export * from "./tagged-fields.js";
 export * from "./types.js";
 // Low-level APIs
 export * from "./admin/index.js";

package/dist/apis/metadata/api-versions-v0.d.ts

@@ -0,0 +1,17 @@
+import { type Reader } from '../../protocol/reader.ts';
+import { Writer } from '../../protocol/writer.ts';
+export type ApiVersionsRequest = Parameters<typeof createRequest>;
+export interface ApiVersionsResponseApi {
+    apiKey: number;
+    name: string;
+    minVersion: number;
+    maxVersion: number;
+}
+export interface ApiVersionsResponse {
+    errorCode: number;
+    apiKeys: ApiVersionsResponseApi[];
+    throttleTimeMs: number;
+}
+export declare function createRequest(_clientSoftwareName: string, _clientSoftwareVersion: string): Writer;
+export declare function parseResponse(_correlationId: number, apiKey: number, apiVersion: number, reader: Reader): ApiVersionsResponse;
+export declare const api: import("../definitions.ts").API<[_clientSoftwareName: string, _clientSoftwareVersion: string], ApiVersionsResponse>;

package/dist/apis/metadata/api-versions-v0.js

@@ -0,0 +1,24 @@
+import { ResponseError } from "../../errors.js";
+import { protocolAPIsById } from "../../protocol/apis.js";
+import { Writer } from "../../protocol/writer.js";
+import { createAPI } from "../definitions.js";
+/* ApiVersions Request (Version: 0) => */
+export function createRequest(_clientSoftwareName, _clientSoftwareVersion) {
+    return Writer.create();
+}
+/* ApiVersions Response (Version: 0) => error_code [api_keys] */
+export function parseResponse(_correlationId, apiKey, apiVersion, reader) {
+    const response = {
+        errorCode: reader.readInt16(),
+        apiKeys: reader.readArray(r => {
+            const apiKey = r.readInt16();
+            return { apiKey, name: protocolAPIsById[apiKey], minVersion: r.readInt16(), maxVersion: r.readInt16() };
+        }, false, false),
+        throttleTimeMs: 0
+    };
+    if (response.errorCode !== 0) {
+        throw new ResponseError(apiKey, apiVersion, { '/': [response.errorCode, null] }, response);
+    }
+    return response;
+}
+export const api = createAPI(18, 0, createRequest, parseResponse, false, false);

package/dist/apis/metadata/api-versions-v1.d.ts

@@ -0,0 +1,17 @@
+import { type Reader } from '../../protocol/reader.ts';
+import { Writer } from '../../protocol/writer.ts';
+export type ApiVersionsRequest = Parameters<typeof createRequest>;
+export interface ApiVersionsResponseApi {
+    apiKey: number;
+    name: string;
+    minVersion: number;
+    maxVersion: number;
+}
+export type ApiVersionsResponse = {
+    errorCode: number;
+    apiKeys: ApiVersionsResponseApi[];
+    throttleTimeMs: number;
+};
+export declare function createRequest(_clientSoftwareName: string, _clientSoftwareVersion: string): Writer;
+export declare function parseResponse(_correlationId: number, apiKey: number, apiVersion: number, reader: Reader): ApiVersionsResponse;
+export declare const api: import("../definitions.ts").API<[_clientSoftwareName: string, _clientSoftwareVersion: string], ApiVersionsResponse>;

package/dist/apis/metadata/api-versions-v1.js

@@ -0,0 +1,39 @@
+import { ResponseError } from "../../errors.js";
+import { protocolAPIsById } from "../../protocol/apis.js";
+import { Writer } from "../../protocol/writer.js";
+import { createAPI } from "../definitions.js";
+/*
+  ApiVersions Request (Version: 1) =>
+*/
+export function createRequest(_clientSoftwareName, _clientSoftwareVersion) {
+    return Writer.create();
+}
+/*
+  ApiVersions Response (Version: 1) => error_code [api_keys] throttle_time_ms
+    error_code => INT16
+    api_keys => api_key min_version max_version
+      api_key => INT16
+      min_version => INT16
+      max_version => INT16
+    throttle_time_ms => INT32
+*/
+export function parseResponse(_correlationId, apiKey, apiVersion, reader) {
+    const response = {
+        errorCode: reader.readInt16(),
+        apiKeys: reader.readArray(r => {
+            const apiKey = r.readInt16();
+            return {
+                apiKey,
+                name: protocolAPIsById[apiKey],
+                minVersion: r.readInt16(),
+                maxVersion: r.readInt16()
+            };
+        }, false, false),
+        throttleTimeMs: reader.readInt32()
+    };
+    if (response.errorCode !== 0) {
+        throw new ResponseError(apiKey, apiVersion, { '/': [response.errorCode, null] }, response);
+    }
+    return response;
+}
+export const api = createAPI(18, 1, createRequest, parseResponse, false, false);

package/dist/apis/metadata/api-versions-v2.d.ts

@@ -0,0 +1,17 @@
+import { type Reader } from '../../protocol/reader.ts';
+import { Writer } from '../../protocol/writer.ts';
+export type ApiVersionsRequest = Parameters<typeof createRequest>;
+export interface ApiVersionsResponseApi {
+    apiKey: number;
+    name: string;
+    minVersion: number;
+    maxVersion: number;
+}
+export type ApiVersionsResponse = {
+    errorCode: number;
+    apiKeys: ApiVersionsResponseApi[];
+    throttleTimeMs: number;
+};
+export declare function createRequest(_clientSoftwareName: string, _clientSoftwareVersion: string): Writer;
+export declare function parseResponse(_correlationId: number, apiKey: number, apiVersion: number, reader: Reader): ApiVersionsResponse;
+export declare const api: import("../definitions.ts").API<[_clientSoftwareName: string, _clientSoftwareVersion: string], ApiVersionsResponse>;

package/dist/apis/metadata/api-versions-v2.js

@@ -0,0 +1,39 @@
+import { ResponseError } from "../../errors.js";
+import { protocolAPIsById } from "../../protocol/apis.js";
+import { Writer } from "../../protocol/writer.js";
+import { createAPI } from "../definitions.js";
+/*
+  ApiVersions Request (Version: 2) =>
+*/
+export function createRequest(_clientSoftwareName, _clientSoftwareVersion) {
+    return Writer.create();
+}
+/*
+  ApiVersions Response (Version: 2) => error_code [api_keys] throttle_time_ms
+    error_code => INT16
+    api_keys => api_key min_version max_version
+      api_key => INT16
+      min_version => INT16
+      max_version => INT16
+    throttle_time_ms => INT32
+*/
+export function parseResponse(_correlationId, apiKey, apiVersion, reader) {
+    const response = {
+        errorCode: reader.readInt16(),
+        apiKeys: reader.readArray(r => {
+            const apiKey = r.readInt16();
+            return {
+                apiKey,
+                name: protocolAPIsById[apiKey],
+                minVersion: r.readInt16(),
+                maxVersion: r.readInt16()
+            };
+        }, false, false),
+        throttleTimeMs: reader.readInt32()
+    };
+    if (response.errorCode !== 0) {
+        throw new ResponseError(apiKey, apiVersion, { '/': [response.errorCode, null] }, response);
+    }
+    return response;
+}
+export const api = createAPI(18, 2, createRequest, parseResponse, false, false);

package/dist/apis/metadata/api-versions-v3.d.ts

@@ -7,11 +7,25 @@ export interface ApiVersionsResponseApi {
     minVersion: number;
     maxVersion: number;
 }
-export type ApiVersionsResponse = {
+export interface ApiVersionsResponseSupportedFeature {
+    name: string;
+    minVersion: number;
+    maxVersion: number;
+}
+export interface ApiVersionsResponseFinalizedFeature {
+    name: string;
+    maxVersionLevel: number;
+    minVersionLevel: number;
+}
+export interface ApiVersionsResponse {
     errorCode: number;
     apiKeys: ApiVersionsResponseApi[];
     throttleTimeMs: number;
-};
+    supportedFeatures?: ApiVersionsResponseSupportedFeature[];
+    finalizedFeaturesEpoch?: bigint;
+    finalizedFeatures?: ApiVersionsResponseFinalizedFeature[];
+    zkMigrationReady?: boolean;
+}
 export declare function createRequest(clientSoftwareName: string, clientSoftwareVersion: string): Writer;
 export declare function parseResponse(_correlationId: number, apiKey: number, apiVersion: number, reader: Reader): ApiVersionsResponse;
 export declare const api: import("../definitions.ts").API<[clientSoftwareName: string, clientSoftwareVersion: string], ApiVersionsResponse>;

package/dist/apis/metadata/api-versions-v3.js

@@ -2,6 +2,7 @@ import { ResponseError } from "../../errors.js";
 import { protocolAPIsById } from "../../protocol/apis.js";
 import { Writer } from "../../protocol/writer.js";
 import { createAPI } from "../definitions.js";
+import { readKnownTaggedFields } from "../tagged-fields.js";
 /*
   ApiVersions Request (Version: 3) => client_software_name client_software_version TAG_BUFFER
     client_software_name => COMPACT_STRING
@@ -18,21 +19,59 @@ export function createRequest(clientSoftwareName, clientSoftwareVersion) {
       min_version => INT16
       max_version => INT16
     throttle_time_ms => INT32
+    TAG_BUFFER => supported_features finalized_features_epoch finalized_features zk_migration_ready
+      supported_features (0) => [name min_version max_version TAG_BUFFER]
+        name => COMPACT_STRING
+        min_version => INT16
+        max_version => INT16
+      finalized_features_epoch (1) => INT64
+      finalized_features (2) => [name max_version_level min_version_level TAG_BUFFER]
+        name => COMPACT_STRING
+        max_version_level => INT16
+        min_version_level => INT16
+      zk_migration_ready (3) => BOOLEAN
 */
 export function parseResponse(_correlationId, apiKey, apiVersion, reader) {
+    const errorCode = reader.readInt16();
+    // Kafka returns an ApiVersions v0-framed response when v3 is unsupported.
+    // Stop before reading the compact array, which would interpret the legacy
+    // array length as flexible protocol data and desynchronize the response.
+    if (errorCode !== 0) {
+        throw new ResponseError(apiKey, apiVersion, { '/': [errorCode, null] }, { errorCode, apiKeys: [], throttleTimeMs: 0 });
+    }
     const response = {
-        errorCode: reader.readInt16(),
+        errorCode,
         apiKeys: reader.readArray(r => {
             const apiKey = r.readInt16();
-            return {
+            const api = {
                 apiKey,
                 name: protocolAPIsById[apiKey],
                 minVersion: r.readInt16(),
                 maxVersion: r.readInt16()
             };
-        }),
-        throttleTimeMs: reader.readInt32()
+            r.readTaggedFields();
+            return api;
+        }, true, false),
+        throttleTimeMs: reader.readInt32(),
+        supportedFeatures: [],
+        finalizedFeaturesEpoch: -1n,
+        finalizedFeatures: [],
+        zkMigrationReady: false
     };
+    readKnownTaggedFields(reader, {
+        0: payload => {
+            response.supportedFeatures = payload.readArray(r => ({ name: r.readString(), minVersion: r.readInt16(), maxVersion: r.readInt16() }), true, true);
+        },
+        1: payload => {
+            response.finalizedFeaturesEpoch = payload.readInt64();
+        },
+        2: payload => {
+            response.finalizedFeatures = payload.readArray(r => ({ name: r.readString(), maxVersionLevel: r.readInt16(), minVersionLevel: r.readInt16() }), true, true);
+        },
+        3: payload => {
+            response.zkMigrationReady = payload.readBoolean();
+        }
+    });
     if (response.errorCode !== 0) {
         throw new ResponseError(apiKey, apiVersion, { '/': [response.errorCode, null] }, response);
     }

package/dist/apis/metadata/api-versions-v4.d.ts

@@ -7,11 +7,25 @@ export interface ApiVersionsResponseApi {
     minVersion: number;
     maxVersion: number;
 }
-export type ApiVersionsResponse = {
+export interface ApiVersionsResponseSupportedFeature {
+    name: string;
+    minVersion: number;
+    maxVersion: number;
+}
+export interface ApiVersionsResponseFinalizedFeature {
+    name: string;
+    maxVersionLevel: number;
+    minVersionLevel: number;
+}
+export interface ApiVersionsResponse {
     errorCode: number;
     apiKeys: ApiVersionsResponseApi[];
     throttleTimeMs: number;
-};
+    supportedFeatures?: ApiVersionsResponseSupportedFeature[];
+    finalizedFeaturesEpoch?: bigint;
+    finalizedFeatures?: ApiVersionsResponseFinalizedFeature[];
+    zkMigrationReady?: boolean;
+}
 export declare function createRequest(clientSoftwareName: string, clientSoftwareVersion: string): Writer;
 export declare function parseResponse(_correlationId: number, apiKey: number, apiVersion: number, reader: Reader): ApiVersionsResponse;
 export declare const api: import("../definitions.ts").API<[clientSoftwareName: string, clientSoftwareVersion: string], ApiVersionsResponse>;

package/dist/apis/metadata/api-versions-v4.js

@@ -2,6 +2,7 @@ import { ResponseError } from "../../errors.js";
 import { protocolAPIsById } from "../../protocol/apis.js";
 import { Writer } from "../../protocol/writer.js";
 import { createAPI } from "../definitions.js";
+import { readKnownTaggedFields } from "../tagged-fields.js";
 /*
   ApiVersions Request (Version: 4) => client_software_name client_software_version TAG_BUFFER
     client_software_name => COMPACT_STRING
@@ -18,21 +19,52 @@ export function createRequest(clientSoftwareName, clientSoftwareVersion) {
       min_version => INT16
       max_version => INT16
     throttle_time_ms => INT32
+    TAG_BUFFER => supported_features finalized_features_epoch finalized_features zk_migration_ready
+      supported_features (0) => [name min_version max_version TAG_BUFFER]
+        name => COMPACT_STRING
+        min_version => INT16
+        max_version => INT16
+      finalized_features_epoch (1) => INT64
+      finalized_features (2) => [name max_version_level min_version_level TAG_BUFFER]
+        name => COMPACT_STRING
+        max_version_level => INT16
+        min_version_level => INT16
+      zk_migration_ready (3) => BOOLEAN
 */
 export function parseResponse(_correlationId, apiKey, apiVersion, reader) {
     const response = {
         errorCode: reader.readInt16(),
         apiKeys: reader.readArray(r => {
             const apiKey = r.readInt16();
-            return {
+            const api = {
                 apiKey,
                 name: protocolAPIsById[apiKey],
                 minVersion: r.readInt16(),
                 maxVersion: r.readInt16()
             };
-        }),
-        throttleTimeMs: reader.readInt32()
+            r.readTaggedFields();
+            return api;
+        }, true, false),
+        throttleTimeMs: reader.readInt32(),
+        supportedFeatures: [],
+        finalizedFeaturesEpoch: -1n,
+        finalizedFeatures: [],
+        zkMigrationReady: false
     };
+    readKnownTaggedFields(reader, {
+        0: payload => {
+            response.supportedFeatures = payload.readArray(r => ({ name: r.readString(), minVersion: r.readInt16(), maxVersion: r.readInt16() }), true, true);
+        },
+        1: payload => {
+            response.finalizedFeaturesEpoch = payload.readInt64();
+        },
+        2: payload => {
+            response.finalizedFeatures = payload.readArray(r => ({ name: r.readString(), maxVersionLevel: r.readInt16(), minVersionLevel: r.readInt16() }), true, true);
+        },
+        3: payload => {
+            response.zkMigrationReady = payload.readBoolean();
+        }
+    });
     if (response.errorCode !== 0) {
         throw new ResponseError(apiKey, apiVersion, { '/': [response.errorCode, null] }, response);
     }

package/dist/apis/metadata/find-coordinator-v0.d.ts

@@ -0,0 +1,18 @@
+import { type Reader } from '../../protocol/reader.ts';
+import { Writer } from '../../protocol/writer.ts';
+export type FindCoordinatorRequest = Parameters<typeof createRequest>;
+export interface FindCoordinatorResponseCoordinator {
+    key: string;
+    nodeId: number;
+    host: string;
+    port: number;
+    errorCode: number;
+    errorMessage: string | null;
+}
+export interface FindCoordinatorResponse {
+    throttleTimeMs: number;
+    coordinators: FindCoordinatorResponseCoordinator[];
+}
+export declare function createRequest(_keyType: number, coordinatorKeys: string[]): Writer;
+export declare function parseResponse(_correlationId: number, apiKey: number, apiVersion: number, reader: Reader): FindCoordinatorResponse;
+export declare const api: import("../definitions.ts").API<[_keyType: number, coordinatorKeys: string[]], FindCoordinatorResponse>;

package/dist/apis/metadata/find-coordinator-v0.js

@@ -0,0 +1,24 @@
+import { ResponseError } from "../../errors.js";
+import { Writer } from "../../protocol/writer.js";
+import { createAPI } from "../definitions.js";
+/* FindCoordinator Request (Version: 0) => group_id */
+export function createRequest(_keyType, coordinatorKeys) {
+    return Writer.create().appendString(coordinatorKeys[0] ?? '', false);
+}
+/* FindCoordinator Response (Version: 0) => error_code coordinator_id host port */
+export function parseResponse(_correlationId, apiKey, apiVersion, reader) {
+    const coordinator = {
+        key: '',
+        errorCode: reader.readInt16(),
+        errorMessage: null,
+        nodeId: reader.readInt32(),
+        host: reader.readString(false),
+        port: reader.readInt32()
+    };
+    const response = { throttleTimeMs: 0, coordinators: [coordinator] };
+    if (coordinator.errorCode !== 0) {
+        throw new ResponseError(apiKey, apiVersion, { '/coordinators/0': [coordinator.errorCode, null] }, response);
+    }
+    return response;
+}
+export const api = createAPI(10, 0, createRequest, parseResponse, false, false);

package/dist/apis/metadata/find-coordinator-v1.d.ts

@@ -0,0 +1,18 @@
+import { type Reader } from '../../protocol/reader.ts';
+import { Writer } from '../../protocol/writer.ts';
+export type FindCoordinatorRequest = Parameters<typeof createRequest>;
+export interface FindCoordinatorResponseCoordinator {
+    key: string;
+    nodeId: number;
+    host: string;
+    port: number;
+    errorCode: number;
+    errorMessage: string | null;
+}
+export interface FindCoordinatorResponse {
+    throttleTimeMs: number;
+    coordinators: FindCoordinatorResponseCoordinator[];
+}
+export declare function createRequest(keyType: number, coordinatorKeys: string[]): Writer;
+export declare function parseResponse(_correlationId: number, apiKey: number, apiVersion: number, reader: Reader): FindCoordinatorResponse;
+export declare const api: import("../definitions.ts").API<[keyType: number, coordinatorKeys: string[]], FindCoordinatorResponse>;

package/dist/apis/metadata/find-coordinator-v1.js

@@ -0,0 +1,41 @@
+import { ResponseError } from "../../errors.js";
+import { Writer } from "../../protocol/writer.js";
+import { createAPI } from "../definitions.js";
+/*
+  FindCoordinator Request (Version: 1) => key key_type
+    key => STRING
+    key_type => INT8
+*/
+export function createRequest(keyType, coordinatorKeys) {
+    return Writer.create().appendString(coordinatorKeys[0] ?? '', false).appendInt8(keyType);
+}
+/*
+  FindCoordinator Response (Version: 1) => throttle_time_ms error_code error_message node_id host port
+    throttle_time_ms => INT32
+    error_code => INT16
+    error_message => NULLABLE_STRING
+    node_id => INT32
+    host => STRING
+    port => INT32
+*/
+export function parseResponse(_correlationId, apiKey, apiVersion, reader) {
+    const response = {
+        throttleTimeMs: reader.readInt32(),
+        coordinators: [
+            {
+                key: '',
+                errorCode: reader.readInt16(),
+                errorMessage: reader.readNullableString(false),
+                nodeId: reader.readInt32(),
+                host: reader.readString(false),
+                port: reader.readInt32()
+            }
+        ]
+    };
+    const coordinator = response.coordinators[0];
+    if (coordinator.errorCode !== 0) {
+        throw new ResponseError(apiKey, apiVersion, { '/coordinators/0': [coordinator.errorCode, coordinator.errorMessage] }, response);
+    }
+    return response;
+}
+export const api = createAPI(10, 1, createRequest, parseResponse, false, false);

package/dist/apis/metadata/find-coordinator-v2.d.ts

@@ -0,0 +1,18 @@
+import { type Reader } from '../../protocol/reader.ts';
+import { Writer } from '../../protocol/writer.ts';
+export type FindCoordinatorRequest = Parameters<typeof createRequest>;
+export interface FindCoordinatorResponseCoordinator {
+    key: string;
+    nodeId: number;
+    host: string;
+    port: number;
+    errorCode: number;
+    errorMessage: string | null;
+}
+export interface FindCoordinatorResponse {
+    throttleTimeMs: number;
+    coordinators: FindCoordinatorResponseCoordinator[];
+}
+export declare function createRequest(keyType: number, coordinatorKeys: string[]): Writer;
+export declare function parseResponse(_correlationId: number, apiKey: number, apiVersion: number, reader: Reader): FindCoordinatorResponse;
+export declare const api: import("../definitions.ts").API<[keyType: number, coordinatorKeys: string[]], FindCoordinatorResponse>;

package/dist/apis/metadata/find-coordinator-v2.js

@@ -0,0 +1,41 @@
+import { ResponseError } from "../../errors.js";
+import { Writer } from "../../protocol/writer.js";
+import { createAPI } from "../definitions.js";
+/*
+  FindCoordinator Request (Version: 2) => key key_type
+    key => STRING
+    key_type => INT8
+*/
+export function createRequest(keyType, coordinatorKeys) {
+    return Writer.create().appendString(coordinatorKeys[0] ?? '', false).appendInt8(keyType);
+}
+/*
+  FindCoordinator Response (Version: 2) => throttle_time_ms error_code error_message node_id host port
+    throttle_time_ms => INT32
+    error_code => INT16
+    error_message => NULLABLE_STRING
+    node_id => INT32
+    host => STRING
+    port => INT32
+*/
+export function parseResponse(_correlationId, apiKey, apiVersion, reader) {
+    const response = {
+        throttleTimeMs: reader.readInt32(),
+        coordinators: [
+            {
+                key: '',
+                errorCode: reader.readInt16(),
+                errorMessage: reader.readNullableString(false),
+                nodeId: reader.readInt32(),
+                host: reader.readString(false),
+                port: reader.readInt32()
+            }
+        ]
+    };
+    const coordinator = response.coordinators[0];
+    if (coordinator.errorCode !== 0) {
+        throw new ResponseError(apiKey, apiVersion, { '/coordinators/0': [coordinator.errorCode, coordinator.errorMessage] }, response);
+    }
+    return response;
+}
+export const api = createAPI(10, 2, createRequest, parseResponse, false, false);