@blueyerobotics/blueye-ts 3.8.0 → 3.10.0

package/dist/src/binlog-parser.d.ts

@@ -22,7 +22,7 @@ export declare const parse: (rawData: Blob, fixTimes?: boolean) => Promise<Messa
  * @param rawData The compressed binary data to decompress (gzip format).
  * @returns A promise that resolves to the decompressed data as a Buffer.
  */
-export declare const decompress: (rawData: Blob) => Promise<Buffer>;
+export declare const decompress: (rawData: Blob) => Promise<Buffer<ArrayBuffer>>;
 /**
  * Parse the decompressed binlog data into structured messages.
  * @param decompressed The gunzipped binlog data.
@@ -35,4 +35,18 @@ export declare const parseMessages: (decompressed: Uint8Array, fixTimes?: boolea
  * @param messages The messages to fix the times for.
  * @returns The messages with corrected times.
  */
+/**
+ * Parse a single varint-prefixed BinlogRecord from raw (uncompressed) bytes.
+ * Used for streaming playback where individual frames are fetched via HTTP Range requests.
+ * @param bytes Raw bytes containing a single varint-length-prefixed BinlogRecord.
+ * @returns The parsed message, or null if the record is not a known protocol type.
+ */
+export declare const parseFrame: (bytes: Uint8Array) => Message | null;
+/**
+ * Parse multiple contiguous varint-prefixed BinlogRecords from raw (uncompressed) bytes.
+ * Used for streaming playback where frame batches are fetched via HTTP Range requests.
+ * @param bytes Raw bytes containing one or more varint-length-prefixed BinlogRecords.
+ * @returns An array of parsed messages.
+ */
+export declare const parseFrames: (bytes: Uint8Array) => Message[];
 export declare const fixMessageTimes: (messages: Message[]) => Message[];

package/dist/src/binlog-parser.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.fixMessageTimes = exports.parseMessages = exports.decompress = exports.parse = void 0;
+exports.fixMessageTimes = exports.parseFrames = exports.parseFrame = exports.parseMessages = exports.decompress = exports.parse = void 0;
 const protocol_definitions_1 = require("@blueyerobotics/protocol-definitions");
 const wire_1 = require("@bufbuild/protobuf/wire");
 const buffer_1 = require("buffer");
@@ -115,6 +115,27 @@ exports.parseMessages = parseMessages;
  * @param messages The messages to fix the times for.
  * @returns The messages with corrected times.
  */
+/**
+ * Parse a single varint-prefixed BinlogRecord from raw (uncompressed) bytes.
+ * Used for streaming playback where individual frames are fetched via HTTP Range requests.
+ * @param bytes Raw bytes containing a single varint-length-prefixed BinlogRecord.
+ * @returns The parsed message, or null if the record is not a known protocol type.
+ */
+const parseFrame = (bytes) => {
+    const messages = (0, exports.parseFrames)(bytes);
+    return messages.length > 0 ? messages[0] : null;
+};
+exports.parseFrame = parseFrame;
+/**
+ * Parse multiple contiguous varint-prefixed BinlogRecords from raw (uncompressed) bytes.
+ * Used for streaming playback where frame batches are fetched via HTTP Range requests.
+ * @param bytes Raw bytes containing one or more varint-length-prefixed BinlogRecords.
+ * @returns An array of parsed messages.
+ */
+const parseFrames = (bytes) => {
+    return (0, exports.parseMessages)(bytes, false);
+};
+exports.parseFrames = parseFrames;
 const fixMessageTimes = (messages) => {
     if (messages.length === 0)
         return messages;

package/dist/src/client.js

@@ -42,7 +42,6 @@ class BlueyeClient extends strict_event_emitter_1.Emitter {
             level: logLevel,
             formatOptions: { colors: true, compact: false },
         });
