@rise-maritime/keelson-js 0.5.3 → 0.6.0-alpha.202.dev.1

package/dist/index.js

@@ -3,15 +3,23 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.encloseFromTypeName = exports.encodePayloadFromTypeName = exports.decodePayloadFromTypeName = exports.getProtobufClassFromTypeName = exports.getSubjectSchema = exports.isSubjectWellKnown = exports.uncover = exports.enclose = exports.get_subject_from_pubsub_key = exports.parse_rpc_key = exports.parse_pubsub_key = exports.construct_rpc_key = exports.construct_pubSub_key = void 0;
+exports.encloseFromTypeName = exports.encodePayloadFromTypeName = exports.decodePayloadFromTypeName = exports.getProtobufClassFromTypeName = exports.qosFor = exports.getProcedureCodecs = exports.getProcedures = exports.getInterfaceDefinition = exports.listInterfaces = exports.getInterfaceService = exports.isInterfaceWellKnown = exports.getSubjectSchema = exports.isSubjectWellKnown = exports.uncover = exports.enclose = exports.get_subject_from_pubsub_key = exports.parse_rpc_key = exports.parse_pubsub_key = exports.construct_rpc_interface_liveliness_key = exports.construct_source_liveliness_key = exports.construct_rpc_key = exports.construct_pubSub_key = void 0;
 const Envelope_1 = require("./Envelope");
 const subjects_json_1 = __importDefault(require("./subjects.json"));
+const interfaces_json_1 = __importDefault(require("./interfaces.json"));
+const qos_json_1 = __importDefault(require("./qos.json"));
 const typeRegistry_1 = require("./payloads/typeRegistry");
+const serviceRegistry_1 = require("./interfaces/serviceRegistry");
 require("./payloads");
 // KEY HELPER FUNCTIONS
 const KEELSON_BASE_KEY_FORMAT = "{base_path}/@v0/{entity_id}";
 const KEELSON_PUB_SUB_KEY_FORMAT = KEELSON_BASE_KEY_FORMAT + "/pubsub/{subject}/{source_id}";
-const KEELSON_REQ_REP_KEY_FORMAT = KEELSON_BASE_KEY_FORMAT + "/@rpc/{procedure}/{source_id}";
+const KEELSON_REQ_REP_KEY_FORMAT = KEELSON_BASE_KEY_FORMAT + "/@rpc/{interface}/{version}/{procedure}/{source_id}";
+const KEELSON_RPC_INTERFACE_LIVELINESS_KEY_FORMAT = KEELSON_BASE_KEY_FORMAT + "/@rpc/{interface}/{version}/*/{source_id}";
+// An interface version chunk is v{N} with N a positive integer.
+function isValidInterfaceVersion(version) {
+    return /^v[1-9][0-9]*$/.test(version);
+}
 function construct_pubSub_key(base_path, entityId, subject, sourceId, targetId) {
     /**
     * Construct a key expression for a publish and subscribe.
@@ -33,16 +41,58 @@ function construct_pubSub_key(base_path, entityId, subject, sourceId, targetId)
     return targetId ? `${key}/@target/${targetId}` : key;
 }
 exports.construct_pubSub_key = construct_pubSub_key;
-function construct_rpc_key(base_path, entityId, procedure, sourceId) {
+function construct_rpc_key(base_path, entityId, iface, version, procedure, sourceId) {
     /**
      * Construct a key expression for a request reply interaction (Queryable).
+     *
+     * @param iface - Well-known RPC interface name (see interfaces.yaml)
+     * @param version - Interface version chunk, v{N} (e.g. "v1")
      */
+    if (!isValidInterfaceVersion(version)) {
+        throw new Error(`Interface version '${version}' is not of the required form v{N}`);
+    }
+    if (!isInterfaceWellKnown(`${iface}/${version}`)) {
+        console.warn(`Interface: ${iface}/${version} is NOT well-known!`);
+    }
     return KEELSON_REQ_REP_KEY_FORMAT.replace("{base_path}", base_path)
         .replace("{entity_id}", entityId)
+        .replace("{interface}", iface)
+        .replace("{version}", version)
         .replace("{procedure}", procedure)
         .replace("{source_id}", sourceId);
 }
 exports.construct_rpc_key = construct_rpc_key;
