apache-iggy 0.5.2 → 0.6.0-edge.2

package/dist/wire/command-set.js

@@ -28,12 +28,14 @@ import { getGroup } from './consumer-group/get-group.command.js';
 import { getGroups } from './consumer-group/get-groups.command.js';
 import { leaveGroup } from './consumer-group/leave-group.command.js';
 import { deleteGroup } from './consumer-group/delete-group.command.js';
+import { ensureConsumerGroup, ensureConsumerGroupAndJoin } from './consumer-group/ensure-group.virtual.command.js';
 import { purgeTopic } from './topic/purge-topic.command.js';
 import { createTopic } from './topic/create-topic.command.js';
 import { updateTopic } from './topic/update-topic.command.js';
 import { getTopic } from './topic/get-topic.command.js';
 import { getTopics } from './topic/get-topics.command.js';
 import { deleteTopic } from './topic/delete-topic.command.js';
+import { ensureTopic } from './topic/ensure-topic.virtual.command.js';
 import { getOffset } from './offset/get-offset.command.js';
 import { storeOffset } from './offset/store-offset.command.js';
 import { deleteOffset } from './offset/delete-offset.command.js';
@@ -46,11 +48,13 @@ import { getStream } from './stream/get-stream.command.js';
 import { getStreams } from './stream/get-streams.command.js';
 import { deleteStream } from './stream/delete-stream.command.js';
 import { purgeStream } from './stream/purge-stream.command.js';
+import { ensureStream } from './stream/ensure-stream.virtual.command.js';
 import { createPartition } from './partition/create-partition.command.js';
 import { deletePartition } from './partition/delete-partition.command.js';
 import { deleteSegments } from './segment/delete-segments.command.js';
 import { getStats } from './system/get-stats.command.js';
 import { ping } from './system/ping.command.js';
+import { getClusterMetadata } from './cluster/get-cluster-metadata.command.js';
 import { getTokens } from './token/get-tokens.command.js';
 import { createToken } from './token/create-token.command.js';
 import { deleteToken } from './token/delete-token.command.js';
