@zlink-systems/stream-wire 0.27.0 → 0.29.0

package/dist/esm/index.mjs

@@ -166,6 +166,17 @@ function isStreamWireMessageKind(value) {
 function isStreamWireCodec(value) {
   return validCodecs.has(value);
 }
+function validateHeaderKindAndControl(kind, codec, flags) {
+  if (!isStreamWireMessageKind(kind)) {
+    throw new Error("Unknown stream message kind.");
+  }
+  if (!isStreamWireCodec(codec)) {
+    throw new Error("Unknown stream codec.");
+  }
+  if (kind === 5 /* Control */ && (codec !== 0 /* Raw */ || flags !== 0 /* None */)) {
+    throw new Error("Control packet must use raw codec and must not contain flags.");
+  }
+}
 var UTF8_TWO_BYTE_MIN = 128;
 var UTF8_THREE_BYTE_MIN = 2048;
 var UTF16_HIGH_SURROGATE_MIN = 55296;
@@ -398,6 +409,7 @@ function encodeStreamWireHeader(header, flagOverrides) {
   headerFlags = hasCorrelation ? headerFlags | flags.hasCorrelationId : headerFlags & ~flags.hasCorrelationId;
   headerFlags = hasFlow ? headerFlags | flags.hasFlowId : headerFlags & ~flags.hasFlowId;
   headerFlags = hasActorSlot ? headerFlags | flags.hasActorSlot : headerFlags & ~flags.hasActorSlot;
+  validateHeaderKindAndControl(header.kind, header.codec, header.flags | headerFlags);
   const metadataBytes = hasMetadata ? encodeStreamWireMetadata(header.metadata) : new Uint8Array();
   const size = 4 + (hasRequestSeq ? UINT64_BYTES : 0) + 1 + nameBytes.length + (hasMetadata ? UINT16_BYTES + metadataBytes.length : 0) + (hasCorrelation ? 1 + correlationBytes.length : 0) + (hasFlow ? FLOW_FIELDS_BYTES : 0) + (hasActorSlot ? UINT16_BYTES : 0);
   const buffer = new Uint8Array(size);
@@ -449,6 +461,7 @@ function decodeStreamWireHeader(header, flagOverrides, includeFlow = true) {
   const kind = header[offset++];
   const codec = header[offset++];
   const headerFlags = header[offset++];
+  validateHeaderKindAndControl(kind, codec, headerFlags);
   const hasRequestSeq = (headerFlags & flags.hasRequestSeq) !== 0;
   const hasMetadata = (headerFlags & flags.hasMetadata) !== 0;
   const hasCorrelation = (headerFlags & flags.hasCorrelationId) !== 0;

package/dist/index.js

@@ -73,6 +73,18 @@ function isStreamWireMessageKind(value) {
 function isStreamWireCodec(value) {
     return validCodecs.has(value);
 }
+function validateHeaderKindAndControl(kind, codec, flags) {
+    if (!isStreamWireMessageKind(kind)) {
+        throw new Error('Unknown stream message kind.');
+    }
+    if (!isStreamWireCodec(codec)) {
+        throw new Error('Unknown stream codec.');
+    }
+    if (kind === ZlinkStreamMessageKind.Control &&
+        (codec !== ZlinkStreamCodec.Raw || flags !== ZlinkStreamHeaderFlags.None)) {
+        throw new Error('Control packet must use raw codec and must not contain flags.');
+    }
+}
 const UTF8_TWO_BYTE_MIN = 0x80;
 const UTF8_THREE_BYTE_MIN = 0x800;
 const UTF16_HIGH_SURROGATE_MIN = 0xd800;
@@ -322,6 +334,7 @@ function encodeStreamWireHeader(header, flagOverrides) {
         : headerFlags & ~flags.hasCorrelationId;
     headerFlags = hasFlow ? headerFlags | flags.hasFlowId : headerFlags & ~flags.hasFlowId;
     headerFlags = hasActorSlot ? headerFlags | flags.hasActorSlot : headerFlags & ~flags.hasActorSlot;
+    validateHeaderKindAndControl(header.kind, header.codec, header.flags | headerFlags);
     const metadataBytes = hasMetadata ? encodeStreamWireMetadata(header.metadata) : new Uint8Array();
     const size = 4 +
         (hasRequestSeq ? exports.UINT64_BYTES : 0) +
@@ -380,6 +393,7 @@ function decodeStreamWireHeader(header, flagOverrides, includeFlow = true) {
     const kind = header[offset++];
     const codec = header[offset++];
     const headerFlags = header[offset++];
+    validateHeaderKindAndControl(kind, codec, headerFlags);
     const hasRequestSeq = (headerFlags & flags.hasRequestSeq) !== 0;
     const hasMetadata = (headerFlags & flags.hasMetadata) !== 0;
     const hasCorrelation = (headerFlags & flags.hasCorrelationId) !== 0;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zlink-systems/stream-wire",
-  "version": "0.27.0",
+  "version": "0.29.0",
   "license": "SEE LICENSE IN LICENSE",
   "repository": {
     "type": "git",