+function construct_source_liveliness_key(base_path, entityId, sourceId) {
+    /**
+     * Construct the source-level liveliness token key: "this process is
+     * present on the bus as a producer in some category". The `*` occupies
+     * the category slot (pubsub / @rpc / ...). Note that as a verbatim
+     * chunk, @rpc is never matched by the wildcard — RPC capability is
+     * discovered via the interface-level token instead.
+     */
+    return `${base_path}/@v0/${entityId}/*/${sourceId}`;
+}
+exports.construct_source_liveliness_key = construct_source_liveliness_key;
+function construct_rpc_interface_liveliness_key(base_path, entityId, iface, version, sourceId) {
+    /**
+     * Construct the liveliness token key for one served RPC
+     * (interface, version) pair. The `*` in the procedure slot means
+     * "any procedure in this scope"; under the full-interface rule the
+     * token also claims full coverage of the interface version.
+     */
+    if (!isValidInterfaceVersion(version)) {
+        throw new Error(`Interface version '${version}' is not of the required form v{N}`);
+    }
+    if (!isInterfaceWellKnown(`${iface}/${version}`)) {
+        console.warn(`Interface: ${iface}/${version} is NOT well-known!`);
+    }
+    return KEELSON_RPC_INTERFACE_LIVELINESS_KEY_FORMAT.replace("{base_path}", base_path)
+        .replace("{entity_id}", entityId)
+        .replace("{interface}", iface)
+        .replace("{version}", version)
+        .replace("{source_id}", sourceId);
+}
+exports.construct_rpc_interface_liveliness_key = construct_rpc_interface_liveliness_key;
 function parse_pubsub_key(key) {
     /**
      * Parse a key expression for a publish subscribe interaction.
@@ -74,8 +124,10 @@ function parse_rpc_key(key) {
     return {
         base_path: parts[0],
         entityId: parts[2],
-        procedure: parts[4],
-        sourceId: parts.slice(5).join("/")
+        interface: parts[4],
+        version: parts[5],
+        procedure: parts[6],
+        sourceId: parts.slice(7).join("/")
     };
 }
 exports.parse_rpc_key = parse_rpc_key;
@@ -103,6 +155,63 @@ function getSubjectSchema(subject) {
     return subjects_json_1.default[subject];
 }
 exports.getSubjectSchema = getSubjectSchema;
+// INTERFACES HELPER FUNCTIONS
+function isInterfaceWellKnown(interfaceAndVersion) {
+    return interfaces_json_1.default[interfaceAndVersion] != null;
+}
+exports.isInterfaceWellKnown = isInterfaceWellKnown;
+function getInterfaceService(interfaceAndVersion) {
+    return interfaces_json_1.default[interfaceAndVersion];
+}
+exports.getInterfaceService = getInterfaceService;
+function listInterfaces() {
+    /** All well-known "{interface}/{version}" keys of this SDK release. */
+    return Object.keys(serviceRegistry_1.serviceDefinitions);
+}
+exports.listInterfaces = listInterfaces;
+function getInterfaceDefinition(interfaceAndVersion) {
+    /** The ts-proto generic ServiceDefinition for "{interface}/{version}". */
+    return serviceRegistry_1.serviceDefinitions[interfaceAndVersion];
+}
+exports.getInterfaceDefinition = getInterfaceDefinition;
+function getProcedures(interfaceAndVersion) {
+    /** Procedure (method) names defined by "{interface}/{version}". */
+    const definition = getInterfaceDefinition(interfaceAndVersion);
+    if (definition == null) {
+        throw new Error(`Unknown interface: ${interfaceAndVersion}`);
+    }
+    return Object.values(definition.methods).map((m) => m.name);
+}
+exports.getProcedures = getProcedures;
+function getProcedureCodecs(interfaceAndVersion, procedure) {
+    /**
+     * The request/response message codecs of one procedure — each has
+     * encode/decode/fromJSON/toJSON/fromPartial per ts-proto's message
+     * functions, enabling generic invocation without static imports.
+     */
+    const definition = getInterfaceDefinition(interfaceAndVersion);
+    if (definition == null) {
+        throw new Error(`Unknown interface: ${interfaceAndVersion}`);
+    }
+    for (const method of Object.values(definition.methods)) {
+        const m = method;
+        if (m.name === procedure) {
+            return { requestType: m.requestType, responseType: m.responseType };
+        }
+    }
+    throw new Error(`Unknown procedure ${procedure} on ${interfaceAndVersion}`);
+}
+exports.getProcedureCodecs = getProcedureCodecs;
+const QOS_PROFILES = qos_json_1.default.profiles ?? {};
+const QOS_SUBJECTS = qos_json_1.default.subjects ?? {};
+const QOS_DEFAULT = qos_json_1.default.default ?? "default";
+/** Return the QoS profile assigned to a well-known subject (or the default). */
+function qosFor(subject) {
+    const name = QOS_SUBJECTS[subject] ?? QOS_DEFAULT;
+    const fields = QOS_PROFILES[name];
+    return { name, ...fields };
+}
+exports.qosFor = qosFor;
 // PAYLOADS
 function getProtobufClassFromTypeName(typeName) {
     return typeRegistry_1.messageTypeRegistry.get(typeName);

package/dist/index.test.js

@@ -159,3 +159,60 @@ describe("get_subject_from_pubsub_key", () => {
         expect(subject).toBe("heading_true_north_deg");
     });
 });
