@rise-maritime/keelson-js 0.6.0-alpha.280.dev.1 → 0.6.0-alpha.281.dev.1

package/dist/index.d.ts

@@ -156,6 +156,14 @@ export declare function getInterfaceDefinition(interfaceAndVersion: string): {
             readonly responseStream: false;
             readonly options: {};
         };
+        readonly describe_file: {
+            readonly name: "describe_file";
+            readonly requestType: import("./interfaces/ReplayControl").MessageFns<import("./interfaces/ReplayControl").DescribeFileRequest>;
+            readonly requestStream: false;
+            readonly responseType: import("./interfaces/ReplayControl").MessageFns<import("./interfaces/ReplayControl").DescribeFileResponse>;
+            readonly responseStream: false;
+            readonly options: {};
+        };
         readonly load_file: {
             readonly name: "load_file";
             readonly requestType: import("./interfaces/ReplayControl").MessageFns<import("./interfaces/ReplayControl").LoadFileRequest>;

package/dist/interfaces/ReplayControl.d.ts

@@ -22,6 +22,38 @@ export interface ListFilesResponse {
     baseDirectory: string;
     files: FileInfo[];
 }
+export interface DescribeFileRequest {
+    /**
+     * Path relative to the replayer's base directory, as in load_file. The file
+     * need not be loaded — a client can inspect a recording before playing it.
+     */
+    path: string;
+}
+/** One channel (topic) in the file, and when it spoke. */
+export interface ChannelInfo {
+    topic: string;
+    /** The channel's schema name as recorded, e.g. "keelson.TimestampedFloat". */
+    schemaName: string;
+    /** The channel's message encoding as recorded, e.g. "protobuf". */
+    messageEncoding: string;
+    messageCount: number;
+    /**
+     * log_time of the channel's first and last message. Unset when the channel
+     * recorded no messages. Exact, not the bounds of the chunks it appears in.
+     */
+    firstTime: Date | undefined;
+    lastTime: Date | undefined;
+}
+export interface DescribeFileResponse {
+    file: FileInfo | undefined;
+    channels: ChannelInfo[];
+    /**
+     * True when the file carried no summary or no chunk indexes, so the replayer
+     * had to read it end to end. The figures are still exact; the call was just
+     * proportional to the file's size rather than to its number of chunks.
+     */
+    fromScan: boolean;
+}
 export interface LoadFileRequest {
     path: string;
 }
@@ -46,6 +78,9 @@ export interface ReplaySuccessResponse {
 export declare const FileInfo: MessageFns<FileInfo>;
 export declare const ListFilesRequest: MessageFns<ListFilesRequest>;
 export declare const ListFilesResponse: MessageFns<ListFilesResponse>;
+export declare const DescribeFileRequest: MessageFns<DescribeFileRequest>;
+export declare const ChannelInfo: MessageFns<ChannelInfo>;
+export declare const DescribeFileResponse: MessageFns<DescribeFileResponse>;
 export declare const LoadFileRequest: MessageFns<LoadFileRequest>;
 export declare const SeekRequest: MessageFns<SeekRequest>;
 export declare const SetSpeedRequest: MessageFns<SetSpeedRequest>;
@@ -64,6 +99,15 @@ export declare const ReplayControlDefinition: {
             readonly responseStream: false;
             readonly options: {};
         };
+        /** Per-channel message counts and first/last message times for one file. */
+        readonly describe_file: {
+            readonly name: "describe_file";
+            readonly requestType: MessageFns<DescribeFileRequest>;
+            readonly requestStream: false;
+            readonly responseType: MessageFns<DescribeFileResponse>;
+            readonly responseStream: false;
+            readonly options: {};
+        };
         readonly load_file: {
             readonly name: "load_file";
             readonly requestType: MessageFns<LoadFileRequest>;

package/dist/interfaces/ReplayControl.js

@@ -5,7 +5,7 @@
 //   protoc               v6.30.2
 // source: ReplayControl.proto
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.ReplayControlDefinition = exports.ReplaySuccessResponse = exports.SetLoopRequest = exports.SetSpeedRequest = exports.SeekRequest = exports.LoadFileRequest = exports.ListFilesResponse = exports.ListFilesRequest = exports.FileInfo = exports.protobufPackage = void 0;
+exports.ReplayControlDefinition = exports.ReplaySuccessResponse = exports.SetLoopRequest = exports.SetSpeedRequest = exports.SeekRequest = exports.LoadFileRequest = exports.DescribeFileResponse = exports.ChannelInfo = exports.DescribeFileRequest = exports.ListFilesResponse = exports.ListFilesRequest = exports.FileInfo = exports.protobufPackage = void 0;
 /* eslint-disable */
 const wire_1 = require("@bufbuild/protobuf/wire");
 const empty_1 = require("./google/protobuf/empty");
@@ -283,6 +283,270 @@ exports.ListFilesResponse = {
         return message;
     },
 };
+function createBaseDescribeFileRequest() {
+    return { path: "" };
+}
+exports.DescribeFileRequest = {
+    encode(message, writer = new wire_1.BinaryWriter()) {
+        if (message.path !== "") {
+            writer.uint32(10).string(message.path);
+        }
+        return writer;
+    },
+    decode(input, length) {
+        const reader = input instanceof wire_1.BinaryReader ? input : new wire_1.BinaryReader(input);
+        let end = length === undefined ? reader.len : reader.pos + length;
+        const message = createBaseDescribeFileRequest();
+        while (reader.pos < end) {
+            const tag = reader.uint32();
+            switch (tag >>> 3) {
+                case 1: {
+                    if (tag !== 10) {
+                        break;
+                    }
+                    message.path = reader.string();
+                    continue;
+                }
+            }
+            if ((tag & 7) === 4 || tag === 0) {
+                break;
+            }
+            reader.skip(tag & 7);
+        }
+        return message;
+    },
+    fromJSON(object) {
+        return { path: isSet(object.path) ? globalThis.String(object.path) : "" };
+    },
+    toJSON(message) {
+        const obj = {};
+        if (message.path !== "") {
+            obj.path = message.path;
+        }
+        return obj;
+    },
+    create(base) {
+        return exports.DescribeFileRequest.fromPartial(base ?? {});
+    },
+    fromPartial(object) {
+        const message = createBaseDescribeFileRequest();
+        message.path = object.path ?? "";
+        return message;
+    },
+};
+function createBaseChannelInfo() {
+    return { topic: "", schemaName: "", messageEncoding: "", messageCount: 0, firstTime: undefined, lastTime: undefined };
+}
+exports.ChannelInfo = {
+    encode(message, writer = new wire_1.BinaryWriter()) {
+        if (message.topic !== "") {
+            writer.uint32(10).string(message.topic);
+        }
+        if (message.schemaName !== "") {
+            writer.uint32(18).string(message.schemaName);
+        }
+        if (message.messageEncoding !== "") {
+            writer.uint32(26).string(message.messageEncoding);
+        }
+        if (message.messageCount !== 0) {
+            writer.uint32(32).uint64(message.messageCount);
+        }
+        if (message.firstTime !== undefined) {
+            timestamp_1.Timestamp.encode(toTimestamp(message.firstTime), writer.uint32(42).fork()).join();
+        }
+        if (message.lastTime !== undefined) {
+            timestamp_1.Timestamp.encode(toTimestamp(message.lastTime), writer.uint32(50).fork()).join();
+        }
+        return writer;
+    },
+    decode(input, length) {
+        const reader = input instanceof wire_1.BinaryReader ? input : new wire_1.BinaryReader(input);
+        let end = length === undefined ? reader.len : reader.pos + length;
+        const message = createBaseChannelInfo();
+        while (reader.pos < end) {
+            const tag = reader.uint32();
+            switch (tag >>> 3) {
+                case 1: {
+                    if (tag !== 10) {
+                        break;
+                    }
+                    message.topic = reader.string();
+                    continue;
+                }
+                case 2: {
+                    if (tag !== 18) {
+                        break;
+                    }
+                    message.schemaName = reader.string();
+                    continue;
+                }
+                case 3: {
+                    if (tag !== 26) {
+                        break;
+                    }
+                    message.messageEncoding = reader.string();
+                    continue;
+                }
+                case 4: {
+                    if (tag !== 32) {
+                        break;
+                    }
+                    message.messageCount = longToNumber(reader.uint64());
+                    continue;
+                }
+                case 5: {
+                    if (tag !== 42) {
+                        break;
+                    }
+                    message.firstTime = fromTimestamp(timestamp_1.Timestamp.decode(reader, reader.uint32()));
+                    continue;
+                }
+                case 6: {
+                    if (tag !== 50) {
+                        break;
+                    }
+                    message.lastTime = fromTimestamp(timestamp_1.Timestamp.decode(reader, reader.uint32()));
+                    continue;
+                }
+            }
+            if ((tag & 7) === 4 || tag === 0) {
+                break;
+            }
+            reader.skip(tag & 7);
+        }
+        return message;
+    },
+    fromJSON(object) {
+        return {
+            topic: isSet(object.topic) ? globalThis.String(object.topic) : "",
+            schemaName: isSet(object.schemaName) ? globalThis.String(object.schemaName) : "",
+            messageEncoding: isSet(object.messageEncoding) ? globalThis.String(object.messageEncoding) : "",
+            messageCount: isSet(object.messageCount) ? globalThis.Number(object.messageCount) : 0,
+            firstTime: isSet(object.firstTime) ? fromJsonTimestamp(object.firstTime) : undefined,
+            lastTime: isSet(object.lastTime) ? fromJsonTimestamp(object.lastTime) : undefined,
+        };
+    },
+    toJSON(message) {
+        const obj = {};
+        if (message.topic !== "") {
+            obj.topic = message.topic;
+        }
+        if (message.schemaName !== "") {
+            obj.schemaName = message.schemaName;
+        }
+        if (message.messageEncoding !== "") {
+            obj.messageEncoding = message.messageEncoding;
+        }
+        if (message.messageCount !== 0) {
+            obj.messageCount = Math.round(message.messageCount);
+        }
+        if (message.firstTime !== undefined) {
+            obj.firstTime = message.firstTime.toISOString();
+        }
+        if (message.lastTime !== undefined) {
+            obj.lastTime = message.lastTime.toISOString();
+        }
+        return obj;
+    },
+    create(base) {
+        return exports.ChannelInfo.fromPartial(base ?? {});
+    },
+    fromPartial(object) {
+        const message = createBaseChannelInfo();
+        message.topic = object.topic ?? "";
+        message.schemaName = object.schemaName ?? "";
+        message.messageEncoding = object.messageEncoding ?? "";
+        message.messageCount = object.messageCount ?? 0;
+        message.firstTime = object.firstTime ?? undefined;
+        message.lastTime = object.lastTime ?? undefined;
+        return message;
+    },
+};
+function createBaseDescribeFileResponse() {
+    return { file: undefined, channels: [], fromScan: false };
+}
+exports.DescribeFileResponse = {
+    encode(message, writer = new wire_1.BinaryWriter()) {
+        if (message.file !== undefined) {
+            exports.FileInfo.encode(message.file, writer.uint32(10).fork()).join();
+        }
+        for (const v of message.channels) {
+            exports.ChannelInfo.encode(v, writer.uint32(18).fork()).join();
+        }
+        if (message.fromScan !== false) {
+            writer.uint32(24).bool(message.fromScan);
+        }
+        return writer;
+    },
+    decode(input, length) {
+        const reader = input instanceof wire_1.BinaryReader ? input : new wire_1.BinaryReader(input);
+        let end = length === undefined ? reader.len : reader.pos + length;
+        const message = createBaseDescribeFileResponse();
+        while (reader.pos < end) {
+            const tag = reader.uint32();
+            switch (tag >>> 3) {
+                case 1: {
+                    if (tag !== 10) {
+                        break;
+                    }
+                    message.file = exports.FileInfo.decode(reader, reader.uint32());
+                    continue;
+                }
+                case 2: {
+                    if (tag !== 18) {
+                        break;
+                    }
+                    message.channels.push(exports.ChannelInfo.decode(reader, reader.uint32()));
+                    continue;
+                }
+                case 3: {
+                    if (tag !== 24) {
+                        break;
+                    }
+                    message.fromScan = reader.bool();
+                    continue;
+                }
+            }
+            if ((tag & 7) === 4 || tag === 0) {
+                break;
+            }
+            reader.skip(tag & 7);
+        }
+        return message;
+    },
+    fromJSON(object) {
+        return {
+            file: isSet(object.file) ? exports.FileInfo.fromJSON(object.file) : undefined,
+            channels: globalThis.Array.isArray(object?.channels)
+                ? object.channels.map((e) => exports.ChannelInfo.fromJSON(e))
+                : [],
+            fromScan: isSet(object.fromScan) ? globalThis.Boolean(object.fromScan) : false,
+        };
+    },
+    toJSON(message) {
+        const obj = {};
+        if (message.file !== undefined) {
+            obj.file = exports.FileInfo.toJSON(message.file);
+        }
+        if (message.channels?.length) {
+            obj.channels = message.channels.map((e) => exports.ChannelInfo.toJSON(e));
+        }
+        if (message.fromScan !== false) {
+            obj.fromScan = message.fromScan;
+        }
+        return obj;
+    },
+    create(base) {
+        return exports.DescribeFileResponse.fromPartial(base ?? {});
+    },
+    fromPartial(object) {
+        const message = createBaseDescribeFileResponse();
+        message.file = (object.file !== undefined && object.file !== null) ? exports.FileInfo.fromPartial(object.file) : undefined;
+        message.channels = object.channels?.map((e) => exports.ChannelInfo.fromPartial(e)) || [];
+        message.fromScan = object.fromScan ?? false;
+        return message;
+    },
+};
 function createBaseLoadFileRequest() {
     return { path: "" };
 }
@@ -536,6 +800,15 @@ exports.ReplayControlDefinition = {
             responseStream: false,
             options: {},
         },
+        /** Per-channel message counts and first/last message times for one file. */
+        describe_file: {
+            name: "describe_file",
+            requestType: exports.DescribeFileRequest,
+            requestStream: false,
+            responseType: exports.DescribeFileResponse,
+            responseStream: false,
+            options: {},
+        },
         load_file: {
             name: "load_file",
             requestType: exports.LoadFileRequest,

package/dist/interfaces/serviceRegistry.d.ts

@@ -137,6 +137,14 @@ export declare const serviceDefinitions: {
                 readonly responseStream: false;
                 readonly options: {};
             };
+            readonly describe_file: {
+                readonly name: "describe_file";
+                readonly requestType: import("./ReplayControl").MessageFns<import("./ReplayControl").DescribeFileRequest>;
+                readonly requestStream: false;
+                readonly responseType: import("./ReplayControl").MessageFns<import("./ReplayControl").DescribeFileResponse>;
+                readonly responseStream: false;
+                readonly options: {};
+            };
             readonly load_file: {
                 readonly name: "load_file";
                 readonly requestType: import("./ReplayControl").MessageFns<import("./ReplayControl").LoadFileRequest>;

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@rise-maritime/keelson-js",
   "//version": "NOT the published version. The release workflow overwrites it from the release tag (npm version --no-git-tag-version), so tag and artifact cannot disagree. Only matters for local installs; do not hand-bump before tagging — that manual step is what broke release 0.5.4.",
-  "version": "0.6.0-alpha.280.dev.1",
+  "version": "0.6.0-alpha.281.dev.1",
   "description": "Keelson JavaScript SDK with Node-RED nodes",
   "main": "dist/index.js",
   "files": [