@sixfathoms/lplex 0.3.0 → 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();
@@ -231,7 +252,7 @@ var Client = class {
   }
   /**
    * Send an ISO Request (PGN 59904) and wait for the response frame.
-   * Returns the response frame, or throws HttpError with status 504 on timeout.
+   * Returns the response frame, or throws HttpError on timeout (408).
    */
   async query(params, signal) {
     const url = `${this.#baseURL}/query`;
@@ -247,7 +268,28 @@ var Client = class {
     }
     return resp.json();
   }
-  /** Check server health. */
+  /**
+   * 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 });
@@ -257,6 +299,26 @@ var Client = class {
     }
     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`;
@@ -290,19 +352,26 @@ 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.exclude_pgn?.length && !f.manufacturer?.length && !f.instance?.length && !f.name?.length && !f.exclude_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 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);
+  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) {
@@ -313,6 +382,7 @@ function filterToJSON(f) {
   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;
 }
 
@@ -368,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.
@@ -47,6 +59,14 @@ interface Filter {
     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 {
@@ -68,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 {
@@ -103,12 +124,56 @@ interface DecodedDeviceValues {
 /** Parameters for an ISO Request query (POST /query). */
 interface QueryParams {
     pgn: number;
-    dst: 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;
 }
-/** Health check response from GET /healthz. */
+/** 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 {
@@ -120,6 +185,10 @@ interface ReplicationStatus {
     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 {
@@ -186,19 +255,31 @@ 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 with status 504 on timeout.
+     * Returns the response frame, or throws HttpError on timeout (408).
      */
     query(params: QueryParams, signal?: AbortSignal): Promise<Frame>;
-    /** Check server health. */
+    /**
+     * 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. */
@@ -230,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 {
@@ -241,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 DecodedDeviceValues, type DecodedPGNValue, type Device, type DeviceValues, type Event, type Filter, type Frame, type HealthStatus, HttpError, type InstanceStatus, type InstanceSummary, LplexError, type PGNValue, type QueryParams, type ReplicationEvent, type ReplicationEventType, type ReplicationStatus, 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.
@@ -47,6 +59,14 @@ interface Filter {
     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 {
@@ -68,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 {
@@ -103,12 +124,56 @@ interface DecodedDeviceValues {
 /** Parameters for an ISO Request query (POST /query). */
 interface QueryParams {
     pgn: number;
-    dst: 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;
 }
-/** Health check response from GET /healthz. */
+/** 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 {
@@ -120,6 +185,10 @@ interface ReplicationStatus {
     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 {
@@ -186,19 +255,31 @@ 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 with status 504 on timeout.
+     * Returns the response frame, or throws HttpError on timeout (408).
      */
     query(params: QueryParams, signal?: AbortSignal): Promise<Frame>;
-    /** Check server health. */
+    /**
+     * 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. */
@@ -230,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 {
@@ -241,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 DecodedDeviceValues, type DecodedPGNValue, type Device, type DeviceValues, type Event, type Filter, type Frame, type HealthStatus, HttpError, type InstanceStatus, type InstanceSummary, LplexError, type PGNValue, type QueryParams, type ReplicationEvent, type ReplicationEventType, type ReplicationStatus, 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();
@@ -201,7 +222,7 @@ var Client = class {
   }
   /**
    * Send an ISO Request (PGN 59904) and wait for the response frame.
-   * Returns the response frame, or throws HttpError with status 504 on timeout.
+   * Returns the response frame, or throws HttpError on timeout (408).
    */
   async query(params, signal) {
     const url = `${this.#baseURL}/query`;
@@ -217,7 +238,28 @@ var Client = class {
     }
     return resp.json();
   }
-  /** Check server health. */
+  /**
+   * 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 });
@@ -227,6 +269,26 @@ var Client = class {
     }
     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`;
@@ -260,19 +322,26 @@ 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.exclude_pgn?.length && !f.manufacturer?.length && !f.instance?.length && !f.name?.length && !f.exclude_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 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);
+  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) {
@@ -283,6 +352,7 @@ function filterToJSON(f) {
   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;
 }
 
@@ -338,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.3.0",
+  "version": "0.4.0",
   "description": "TypeScript client for lplex CAN bus HTTP bridge",
   "type": "module",
   "main": "./dist/index.cjs",