+describe("construct_rpc_key", () => {
+    it("builds the interface/version key shape", () => {
+        expect((0, index_1.construct_rpc_key)("realm", "boat", "replay_control", "v1", "play", "conn/0"))
+            .toBe("realm/@v0/boat/@rpc/replay_control/v1/play/conn/0");
+    });
+    it("rejects malformed versions", () => {
+        expect(() => (0, index_1.construct_rpc_key)("realm", "boat", "replay_control", "1", "play", "c")).toThrow();
+        expect(() => (0, index_1.construct_rpc_key)("realm", "boat", "replay_control", "v0", "play", "c")).toThrow();
+        expect(() => (0, index_1.construct_rpc_key)("realm", "boat", "replay_control", "v01", "play", "c")).toThrow();
+    });
+});
+describe("construct_rpc_interface_liveliness_key", () => {
+    it("builds the interface liveliness token key", () => {
+        expect((0, index_1.construct_rpc_interface_liveliness_key)("realm", "boat", "whep_proxy", "v1", "mediamtx/0"))
+            .toBe("realm/@v0/boat/@rpc/whep_proxy/v1/*/mediamtx/0");
+    });
+});
+describe("parse_rpc_key", () => {
+    it("parses interface, version, procedure and multi-chunk source", () => {
+        expect((0, index_1.parse_rpc_key)("realm/@v0/boat/@rpc/replay_control/v1/play/conn/0")).toEqual({
+            base_path: "realm",
+            entityId: "boat",
+            interface: "replay_control",
+            version: "v1",
+            procedure: "play",
+            sourceId: "conn/0",
+        });
+    });
+});
+describe("interfaces registry", () => {
+    it("knows the bundled well-known interfaces", () => {
+        expect((0, index_1.isInterfaceWellKnown)("replay_control/v1")).toBe(true);
+        expect((0, index_1.isInterfaceWellKnown)("nope/v1")).toBe(false);
+        expect((0, index_1.getInterfaceService)("vehicle_mission/v1"))
+            .toBe("keelson.interfaces.vehicle_mission.VehicleMission");
+    });
+});
+describe("interface introspection", () => {
+    const { listInterfaces, getProcedures, getProcedureCodecs } = require('./index');
+    it("lists every bundled interface", () => {
+        const interfaces = listInterfaces();
+        expect(interfaces).toContain("vehicle_lifecycle/v1");
+        expect(interfaces).toContain("replay_control/v1");
+        expect(interfaces.length).toBeGreaterThanOrEqual(14);
+    });
+    it("enumerates procedures", () => {
+        expect(getProcedures("vehicle_lifecycle/v1")).toEqual(["arm", "set_mode", "emergency_stop"]);
+        expect(() => getProcedures("nope/v1")).toThrow();
+    });
+    it("resolves procedure codecs that roundtrip", () => {
+        const { requestType } = getProcedureCodecs("replay_control/v1", "set_speed");
+        const encoded = requestType.encode(requestType.fromPartial({ speed: 2.5 })).finish();
+        const decoded = requestType.decode(encoded);
+        expect(decoded.speed).toBeCloseTo(2.5);
+        expect(() => getProcedureCodecs("replay_control/v1", "warp")).toThrow();
+    });
+});

package/dist/interfaces/AlarmAck.d.ts

