@platformatic/kafka 2.10.0 → 2.12.0

package/README.md

@@ -108,6 +108,12 @@ await forEach(
 await consumer.close()
 ```
 
+### Consuming messages in batches
+
+The [`examples/batching`](./examples/batching) example uses the [`hwp`](https://www.npmjs.com/package/hwp)
+`batchIterator` operator to process messages in batches and commit offsets after each batch. The batch is emitted
+when it reaches the configured size or when its timeout expires, so the final batch can contain fewer messages.
+
 ### Admin
 
 ```typescript
@@ -349,6 +355,7 @@ Many of the methods accept the same options as the client's constructors. The co
 - [Metrics](./docs/metrics.md)
 - [Diagnostic and Instrumentation](./docs/diagnostic.md)
 - [Other APIs and Types](./docs/other.md)
+- [Kafka API Codec Changelogs](https://github.com/platformatic/kafka/blob/main/docs/internals/api-changelog/README.md)
 - [Migrating from KafkaJS](./migration/README.md)
 
 ## Requirements

package/dist/apis/admin/alter-client-quotas-v0.d.ts

@@ -0,0 +1,40 @@
+import { type NullableString } from '../../protocol/definitions.ts';
+import { type Reader } from '../../protocol/reader.ts';
+import { Writer } from '../../protocol/writer.ts';
+import type { ClientQuotaEntityType, ClientQuotaKey } from '../enumerations.ts';
+export type { ClientQuotaEntityType, ClientQuotaKey } from '../enumerations.ts';
+export interface AlterClientQuotasRequestEntity {
+    entityType: ClientQuotaEntityType;
+    entityName?: NullableString;
+}
+export interface AlterClientQuotaRequestOpAddition {
+    key: ClientQuotaKey;
+    value: number;
+    remove: false;
+}
+export interface AlterClientQuotaRequestOpRemoval {
+    key: ClientQuotaKey;
+    remove: true;
+}
+export type AlterClientQuotasRequestOp = AlterClientQuotaRequestOpAddition | AlterClientQuotaRequestOpRemoval;
+export interface AlterClientQuotasRequestEntry {
+    entities: AlterClientQuotasRequestEntity[];
+    ops: AlterClientQuotasRequestOp[];
+}
+export type AlterClientQuotasRequest = Parameters<typeof createRequest>;
+export interface AlterClientQuotasResponseEntity {
+    entityType: ClientQuotaEntityType;
+    entityName: NullableString;
+}
+export interface AlterClientQuotasResponseEntries {
+    errorCode: number;
+    errorMessage: NullableString;
+    entity: AlterClientQuotasResponseEntity[];
+}
+export interface AlterClientQuotasResponse {
+    throttleTimeMs: number;
+    entries: AlterClientQuotasResponseEntries[];
+}
+export declare function createRequest(entries: AlterClientQuotasRequestEntry[], validateOnly: boolean): Writer;
+export declare function parseResponse(_correlationId: number, apiKey: number, apiVersion: number, reader: Reader): AlterClientQuotasResponse;
+export declare const api: import("../definitions.ts").API<[entries: AlterClientQuotasRequestEntry[], validateOnly: boolean], AlterClientQuotasResponse>;

package/dist/apis/admin/alter-client-quotas-v0.js

@@ -0,0 +1,60 @@
+import { ResponseError } from "../../errors.js";
+import { Writer } from "../../protocol/writer.js";
+import { createAPI } from "../definitions.js";
+/*
+  AlterClientQuotas Request (Version: 0) => [entries] validate_only
+    entries => [entity] [ops]
+      entity => entity_type entity_name
+        entity_type => STRING
+        entity_name => NULLABLE_STRING
+      ops => key value remove
+        key => STRING
+        value => FLOAT64
+        remove => BOOLEAN
+    validate_only => BOOLEAN
+*/
+export function createRequest(entries, validateOnly) {
+    return Writer.create()
+        .appendArray(entries, (w, entry) => {
+        w.appendArray(entry.entities, (w, entity) => {
+            w.appendString(entity.entityType, false).appendString(entity.entityName, false);
+        }, false, false).appendArray(entry.ops, (w, op) => {
+            w.appendString(op.key, false)
+                .appendFloat64(op.value ?? 0)
+                .appendBoolean(op.remove);
+        }, false, false);
+    }, false, false)
+        .appendBoolean(validateOnly);
+}
+/*
+  AlterClientQuotas Response (Version: 0) => throttle_time_ms [entries]
+    throttle_time_ms => INT32
+    entries => error_code error_message [entity]
+      error_code => INT16
+      error_message => NULLABLE_STRING
+      entity => entity_type entity_name
+        entity_type => STRING
+        entity_name => NULLABLE_STRING
+*/
+export function parseResponse(_correlationId, apiKey, apiVersion, reader) {
+    const errors = [];
+    const response = {
+        throttleTimeMs: reader.readInt32(),
+        entries: reader.readArray((r, index) => {
+            const entry = {
+                errorCode: r.readInt16(),
+                errorMessage: r.readNullableString(false),
+                entity: r.readArray(r => ({ entityType: r.readString(false), entityName: r.readNullableString(false) }), false, false)
+            };
+            if (entry.errorCode !== 0) {
+                errors.push([`/entries/${index}`, [entry.errorCode, entry.errorMessage]]);
+            }
+            return entry;
+        }, false, false)
+    };
+    if (errors.length) {
+        throw new ResponseError(apiKey, apiVersion, Object.fromEntries(errors), response);
+    }
+    return response;
+}
+export const api = createAPI(49, 0, createRequest, parseResponse, false, false);

package/dist/apis/admin/alter-client-quotas-v1.d.ts

@@ -1,18 +1,19 @@
 import { type NullableString } from '../../protocol/definitions.ts';
 import { type Reader } from '../../protocol/reader.ts';
 import { Writer } from '../../protocol/writer.ts';
-import { type ClientQuotaEntityTypeValue, type ClientQuotaKeyValue } from '../enumerations.ts';
+import type { ClientQuotaEntityType, ClientQuotaKey } from '../enumerations.ts';
+export type { ClientQuotaEntityType, ClientQuotaKey } from '../enumerations.ts';
 export interface AlterClientQuotasRequestEntity {
-    entityType: ClientQuotaEntityTypeValue;
+    entityType: ClientQuotaEntityType;
     entityName?: NullableString;
 }
 export interface AlterClientQuotaRequestOpAddition {
-    key: ClientQuotaKeyValue;
+    key: ClientQuotaKey;
     value: number;
     remove: false;
 }
 export interface AlterClientQuotaRequestOpRemoval {
-    key: ClientQuotaKeyValue;
+    key: ClientQuotaKey;
     remove: true;
 }
 export type AlterClientQuotasRequestOp = AlterClientQuotaRequestOpAddition | AlterClientQuotaRequestOpRemoval;
@@ -22,7 +23,7 @@ export interface AlterClientQuotasRequestEntry {
 }
 export type AlterClientQuotasRequest = Parameters<typeof createRequest>;
 export interface AlterClientQuotasResponseEntity {
-    entityType: string;
+    entityType: ClientQuotaEntityType;
     entityName: NullableString;
 }
 export interface AlterClientQuotasResponseEntries {

package/dist/apis/admin/alter-client-quotas-v1.js

@@ -46,10 +46,11 @@ export function parseResponse(_correlationId, apiKey, apiVersion, reader) {
                 errorCode: r.readInt16(),
                 errorMessage: r.readNullableString(),
                 entity: r.readArray(r => {
-                    return {
+                    const entity = {
                         entityType: r.readString(),
                         entityName: r.readNullableString()
                     };
+                    return entity;
                 })
             };
             if (entry.errorCode !== 0) {
@@ -58,6 +59,7 @@ export function parseResponse(_correlationId, apiKey, apiVersion, reader) {
             return entry;
         })
     };
+    reader.readTaggedFields();
     if (errors.length) {
         throw new ResponseError(apiKey, apiVersion, Object.fromEntries(errors), response);
     }

package/dist/apis/admin/alter-configs-v0.d.ts

@@ -0,0 +1,7 @@
+import { type Reader } from '../../protocol/reader.ts';
+import { Writer } from '../../protocol/writer.ts';
+import { type AlterConfigsRequestResource, type AlterConfigsResponse } from './alter-configs-v2.ts';
+export * from './alter-configs-v2.ts';
+export declare function createRequest(resources: AlterConfigsRequestResource[], validateOnly: boolean): Writer;
+export declare function parseResponse(_: number, apiKey: number, apiVersion: number, reader: Reader): AlterConfigsResponse;
+export declare const api: import("../definitions.ts").API<unknown[], AlterConfigsResponse>;

package/dist/apis/admin/alter-configs-v0.js

@@ -0,0 +1,10 @@
+import { ResponseError } from "../../errors.js";
+import { Writer } from "../../protocol/writer.js";
+import { createAPI } from "../definitions.js";
+export * from "./alter-configs-v2.js";
+/* AlterConfigs Request (Version: 0) => [resources] validate_only; configs => name value. Response entries use classic strings. */
+export function createRequest(resources, validateOnly) { return Writer.create().appendArray(resources, (w, r) => w.appendInt8(r.resourceType).appendString(r.resourceName, false).appendArray(r.configs, (w, c) => w.appendString(c.name, false).appendString(c.value, false), false, false), false, false).appendBoolean(validateOnly); }
+export function parseResponse(_, apiKey, apiVersion, reader) { const errors = []; const response = { throttleTimeMs: reader.readInt32(), responses: reader.readArray((r, i) => { const errorCode = r.readInt16(); const errorMessage = r.readNullableString(false); if (errorCode)
+        errors.push([`/responses/${i}`, [errorCode, errorMessage]]); return { errorCode, errorMessage, resourceType: r.readInt8(), resourceName: r.readString(false) }; }, false, false) }; if (errors.length)
+    throw new ResponseError(apiKey, apiVersion, Object.fromEntries(errors), response); return response; }
+export const api = createAPI(33, 0, createRequest, parseResponse, false, false);

package/dist/apis/admin/alter-configs-v1.d.ts

@@ -0,0 +1,2 @@
+export * from './alter-configs-v0.ts';
+export declare const api: import("../definitions.ts").API<unknown[], import("./alter-configs-v2.ts").AlterConfigsResponse>;

package/dist/apis/admin/alter-configs-v1.js

@@ -0,0 +1,5 @@
+import { createAPI } from "../definitions.js";
+import { createRequest, parseResponse } from "./alter-configs-v0.js";
+export * from "./alter-configs-v0.js";
+/* AlterConfigs v1 uses the v0 wire shape and adds no fields. */
+export const api = createAPI(33, 1, createRequest, parseResponse, false, false);

package/dist/apis/admin/alter-configs-v2.js

@@ -42,14 +42,16 @@ export function parseResponse(_correlationId, apiKey, apiVersion, reader) {
             if (errorCode !== 0) {
                 errors.push([`/responses/${i}`, [errorCode, errorMessage]]);
             }
-            return {
+            const result = {
                 errorCode,
                 errorMessage,
                 resourceType: r.readInt8(),
                 resourceName: r.readString()
             };
+            return result;
         })
     };
+    reader.readTaggedFields();
     if (errors.length) {
         throw new ResponseError(apiKey, apiVersion, Object.fromEntries(errors), response);
     }

package/dist/apis/admin/alter-partition-reassignments-v0.d.ts

@@ -1,9 +1,9 @@
-import { type NullableString } from '../../protocol/definitions.ts';
+import { type Nullable, type NullableString } from '../../protocol/definitions.ts';
 import { type Reader } from '../../protocol/reader.ts';
 import { Writer } from '../../protocol/writer.ts';
 export interface AlterPartitionReassignmentsRequestPartition {
     partitionIndex: number;
-    replicas: number[];
+    replicas: Nullable<number[]>;
 }
 export interface AlterPartitionReassignmentsRequestTopic {
     name: string;
@@ -21,6 +21,7 @@ export interface AlterPartitionReassignmentsResponseResponse {
 }
 export interface AlterPartitionReassignmentsResponse {
     throttleTimeMs: number;
+    allowReplicationFactorChange: boolean;
     errorCode: number;
     errorMessage: NullableString;
     responses: AlterPartitionReassignmentsResponseResponse[];

package/dist/apis/admin/alter-partition-reassignments-v0.js

@@ -42,10 +42,11 @@ export function parseResponse(_correlationId, apiKey, apiVersion, reader) {
     }
     const response = {
         throttleTimeMs,
+        allowReplicationFactorChange: true,
         errorCode,
         errorMessage,
         responses: reader.readArray((r, i) => {
-            return {
+            const topic = {
                 name: r.readString(),
                 partitions: r.readArray((r, j) => {
                     const partition = {
@@ -59,8 +60,10 @@ export function parseResponse(_correlationId, apiKey, apiVersion, reader) {
                     return partition;
                 })
             };
+            return topic;
         })
     };
+    reader.readTaggedFields();
     if (errors.length) {
         throw new ResponseError(apiKey, apiVersion, Object.fromEntries(errors), response);
     }

package/dist/apis/admin/alter-partition-reassignments-v1.d.ts

@@ -1,9 +1,9 @@
-import { type NullableString } from '../../protocol/definitions.ts';
+import { type Nullable, type NullableString } from '../../protocol/definitions.ts';
 import { type Reader } from '../../protocol/reader.ts';
 import { Writer } from '../../protocol/writer.ts';
 export interface AlterPartitionReassignmentsRequestPartition {
     partitionIndex: number;
-    replicas: number[];
+    replicas: Nullable<number[]>;
 }
 export interface AlterPartitionReassignmentsRequestTopic {
     name: string;
@@ -15,15 +15,17 @@ export interface AlterPartitionReassignmentsResponsePartition {
     errorCode: number;
     errorMessage: NullableString;
 }
-export interface AlterPartitionReassignmentsResponseResponse {
+export interface AlterPartitionReassignmentsResponseTopic {
     name: string;
     partitions: AlterPartitionReassignmentsResponsePartition[];
 }
+export type AlterPartitionReassignmentsResponseResponse = AlterPartitionReassignmentsResponseTopic;
 export interface AlterPartitionReassignmentsResponse {
     throttleTimeMs: number;
+    allowReplicationFactorChange: boolean;
     errorCode: number;
     errorMessage: NullableString;
-    responses: AlterPartitionReassignmentsResponseResponse[];
+    responses: AlterPartitionReassignmentsResponseTopic[];
 }
 export declare function createRequest(timeoutMs: number, allowReplicationFactorChange: boolean, topics: AlterPartitionReassignmentsRequestTopic[]): Writer;
 export declare function parseResponse(_correlationId: number, apiKey: number, apiVersion: number, reader: Reader): AlterPartitionReassignmentsResponse;

package/dist/apis/admin/alter-partition-reassignments-v1.js

@@ -23,9 +23,10 @@ export function createRequest(timeoutMs, allowReplicationFactorChange, topics) {
         .appendTaggedFields();
 }
 /*
-  AlterPartitionReassignments Response (Version: 1) => throttle_time_ms error_code error_message [responses] TAG_BUFFER
-    throttle_time_ms => INT32
-    error_code => INT16
+  AlterPartitionReassignments Response (Version: 1) => throttle_time_ms allow_replication_factor_change error_code error_message [responses] TAG_BUFFER
+  throttle_time_ms => INT32
+  allow_replication_factor_change => BOOLEAN
+  error_code => INT16
     error_message => COMPACT_NULLABLE_STRING
     responses => name [partitions] TAG_BUFFER
       name => COMPACT_STRING
@@ -37,6 +38,7 @@ export function createRequest(timeoutMs, allowReplicationFactorChange, topics) {
 export function parseResponse(_correlationId, apiKey, apiVersion, reader) {
     const errors = [];
     const throttleTimeMs = reader.readInt32();
+    const allowReplicationFactorChange = reader.readBoolean();
     const errorCode = reader.readInt16();
     const errorMessage = reader.readNullableString();
     /* c8 ignore next 3 - Hard to test */
@@ -45,6 +47,7 @@ export function parseResponse(_correlationId, apiKey, apiVersion, reader) {
     }
     const response = {
         throttleTimeMs,
+        allowReplicationFactorChange,
         errorCode,
         errorMessage,
         responses: reader.readArray((r, i) => {
@@ -64,6 +67,7 @@ export function parseResponse(_correlationId, apiKey, apiVersion, reader) {
             };
         })
     };
+    reader.readTaggedFields();
     if (errors.length) {
         throw new ResponseError(apiKey, apiVersion, Object.fromEntries(errors), response);
     }

package/dist/apis/admin/alter-partition-v0.d.ts

@@ -0,0 +1,40 @@
+import { type Reader } from '../../protocol/reader.ts';
+import { Writer } from '../../protocol/writer.ts';
+export interface AlterPartitionRequestPartition {
+    partitionIndex: number;
+    leaderEpoch: number;
+    newIsrWithEpochs: AlterPartitionRequestBroker[];
+    leaderRecoveryState?: number;
+    partitionEpoch: number;
+}
+export interface AlterPartitionRequestBroker {
+    brokerId: number;
+    brokerEpoch: bigint;
+}
+export interface AlterPartitionRequestTopic {
+    topicName: string;
+    partitions: AlterPartitionRequestPartition[];
+}
+export type AlterPartitionRequest = Parameters<typeof createRequest>;
+export interface AlterPartitionResponsePartition {
+    partitionIndex: number;
+    errorCode: number;
+    leaderId: number;
+    leaderEpoch: number;
+    isr: number[];
+    leaderRecoveryState: number;
+    partitionEpoch: number;
+}
+export interface AlterPartitionResponseTopic {
+    topicName: string;
+    topicId: string;
+    partitions: AlterPartitionResponsePartition[];
+}
+export interface AlterPartitionResponse {
+    throttleTimeMs: number;
+    errorCode: number;
+    topics: AlterPartitionResponseTopic[];
+}
+export declare function createRequest(brokerId: number, brokerEpoch: bigint, topics: AlterPartitionRequestTopic[]): Writer;
+export declare function parseResponse(_correlationId: number, apiKey: number, apiVersion: number, reader: Reader): AlterPartitionResponse;
+export declare const api: import("../definitions.ts").API<[brokerId: number, brokerEpoch: bigint, topics: AlterPartitionRequestTopic[]], AlterPartitionResponse>;

package/dist/apis/admin/alter-partition-v0.js

@@ -0,0 +1,81 @@
+import { ResponseError } from "../../errors.js";
+import { Writer } from "../../protocol/writer.js";
+import { createAPI } from "../definitions.js";
+/*
+  AlterPartition Request (Version: 0) => broker_id broker_epoch [topics] TAG_BUFFER
+    broker_id => INT32
+    broker_epoch => INT64
+    topics => topic_name [partitions] TAG_BUFFER
+      topic_name => COMPACT_STRING
+      partitions => partition_index leader_epoch [new_isr] partition_epoch TAG_BUFFER
+        partition_index => INT32
+        leader_epoch => INT32
+        new_isr => INT32
+        partition_epoch => INT32
+*/
+export function createRequest(brokerId, brokerEpoch, topics) {
+    return Writer.create()
+        .appendInt32(brokerId)
+        .appendInt64(brokerEpoch)
+        .appendArray(topics, (writer, topic) => {
+        writer.appendString(topic.topicName).appendArray(topic.partitions, (writer, partition) => {
+            writer
+                .appendInt32(partition.partitionIndex)
+                .appendInt32(partition.leaderEpoch)
+                .appendArray(partition.newIsrWithEpochs, (writer, broker) => writer.appendInt32(broker.brokerId), true, false)
+                .appendInt32(partition.partitionEpoch);
+        });
+    })
+        .appendTaggedFields();
+}
+/*
+  AlterPartition Response (Version: 0) => throttle_time_ms error_code [topics] TAG_BUFFER
+    throttle_time_ms => INT32
+    error_code => INT16
+    topics => topic_name [partitions] TAG_BUFFER
+      topic_name => COMPACT_STRING
+      partitions => partition_index error_code leader_id leader_epoch [isr] partition_epoch TAG_BUFFER
+        partition_index => INT32
+        error_code => INT16
+        leader_id => INT32
+        leader_epoch => INT32
+        isr => INT32
+        partition_epoch => INT32
+*/
+export function parseResponse(_correlationId, apiKey, apiVersion, reader) {
+    const errors = [];
+    const throttleTimeMs = reader.readInt32();
+    const errorCode = reader.readInt16();
+    if (errorCode !== 0) {
+        errors.push(['/', [errorCode, null]]);
+    }
+    const response = {
+        throttleTimeMs,
+        errorCode,
+        topics: reader.readArray((reader, topicIndex) => ({
+            topicName: reader.readString(),
+            topicId: '00000000-0000-0000-0000-000000000000',
+            partitions: reader.readArray((reader, partitionIndex) => {
+                const partition = {
+                    partitionIndex: reader.readInt32(),
+                    errorCode: reader.readInt16(),
+                    leaderId: reader.readInt32(),
+                    leaderEpoch: reader.readInt32(),
+                    isr: reader.readArray(reader => reader.readInt32(), true, false),
+                    leaderRecoveryState: 0,
+                    partitionEpoch: reader.readInt32()
+                };
+                if (partition.errorCode !== 0) {
+                    errors.push([`/topics/${topicIndex}/partitions/${partitionIndex}`, [partition.errorCode, null]]);
+                }
+                return partition;
+            })
+        }))
+    };
+    reader.readTaggedFields();
+    if (errors.length) {
+        throw new ResponseError(apiKey, apiVersion, Object.fromEntries(errors), response);
+    }
+    return response;
+}
+export const api = createAPI(56, 0, createRequest, parseResponse);

package/dist/apis/admin/alter-partition-v1.d.ts

@@ -0,0 +1,37 @@
+import { type Reader } from '../../protocol/reader.ts';
+import { Writer } from '../../protocol/writer.ts';
+import type { AlterPartitionRequestBroker } from './alter-partition-v0.ts';
+export interface AlterPartitionRequestPartition {
+    partitionIndex: number;
+    leaderEpoch: number;
+    newIsrWithEpochs: AlterPartitionRequestBroker[];
+    leaderRecoveryState: number;
+    partitionEpoch: number;
+}
+export interface AlterPartitionRequestTopic {
+    topicName: string;
+    partitions: AlterPartitionRequestPartition[];
+}
+export type AlterPartitionRequest = Parameters<typeof createRequest>;
+export interface AlterPartitionResponsePartition {
+    partitionIndex: number;
+    errorCode: number;
+    leaderId: number;
+    leaderEpoch: number;
+    isr: number[];
+    leaderRecoveryState: number;
+    partitionEpoch: number;
+}
+export interface AlterPartitionResponseTopic {
+    topicName: string;
+    topicId: string;
+    partitions: AlterPartitionResponsePartition[];
+}
+export interface AlterPartitionResponse {
+    throttleTimeMs: number;
+    errorCode: number;
+    topics: AlterPartitionResponseTopic[];
+}
+export declare function createRequest(brokerId: number, brokerEpoch: bigint, topics: AlterPartitionRequestTopic[]): Writer;
+export declare function parseResponse(_correlationId: number, apiKey: number, apiVersion: number, reader: Reader): AlterPartitionResponse;
+export declare const api: import("../definitions.ts").API<[brokerId: number, brokerEpoch: bigint, topics: AlterPartitionRequestTopic[]], AlterPartitionResponse>;

package/dist/apis/admin/alter-partition-v1.js

@@ -0,0 +1,84 @@
+import { ResponseError } from "../../errors.js";
+import { Writer } from "../../protocol/writer.js";
+import { createAPI } from "../definitions.js";
+/*
+  AlterPartition Request (Version: 1) => broker_id broker_epoch [topics] TAG_BUFFER
+    broker_id => INT32
+    broker_epoch => INT64
+    topics => topic_name [partitions] TAG_BUFFER
+      topic_name => COMPACT_STRING
+      partitions => partition_index leader_epoch [new_isr] leader_recovery_state partition_epoch TAG_BUFFER
+        partition_index => INT32
+        leader_epoch => INT32
+        new_isr => INT32
+        leader_recovery_state => INT8
+        partition_epoch => INT32
+*/
+export function createRequest(brokerId, brokerEpoch, topics) {
+    return Writer.create()
+        .appendInt32(brokerId)
+        .appendInt64(brokerEpoch)
+        .appendArray(topics, (writer, topic) => {
+        writer.appendString(topic.topicName).appendArray(topic.partitions, (writer, partition) => {
+            writer
+                .appendInt32(partition.partitionIndex)
+                .appendInt32(partition.leaderEpoch)
+                .appendArray(partition.newIsrWithEpochs, (writer, broker) => writer.appendInt32(broker.brokerId), true, false)
+                .appendInt8(partition.leaderRecoveryState)
+                .appendInt32(partition.partitionEpoch);
+        });
+    })
+        .appendTaggedFields();
+}
+/*
+  AlterPartition Response (Version: 1) => throttle_time_ms error_code [topics] TAG_BUFFER
+    throttle_time_ms => INT32
+    error_code => INT16
+    topics => topic_name [partitions] TAG_BUFFER
+      topic_name => COMPACT_STRING
+      partitions => partition_index error_code leader_id leader_epoch [isr] leader_recovery_state partition_epoch TAG_BUFFER
+        partition_index => INT32
+        error_code => INT16
+        leader_id => INT32
+        leader_epoch => INT32
+        isr => INT32
+        leader_recovery_state => INT8
+        partition_epoch => INT32
+*/
+export function parseResponse(_correlationId, apiKey, apiVersion, reader) {
+    const errors = [];
+    const throttleTimeMs = reader.readInt32();
+    const errorCode = reader.readInt16();
+    if (errorCode !== 0) {
+        errors.push(['/', [errorCode, null]]);
+    }
+    const response = {
+        throttleTimeMs,
+        errorCode,
+        topics: reader.readArray((reader, topicIndex) => ({
+            topicName: reader.readString(),
+            topicId: '00000000-0000-0000-0000-000000000000',
+            partitions: reader.readArray((reader, partitionIndex) => {
+                const partition = {
+                    partitionIndex: reader.readInt32(),
+                    errorCode: reader.readInt16(),
+                    leaderId: reader.readInt32(),
+                    leaderEpoch: reader.readInt32(),
+                    isr: reader.readArray(reader => reader.readInt32(), true, false),
+                    leaderRecoveryState: reader.readInt8(),
+                    partitionEpoch: reader.readInt32()
+                };
+                if (partition.errorCode !== 0) {
+                    errors.push([`/topics/${topicIndex}/partitions/${partitionIndex}`, [partition.errorCode, null]]);
+                }
+                return partition;
+            })
+        }))
+    };
+    reader.readTaggedFields();
+    if (errors.length) {
+        throw new ResponseError(apiKey, apiVersion, Object.fromEntries(errors), response);
+    }
+    return response;
+}
+export const api = createAPI(56, 1, createRequest, parseResponse);

package/dist/apis/admin/alter-partition-v2.d.ts

@@ -0,0 +1,36 @@
+import { type Reader } from '../../protocol/reader.ts';
+import { Writer } from '../../protocol/writer.ts';
+import type { AlterPartitionRequestBroker } from './alter-partition-v0.ts';
+export interface AlterPartitionRequestPartition {
+    partitionIndex: number;
+    leaderEpoch: number;
+    newIsrWithEpochs: AlterPartitionRequestBroker[];
+    leaderRecoveryState: number;
+    partitionEpoch: number;
+}
+export interface AlterPartitionRequestTopic {
+    topicId: string;
+    partitions: AlterPartitionRequestPartition[];
+}
+export type AlterPartitionRequest = Parameters<typeof createRequest>;
+export interface AlterPartitionResponsePartition {
+    partitionIndex: number;
+    errorCode: number;
+    leaderId: number;
+    leaderEpoch: number;
+    isr: number[];
+    leaderRecoveryState: number;
+    partitionEpoch: number;
+}
+export interface AlterPartitionResponseTopic {
+    topicId: string;
+    partitions: AlterPartitionResponsePartition[];
+}
+export interface AlterPartitionResponse {
+    throttleTimeMs: number;
+    errorCode: number;
+    topics: AlterPartitionResponseTopic[];
+}
+export declare function createRequest(brokerId: number, brokerEpoch: bigint, topics: AlterPartitionRequestTopic[]): Writer;
+export declare function parseResponse(_correlationId: number, apiKey: number, apiVersion: number, reader: Reader): AlterPartitionResponse;
+export declare const api: import("../definitions.ts").API<[brokerId: number, brokerEpoch: bigint, topics: AlterPartitionRequestTopic[]], AlterPartitionResponse>;