-        // @ts-ignore
         this.sub.on("message", (topic, msg) => {
             const { key, data } = schema_1.responseSchema.parse({ key: topic, data: msg });
             if (!(0, exports.isInProtocol)(key) || !key.endsWith("Tel")) {
@@ -107,7 +106,6 @@ class BlueyeClient extends strict_event_emitter_1.Emitter {
         const request = () => {
             return new Promise((resolve, reject) => {
                 const timer = setTimeout(() => reject(new Error("[rpc] request timed out")), this.timeout);
-                // @ts-ignore
                 this.rpc.once("message", (topic, msg) => {
                     clearTimeout(timer);
                     resolve({ key: topic.toString().split(".").at(-1), data: msg });

package/dist/src/schema.d.ts

@@ -1,12 +1,11 @@
-import { Buffer } from "buffer";
 import z from "zod";
 export declare const responseSchema: z.ZodObject<{
-    key: z.ZodPipe<z.ZodCustom<Buffer, Buffer>, z.ZodTransform<string, Buffer>>;
-    data: z.ZodCustom<Buffer, Buffer>;
+    key: z.ZodPipe<z.ZodCustom<Uint8Array<ArrayBuffer>, Uint8Array<ArrayBuffer>>, z.ZodTransform<string, Uint8Array<ArrayBuffer>>>;
+    data: z.ZodCustom<Uint8Array<ArrayBuffer>, Uint8Array<ArrayBuffer>>;
 }, z.core.$strip>;
 export declare const telemetrySchema: z.ZodObject<{
     payload: z.ZodObject<{
         typeUrl: z.ZodPipe<z.ZodString, z.ZodTransform<string, string>>;
-        value: z.ZodPipe<z.ZodAny & z.ZodType<Buffer | Uint8Array<ArrayBufferLike>, any, z.core.$ZodTypeInternals<Buffer | Uint8Array<ArrayBufferLike>, any>>, z.ZodTransform<Buffer, any>>;
+        value: z.ZodPipe<z.ZodAny & z.ZodType<Buffer<ArrayBuffer> | Buffer<any> | Uint8Array<ArrayBufferLike>, any, z.core.$ZodTypeInternals<Buffer<ArrayBuffer> | Buffer<any> | Uint8Array<ArrayBufferLike>, any>>, z.ZodTransform<Buffer<any>, any>>;
     }, z.core.$strip>;
 }, z.core.$strip>;

package/dist/src/schema.js

@@ -4,20 +4,19 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.telemetrySchema = exports.responseSchema = void 0;
-const buffer_1 = require("buffer");
 const zod_1 = __importDefault(require("zod"));
 exports.responseSchema = zod_1.default.object({
     key: zod_1.default
-        .instanceof(buffer_1.Buffer)
+        .instanceof(Uint8Array)
         .transform((val) => val.toString().split(".").at(-1)),
-    data: zod_1.default.instanceof(buffer_1.Buffer),
+    data: zod_1.default.instanceof(Uint8Array),
 });
 exports.telemetrySchema = zod_1.default.object({
     payload: zod_1.default.object({
         typeUrl: zod_1.default.string().transform((val) => val.split(".").at(-1)),
         value: zod_1.default
             .any()
-            .refine((val) => val instanceof buffer_1.Buffer || val instanceof Uint8Array)
-            .transform((val) => (buffer_1.Buffer.isBuffer(val) ? val : buffer_1.Buffer.from(val))),
+            .refine((val) => val instanceof Buffer || val instanceof Uint8Array)
+            .transform((val) => (Buffer.isBuffer(val) ? val : Buffer.from(val))),
     }),
 });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@blueyerobotics/blueye-ts",
-  "version": "3.8.0",
+  "version": "3.10.0",
   "description": "A TypeScript client for interacting with Blueye underwater drones.",
   "repository": {
     "type": "git",
@@ -26,6 +26,7 @@
   },
   "devDependencies": {
     "@biomejs/biome": "2.3.14",
+    "@types/node": "^25.4.0",
     "typescript": "^5.9.3"
   },
   "scripts": {