@@ -0,0 +1,62 @@
+import { BinaryReader, BinaryWriter } from "@bufbuild/protobuf/wire";
+export declare const protobufPackage = "";
+export interface AcknowledgeAlarmRequest {
+    /** Client wall-clock at send, so the responder can log round-trip latency. */
+    timestamp: Date | undefined;
+    /** `Alarm.identifier` of the alarm being acknowledged. */
+    identifier: string;
+    /**
+     * Who is acknowledging — operator or station id. Recorded verbatim in the
+     * alarm's `AlarmAcknowledgment.acknowledged_by`, so it should be meaningful
+     * to somebody reading the alarm later, not an opaque session id.
+     */
+    acknowledgedBy: string;
+}
+export interface AcknowledgeAlarmResponse {
+    /**
+     * True when the owner recorded the acknowledgment. False is a legitimate
+     * outcome, not an error: an alarm may have expired, may already have been
+     * acknowledged by this party, or may carry ACK_NONE.
+     */
+    acknowledged: boolean;
+    /** Why not, when `acknowledged` is false. Empty otherwise. */
+    reason: string;
+    /** When the owner recorded it. Set only when `acknowledged` is true. */
+    timestampAcknowledged: Date | undefined;
+}
+export declare const AcknowledgeAlarmRequest: MessageFns<AcknowledgeAlarmRequest>;
+export declare const AcknowledgeAlarmResponse: MessageFns<AcknowledgeAlarmResponse>;
+export type AlarmAckDefinition = typeof AlarmAckDefinition;
+export declare const AlarmAckDefinition: {
+    readonly name: "AlarmAck";
+    readonly fullName: "AlarmAck";
+    readonly methods: {
+        readonly acknowledge_alarm: {
+            readonly name: "acknowledge_alarm";
+            readonly requestType: MessageFns<AcknowledgeAlarmRequest>;
+            readonly requestStream: false;
+            readonly responseType: MessageFns<AcknowledgeAlarmResponse>;
+            readonly responseStream: false;
+            readonly options: {};
+        };
+    };
+};
+type Builtin = Date | Function | Uint8Array | string | number | boolean | undefined;
+export type DeepPartial<T> = T extends Builtin ? T : T extends globalThis.Array<infer U> ? globalThis.Array<DeepPartial<U>> : T extends ReadonlyArray<infer U> ? ReadonlyArray<DeepPartial<U>> : T extends {} ? {
+    [K in keyof T]?: DeepPartial<T[K]>;
+} : Partial<T>;
+type KeysOfUnion<T> = T extends T ? keyof T : never;
+export type Exact<P, I extends P> = P extends Builtin ? P : P & {
+    [K in keyof P]: Exact<P[K], I[K]>;
+} & {
+    [K in Exclude<keyof I, KeysOfUnion<P>>]: never;
+};
+export interface MessageFns<T> {
+    encode(message: T, writer?: BinaryWriter): BinaryWriter;
+    decode(input: BinaryReader | Uint8Array, length?: number): T;
+    fromJSON(object: any): T;
+    toJSON(message: T): unknown;
+    create<I extends Exact<DeepPartial<T>, I>>(base?: I): T;
+    fromPartial<I extends Exact<DeepPartial<T>, I>>(object: I): T;
+}
+export {};

package/dist/interfaces/AlarmAck.js

