@rise-maritime/keelson-js 0.6.0-experimental.7 → 0.6.0-experimental.8

package/dist/interfaces/NavigationControl.d.ts

@@ -13,7 +13,9 @@ export interface Caller {
     controllerId: string;
     /**
      * The token of the command_authority lease the caller holds. Absent when it holds none, which
-     * is valid only while the responder holds the conn itself (see WHO MAY CALL).
+     * is valid only while the responder holds the conn itself. The token is broadcast on a stored
+     * slot, so this is an interlock against a station that has lost the conn, not a credential
+     * (protocols/navigation_conduct.yaml).
      */
     authorityToken?: string | undefined;
 }
@@ -65,7 +67,8 @@ export interface SetGuidanceOrderRequest {
 export interface SetGuidanceOrderResponse {
     /**
      * UNSUPPORTED when the responder, or the vehicle behind it, cannot hold the requested frame —
-     * it never substitutes course for heading or the reverse.
+     * it never substitutes course for heading or the reverse. TEMPORARILY_REJECTED when there is no
+     * active voyage to steer.
      */
     result: CommandResult;
     detail: string;

package/dist/interfaces/ReplayControl.d.ts

@@ -58,7 +58,12 @@ export interface LoadFileRequest {
     path: string;
 }
 export interface SeekRequest {
-    /** Target playhead timestamp. Must fall within the loaded file's window. */
+    /**
+     * Target playhead timestamp. Must fall within the ACTIVE RANGE when `set_range` has set one, and
+     * within the loaded file's window otherwise; outside it the reply is OUT_OF_RANGE. A seek is not
+     * clamped into the range, for the reason an inverted range is not swapped: a client that read its
+     * own position back and found it somewhere else would have nothing telling it so.
+     */
     target: Date | undefined;
 }
 export interface SetSpeedRequest {
@@ -89,7 +94,12 @@ export interface SetLoopRequest {
 export interface SetRangeRequest {
     /** First message replayed. Unset means the file's start. */
     start: Date | undefined;
-    /** Playback stops or loops on reaching this. Unset means the file's end. */
+    /**
+     * Playback stops or loops on reaching this. Unset means the file's end.
+     *
+     * Inclusive: an operator who puts the out-point ON a message means to hear that message. Only
+     * `end` strictly BEFORE `start` is refused -- `end` equal to `start` is a one-message span.
+     */
     end: Date | undefined;
 }
 /** Generic acknowledgement for control commands. */

package/dist/interfaces/Route.d.ts

@@ -410,6 +410,9 @@ export interface Waypoints {
  * route sets no default speed" as distinct from "this route defaults to
  * zero", and a consumer merging defaults into a waypoint cannot tell which
  * it was handed.
+ *
+ * `Leg.xtd_corridor_mode` and both boundary lists are ignored here: a drawn
+ * corridor belongs to one stretch of water and cannot be a default (§6.2.2).
  */
 export interface DefaultWaypoint {
     leg: Leg | undefined;

package/dist/interfaces/Voyage.d.ts

@@ -126,6 +126,16 @@ export interface Voyage {
      * voyages (e.g. crewed vs unmanned).
      */
     reroutingPolicy: DynamicReroutingPolicy | undefined;
+    /**
+     * -- Who writes this voyage -------------------------------------------------
+     * `voyage/{voyage_id}` is a slot (§2.1.1): one position per voyage, overwritten
+     * as the voyage runs, with no producer chunk in the key. The current writer is
+     * therefore in the payload, and this is it — the navigation process conducting
+     * the voyage, while it serves `navigation_control/v1`
+     * (protocols/navigation_conduct.yaml). Empty before conduct begins: a voyage
+     * published PLANNED by a station is not yet conducted by anybody.
+     */
+    conductedBy: string;
 }
 export declare const VoyageAuditEntry: MessageFns<VoyageAuditEntry>;
 export declare const DynamicReroutingPolicy: MessageFns<DynamicReroutingPolicy>;

package/dist/interfaces/Voyage.js

@@ -425,6 +425,7 @@ function createBaseVoyage() {
         linkedProcedureIds: [],
         auditTrail: [],
         reroutingPolicy: undefined,
+        conductedBy: "",
     };
 }
 exports.Voyage = {
@@ -498,6 +499,9 @@ exports.Voyage = {
         if (message.reroutingPolicy !== undefined) {
             exports.DynamicReroutingPolicy.encode(message.reroutingPolicy, writer.uint32(722).fork()).join();
         }
+        if (message.conductedBy !== "") {
+            writer.uint32(730).string(message.conductedBy);
+        }
         return writer;
     },
     decode(input, length) {
@@ -668,6 +672,13 @@ exports.Voyage = {
                     message.reroutingPolicy = exports.DynamicReroutingPolicy.decode(reader, reader.uint32());
                     continue;
                 }
+                case 91: {
+                    if (tag !== 730) {
+                        break;
+                    }
+                    message.conductedBy = reader.string();
+                    continue;
+                }
             }
             if ((tag & 7) === 4 || tag === 0) {
                 break;
@@ -707,6 +718,7 @@ exports.Voyage = {
             reroutingPolicy: isSet(object.reroutingPolicy)
                 ? exports.DynamicReroutingPolicy.fromJSON(object.reroutingPolicy)
                 : undefined,
+            conductedBy: isSet(object.conductedBy) ? globalThis.String(object.conductedBy) : "",
         };
     },
     toJSON(message) {
@@ -780,6 +792,9 @@ exports.Voyage = {
         if (message.reroutingPolicy !== undefined) {
             obj.reroutingPolicy = exports.DynamicReroutingPolicy.toJSON(message.reroutingPolicy);
         }
+        if (message.conductedBy !== "") {
+            obj.conductedBy = message.conductedBy;
+        }
         return obj;
     },
     create(base) {
@@ -816,6 +831,7 @@ exports.Voyage = {
         message.reroutingPolicy = (object.reroutingPolicy !== undefined && object.reroutingPolicy !== null)
             ? exports.DynamicReroutingPolicy.fromPartial(object.reroutingPolicy)
             : undefined;
+        message.conductedBy = object.conductedBy ?? "";
         return message;
     },
 };

package/dist/payloads/Route.d.ts

@@ -417,6 +417,9 @@ export interface Waypoints {
  * route sets no default speed" as distinct from "this route defaults to
  * zero", and a consumer merging defaults into a waypoint cannot tell which
  * it was handed.
+ *
+ * `Leg.xtd_corridor_mode` and both boundary lists are ignored here: a drawn
+ * corridor belongs to one stretch of water and cannot be a default (§6.2.2).
  */
 export interface DefaultWaypoint {
     $type: "keelson.DefaultWaypoint";

package/dist/payloads/Voyage.d.ts

@@ -128,6 +128,16 @@ export interface Voyage {
      * voyages (e.g. crewed vs unmanned).
      */
     reroutingPolicy: DynamicReroutingPolicy | undefined;
+    /**
+     * -- Who writes this voyage -------------------------------------------------
+     * `voyage/{voyage_id}` is a slot (§2.1.1): one position per voyage, overwritten
+     * as the voyage runs, with no producer chunk in the key. The current writer is
+     * therefore in the payload, and this is it — the navigation process conducting
+     * the voyage, while it serves `navigation_control/v1`
+     * (protocols/navigation_conduct.yaml). Empty before conduct begins: a voyage
+     * published PLANNED by a station is not yet conducted by anybody.
+     */
+    conductedBy: string;
 }
 export declare const VoyageAuditEntry: MessageFns<VoyageAuditEntry, "keelson.VoyageAuditEntry">;
 export declare const DynamicReroutingPolicy: MessageFns<DynamicReroutingPolicy, "keelson.DynamicReroutingPolicy">;

package/dist/payloads/Voyage.js

@@ -433,6 +433,7 @@ function createBaseVoyage() {
         linkedProcedureIds: [],
         auditTrail: [],
         reroutingPolicy: undefined,
+        conductedBy: "",
     };
 }
 exports.Voyage = {
@@ -507,6 +508,9 @@ exports.Voyage = {
         if (message.reroutingPolicy !== undefined) {
             exports.DynamicReroutingPolicy.encode(message.reroutingPolicy, writer.uint32(722).fork()).join();
         }
+        if (message.conductedBy !== "") {
+            writer.uint32(730).string(message.conductedBy);
+        }
         return writer;
     },
     decode(input, length) {
@@ -677,6 +681,13 @@ exports.Voyage = {
                     message.reroutingPolicy = exports.DynamicReroutingPolicy.decode(reader, reader.uint32());
                     continue;
                 }
+                case 91: {
+                    if (tag !== 730) {
+                        break;
+                    }
+                    message.conductedBy = reader.string();
+                    continue;
+                }
             }
             if ((tag & 7) === 4 || tag === 0) {
                 break;
@@ -717,6 +728,7 @@ exports.Voyage = {
             reroutingPolicy: isSet(object.reroutingPolicy)
                 ? exports.DynamicReroutingPolicy.fromJSON(object.reroutingPolicy)
                 : undefined,
+            conductedBy: isSet(object.conductedBy) ? globalThis.String(object.conductedBy) : "",
         };
     },
     toJSON(message) {
@@ -790,6 +802,9 @@ exports.Voyage = {
         if (message.reroutingPolicy !== undefined) {
             obj.reroutingPolicy = exports.DynamicReroutingPolicy.toJSON(message.reroutingPolicy);
         }
+        if (message.conductedBy !== "") {
+            obj.conductedBy = message.conductedBy;
+        }
         return obj;
     },
     create(base) {
@@ -826,6 +841,7 @@ exports.Voyage = {
         message.reroutingPolicy = (object.reroutingPolicy !== undefined && object.reroutingPolicy !== null)
             ? exports.DynamicReroutingPolicy.fromPartial(object.reroutingPolicy)
             : undefined;
+        message.conductedBy = object.conductedBy ?? "";
         return message;
     },
 };

package/dist/subjects.json

@@ -172,7 +172,6 @@
     "container_status": "keelson.ContainerHostStatus",
     "container_stats": "keelson.ContainerHostStats",
     "radio_channel_ppm_pct": "keelson.TimestampedFloat",
-    "radio_rssi": "keelson.TimestampedFloat",
     "radio_rsrp_dbm": "keelson.TimestampedFloat",
     "radio_rsrq_db": "keelson.TimestampedFloat",
     "radio_sinr_db": "keelson.TimestampedFloat",

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-experimental.7",
+  "version": "0.6.0-experimental.8",
   "description": "Keelson JavaScript SDK with Node-RED nodes",
   "main": "dist/index.js",
   "files": [