@@ -91,7 +95,8 @@ const streamAPI = (c) => ({
     create: createStream(c),
     update: updateStream(c),
     delete: deleteStream(c),
-    purge: purgeStream(c)
+    purge: purgeStream(c),
+    ensure: ensureStream(c)
 });
 const topicAPI = (c) => ({
     get: getTopic(c),
@@ -99,7 +104,8 @@ const topicAPI = (c) => ({
     create: createTopic(c),
     update: updateTopic(c),
     delete: deleteTopic(c),
-    purge: purgeTopic(c)
+    purge: purgeTopic(c),
+    ensure: ensureTopic(c)
 });
 const partitionAPI = (c) => ({
     create: createPartition(c),
@@ -115,6 +121,8 @@ const groupAPI = (c) => ({
     join: joinGroup(c),
     leave: leaveGroup(c),
     delete: deleteGroup(c),
+    ensure: ensureConsumerGroup(c),
+    ensureAndJoin: ensureConsumerGroupAndJoin(c)
 });
 const offsetAPI = (c) => ({
     get: getOffset(c),
@@ -130,6 +138,9 @@ const systemAPI = (c) => ({
     ping: ping(c),
     getStats: getStats(c)
 });
+const clusterAPI = (c) => ({
+    getClusterMetadata: getClusterMetadata(c)
+});
 export class AbstractAPI {
     clientProvider;
     constructor(getClient) {
@@ -149,6 +160,7 @@ export class CommandAPI extends AbstractAPI {
     offset = offsetAPI(this.clientProvider);
     message = messageAPI(this.clientProvider);
     system = systemAPI(this.clientProvider);
+    cluster = clusterAPI(this.clientProvider);
     constructor(c) {
         super(c);
     }

package/dist/wire/command.code.d.ts

@@ -20,6 +20,7 @@ export declare const COMMAND_CODE: {
     Ping: number;
     GetStats: number;
     GetSnapshot: number;
+    GetClusterMetadata: number;
     GetMe: number;
     GetClient: number;
     GetClients: number;

package/dist/wire/command.code.js

@@ -21,6 +21,7 @@ export const COMMAND_CODE = {
     Ping: 1,
     GetStats: 10,
     GetSnapshot: 11, // @TODO GET_SNAPSHOT_FILE_CODE: u32 = 11
+    GetClusterMetadata: 12, // GET_CLUSTER_METADATA_CODE: u32 = 12
     GetMe: 20,
     GetClient: 21,
     GetClients: 22,

package/dist/wire/command.utils.js

@@ -16,12 +16,6 @@
  * specific language governing permissions and limitations
  * under the License.
  */
-// export function wrapCommand<I, O>(cmd: Command<I, O>) {
-//   return (client: RawClient) =>
-//     async (arg: I) => cmd.deserialize(
-//       await client.sendCommand(cmd.code, cmd.serialize(arg))
-//     );
-// };
 export function wrapCommand(cmd) {
     return (getClient) => async (arg) => cmd.deserialize(await (await getClient()).sendCommand(cmd.code, cmd.serialize(arg)));
 }

package/dist/wire/consumer-group/create-group.command.d.ts

@@ -22,12 +22,11 @@ import { type ConsumerGroup } from './group.utils.js';
 export type CreateGroup = {
     streamId: Id;
     topicId: Id;
-    groupId: number;
     name: string;
 };
 export declare const CREATE_GROUP: {
     code: number;
-    serialize: ({ streamId, topicId, groupId, name }: CreateGroup) => Buffer<ArrayBuffer>;
+    serialize: ({ streamId, topicId, name }: CreateGroup) => Buffer<ArrayBuffer>;
     deserialize: (r: CommandResponse) => ConsumerGroup;
 };
 export declare const createGroup: (getClient: import("../../client/client.type.js").ClientProvider) => (arg: CreateGroup) => Promise<ConsumerGroup>;

package/dist/wire/consumer-group/create-group.command.js

@@ -22,13 +22,13 @@ import { COMMAND_CODE } from '../command.code.js';
 import { deserializeConsumerGroup } from './group.utils.js';
 export const CREATE_GROUP = {
     code: COMMAND_CODE.CreateGroup,
-    serialize: ({ streamId, topicId, groupId, name }) => {
+    serialize: ({ streamId, topicId, name }) => {
+        // Consumer group ID is now auto-assigned by the server, not sent in the protocol
         const bName = Buffer.from(name);
         if (bName.length < 1 || bName.length > 255)
             throw new Error('Consumer group name should be between 1 and 255 bytes');
-        const b = Buffer.allocUnsafe(5);
-        b.writeUInt32LE(groupId);
-        b.writeUInt8(bName.length, 4);
+        const b = Buffer.allocUnsafe(1);
+        b.writeUInt8(bName.length, 0);
         return Buffer.concat([
             serializeIdentifier(streamId),
             serializeIdentifier(topicId),

package/dist/wire/consumer-group/create-group.command.test.js

@@ -24,11 +24,10 @@ describe('CreateGroup', () => {
         const s1 = {
             streamId: 5,
             topicId: 2,
-            groupId: 1,
             name: 'test-group'
         };
         it('serialize group id & name into buffer', () => {
-            assert.deepEqual(CREATE_GROUP.serialize(s1).length, 6 + 6 + 5 + s1.name.length);
+            assert.deepEqual(CREATE_GROUP.serialize(s1).length, 6 + 6 + 1 + s1.name.length);
         });
         it('throw on name < 1', () => {
             const s2 = { ...s1, name: '' };

package/dist/wire/consumer-group/ensure-group.virtual.command.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Licensed to the Apache Software Foundation (ASF) under one
+ * or more contributor license agreements.  See the NOTICE file
+ * distributed with this work for additional information
+ * regarding copyright ownership.  The ASF licenses this file
+ * to you under the Apache License, Version 2.0 (the
+ * "License"); you may not use this file except in compliance
+ * with the License.  You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing,
+ * software distributed under the License is distributed on an
+ * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ * KIND, either express or implied.  See the License for the
+ * specific language governing permissions and limitations
+ * under the License.
+ */
+import type { Id } from '../identifier.utils.js';
+import { ClientProvider } from '../../client/index.js';
+export declare const ensureConsumerGroup: (c: ClientProvider) => (streamId: Id, topicId: Id, groupName: string) => Promise<import("./group.utils.js").ConsumerGroup>;
+export declare const ensureConsumerGroupAndJoin: (c: ClientProvider) => (streamId: Id, topicId: Id, groupName: string) => Promise<import("./group.utils.js").ConsumerGroup>;
+//# sourceMappingURL=ensure-group.virtual.command.d.ts.map

package/dist/wire/consumer-group/ensure-group.virtual.command.js

@@ -0,0 +1,33 @@
+/**
+ * Licensed to the Apache Software Foundation (ASF) under one
+ * or more contributor license agreements.  See the NOTICE file
+ * distributed with this work for additional information
+ * regarding copyright ownership.  The ASF licenses this file
+ * to you under the Apache License, Version 2.0 (the
+ * "License"); you may not use this file except in compliance
+ * with the License.  You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing,
+ * software distributed under the License is distributed on an
+ * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ * KIND, either express or implied.  See the License for the
+ * specific language governing permissions and limitations
+ * under the License.
+ */
+import { createGroup } from './create-group.command.js';
+import { getGroup } from './get-group.command.js';
+import { joinGroup } from './join-group.command.js';
+export const ensureConsumerGroup = (c) => async function ensureConsumerGroup(streamId, topicId, groupName) {
+    const group = await getGroup(c)({ streamId, topicId, groupId: groupName });
+    if (!group)
+        return await createGroup(c)({ streamId, topicId, name: groupName });
+    return group;
+};
+export const ensureConsumerGroupAndJoin = (c) => async function ensureConsumerGroupAndJoin(streamId, topicId, groupName) {
+    const group = await ensureConsumerGroup(c)(streamId, topicId, groupName);
+    await joinGroup(c)({ streamId, topicId, groupId: group.id });
+    return group;
+};
+//# sourceMappingURL=ensure-group.virtual.command.js.map

package/dist/wire/consumer-group/get-group.command.d.ts

@@ -27,7 +27,7 @@ export type GetGroup = {
 export declare const GET_GROUP: {
     code: number;
     serialize: ({ streamId, topicId, groupId }: GetGroup) => Buffer<ArrayBuffer>;
-    deserialize: (r: CommandResponse) => ConsumerGroup;
+    deserialize: (r: CommandResponse) => ConsumerGroup | null;
 };
-export declare const getGroup: (getClient: import("../../client/client.type.js").ClientProvider) => (arg: GetGroup) => Promise<ConsumerGroup>;
+export declare const getGroup: (getClient: import("../../client/client.type.js").ClientProvider) => (arg: GetGroup) => Promise<ConsumerGroup | null>;
 //# sourceMappingURL=get-group.command.d.ts.map

package/dist/wire/consumer-group/get-group.command.js

@@ -25,6 +25,8 @@ export const GET_GROUP = {
         return serializeTargetGroup(streamId, topicId, groupId);
     },
     deserialize: (r) => {
+        if (r.status === 0 && r.length === 0)
+            return null;
         return deserializeConsumerGroup(r.data).data;
     }
 };

package/dist/wire/consumer-group/index.d.ts

@@ -22,4 +22,5 @@ export * from './get-group.command.js';
 export * from './get-groups.command.js';
 export * from './join-group.command.js';
 export * from './leave-group.command.js';
+export * from './ensure-group.virtual.command.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/wire/consumer-group/index.js

@@ -22,4 +22,5 @@ export * from './get-group.command.js';
 export * from './get-groups.command.js';
 export * from './join-group.command.js';
 export * from './leave-group.command.js';
+export * from './ensure-group.virtual.command.js';
 //# sourceMappingURL=index.js.map

package/dist/wire/error.utils.d.ts

@@ -17,4 +17,8 @@
  * under the License.
  */
 export declare const responseError: (cmdCode: number, errCode: number) => Error;
+export declare class DeserializeError extends Error {
+    constructor(message: string, cause?: Record<string, unknown>);
+}
+export declare const deserializeError: (name: string, position: number, buffer_size: number, lookup?: number, read?: Record<string, unknown>) => never;
 //# sourceMappingURL=error.utils.d.ts.map

package/dist/wire/error.utils.js

@@ -20,4 +20,14 @@ import { translateCommandCode } from './command.code.js';
 import { translateErrorCode } from './error.code.js';
 export const responseError = (cmdCode, errCode) => new Error(`command: { code: ${cmdCode}, name: ${translateCommandCode(cmdCode)} } ` +
     `error: {code: ${errCode}, message: ${translateErrorCode(errCode)} }`);
+export class DeserializeError extends Error {
+    constructor(message, cause) {
+        super(message, cause);
+        this.name = "DeserializeError";
+        Object.setPrototypeOf(this, DeserializeError.prototype);
+    }
+}
+export const deserializeError = (name, position, buffer_size, lookup, read) => {
+    throw new DeserializeError(`cannot deserialize ${name}: buffer too small`, { cause: { position, buffer_size, lookup, read } });
+};
 //# sourceMappingURL=error.utils.js.map

package/dist/wire/message/header.type.d.ts

@@ -37,7 +37,7 @@ export declare const HeaderKind: {
 export type HeaderKind = typeof HeaderKind;
 export type HeaderKindId = keyof HeaderKind;
 export type HeaderKindValue = ValueOf<HeaderKind>;
-export declare const ReverseHeaderKind: Record<1 | 2 | 10 | 11 | 4 | 8 | 3 | 5 | 12 | 9 | 13 | 6 | 7 | 14 | 15, "Raw" | "String" | "Bool" | "Int8" | "Int16" | "Int32" | "Int64" | "Int128" | "Uint8" | "Uint16" | "Uint32" | "Uint64" | "Uint128" | "Float" | "Double">;
+export declare const ReverseHeaderKind: Record<1 | 2 | 10 | 11 | 12 | 4 | 8 | 3 | 5 | 9 | 13 | 6 | 7 | 14 | 15, "Raw" | "String" | "Bool" | "Int8" | "Int16" | "Int32" | "Int64" | "Int128" | "Uint8" | "Uint16" | "Uint32" | "Uint64" | "Uint128" | "Float" | "Double">;
 export type HeaderValueRaw = {
     kind: HeaderKind['Raw'];
     value: Buffer;

package/dist/wire/message/poll-messages.command.d.ts

@@ -24,7 +24,7 @@ export type PollMessages = {
     streamId: Id;
     topicId: Id;
     consumer: Consumer;
-    partitionId: number;
+    partitionId: number | null;
     pollingStrategy: PollingStrategy;
     count: number;
     autocommit: boolean;

package/dist/wire/message/poll.utils.d.ts

@@ -60,7 +60,7 @@ export declare const PollingStrategy: {
     Offset: (n: bigint) => OffsetPollingStrategy;
     Timestamp: (n: bigint) => TimestampPollingStrategy;
 };
-export declare const serializePollMessages: (streamId: Id, topicId: Id, consumer: Consumer, partitionId: number, pollingStrategy: PollingStrategy, count?: number, autocommit?: boolean) => Buffer<ArrayBuffer>;
+export declare const serializePollMessages: (streamId: Id, topicId: Id, consumer: Consumer, partitionId: number | null, pollingStrategy: PollingStrategy, count?: number, autocommit?: boolean) => Buffer<ArrayBuffer>;
 export declare const MessageState: {
     Available: number;
     Unavailable: number;

package/dist/wire/message/poll.utils.js

@@ -56,8 +56,7 @@ export const PollingStrategy = {
     Offset,
     Timestamp
 };
-export const serializePollMessages = (streamId, topicId, consumer, partitionId, // default to 1
-pollingStrategy, // default to OffsetPollingStrategy
+export const serializePollMessages = (streamId, topicId, consumer, partitionId, pollingStrategy, // default to OffsetPollingStrategy
 count = 10, autocommit = false) => {
     const b = Buffer.allocUnsafe(14);
     b.writeUInt8(pollingStrategy.kind, 0);

package/dist/wire/offset/delete-offset.command.js

@@ -22,7 +22,7 @@ import { serializeGetOffset } from './offset.utils.js';
 import { COMMAND_CODE } from '../command.code.js';
 export const DELETE_OFFSET = {
     code: COMMAND_CODE.DeleteConsumerOffset,
-    serialize: ({ streamId, topicId, consumer, partitionId = 1 }) => {
+    serialize: ({ streamId, topicId, consumer, partitionId = 0 }) => {
         return serializeGetOffset(streamId, topicId, consumer, partitionId);
     },
     deserialize: deserializeVoidResponse

package/dist/wire/offset/get-offset.command.d.ts

@@ -23,12 +23,16 @@ export type GetOffset = {
     streamId: Id;
     topicId: Id;
     consumer: Consumer;
-    partitionId?: number;
+    partitionId: number | null;
 };
 export declare const GET_OFFSET: {
     code: number;
     serialize: ({ streamId, topicId, consumer, partitionId }: GetOffset) => Buffer<ArrayBuffer>;
-    deserialize: (r: CommandResponse) => OffsetResponse;
+    deserialize: (r: CommandResponse) => {
+        partitionId: number;
+        currentOffset: bigint;
+        storedOffset: bigint;
+    } | null;
 };
-export declare const getOffset: (getClient: import("../../client/client.type.js").ClientProvider) => (arg: GetOffset) => Promise<OffsetResponse>;
+export declare const getOffset: (getClient: import("../../client/client.type.js").ClientProvider) => (arg: GetOffset) => Promise<OffsetResponse | null>;
 //# sourceMappingURL=get-offset.command.d.ts.map

package/dist/wire/offset/get-offset.command.js

@@ -21,12 +21,12 @@ import { COMMAND_CODE } from '../command.code.js';
 import { serializeGetOffset } from './offset.utils.js';
 export const GET_OFFSET = {
     code: COMMAND_CODE.GetOffset,
-    serialize: ({ streamId, topicId, consumer, partitionId = 1 }) => {
+    serialize: ({ streamId, topicId, consumer, partitionId = 0 }) => {
         return serializeGetOffset(streamId, topicId, consumer, partitionId);
     },
     deserialize: (r) => {
-        if (r.data.length < 20)
-            throw new Error('Offset not found');
+        if (r.status === 0 && r.length === 0)
+            return null;
         const partitionId = r.data.readUInt32LE(0);
         const currentOffset = r.data.readBigUInt64LE(4);
         const storedOffset = r.data.readBigUInt64LE(12);

package/dist/wire/offset/offset.utils.d.ts

@@ -49,6 +49,6 @@ export type OffsetResponse = {
     currentOffset: bigint;
     storedOffset: bigint;
 };
-export declare const serializeGetOffset: (streamId: Id, topicId: Id, consumer: Consumer, partitionId?: number) => Buffer<ArrayBuffer>;
-export declare const serializeStoreOffset: (streamId: Id, topicId: Id, consumer: Consumer, partitionId: number, offset: bigint) => Buffer<ArrayBuffer>;
+export declare const serializeGetOffset: (streamId: Id, topicId: Id, consumer: Consumer, partitionId: number | null) => Buffer<ArrayBuffer>;
+export declare const serializeStoreOffset: (streamId: Id, topicId: Id, consumer: Consumer, partitionId: number | null, offset: bigint) => Buffer<ArrayBuffer>;
 //# sourceMappingURL=offset.utils.d.ts.map

package/dist/wire/offset/offset.utils.js

@@ -17,7 +17,7 @@
  * under the License.
  */
 import { serializeIdentifier } from '../identifier.utils.js';
-import { uint32ToBuf, uint8ToBuf } from '../number.utils.js';
+import { uint8ToBuf } from '../number.utils.js';
 export const ConsumerKind = {
     Single: 1,
     Group: 2
@@ -34,13 +34,22 @@ export const Consumer = {
     })
 };
 export const serializeGetOffset = (streamId, topicId, consumer, partitionId) => {
-    if (consumer.kind === ConsumerKind.Single && (!partitionId || partitionId < 1))
-        throw new Error('getOffset error: partitionId must be > 0 for single consumer kind');
+    if (consumer.kind === ConsumerKind.Single && partitionId === null)
+        throw new Error('getOffset error: partitionId must be provided for single consumer kind');
     const streamIdentifier = serializeIdentifier(streamId);
     const topicIdentifier = serializeIdentifier(topicId);
     const consumerIdentifier = serializeIdentifier(consumer.id);
     const b1 = uint8ToBuf(consumer.kind);
-    const b2 = uint32ToBuf(partitionId || 0);
+    // Encode partition_id with a flag byte: 1 = Some, 0 = None
+    const b2 = Buffer.allocUnsafe(5);
+    if (partitionId !== null) {
+        b2.writeUInt8(1, 0); // Flag byte: partition_id is Some
+        b2.writeUInt32LE(partitionId, 1);
+    }
+    else {
+        b2.writeUInt8(0, 0); // Flag byte: partition_id is None
+        b2.writeUInt32LE(0, 1); // Padding
+    }
     return Buffer.concat([
         b1,
         consumerIdentifier,

package/dist/wire/offset/store-offset.command.d.ts

@@ -22,7 +22,7 @@ export type StoreOffset = {
     streamId: Id;
     topicId: Id;
     consumer: Consumer;
-    partitionId: number;
+    partitionId: number | null;
     offset: bigint;
 };
 export declare const STORE_OFFSET: {

package/dist/wire/stream/create-stream.command.d.ts

@@ -19,12 +19,12 @@
 import type { CommandResponse } from '../../client/client.type.js';
 import { type Stream } from './stream.utils.js';
 export type CreateStream = {
-    streamId: number;
+    streamId?: number;
     name: string;
 };
 export declare const CREATE_STREAM: {
     code: number;
-    serialize: ({ streamId, name }: CreateStream) => Buffer<ArrayBuffer>;
+    serialize: ({ name }: CreateStream) => Buffer<ArrayBuffer>;
     deserialize: (r: CommandResponse) => Stream;
 };
 export declare const createStream: (getClient: import("../../client/client.type.js").ClientProvider) => (arg: CreateStream) => Promise<Stream>;

package/dist/wire/stream/create-stream.command.js

@@ -21,13 +21,13 @@ import { COMMAND_CODE } from '../command.code.js';
 import { deserializeToStream } from './stream.utils.js';
 export const CREATE_STREAM = {
     code: COMMAND_CODE.CreateStream,
-    serialize: ({ streamId, name }) => {
+    serialize: ({ name }) => {
+        // Stream ID is now auto-assigned by the server, not sent in the protocol
         const bName = Buffer.from(name);
         if (bName.length < 1 || bName.length > 255)
             throw new Error('Stream name should be between 1 and 255 bytes');
-        const b = Buffer.allocUnsafe(4 + 1);
-        b.writeUInt32LE(streamId, 0);
-        b.writeUInt8(bName.length, 4);
+        const b = Buffer.allocUnsafe(1);
+        b.writeUInt8(bName.length, 0);
         return Buffer.concat([
             b,
             bName

package/dist/wire/stream/create-stream.command.test.js

@@ -22,11 +22,10 @@ import { CREATE_STREAM } from './create-stream.command.js';
 describe('CreateStream', () => {
     describe('serialize', () => {
         const s1 = {
-            streamId: 1,
             name: 'test-stream'
         };
-        it('serialize 1 numeric id & 1 name into buffer', () => {
-            assert.deepEqual(CREATE_STREAM.serialize(s1).length, 4 + 1 + s1.name.length);
+        it('serialize 1 name into buffer', () => {
+            assert.deepEqual(CREATE_STREAM.serialize(s1).length, 1 + s1.name.length);
         });
         it('throw on name < 1', () => {
             const s2 = { ...s1, name: '' };

package/dist/wire/stream/ensure-stream.virtual.command.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Licensed to the Apache Software Foundation (ASF) under one
+ * or more contributor license agreements.  See the NOTICE file
+ * distributed with this work for additional information
+ * regarding copyright ownership.  The ASF licenses this file
+ * to you under the Apache License, Version 2.0 (the
+ * "License"); you may not use this file except in compliance
+ * with the License.  You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing,
+ * software distributed under the License is distributed on an
+ * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ * KIND, either express or implied.  See the License for the
+ * specific language governing permissions and limitations
+ * under the License.
+ */
+import { ClientProvider } from '../../client/index.js';
+export declare const ensureStream: (c: ClientProvider) => (streamName: string) => Promise<import("./stream.utils.js").Stream>;
+//# sourceMappingURL=ensure-stream.virtual.command.d.ts.map

package/dist/wire/stream/ensure-stream.virtual.command.js

@@ -0,0 +1,26 @@
+/**
+ * Licensed to the Apache Software Foundation (ASF) under one
+ * or more contributor license agreements.  See the NOTICE file
+ * distributed with this work for additional information
+ * regarding copyright ownership.  The ASF licenses this file
+ * to you under the Apache License, Version 2.0 (the
+ * "License"); you may not use this file except in compliance
+ * with the License.  You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing,
+ * software distributed under the License is distributed on an
+ * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ * KIND, either express or implied.  See the License for the
+ * specific language governing permissions and limitations
+ * under the License.
+ */
+import { createStream } from './create-stream.command.js';
+import { getStream } from './get-stream.command.js';
+export const ensureStream = (c) => async function ensureStream(streamName) {
+    const stream = await getStream(c)({ streamId: streamName });
+    return stream === null ?
+        createStream(c)({ name: streamName }) : stream;
+};
+//# sourceMappingURL=ensure-stream.virtual.command.js.map

package/dist/wire/stream/get-stream.command.d.ts

@@ -25,7 +25,7 @@ export type GetStream = {
 export declare const GET_STREAM: {
     code: number;
     serialize: ({ streamId }: GetStream) => Buffer<ArrayBufferLike>;
-    deserialize: (r: CommandResponse) => Stream;
+    deserialize: (r: CommandResponse) => Stream | null;
 };
-export declare const getStream: (getClient: import("../../client/client.type.js").ClientProvider) => (arg: GetStream) => Promise<Stream>;
+export declare const getStream: (getClient: import("../../client/client.type.js").ClientProvider) => (arg: GetStream) => Promise<Stream | null>;
 //# sourceMappingURL=get-stream.command.d.ts.map

package/dist/wire/stream/get-stream.command.js

@@ -26,6 +26,8 @@ export const GET_STREAM = {
         return serializeIdentifier(streamId);
     },
     deserialize: (r) => {
+        if (r.status === 0 && r.length === 0)
+            return null;
         return deserializeToStream(r.data, 0).data;
     }
 };

package/dist/wire/stream/index.d.ts

@@ -22,4 +22,5 @@ export * from './get-stream.command.js';
 export * from './get-streams.command.js';
 export * from './purge-stream.command.js';
 export * from './update-stream.command.js';
+export * from './ensure-stream.virtual.command.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/wire/stream/index.js

@@ -22,4 +22,5 @@ export * from './get-stream.command.js';
 export * from './get-streams.command.js';
 export * from './purge-stream.command.js';
 export * from './update-stream.command.js';
+export * from './ensure-stream.virtual.command.js';
 //# sourceMappingURL=index.js.map

package/dist/wire/system/get-stats.command.d.ts

@@ -16,7 +16,7 @@
  * specific language governing permissions and limitations
  * under the License.
  */
-import type { CommandResponse } from '../../client/client.type.js';
+import type { CommandResponse } from '../../client/index.js';
 export type Stats = {
     processId: number;
     cpuUsage: number;

package/dist/wire/topic/create-topic.command.d.ts

@@ -21,7 +21,6 @@ import { type Id } from '../identifier.utils.js';
 import { type Topic, type CompressionAlgorithm as CompressionAlgorithmT } from './topic.utils.js';
 export type CreateTopic = {
     streamId: Id;
-    topicId: number;
     name: string;
     partitionCount: number;
     compressionAlgorithm: CompressionAlgorithmT;
@@ -31,7 +30,7 @@ export type CreateTopic = {
 };
 export declare const CREATE_TOPIC: {
     code: number;
-    serialize: ({ streamId, topicId, name, partitionCount, compressionAlgorithm, messageExpiry, maxTopicSize, replicationFactor }: CreateTopic) => Buffer<ArrayBuffer>;
+    serialize: ({ streamId, name, partitionCount, compressionAlgorithm, messageExpiry, maxTopicSize, replicationFactor }: CreateTopic) => Buffer<ArrayBuffer>;
     deserialize: (r: CommandResponse) => Topic;
 };
 export declare const createTopic: (getClient: import("../../client/client.type.js").ClientProvider) => (arg: CreateTopic) => Promise<Topic>;

package/dist/wire/topic/create-topic.command.js

@@ -22,7 +22,8 @@ import { COMMAND_CODE } from '../command.code.js';
 import { isValidCompressionAlgorithm, CompressionAlgorithm, deserializeTopic } from './topic.utils.js';
 export const CREATE_TOPIC = {
     code: COMMAND_CODE.CreateTopic,
-    serialize: ({ streamId, topicId, name, partitionCount, compressionAlgorithm = CompressionAlgorithm.None, messageExpiry = 0n, maxTopicSize = 0n, replicationFactor = 1 }) => {
+    serialize: ({ streamId, name, partitionCount, compressionAlgorithm = CompressionAlgorithm.None, messageExpiry = 0n, maxTopicSize = 0n, replicationFactor = 1 }) => {
+        // Topic ID is now auto-assigned by the server, not sent in the protocol
         const streamIdentifier = serializeIdentifier(streamId);
         const bName = Buffer.from(name);
         if (replicationFactor < 1 || replicationFactor > 255)
@@ -31,14 +32,13 @@ export const CREATE_TOPIC = {
             throw new Error('Topic name should be between 1 and 255 bytes');
         if (!isValidCompressionAlgorithm(compressionAlgorithm))
             throw new Error(`createTopic: invalid compressionAlgorithm (${compressionAlgorithm})`);
-        const b = Buffer.allocUnsafe(4 + 4 + 1 + 8 + 8 + 1 + 1);
-        b.writeUInt32LE(topicId, 0);
-        b.writeUInt32LE(partitionCount, 4);
-        b.writeUInt8(compressionAlgorithm, 8);
-        b.writeBigUInt64LE(messageExpiry, 9); // 0 is unlimited
-        b.writeBigUInt64LE(maxTopicSize, 17); // optional, 0 is null
-        b.writeUInt8(replicationFactor, 25); // must be > 0
-        b.writeUInt8(bName.length, 26);
+        const b = Buffer.allocUnsafe(4 + 1 + 8 + 8 + 1 + 1);
+        b.writeUInt32LE(partitionCount, 0);
+        b.writeUInt8(compressionAlgorithm, 4);
+        b.writeBigUInt64LE(messageExpiry, 5); // 0 is unlimited
+        b.writeBigUInt64LE(maxTopicSize, 13); // optional, 0 is null
+        b.writeUInt8(replicationFactor, 21); // must be > 0
+        b.writeUInt8(bName.length, 22);
         return Buffer.concat([
             streamIdentifier,
             b,