apache-iggy 0.8.0 → 0.8.1-edge.1

package/NOTICE

@@ -0,0 +1,12 @@
+Apache Iggy (Incubating)
+Copyright 2026 The Apache Software Foundation
+
+This product includes software developed at
+The Apache Software Foundation (http://www.apache.org/).
+
+================================================================
+
+The Iggy project code was originally created, designed, developed by Piotr Gankiewicz in April 2023.
+It was released as an open-source project under MIT License, later converted to Apache 2.0 License,
+and donated by LaserData, Inc. to the Apache Software Foundation (ASF) in February 2025.
+Copyright April 2023 - February 2025 Piotr Gankiewicz, LaserData, Inc.

package/README.md

@@ -1,7 +1,21 @@
+<div align="center">
+  <picture>
+    <source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/apache/iggy/refs/heads/master/assets/logo/SVG/iggy-apache-color-darkbg.svg">
+    <source media="(prefers-color-scheme: light)" srcset="https://raw.githubusercontent.com/apache/iggy/refs/heads/master/assets/logo/SVG/iggy-apache-color-lightbg.svg">
+    <img alt="Apache Iggy" src="https://raw.githubusercontent.com/apache/iggy/refs/heads/master/assets/logo/SVG/iggy-apache-color-lightbg.svg" width="320">
+  </picture>
+</div>
+
 # Apache Iggy Node.js Client
 
 Apache Iggy Node.js client written in typescript, it currently only supports tcp & tls transports.
 
+> Apache Iggy (Incubating) is an effort undergoing incubation at the Apache Software Foundation (ASF), sponsored by the Apache Incubator PMC.
+>
+> Incubation is required of all newly accepted projects until a further review indicates that the infrastructure, communications, and decision making process have stabilized in a manner consistent with other successful ASF projects.
+>
+> While incubation status is not necessarily a reflection of the completeness or stability of the code, it does indicate that the project has yet to be fully endorsed by the ASF.
+
 diclaimer: although all iggy commands & basic client/stream are implemented this is still a WIP, provided as is, and has still a long way to go to be considered "battle tested".
 
 note: This lib started as _iggy-bin_ ( [github](https://github.com/T1B0/iggy-bin) / [npm](https://www.npmjs.com/package/iggy-bin)) before migrating under iggy-rs org. package iggy-bin@v1.3.4 is equivalent to @iggy.rs/sdk@v1.0.3 and migrating again under apache iggy monorepo ( [github](https://github.com/apache/iggy/tree/master/foreign/node) and is now published on npmjs as apache-iggy

package/dist/client/client.utils.d.ts

@@ -45,6 +45,7 @@ export declare const handleResponseTransform: () => Transform;
  * @returns True if the response indicates success with no data
  */
 export declare const deserializeVoidResponse: (r: CommandResponse) => boolean;
+export declare const deserializeStatusResponse: (r: CommandResponse) => boolean;
 /**
  * Serializes a command and its payload into a buffer for sending to the server.
  * Creates the wire format: [payload_size (4 bytes)][command (4 bytes)][payload]

package/dist/client/client.utils.js

@@ -31,7 +31,7 @@ export const handleResponse = (r) => {
     const length = r.readUint32LE(4);
     debug('<== handleResponse', { status, length });
     return {
-        status, length, data: r.subarray(8)
+        status, length, data: r.subarray(8, 8 + length)
     };
 };
 /**
@@ -60,6 +60,7 @@ export const handleResponseTransform = () => new Transform({
  * @returns True if the response indicates success with no data
  */
 export const deserializeVoidResponse = (r) => r.status === 0 && r.data.length === 0;
+export const deserializeStatusResponse = (r) => r.status === 0;
 /** Length of the command code in bytes */
 const COMMAND_LENGTH = 4;
 /**

package/dist/client/client.utils.test.d.ts

@@ -0,0 +1,20 @@
+/**
+ * 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.
+ */
+export {};
+//# sourceMappingURL=client.utils.test.d.ts.map

package/dist/client/client.utils.test.js

@@ -0,0 +1,59 @@
+/**
+ * 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 { describe, it } from 'node:test';
+import assert from 'node:assert/strict';
+import { handleResponse, deserializeVoidResponse, deserializeStatusResponse } from './client.utils.js';
+const SUCCESS = 0;
+const ERROR = 1;
+describe('handleResponse', () => {
+    it('bounds data to the length field, not the full buffer', () => {
+        // Server says: status=0, length=0, no payload.
+        // But the raw buffer has 4 trailing bytes (e.g. start of next response).
+        const buf = Buffer.alloc(12);
+        buf.writeUInt32LE(SUCCESS, 0); // status
+        buf.writeUInt32LE(0, 4); // length = 0 (void response)
+        buf.writeUInt32LE(42, 8); // trailing bytes — NOT part of this response
+        const r = handleResponse(buf);
+        assert.equal(r.data.length, 0);
+    });
+    it('deserializeVoidResponse returns true for a valid void response with trailing buffer bytes', () => {
+        const buf = Buffer.alloc(12);
+        buf.writeUInt32LE(SUCCESS, 0);
+        buf.writeUInt32LE(0, 4); // length = 0
+        buf.writeUInt32LE(42, 8); // trailing bytes
+        const r = handleResponse(buf);
+        assert.equal(deserializeVoidResponse(r), true);
+    });
+});
+describe('deserializeStatusResponse', () => {
+    it('returns true when status is SUCCESS and data is empty', () => {
+        const r = { status: SUCCESS, length: 0, data: Buffer.alloc(0) };
+        assert.equal(deserializeStatusResponse(r), true);
+    });
+    it('returns true when status is SUCCESS and data is non-empty (e.g. SendMessages server payload)', () => {
+        // Key difference from deserializeVoidResponse: non-empty data is accepted.
+        const r = { status: SUCCESS, length: 4, data: Buffer.from([1, 2, 3, 4]) };
+        assert.equal(deserializeStatusResponse(r), true);
+    });
+    it('returns false when status is an error code', () => {
+        const r = { status: ERROR, length: 0, data: Buffer.alloc(0) };
+        assert.equal(deserializeStatusResponse(r), false);
+    });
+});
+//# sourceMappingURL=client.utils.test.js.map

package/dist/wire/message/send-messages.command.js

@@ -17,7 +17,7 @@
  * under the License.
  */
 import { serializeSendMessages } from './message.utils.js';
-import { deserializeVoidResponse } from '../../client/client.utils.js';
+import { deserializeStatusResponse } from '../../client/client.utils.js';
 import { wrapCommand } from '../command.utils.js';
 import { COMMAND_CODE } from '../command.code.js';
 /**
@@ -29,7 +29,7 @@ export const SEND_MESSAGES = {
     serialize: ({ streamId, topicId, messages, partition }) => {
         return serializeSendMessages(streamId, topicId, messages, partition);
     },
-    deserialize: deserializeVoidResponse
+    deserialize: deserializeStatusResponse
 };
 /**
  * Executable send messages command function.

package/dist/wire/message/send-messages.command.test.js

@@ -21,6 +21,8 @@ import assert from "node:assert/strict";
 import { uuidv7, uuidv4 } from "uuidv7";
 import { SEND_MESSAGES } from "./send-messages.command.js";
 import { HeaderValue, HeaderKeyFactory } from "./header.utils.js";
+const SUCCESS = 0;
+const ERROR = 1;
 describe("SendMessages", () => {
     describe("serialize", () => {
         const t1 = {
@@ -148,5 +150,21 @@ describe("SendMessages", () => {
             assert.doesNotThrow(() => SEND_MESSAGES.serialize(t));
         });
     });
+    describe('deserialize', () => {
+        it('returns true when status is SUCCESS with empty data', () => {
+            const r = { status: SUCCESS, length: 0, data: Buffer.alloc(0) };
+            assert.equal(SEND_MESSAGES.deserialize(r), true);
+        });
+        it('returns true when status is SUCCESS with non-empty server payload', () => {
+            // SendMessages server response includes data (e.g. partition/offset info).
+            // The deserializer must accept non-empty data unlike deserializeVoidResponse.
+            const r = { status: SUCCESS, length: 4, data: Buffer.from([1, 2, 3, 4]) };
+            assert.equal(SEND_MESSAGES.deserialize(r), true);
+        });
+        it('returns false when status is an error code', () => {
+            const r = { status: ERROR, length: 0, data: Buffer.alloc(0) };
+            assert.equal(SEND_MESSAGES.deserialize(r), false);
+        });
+    });
 });
 //# sourceMappingURL=send-messages.command.test.js.map

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "apache-iggy",
   "type": "module",
-  "version": "0.8.0",
+  "version": "0.8.1-edge.1",
   "description": "Official Apache Iggy NodeJS SDK",
   "keywords": [
     "iggy",
@@ -28,7 +28,9 @@
     "dist/**/*.d.ts",
     "dist/index.d.ts",
     "!dist/bdd/",
-    "!dist/examples/"
+    "!dist/examples/",
+    "LICENSE",
+    "NOTICE"
   ],
   "types": "dist/index.d.ts",
   "main": "dist/index.js",
@@ -54,7 +56,7 @@
   "devDependencies": {
     "@commitlint/cli": "20.1.0",
     "@commitlint/config-conventional": "20.0.0",
-    "@cucumber/cucumber": "12.2.0",
+    "@cucumber/cucumber": "12.8.2",
     "@swc-node/register": "1.11.1",
     "@types/debug": "4.1.12",
     "@types/node": "24.10.1",