@@ -0,0 +1,218 @@
+"use strict";
+// Code generated by protoc-gen-ts_proto. DO NOT EDIT.
+// versions:
+//   protoc-gen-ts_proto  v2.6.1
+//   protoc               v6.30.2
+// source: AlarmAck.proto
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AlarmAckDefinition = exports.AcknowledgeAlarmResponse = exports.AcknowledgeAlarmRequest = exports.protobufPackage = void 0;
+/* eslint-disable */
+const wire_1 = require("@bufbuild/protobuf/wire");
+const timestamp_1 = require("./google/protobuf/timestamp");
+exports.protobufPackage = "";
+function createBaseAcknowledgeAlarmRequest() {
+    return { timestamp: undefined, identifier: "", acknowledgedBy: "" };
+}
+exports.AcknowledgeAlarmRequest = {
+    encode(message, writer = new wire_1.BinaryWriter()) {
+        if (message.timestamp !== undefined) {
+            timestamp_1.Timestamp.encode(toTimestamp(message.timestamp), writer.uint32(10).fork()).join();
+        }
+        if (message.identifier !== "") {
+            writer.uint32(18).string(message.identifier);
+        }
+        if (message.acknowledgedBy !== "") {
+            writer.uint32(26).string(message.acknowledgedBy);
+        }
+        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 = createBaseAcknowledgeAlarmRequest();
+        while (reader.pos < end) {
+            const tag = reader.uint32();
+            switch (tag >>> 3) {
+                case 1: {
+                    if (tag !== 10) {
+                        break;
+                    }
+                    message.timestamp = fromTimestamp(timestamp_1.Timestamp.decode(reader, reader.uint32()));
+                    continue;
+                }
+                case 2: {
+                    if (tag !== 18) {
+                        break;
+                    }
+                    message.identifier = reader.string();
+                    continue;
+                }
+                case 3: {
+                    if (tag !== 26) {
+                        break;
+                    }
+                    message.acknowledgedBy = reader.string();
+                    continue;
+                }
+            }
+            if ((tag & 7) === 4 || tag === 0) {
+                break;
+            }
+            reader.skip(tag & 7);
+        }
+        return message;
+    },
+    fromJSON(object) {
+        return {
+            timestamp: isSet(object.timestamp) ? fromJsonTimestamp(object.timestamp) : undefined,
+            identifier: isSet(object.identifier) ? globalThis.String(object.identifier) : "",
+            acknowledgedBy: isSet(object.acknowledgedBy) ? globalThis.String(object.acknowledgedBy) : "",
+        };
+    },
+    toJSON(message) {
+        const obj = {};
+        if (message.timestamp !== undefined) {
+            obj.timestamp = message.timestamp.toISOString();
+        }
+        if (message.identifier !== "") {
+            obj.identifier = message.identifier;
+        }
+        if (message.acknowledgedBy !== "") {
+            obj.acknowledgedBy = message.acknowledgedBy;
+        }
+        return obj;
+    },
+    create(base) {
+        return exports.AcknowledgeAlarmRequest.fromPartial(base ?? {});
+    },
+    fromPartial(object) {
+        const message = createBaseAcknowledgeAlarmRequest();
+        message.timestamp = object.timestamp ?? undefined;
+        message.identifier = object.identifier ?? "";
+        message.acknowledgedBy = object.acknowledgedBy ?? "";
+        return message;
+    },
+};
+function createBaseAcknowledgeAlarmResponse() {
+    return { acknowledged: false, reason: "", timestampAcknowledged: undefined };
+}
+exports.AcknowledgeAlarmResponse = {
+    encode(message, writer = new wire_1.BinaryWriter()) {
+        if (message.acknowledged !== false) {
+            writer.uint32(8).bool(message.acknowledged);
+        }
+        if (message.reason !== "") {
+            writer.uint32(18).string(message.reason);
+        }
+        if (message.timestampAcknowledged !== undefined) {
+            timestamp_1.Timestamp.encode(toTimestamp(message.timestampAcknowledged), writer.uint32(26).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 = createBaseAcknowledgeAlarmResponse();
+        while (reader.pos < end) {
+            const tag = reader.uint32();
+            switch (tag >>> 3) {
+                case 1: {
+                    if (tag !== 8) {
+                        break;
+                    }
+                    message.acknowledged = reader.bool();
+                    continue;
+                }
+                case 2: {
+                    if (tag !== 18) {
+                        break;
+                    }
+                    message.reason = reader.string();
+                    continue;
+                }
+                case 3: {
+                    if (tag !== 26) {
+                        break;
+                    }
+                    message.timestampAcknowledged = 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 {
+            acknowledged: isSet(object.acknowledged) ? globalThis.Boolean(object.acknowledged) : false,
+            reason: isSet(object.reason) ? globalThis.String(object.reason) : "",
+            timestampAcknowledged: isSet(object.timestampAcknowledged)
+                ? fromJsonTimestamp(object.timestampAcknowledged)
+                : undefined,
+        };
+    },
+    toJSON(message) {
+        const obj = {};
+        if (message.acknowledged !== false) {
+            obj.acknowledged = message.acknowledged;
+        }
+        if (message.reason !== "") {
+            obj.reason = message.reason;
+        }
+        if (message.timestampAcknowledged !== undefined) {
+            obj.timestampAcknowledged = message.timestampAcknowledged.toISOString();
+        }
+        return obj;
+    },
+    create(base) {
+        return exports.AcknowledgeAlarmResponse.fromPartial(base ?? {});
+    },
+    fromPartial(object) {
+        const message = createBaseAcknowledgeAlarmResponse();
+        message.acknowledged = object.acknowledged ?? false;
+        message.reason = object.reason ?? "";
+        message.timestampAcknowledged = object.timestampAcknowledged ?? undefined;
+        return message;
+    },
+};
+exports.AlarmAckDefinition = {
+    name: "AlarmAck",
+    fullName: "AlarmAck",
+    methods: {
+        acknowledge_alarm: {
+            name: "acknowledge_alarm",
+            requestType: exports.AcknowledgeAlarmRequest,
+            requestStream: false,
+            responseType: exports.AcknowledgeAlarmResponse,
+            responseStream: false,
+            options: {},
+        },
+    },
+};
+function toTimestamp(date) {
+    const seconds = Math.trunc(date.getTime() / 1000);
+    const nanos = (date.getTime() % 1000) * 1000000;
+    return { seconds, nanos };
+}
+function fromTimestamp(t) {
+    let millis = (t.seconds || 0) * 1000;
+    millis += (t.nanos || 0) / 1000000;
+    return new globalThis.Date(millis);
+}
+function fromJsonTimestamp(o) {
+    if (o instanceof globalThis.Date) {
+        return o;
+    }
+    else if (typeof o === "string") {
+        return new globalThis.Date(o);
+    }
+    else {
+        return fromTimestamp(timestamp_1.Timestamp.fromJSON(o));
+    }
+}
+function isSet(value) {
+    return value !== null && value !== undefined;
+}

package/dist/interfaces/Configurable.d.ts

@@ -1,6 +1,6 @@
 import { BinaryReader, BinaryWriter } from "@bufbuild/protobuf/wire";
 import { Empty } from "./google/protobuf/empty";
-export declare const protobufPackage = "";
+export declare const protobufPackage = "keelson.interfaces.configurable";
 /** This represents an actual JSON string, i.e. not a protobuf type! */
 export interface JSON {
 }
@@ -8,23 +8,29 @@ export interface ConfigurableSuccessResponse {
 }
 export declare const JSON: MessageFns<JSON>;
 export declare const ConfigurableSuccessResponse: MessageFns<ConfigurableSuccessResponse>;
-export interface Configurable {
-    get_config(request: Empty): Promise<JSON>;
-    set_config(request: JSON): Promise<ConfigurableSuccessResponse>;
-}
-export declare const ConfigurableServiceName = "Configurable";
-export declare class ConfigurableClientImpl implements Configurable {
-    private readonly rpc;
-    private readonly service;
-    constructor(rpc: Rpc, opts?: {
-        service?: string;
-    });
-    get_config(request: Empty): Promise<JSON>;
-    set_config(request: JSON): Promise<ConfigurableSuccessResponse>;
-}
-interface Rpc {
-    request(service: string, method: string, data: Uint8Array): Promise<Uint8Array>;
-}
+export type ConfigurableDefinition = typeof ConfigurableDefinition;
+export declare const ConfigurableDefinition: {
+    readonly name: "Configurable";
+    readonly fullName: "keelson.interfaces.configurable.Configurable";
+    readonly methods: {
+        readonly get_config: {
+            readonly name: "get_config";
+            readonly requestType: import("./google/protobuf/empty").MessageFns<Empty>;
+            readonly requestStream: false;
+            readonly responseType: MessageFns<JSON>;
+            readonly responseStream: false;
+            readonly options: {};
+        };
+        readonly set_config: {
+            readonly name: "set_config";
+            readonly requestType: MessageFns<JSON>;
+            readonly requestStream: false;
+            readonly responseType: MessageFns<ConfigurableSuccessResponse>;
+            readonly responseStream: false;
+            readonly options: {};
+        };
+    };
+};
 type Builtin = Date | Function | Uint8Array | string | number | boolean | undefined;
 export type DeepPartial<T> = T extends Builtin ? T : T extends globalThis.Array<infer U> ? globalThis.Array<DeepPartial<U>> : T extends ReadonlyArray<infer U> ? ReadonlyArray<DeepPartial<U>> : T extends {} ? {
     [K in keyof T]?: DeepPartial<T[K]>;

package/dist/interfaces/Configurable.js

@@ -5,11 +5,11 @@
 //   protoc               v6.30.2
 // source: Configurable.proto
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.ConfigurableClientImpl = exports.ConfigurableServiceName = exports.ConfigurableSuccessResponse = exports.JSON = exports.protobufPackage = void 0;
+exports.ConfigurableDefinition = exports.ConfigurableSuccessResponse = exports.JSON = exports.protobufPackage = void 0;
 /* eslint-disable */
 const wire_1 = require("@bufbuild/protobuf/wire");
 const empty_1 = require("./google/protobuf/empty");
-exports.protobufPackage = "";
+exports.protobufPackage = "keelson.interfaces.configurable";
 function createBaseJSON() {
     return {};
 }
@@ -84,23 +84,25 @@ exports.ConfigurableSuccessResponse = {
         return message;
     },
 };
-exports.ConfigurableServiceName = "Configurable";
-class ConfigurableClientImpl {
-    constructor(rpc, opts) {
-        this.service = opts?.service || exports.ConfigurableServiceName;
-        this.rpc = rpc;
-        this.get_config = this.get_config.bind(this);
-        this.set_config = this.set_config.bind(this);
-    }
-    get_config(request) {
-        const data = empty_1.Empty.encode(request).finish();
-        const promise = this.rpc.request(this.service, "get_config", data);
-        return promise.then((data) => exports.JSON.decode(new wire_1.BinaryReader(data)));
-    }
-    set_config(request) {
-        const data = exports.JSON.encode(request).finish();
-        const promise = this.rpc.request(this.service, "set_config", data);
-        return promise.then((data) => exports.ConfigurableSuccessResponse.decode(new wire_1.BinaryReader(data)));
-    }
-}
-exports.ConfigurableClientImpl = ConfigurableClientImpl;
+exports.ConfigurableDefinition = {
+    name: "Configurable",
+    fullName: "keelson.interfaces.configurable.Configurable",
+    methods: {
+        get_config: {
+            name: "get_config",
+            requestType: empty_1.Empty,
+            requestStream: false,
+            responseType: exports.JSON,
+            responseStream: false,
+            options: {},
+        },
+        set_config: {
+            name: "set_config",
+            requestType: exports.JSON,
+            requestStream: false,
+            responseType: exports.ConfigurableSuccessResponse,
+            responseStream: false,
+            options: {},
+        },
+    },
+};

package/dist/interfaces/Coordinate.d.ts

@@ -0,0 +1,38 @@
+import { BinaryReader, BinaryWriter } from "@bufbuild/protobuf/wire";
+export declare const protobufPackage = "keelson";
+/**
+ * WGS84 latitude/longitude in plain degrees. The canonical coordinate
+ * shape for keelson *domain nouns* — mission waypoints, geofence
+ * vertices, navigation targets, route legs — shared by RPC interfaces
+ * and pub/sub payloads alike so consumers see a single coordinate type
+ * rather than each surface picking its own scaling / units.
+ *
+ * Telemetry position *fixes* (the `location_fix` subject) intentionally
+ * remain foxglove.LocationFix: a measured fix carries sensor context
+ * (covariance, frame_id) that is meaningful for telemetry but noise for
+ * a planned position. Don't swap one for the other.
+ */
+export interface Coordinate {
+    latitudeDeg: number;
+    longitudeDeg: number;
+}
+export declare const Coordinate: MessageFns<Coordinate>;
+type Builtin = Date | Function | Uint8Array | string | number | boolean | undefined;
+export type DeepPartial<T> = T extends Builtin ? T : T extends globalThis.Array<infer U> ? globalThis.Array<DeepPartial<U>> : T extends ReadonlyArray<infer U> ? ReadonlyArray<DeepPartial<U>> : T extends {} ? {
+    [K in keyof T]?: DeepPartial<T[K]>;
+} : Partial<T>;
+type KeysOfUnion<T> = T extends T ? keyof T : never;
+export type Exact<P, I extends P> = P extends Builtin ? P : P & {
+    [K in keyof P]: Exact<P[K], I[K]>;
+} & {
+    [K in Exclude<keyof I, KeysOfUnion<P>>]: never;
+};
+export interface MessageFns<T> {
+    encode(message: T, writer?: BinaryWriter): BinaryWriter;
+    decode(input: BinaryReader | Uint8Array, length?: number): T;
+    fromJSON(object: any): T;
+    toJSON(message: T): unknown;
+    create<I extends Exact<DeepPartial<T>, I>>(base?: I): T;
+    fromPartial<I extends Exact<DeepPartial<T>, I>>(object: I): T;
+}
+export {};