@sixfathoms/lplex 0.2.1 → 0.4.0

package/dist/index.cjs

@@ -89,8 +89,16 @@ async function* parseSSE(body) {
   }
 }
 function classify(obj) {
-  if ("type" in obj && obj.type === "device") {
-    return { type: "device", device: obj };
+  if ("type" in obj) {
+    if (obj.type === "device") {
+      return { type: "device", device: obj };
+    }
+    if (obj.type === "device_removed") {
+      return {
+        type: "device_removed",
+        deviceRemoved: obj
+      };
+    }
   }
   if ("seq" in obj) {
     return { type: "frame", frame: obj };
@@ -185,14 +193,27 @@ var Client = class {
   /**
    * Open an ephemeral SSE stream with optional filtering.
    * No session, no replay, no ACK.
+   *
+   * Accepts either a Filter (for backwards compatibility) or
+   * SubscribeOptions for additional control (decode, signal).
    */
-  async subscribe(filter, signal) {
+  async subscribe(filterOrOptions, signal) {
+    let filter;
+    let decode;
+    let sig = signal;
+    if (filterOrOptions && isSubscribeOptions(filterOrOptions)) {
+      filter = filterOrOptions.filter;
+      decode = filterOrOptions.decode;
+      sig = filterOrOptions.signal ?? sig;
+    } else {
+      filter = filterOrOptions;
+    }
     let url = `${this.#baseURL}/events`;
-    const qs = filterToQueryString(filter);
+    const qs = filterToQueryString(filter, decode);
     if (qs) url += `?${qs}`;
     const resp = await this.#fetch(url, {
       headers: { Accept: "text/event-stream" },
-      signal
+      signal: sig
     });
     if (!resp.ok) {
       const body = await resp.text();
@@ -203,6 +224,18 @@ var Client = class {
     }
     return parseSSE(resp.body);
   }
+  /** Fetch the last-seen decoded values for each (device, PGN) pair. */
+  async decodedValues(filter, signal) {
+    let url = `${this.#baseURL}/values/decoded`;
+    const qs = filterToQueryString(filter);
+    if (qs) url += `?${qs}`;
+    const resp = await this.#fetch(url, { signal });
+    if (!resp.ok) {
+      const body = await resp.text();
+      throw new HttpError("GET", url, resp.status, body);
+    }
+    return resp.json();
+  }
   /** Transmit a CAN frame through the server. */
   async send(params, signal) {
     const url = `${this.#baseURL}/send`;
@@ -217,6 +250,85 @@ var Client = class {
       throw new HttpError("POST", url, resp.status, body);
     }
   }
+  /**
+   * Send an ISO Request (PGN 59904) and wait for the response frame.
+   * Returns the response frame, or throws HttpError on timeout (408).
+   */
+  async query(params, signal) {
+    const url = `${this.#baseURL}/query`;
+    const resp = await this.#fetch(url, {
+      method: "POST",
+      headers: { "Content-Type": "application/json" },
+      body: JSON.stringify(params),
+      signal
+    });
+    if (!resp.ok) {
+      const body = await resp.text();
+      throw new HttpError("POST", url, resp.status, body);
+    }
+    return resp.json();
+  }
+  /**
+   * Query historical frames (requires journaling on the server).
+   * Returns an array of frames matching the query parameters.
+   */
+  async history(params, signal) {
+    const qs = new URLSearchParams();
+    qs.set("from", params.from);
+    if (params.to) qs.set("to", params.to);
+    for (const p of params.pgn ?? []) qs.append("pgn", p.toString());
+    for (const s of params.src ?? []) qs.append("src", s.toString());
+    if (params.limit !== void 0) qs.set("limit", params.limit.toString());
+    if (params.interval) qs.set("interval", params.interval);
+    if (params.decode) qs.set("decode", "true");
+    const url = `${this.#baseURL}/history?${qs.toString()}`;
+    const resp = await this.#fetch(url, { signal });
+    if (!resp.ok) {
+      const body = await resp.text();
+      throw new HttpError("GET", url, resp.status, body);
+    }
+    return resp.json();
+  }
+  /** Check server health (GET /healthz). */
+  async health(signal) {
+    const url = `${this.#baseURL}/healthz`;
+    const resp = await this.#fetch(url, { signal });
+    if (!resp.ok) {
+      const body = await resp.text();
+      throw new HttpError("GET", url, resp.status, body);
+    }
+    return resp.json();
+  }
+  /** Liveness probe (GET /livez). */
+  async liveness(signal) {
+    const url = `${this.#baseURL}/livez`;
+    const resp = await this.#fetch(url, { signal });
+    if (!resp.ok) {
+      const body = await resp.text();
+      throw new HttpError("GET", url, resp.status, body);
+    }
+    return resp.json();
+  }
+  /** Readiness probe (GET /readyz). */
+  async readiness(signal) {
+    const url = `${this.#baseURL}/readyz`;
+    const resp = await this.#fetch(url, { signal });
+    if (!resp.ok) {
+      const body = await resp.text();
+      throw new HttpError("GET", url, resp.status, body);
+    }
+    return resp.json();
+  }
+  /** Fetch boat-side replication status (only available when replication is configured). */
+  async replicationStatus(signal) {
+    const url = `${this.#baseURL}/replication/status`;
+    const resp = await this.#fetch(url, { signal });
+    if (!resp.ok) {
+      const body = await resp.text();
+      throw new HttpError("GET", url, resp.status, body);
+    }
+    return resp.json();
+  }
   /** Create or reconnect a buffered session on the server. */
   async createSession(config, signal) {
     const url = `${this.#baseURL}/clients/${config.clientId}`;
@@ -240,24 +352,37 @@ var Client = class {
     return new Session(this.#baseURL, this.#fetch, info);
   }
 };
+function isSubscribeOptions(obj) {
+  return "decode" in obj || "signal" in obj || "filter" in obj;
+}
 function filterIsEmpty(f) {
-  return !f.pgn?.length && !f.manufacturer?.length && !f.instance?.length && !f.name?.length;
+  return !f.pgn?.length && !f.exclude_pgn?.length && !f.manufacturer?.length && !f.instance?.length && !f.name?.length && !f.exclude_name?.length && !f.bus?.length;
 }
-function filterToQueryString(f) {
-  if (!f || filterIsEmpty(f)) return "";
+function filterToQueryString(f, decode) {
+  if ((!f || filterIsEmpty(f)) && !decode) return "";
   const params = new URLSearchParams();
-  for (const p of f.pgn ?? []) params.append("pgn", p.toString());
-  for (const m of f.manufacturer ?? []) params.append("manufacturer", m);
-  for (const i of f.instance ?? []) params.append("instance", i.toString());
-  for (const n of f.name ?? []) params.append("name", n);
+  if (f) {
+    for (const p of f.pgn ?? []) params.append("pgn", p.toString());
+    for (const p of f.exclude_pgn ?? [])
+      params.append("exclude_pgn", p.toString());
+    for (const m of f.manufacturer ?? []) params.append("manufacturer", m);
+    for (const i of f.instance ?? []) params.append("instance", i.toString());
+    for (const n of f.name ?? []) params.append("name", n);
+    for (const n of f.exclude_name ?? []) params.append("exclude_name", n);
+    for (const b of f.bus ?? []) params.append("bus", b);
+  }
+  if (decode) params.set("decode", "true");
   return params.toString();
 }
 function filterToJSON(f) {
   const m = {};
   if (f.pgn?.length) m.pgn = f.pgn;
+  if (f.exclude_pgn?.length) m.exclude_pgn = f.exclude_pgn;
   if (f.manufacturer?.length) m.manufacturer = f.manufacturer;
   if (f.instance?.length) m.instance = f.instance;
   if (f.name?.length) m.name = f.name;
+  if (f.exclude_name?.length) m.exclude_name = f.exclude_name;
+  if (f.bus?.length) m.bus = f.bus;
   return m;
 }
 
@@ -313,6 +438,36 @@ var CloudClient = class {
     }
     return resp.json();
   }
+  /** Check cloud server health (GET /healthz). */
+  async health(signal) {
+    const url = `${this.#baseURL}/healthz`;
+    const resp = await this.#fetch(url, { signal });
+    if (!resp.ok) {
+      const body = await resp.text();
+      throw new HttpError("GET", url, resp.status, body);
+    }
+    return resp.json();
+  }
+  /** Liveness probe (GET /livez). */
+  async liveness(signal) {
+    const url = `${this.#baseURL}/livez`;
+    const resp = await this.#fetch(url, { signal });
+    if (!resp.ok) {
+      const body = await resp.text();
+      throw new HttpError("GET", url, resp.status, body);
+    }
+    return resp.json();
+  }
+  /** Readiness probe (GET /readyz). */
+  async readiness(signal) {
+    const url = `${this.#baseURL}/readyz`;
+    const resp = await this.#fetch(url, { signal });
+    if (!resp.ok) {
+      const body = await resp.text();
+      throw new HttpError("GET", url, resp.status, body);
+    }
+    return resp.json();
+  }
 };
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {

package/dist/index.d.cts

@@ -2,14 +2,17 @@
 interface Frame {
     seq: number;
     ts: string;
+    bus?: string;
     prio: number;
     pgn: number;
     src: number;
     dst: number;
     data: string;
+    decoded?: Record<string, unknown>;
 }
 /** An NMEA 2000 device discovered on the bus. */
 interface Device {
+    bus?: string;
     src: number;
     name: string;
     manufacturer: string;
@@ -28,6 +31,12 @@ interface Device {
     packet_count: number;
     byte_count: number;
 }
+/** A device-removed notification from the bus. */
+interface DeviceRemoved {
+    type: "device_removed";
+    bus?: string;
+    src: number;
+}
 /** Discriminated union for SSE events. */
 type Event = {
     type: "frame";
@@ -35,6 +44,9 @@ type Event = {
 } | {
     type: "device";
     device: Device;
+} | {
+    type: "device_removed";
+    deviceRemoved: DeviceRemoved;
 };
 /**
  * Filter for CAN frames.
@@ -42,9 +54,19 @@ type Event = {
  */
 interface Filter {
     pgn?: number[];
+    exclude_pgn?: number[];
     manufacturer?: string[];
     instance?: number[];
     name?: string[];
+    exclude_name?: string[];
+    bus?: string[];
+}
+/** Options for ephemeral SSE subscription. */
+interface SubscribeOptions {
+    filter?: Filter;
+    /** When true, frames include decoded field values. */
+    decode?: boolean;
+    signal?: AbortSignal;
 }
 /** Configuration for creating a buffered session. */
 interface SessionConfig {
@@ -66,6 +88,7 @@ interface SendParams {
     dst: number;
     prio: number;
     data: string;
+    bus?: string;
 }
 /** A single PGN's last-known value for a device. */
 interface PGNValue {
@@ -82,6 +105,91 @@ interface DeviceValues {
     model_id?: string;
     values: PGNValue[];
 }
+/** A single PGN's decoded value for a device. */
+interface DecodedPGNValue {
+    pgn: number;
+    ts: string;
+    data: string;
+    seq: number;
+    decoded: Record<string, unknown>;
+}
+/** Decoded values grouped by device. */
+interface DecodedDeviceValues {
+    name: string;
+    src: number;
+    manufacturer?: string;
+    model_id?: string;
+    values: DecodedPGNValue[];
+}
+/** Parameters for an ISO Request query (POST /query). */
+interface QueryParams {
+    pgn: number;
+    /** Destination address. Defaults to 0xFF (broadcast) on the server. */
+    dst?: number;
+    timeout?: string;
+    bus?: string;
+}
+/** Parameters for historical data query (GET /history). */
+interface HistoryParams {
+    /** Start timestamp (RFC 3339). */
+    from: string;
+    /** End timestamp (RFC 3339). Defaults to now. */
+    to?: string;
+    /** Filter by PGN(s). */
+    pgn?: number[];
+    /** Filter by source address(es). */
+    src?: number[];
+    /** Max frames to return. Defaults to 10000. */
+    limit?: number;
+    /** Downsample interval (e.g. "1s", "PT1M"). */
+    interval?: string;
+    /** Include decoded values in response. */
+    decode?: boolean;
+}
+/** Broker health details. */
+interface BrokerHealth {
+    status: string;
+    frames_total: number;
+    head_seq: number;
+    last_frame_time: string;
+    device_count: number;
+    ring_entries: number;
+    ring_capacity: number;
+}
+/** Replication component health (within health response). */
+interface ReplicationHealth {
+    status: string;
+    connected: boolean;
+    live_lag: number;
+    backfill_remaining_seqs: number;
+    last_ack: string;
+}
+/** Health check response from GET /healthz or /readyz. */
+interface HealthStatus {
+    status: string;
+    broker?: BrokerHealth;
+    replication?: ReplicationHealth;
+    components?: Record<string, unknown>;
+    /** Cloud-only: total known instances. */
+    instances_total?: number;
+    /** Cloud-only: currently connected instances. */
+    instances_connected?: number;
+}
+/** Boat-side replication status from GET /replication/status. */
+interface ReplicationStatus {
+    connected: boolean;
+    instance_id: string;
+    local_head_seq: number;
+    cloud_cursor: number;
+    holes: SeqRange[];
+    live_lag: number;
+    backfill_remaining_seqs: number;
+    last_ack: string;
+    live_frames_sent: number;
+    backfill_blocks_sent: number;
+    backfill_bytes_sent: number;
+    reconnects: number;
+}
 /** Summary of a cloud instance, returned by GET /instances. */
 interface InstanceSummary {
     id: string;
@@ -147,10 +255,33 @@ declare class Client {
     /**
      * Open an ephemeral SSE stream with optional filtering.
      * No session, no replay, no ACK.
+     *
+     * Accepts either a Filter (for backwards compatibility) or
+     * SubscribeOptions for additional control (decode, signal).
      */
-    subscribe(filter?: Filter, signal?: AbortSignal): Promise<AsyncIterable<Event>>;
+    subscribe(filterOrOptions?: Filter | SubscribeOptions, signal?: AbortSignal): Promise<AsyncIterable<Event>>;
+    /** Fetch the last-seen decoded values for each (device, PGN) pair. */
+    decodedValues(filter?: Filter, signal?: AbortSignal): Promise<DecodedDeviceValues[]>;
     /** Transmit a CAN frame through the server. */
     send(params: SendParams, signal?: AbortSignal): Promise<void>;
+    /**
+     * Send an ISO Request (PGN 59904) and wait for the response frame.
+     * Returns the response frame, or throws HttpError on timeout (408).
+     */
+    query(params: QueryParams, signal?: AbortSignal): Promise<Frame>;
+    /**
+     * Query historical frames (requires journaling on the server).
+     * Returns an array of frames matching the query parameters.
+     */
+    history(params: HistoryParams, signal?: AbortSignal): Promise<Frame[]>;
+    /** Check server health (GET /healthz). */
+    health(signal?: AbortSignal): Promise<HealthStatus>;
+    /** Liveness probe (GET /livez). */
+    liveness(signal?: AbortSignal): Promise<HealthStatus>;
+    /** Readiness probe (GET /readyz). */
+    readiness(signal?: AbortSignal): Promise<HealthStatus>;
+    /** Fetch boat-side replication status (only available when replication is configured). */
+    replicationStatus(signal?: AbortSignal): Promise<ReplicationStatus>;
     /** Create or reconnect a buffered session on the server. */
     createSession(config: SessionConfig, signal?: AbortSignal): Promise<Session>;
 }
@@ -180,6 +311,12 @@ declare class CloudClient {
     status(instanceId: string, signal?: AbortSignal): Promise<InstanceStatus>;
     /** Fetch recent replication diagnostic events for an instance. */
     replicationEvents(instanceId: string, limit?: number, signal?: AbortSignal): Promise<ReplicationEvent[]>;
+    /** Check cloud server health (GET /healthz). */
+    health(signal?: AbortSignal): Promise<HealthStatus>;
+    /** Liveness probe (GET /livez). */
+    liveness(signal?: AbortSignal): Promise<HealthStatus>;
+    /** Readiness probe (GET /readyz). */
+    readiness(signal?: AbortSignal): Promise<HealthStatus>;
 }
 
 declare class LplexError extends Error {
@@ -191,4 +328,4 @@ declare class HttpError extends LplexError {
     constructor(method: string, path: string, status: number, body: string);
 }
 
-export { Client, type ClientOptions, CloudClient, type CloudClientOptions, type Device, type DeviceValues, type Event, type Filter, type Frame, HttpError, type InstanceStatus, type InstanceSummary, LplexError, type PGNValue, type ReplicationEvent, type ReplicationEventType, type SendParams, type SeqRange, Session, type SessionConfig, type SessionInfo };
+export { type BrokerHealth, Client, type ClientOptions, CloudClient, type CloudClientOptions, type DecodedDeviceValues, type DecodedPGNValue, type Device, type DeviceRemoved, type DeviceValues, type Event, type Filter, type Frame, type HealthStatus, type HistoryParams, HttpError, type InstanceStatus, type InstanceSummary, LplexError, type PGNValue, type QueryParams, type ReplicationEvent, type ReplicationEventType, type ReplicationHealth, type ReplicationStatus, type SendParams, type SeqRange, Session, type SessionConfig, type SessionInfo, type SubscribeOptions };

package/dist/index.d.ts

@@ -2,14 +2,17 @@
 interface Frame {
     seq: number;
     ts: string;
+    bus?: string;
     prio: number;
     pgn: number;
     src: number;
     dst: number;
     data: string;
+    decoded?: Record<string, unknown>;
 }
 /** An NMEA 2000 device discovered on the bus. */
 interface Device {
+    bus?: string;
     src: number;
     name: string;
     manufacturer: string;
@@ -28,6 +31,12 @@ interface Device {
     packet_count: number;
     byte_count: number;
 }
+/** A device-removed notification from the bus. */
+interface DeviceRemoved {
+    type: "device_removed";
+    bus?: string;
+    src: number;
+}
 /** Discriminated union for SSE events. */
 type Event = {
     type: "frame";
@@ -35,6 +44,9 @@ type Event = {
 } | {
     type: "device";
     device: Device;
+} | {
+    type: "device_removed";
+    deviceRemoved: DeviceRemoved;
 };
 /**
  * Filter for CAN frames.
@@ -42,9 +54,19 @@ type Event = {
  */
 interface Filter {
     pgn?: number[];
+    exclude_pgn?: number[];
     manufacturer?: string[];
     instance?: number[];
     name?: string[];
+    exclude_name?: string[];
+    bus?: string[];
+}
+/** Options for ephemeral SSE subscription. */
+interface SubscribeOptions {
+    filter?: Filter;
+    /** When true, frames include decoded field values. */
+    decode?: boolean;
+    signal?: AbortSignal;
 }
 /** Configuration for creating a buffered session. */
 interface SessionConfig {
@@ -66,6 +88,7 @@ interface SendParams {
     dst: number;
     prio: number;
     data: string;
+    bus?: string;
 }
 /** A single PGN's last-known value for a device. */
 interface PGNValue {
@@ -82,6 +105,91 @@ interface DeviceValues {
     model_id?: string;
     values: PGNValue[];
 }
+/** A single PGN's decoded value for a device. */
+interface DecodedPGNValue {
+    pgn: number;
+    ts: string;
+    data: string;
+    seq: number;
+    decoded: Record<string, unknown>;
+}
+/** Decoded values grouped by device. */
+interface DecodedDeviceValues {
+    name: string;
+    src: number;
+    manufacturer?: string;
+    model_id?: string;
+    values: DecodedPGNValue[];
+}
+/** Parameters for an ISO Request query (POST /query). */
+interface QueryParams {
+    pgn: number;
+    /** Destination address. Defaults to 0xFF (broadcast) on the server. */
+    dst?: number;
+    timeout?: string;
+    bus?: string;
+}
+/** Parameters for historical data query (GET /history). */
+interface HistoryParams {
+    /** Start timestamp (RFC 3339). */
+    from: string;
+    /** End timestamp (RFC 3339). Defaults to now. */
+    to?: string;
+    /** Filter by PGN(s). */
+    pgn?: number[];
+    /** Filter by source address(es). */
+    src?: number[];
+    /** Max frames to return. Defaults to 10000. */
+    limit?: number;
+    /** Downsample interval (e.g. "1s", "PT1M"). */
+    interval?: string;
+    /** Include decoded values in response. */
+    decode?: boolean;
+}
+/** Broker health details. */
+interface BrokerHealth {
+    status: string;
+    frames_total: number;
+    head_seq: number;
+    last_frame_time: string;
+    device_count: number;
+    ring_entries: number;
+    ring_capacity: number;
+}
+/** Replication component health (within health response). */
+interface ReplicationHealth {
+    status: string;
+    connected: boolean;
+    live_lag: number;
+    backfill_remaining_seqs: number;
+    last_ack: string;
+}
+/** Health check response from GET /healthz or /readyz. */
+interface HealthStatus {
+    status: string;
+    broker?: BrokerHealth;
+    replication?: ReplicationHealth;
+    components?: Record<string, unknown>;
+    /** Cloud-only: total known instances. */
+    instances_total?: number;
+    /** Cloud-only: currently connected instances. */
+    instances_connected?: number;
+}
+/** Boat-side replication status from GET /replication/status. */
+interface ReplicationStatus {
+    connected: boolean;
+    instance_id: string;
+    local_head_seq: number;
+    cloud_cursor: number;
+    holes: SeqRange[];
+    live_lag: number;
+    backfill_remaining_seqs: number;
+    last_ack: string;
+    live_frames_sent: number;
+    backfill_blocks_sent: number;
+    backfill_bytes_sent: number;
+    reconnects: number;
+}
 /** Summary of a cloud instance, returned by GET /instances. */
 interface InstanceSummary {
     id: string;
@@ -147,10 +255,33 @@ declare class Client {
     /**
      * Open an ephemeral SSE stream with optional filtering.
      * No session, no replay, no ACK.
+     *
+     * Accepts either a Filter (for backwards compatibility) or
+     * SubscribeOptions for additional control (decode, signal).
      */
-    subscribe(filter?: Filter, signal?: AbortSignal): Promise<AsyncIterable<Event>>;
+    subscribe(filterOrOptions?: Filter | SubscribeOptions, signal?: AbortSignal): Promise<AsyncIterable<Event>>;
+    /** Fetch the last-seen decoded values for each (device, PGN) pair. */
+    decodedValues(filter?: Filter, signal?: AbortSignal): Promise<DecodedDeviceValues[]>;
     /** Transmit a CAN frame through the server. */
     send(params: SendParams, signal?: AbortSignal): Promise<void>;
+    /**
+     * Send an ISO Request (PGN 59904) and wait for the response frame.
+     * Returns the response frame, or throws HttpError on timeout (408).
+     */
+    query(params: QueryParams, signal?: AbortSignal): Promise<Frame>;
+    /**
+     * Query historical frames (requires journaling on the server).
+     * Returns an array of frames matching the query parameters.
+     */
+    history(params: HistoryParams, signal?: AbortSignal): Promise<Frame[]>;
+    /** Check server health (GET /healthz). */
+    health(signal?: AbortSignal): Promise<HealthStatus>;
+    /** Liveness probe (GET /livez). */
+    liveness(signal?: AbortSignal): Promise<HealthStatus>;
+    /** Readiness probe (GET /readyz). */
+    readiness(signal?: AbortSignal): Promise<HealthStatus>;
+    /** Fetch boat-side replication status (only available when replication is configured). */
+    replicationStatus(signal?: AbortSignal): Promise<ReplicationStatus>;
     /** Create or reconnect a buffered session on the server. */
     createSession(config: SessionConfig, signal?: AbortSignal): Promise<Session>;
 }
@@ -180,6 +311,12 @@ declare class CloudClient {
     status(instanceId: string, signal?: AbortSignal): Promise<InstanceStatus>;
     /** Fetch recent replication diagnostic events for an instance. */
     replicationEvents(instanceId: string, limit?: number, signal?: AbortSignal): Promise<ReplicationEvent[]>;
+    /** Check cloud server health (GET /healthz). */
+    health(signal?: AbortSignal): Promise<HealthStatus>;
+    /** Liveness probe (GET /livez). */
+    liveness(signal?: AbortSignal): Promise<HealthStatus>;
+    /** Readiness probe (GET /readyz). */
+    readiness(signal?: AbortSignal): Promise<HealthStatus>;
 }
 
 declare class LplexError extends Error {
@@ -191,4 +328,4 @@ declare class HttpError extends LplexError {
     constructor(method: string, path: string, status: number, body: string);
 }
 
-export { Client, type ClientOptions, CloudClient, type CloudClientOptions, type Device, type DeviceValues, type Event, type Filter, type Frame, HttpError, type InstanceStatus, type InstanceSummary, LplexError, type PGNValue, type ReplicationEvent, type ReplicationEventType, type SendParams, type SeqRange, Session, type SessionConfig, type SessionInfo };
+export { type BrokerHealth, Client, type ClientOptions, CloudClient, type CloudClientOptions, type DecodedDeviceValues, type DecodedPGNValue, type Device, type DeviceRemoved, type DeviceValues, type Event, type Filter, type Frame, type HealthStatus, type HistoryParams, HttpError, type InstanceStatus, type InstanceSummary, LplexError, type PGNValue, type QueryParams, type ReplicationEvent, type ReplicationEventType, type ReplicationHealth, type ReplicationStatus, type SendParams, type SeqRange, Session, type SessionConfig, type SessionInfo, type SubscribeOptions };

package/dist/index.js

@@ -59,8 +59,16 @@ async function* parseSSE(body) {
   }
 }
 function classify(obj) {
-  if ("type" in obj && obj.type === "device") {
-    return { type: "device", device: obj };
+  if ("type" in obj) {
+    if (obj.type === "device") {
+      return { type: "device", device: obj };
+    }
+    if (obj.type === "device_removed") {
+      return {
+        type: "device_removed",
+        deviceRemoved: obj
+      };
+    }
   }
   if ("seq" in obj) {
     return { type: "frame", frame: obj };
@@ -155,14 +163,27 @@ var Client = class {
   /**
    * Open an ephemeral SSE stream with optional filtering.
    * No session, no replay, no ACK.
+   *
+   * Accepts either a Filter (for backwards compatibility) or
+   * SubscribeOptions for additional control (decode, signal).
    */
-  async subscribe(filter, signal) {
+  async subscribe(filterOrOptions, signal) {
+    let filter;
+    let decode;
+    let sig = signal;
+    if (filterOrOptions && isSubscribeOptions(filterOrOptions)) {
+      filter = filterOrOptions.filter;
+      decode = filterOrOptions.decode;
+      sig = filterOrOptions.signal ?? sig;
+    } else {
+      filter = filterOrOptions;
+    }
     let url = `${this.#baseURL}/events`;
-    const qs = filterToQueryString(filter);
+    const qs = filterToQueryString(filter, decode);
     if (qs) url += `?${qs}`;
     const resp = await this.#fetch(url, {
       headers: { Accept: "text/event-stream" },
-      signal
+      signal: sig
     });
     if (!resp.ok) {
       const body = await resp.text();
@@ -173,6 +194,18 @@ var Client = class {
     }
     return parseSSE(resp.body);
   }
+  /** Fetch the last-seen decoded values for each (device, PGN) pair. */
+  async decodedValues(filter, signal) {
+    let url = `${this.#baseURL}/values/decoded`;
+    const qs = filterToQueryString(filter);
+    if (qs) url += `?${qs}`;
+    const resp = await this.#fetch(url, { signal });
+    if (!resp.ok) {
+      const body = await resp.text();
+      throw new HttpError("GET", url, resp.status, body);
+    }
+    return resp.json();
+  }
   /** Transmit a CAN frame through the server. */
   async send(params, signal) {
     const url = `${this.#baseURL}/send`;
@@ -187,6 +220,85 @@ var Client = class {
       throw new HttpError("POST", url, resp.status, body);
     }
   }
+  /**
+   * Send an ISO Request (PGN 59904) and wait for the response frame.
+   * Returns the response frame, or throws HttpError on timeout (408).
+   */
+  async query(params, signal) {
+    const url = `${this.#baseURL}/query`;
+    const resp = await this.#fetch(url, {
+      method: "POST",
+      headers: { "Content-Type": "application/json" },
+      body: JSON.stringify(params),
+      signal
+    });
+    if (!resp.ok) {
+      const body = await resp.text();
+      throw new HttpError("POST", url, resp.status, body);
+    }
+    return resp.json();
+  }
+  /**
+   * Query historical frames (requires journaling on the server).
+   * Returns an array of frames matching the query parameters.
+   */
+  async history(params, signal) {
+    const qs = new URLSearchParams();
+    qs.set("from", params.from);
+    if (params.to) qs.set("to", params.to);
+    for (const p of params.pgn ?? []) qs.append("pgn", p.toString());
+    for (const s of params.src ?? []) qs.append("src", s.toString());
+    if (params.limit !== void 0) qs.set("limit", params.limit.toString());
+    if (params.interval) qs.set("interval", params.interval);
+    if (params.decode) qs.set("decode", "true");
+    const url = `${this.#baseURL}/history?${qs.toString()}`;
+    const resp = await this.#fetch(url, { signal });
+    if (!resp.ok) {
+      const body = await resp.text();
+      throw new HttpError("GET", url, resp.status, body);
+    }
+    return resp.json();
+  }
+  /** Check server health (GET /healthz). */
+  async health(signal) {
+    const url = `${this.#baseURL}/healthz`;
+    const resp = await this.#fetch(url, { signal });
+    if (!resp.ok) {
+      const body = await resp.text();
+      throw new HttpError("GET", url, resp.status, body);
+    }
+    return resp.json();
+  }
+  /** Liveness probe (GET /livez). */
+  async liveness(signal) {
+    const url = `${this.#baseURL}/livez`;
+    const resp = await this.#fetch(url, { signal });
+    if (!resp.ok) {
+      const body = await resp.text();
+      throw new HttpError("GET", url, resp.status, body);
+    }
+    return resp.json();
+  }
+  /** Readiness probe (GET /readyz). */
+  async readiness(signal) {
+    const url = `${this.#baseURL}/readyz`;
+    const resp = await this.#fetch(url, { signal });
+    if (!resp.ok) {
+      const body = await resp.text();
+      throw new HttpError("GET", url, resp.status, body);
+    }
+    return resp.json();
+  }
+  /** Fetch boat-side replication status (only available when replication is configured). */
+  async replicationStatus(signal) {
+    const url = `${this.#baseURL}/replication/status`;
+    const resp = await this.#fetch(url, { signal });
+    if (!resp.ok) {
+      const body = await resp.text();
+      throw new HttpError("GET", url, resp.status, body);
+    }
+    return resp.json();
+  }
   /** Create or reconnect a buffered session on the server. */
   async createSession(config, signal) {
     const url = `${this.#baseURL}/clients/${config.clientId}`;
@@ -210,24 +322,37 @@ var Client = class {
     return new Session(this.#baseURL, this.#fetch, info);
   }
 };
+function isSubscribeOptions(obj) {
+  return "decode" in obj || "signal" in obj || "filter" in obj;
+}
 function filterIsEmpty(f) {
-  return !f.pgn?.length && !f.manufacturer?.length && !f.instance?.length && !f.name?.length;
+  return !f.pgn?.length && !f.exclude_pgn?.length && !f.manufacturer?.length && !f.instance?.length && !f.name?.length && !f.exclude_name?.length && !f.bus?.length;
 }
-function filterToQueryString(f) {
-  if (!f || filterIsEmpty(f)) return "";
+function filterToQueryString(f, decode) {
+  if ((!f || filterIsEmpty(f)) && !decode) return "";
   const params = new URLSearchParams();
-  for (const p of f.pgn ?? []) params.append("pgn", p.toString());
-  for (const m of f.manufacturer ?? []) params.append("manufacturer", m);
-  for (const i of f.instance ?? []) params.append("instance", i.toString());
-  for (const n of f.name ?? []) params.append("name", n);
+  if (f) {
+    for (const p of f.pgn ?? []) params.append("pgn", p.toString());
+    for (const p of f.exclude_pgn ?? [])
+      params.append("exclude_pgn", p.toString());
+    for (const m of f.manufacturer ?? []) params.append("manufacturer", m);
+    for (const i of f.instance ?? []) params.append("instance", i.toString());
+    for (const n of f.name ?? []) params.append("name", n);
+    for (const n of f.exclude_name ?? []) params.append("exclude_name", n);
+    for (const b of f.bus ?? []) params.append("bus", b);
+  }
+  if (decode) params.set("decode", "true");
   return params.toString();
 }
 function filterToJSON(f) {
   const m = {};
   if (f.pgn?.length) m.pgn = f.pgn;
+  if (f.exclude_pgn?.length) m.exclude_pgn = f.exclude_pgn;
   if (f.manufacturer?.length) m.manufacturer = f.manufacturer;
   if (f.instance?.length) m.instance = f.instance;
   if (f.name?.length) m.name = f.name;
+  if (f.exclude_name?.length) m.exclude_name = f.exclude_name;
+  if (f.bus?.length) m.bus = f.bus;
   return m;
 }
 
@@ -283,6 +408,36 @@ var CloudClient = class {
     }
     return resp.json();
   }
+  /** Check cloud server health (GET /healthz). */
+  async health(signal) {
+    const url = `${this.#baseURL}/healthz`;
+    const resp = await this.#fetch(url, { signal });
+    if (!resp.ok) {
+      const body = await resp.text();
+      throw new HttpError("GET", url, resp.status, body);
+    }
+    return resp.json();
+  }
+  /** Liveness probe (GET /livez). */
+  async liveness(signal) {
+    const url = `${this.#baseURL}/livez`;
+    const resp = await this.#fetch(url, { signal });
+    if (!resp.ok) {
+      const body = await resp.text();
+      throw new HttpError("GET", url, resp.status, body);
+    }
+    return resp.json();
+  }
+  /** Readiness probe (GET /readyz). */
+  async readiness(signal) {
+    const url = `${this.#baseURL}/readyz`;
+    const resp = await this.#fetch(url, { signal });
+    if (!resp.ok) {
+      const body = await resp.text();
+      throw new HttpError("GET", url, resp.status, body);
+    }
+    return resp.json();
+  }
 };
 export {
   Client,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sixfathoms/lplex",
-  "version": "0.2.1",
+  "version": "0.4.0",
   "description": "TypeScript client for lplex CAN bus HTTP bridge",
   "type": "module",
   "main": "./dist/index.cjs",