@varta-health/client 0.1.0

package/dist/outcome.js

@@ -0,0 +1,92 @@
+// BeatOutcome tagged union, DropReason enum, BeatError, and the
+// `classifySendError` function — mirrors Rust `BeatOutcome`,
+// Python `BeatOutcome`/`DropReason`, and Go `BeatOutcome`/`DropReason`.
+import { EAGAIN, ECONNREFUSED, ECONNRESET, ENOBUFS, ENOENT, ENOSPC, ENOTCONN, EPIPE, EWOULDBLOCK, errnoName, } from "./errno.js";
+// String-valued enum so the wire-side metrics label matches the Rust
+// `Display` impl directly. The string values MUST stay byte-equal to
+// the labels Prometheus sees from the observer (`varta_*_total{reason=…}`).
+export var DropReason;
+(function (DropReason) {
+    DropReason["KernelQueueFull"] = "kernel queue full";
+    DropReason["NoObserver"] = "no observer";
+    DropReason["PeerGone"] = "peer gone";
+    DropReason["StorageFull"] = "storage full";
+})(DropReason || (DropReason = {}));
+// Payload of `{ kind: "failed" }`. Extends `Error` so it can be thrown
+// or logged like any other Node error, but carries structured `errno`
+// and `kind` fields so callers don't have to parse `.message`.
+export class BeatError extends Error {
+    errno;
+    kind;
+    constructor(errno, kind, message) {
+        super(message ?? `${kind} (errno=${errno})`);
+        this.name = "BeatError";
+        this.errno = errno;
+        this.kind = kind;
+    }
+    static fromNodeError(err) {
+        const code = typeof err.errno === "number" ? err.errno : 0;
+        return new BeatError(code, code ? errnoName(code) : err.name || "Other", err.message);
+    }
+}
+export const BeatOutcomes = Object.freeze({
+    sent() {
+        return { kind: "sent" };
+    },
+    dropped(reason) {
+        return { kind: "dropped", reason };
+    },
+    failed(error) {
+        return { kind: "failed", error };
+    },
+});
+export function isSent(o) {
+    return o.kind === "sent";
+}
+export function isDropped(o) {
+    return o.kind === "dropped";
+}
+export function isFailed(o) {
+    return o.kind === "failed";
+}
+// Translate a Node `send`-time error into a `BeatOutcome`.
+//
+// Mirrors `crates/varta-client/src/client.rs::classify_send_error` and
+// the Python and Go equivalents. Exported because authors of custom
+// `BeatTransport` implementations are likely to want the same bucketing.
+export function classifySendError(err) {
+    // Node's `ErrnoException.errno` is the negative POSIX value on some
+    // calls (libuv convention) and the positive value on others. Take
+    // the absolute value so the comparisons below work uniformly.
+    const rawErrno = typeof err.errno === "number" ? err.errno : 0;
+    const code = rawErrno < 0 ? -rawErrno : rawErrno;
+    const sym = err.code ?? "";
+    if (code === ENOBUFS || sym === "ENOBUFS") {
+        return BeatOutcomes.dropped(DropReason.KernelQueueFull);
+    }
+    if (code === EAGAIN ||
+        code === EWOULDBLOCK ||
+        sym === "EAGAIN" ||
+        sym === "EWOULDBLOCK") {
+        return BeatOutcomes.dropped(DropReason.KernelQueueFull);
+    }
+    if (code === ECONNREFUSED ||
+        code === ENOENT ||
+        sym === "ECONNREFUSED" ||
+        sym === "ENOENT") {
+        return BeatOutcomes.dropped(DropReason.NoObserver);
+    }
+    if (code === ECONNRESET ||
+        code === ENOTCONN ||
+        code === EPIPE ||
+        sym === "ECONNRESET" ||
+        sym === "ENOTCONN" ||
+        sym === "EPIPE") {
+        return BeatOutcomes.dropped(DropReason.PeerGone);
+    }
+    if (code === ENOSPC || sym === "ENOSPC") {
+        return BeatOutcomes.dropped(DropReason.StorageFull);
+    }
+    return BeatOutcomes.failed(BeatError.fromNodeError(err));
+}
+//# sourceMappingURL=outcome.js.map

package/dist/outcome.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"outcome.js","sourceRoot":"","sources":["../src/outcome.ts"],"names":[],"mappings":"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"}

package/dist/panic.d.ts

@@ -0,0 +1,8 @@
+export declare class PanicInstallError extends Error {
+    readonly kind: string;
+    constructor(kind: string, message: string);
+}
+export declare function installSignalHandlerUdp(host: string, port: number): void;
+export declare function installSignalHandlerSecureUdp(host: string, port: number, key: Buffer): void;
+export declare function run(fn: () => void | Promise<void>): Promise<void>;
+//# sourceMappingURL=panic.d.ts.map

package/dist/panic.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"panic.d.ts","sourceRoot":"","sources":["../src/panic.ts"],"names":[],"mappings":"AA8BA,qBAAa,iBAAkB,SAAQ,KAAK;IAC1C,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;gBACV,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM;CAK1C;AAwED,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI,CAexE;AAOD,wBAAgB,6BAA6B,CAC3C,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,EACZ,GAAG,EAAE,MAAM,GACV,IAAI,CAkDN;AAMD,wBAAsB,GAAG,CAAC,EAAE,EAAE,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CASvE"}

package/dist/panic.js

@@ -0,0 +1,172 @@
+// Panic-style emitters — Node's analogue of Rust's `install_panic_handler`.
+//
+// Node has no `excepthook` in the Python sense, but it does have:
+//   * `process.on('uncaughtException')` — synchronous throws.
+//   * `process.on('unhandledRejection')` — async promise rejections.
+//   * `process.on('SIGTERM' | 'SIGINT' | 'SIGQUIT' | 'SIGHUP')` —
+//     terminating signals.
+//
+// Each installer wires all three into a single critical-beat emitter
+// for the chosen transport. The socket and frame buffer are
+// pre-allocated at install time so the hot path is alloc-free and
+// async-signal-safe (cerebrum 2026-05-14).
+import { randomBytes } from "node:crypto";
+import { createSocket } from "node:dgram";
+import { encodeShared, KEY_BYTES, deriveIvPrefix, IV_RANDOM_BYTES, SESSION_SALT_BYTES, } from "./vlp_secure.js";
+import { encodeInto, FRAME_BYTES, NONCE_TERMINAL, Status, } from "./vlp.js";
+export class PanicInstallError extends Error {
+    kind;
+    constructor(kind, message) {
+        super(`${kind}: ${message}`);
+        this.name = "PanicInstallError";
+        this.kind = kind;
+    }
+}
+const FATAL_SIGNALS = ["SIGTERM", "SIGINT", "SIGQUIT", "SIGHUP"];
+function buildCriticalFrame(payload = 0) {
+    const buf = Buffer.alloc(FRAME_BYTES);
+    encodeInto(buf, Status.Critical, process.pid >>> 0, process.hrtime.bigint(), NONCE_TERMINAL, payload >>> 0);
+    return buf;
+}
+// Wire emit() into the three terminating event sources. Each callback
+// is one-shot: after the first invocation we tear down the listeners
+// so process exit isn't blocked by lingering handlers.
+function arm(emit) {
+    let fired = false;
+    const trigger = () => {
+        if (fired)
+            return;
+        fired = true;
+        try {
+            emit();
+        }
+        catch {
+            // Hook must never propagate.
+        }
+    };
+    process.on("uncaughtException", (err) => {
+        trigger();
+        // Re-throw so Node's default crash printer still runs and the
+        // process exits with code 1 — preserves Node's standard behaviour.
+        setImmediate(() => {
+            throw err;
+        });
+    });
+    process.on("unhandledRejection", (reason) => {
+        trigger();
+        setImmediate(() => {
+            throw reason instanceof Error ? reason : new Error(String(reason));
+        });
+    });
+    for (const sig of FATAL_SIGNALS) {
+        process.on(sig, () => {
+            trigger();
+            // Restore default handler and re-raise so the process exits with
+            // the canonical signal-derived code (128 + signum on POSIX).
+            process.removeAllListeners(sig);
+            process.kill(process.pid, sig);
+        });
+    }
+}
+function createConnectedSocket(host, port) {
+    const family = host.includes(":") ? "udp6" : "udp4";
+    const s = createSocket(family);
+    s.on("error", () => {
+        // Drop libuv async errors silently — emission is best-effort.
+    });
+    s.unref();
+    s.connect(port, host);
+    return s;
+}
+// Install a panic emitter that publishes a Critical+NONCE_TERMINAL
+// frame over plaintext UDP on any terminating event.
+export function installSignalHandlerUdp(host, port) {
+    let sock;
+    try {
+        sock = createConnectedSocket(host, port);
+    }
+    catch (err) {
+        throw new PanicInstallError("SocketBind", err.message);
+    }
+    const frame = buildCriticalFrame();
+    arm(() => {
+        try {
+            sock.send(frame);
+        }
+        catch {
+            // Best effort.
+        }
+    });
+}
+// Install a panic emitter that publishes a Critical+NONCE_TERMINAL
+// frame over ChaCha20-Poly1305 AEAD UDP. Fail-closed entropy posture:
+// `crypto.randomBytes(16)` is invoked once at install time; if it
+// throws, `PanicInstallError(kind="EntropyUnavailable")` propagates
+// and no hook is registered.
+export function installSignalHandlerSecureUdp(host, port, key) {
+    if (key.length !== KEY_BYTES) {
+        throw new RangeError(`key must be ${KEY_BYTES} bytes`);
+    }
+    let salt;
+    try {
+        salt = randomBytes(SESSION_SALT_BYTES);
+    }
+    catch (err) {
+        throw new PanicInstallError("EntropyUnavailable", err.message);
+    }
+    let sock;
+    try {
+        sock = createConnectedSocket(host, port);
+    }
+    catch (err) {
+        throw new PanicInstallError("SocketBind", err.message);
+    }
+    // Capture state by reference inside the closure. `installPid` lets
+    // the hook detect post-`fork(2)` execution and re-read entropy
+    // before the IV is reused.
+    const state = {
+        salt,
+        installPid: process.pid,
+        counter: 0,
+    };
+    const keyCopy = Buffer.from(key);
+    arm(() => {
+        try {
+            if (process.pid !== state.installPid) {
+                try {
+                    state.salt = randomBytes(SESSION_SALT_BYTES);
+                }
+                catch {
+                    return; // fail-closed: skip emission rather than reuse stale IV
+                }
+                state.installPid = process.pid;
+                state.counter = 0;
+            }
+            const ivPrefix = deriveIvPrefix(state.salt, 0).subarray(0, IV_RANDOM_BYTES);
+            const counter = state.counter;
+            state.counter = (state.counter + 1) >>> 0;
+            const plaintext = buildCriticalFrame();
+            const wire = encodeShared(keyCopy, ivPrefix, counter, plaintext);
+            sock.send(wire);
+        }
+        catch {
+            // Hook must never propagate.
+        }
+    });
+}
+// Defer/recover-style wrapper. Any throw inside `fn` (sync or async)
+// causes a critical beat to be emitted by whichever installer is
+// already armed, then the original error is re-thrown so the caller's
+// shutdown logic still runs.
+export async function run(fn) {
+    try {
+        await fn();
+    }
+    catch (err) {
+        // Emit by triggering the uncaughtException pathway — re-throws
+        // are caught by the armed handler installed via `arm()`. If no
+        // handler is installed, the error simply propagates.
+        throw err;
+    }
+}
+//# sourceMappingURL=panic.js.map

package/dist/panic.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"panic.js","sourceRoot":"","sources":["../src/panic.ts"],"names":[],"mappings":"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"}

package/dist/transport.d.ts

@@ -0,0 +1,40 @@
+export interface BeatTransport {
+    send(buf: Buffer): void;
+    reconnect(): void;
+    close(): void;
+}
+export declare class UdpTransport implements BeatTransport {
+    private socket;
+    private readonly host;
+    private readonly port;
+    pendingError: NodeJS.ErrnoException | null;
+    constructor(host: string, port: number);
+    private openSocket;
+    send(buf: Buffer): void;
+    reconnect(): void;
+    close(): void;
+}
+export type SecureUdpKind = "shared" | "master";
+export declare class SecureUdpTransport implements BeatTransport {
+    private socket;
+    private readonly host;
+    private readonly port;
+    private readonly secret;
+    private sessionSalt;
+    private ivPrefix;
+    private prefixIndex;
+    private counter;
+    pendingError: NodeJS.ErrnoException | null;
+    private constructor();
+    static shared(host: string, port: number, key: Buffer): SecureUdpTransport;
+    static master(host: string, port: number, masterKey: Buffer): SecureUdpTransport;
+    private openSocket;
+    __setCounterForTest(v: number): void;
+    __getCounterForTest(): number;
+    __getPrefixIndexForTest(): number;
+    __getIvPrefixForTest(): Buffer;
+    send(buf: Buffer): void;
+    reconnect(): void;
+    close(): void;
+}
+//# sourceMappingURL=transport.d.ts.map

package/dist/transport.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transport.d.ts","sourceRoot":"","sources":["../src/transport.ts"],"names":[],"mappings":"AAuBA,MAAM,WAAW,aAAa;IAO5B,IAAI,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,SAAS,IAAI,IAAI,CAAC;IAClB,KAAK,IAAI,IAAI,CAAC;CACf;AAeD,qBAAa,YAAa,YAAW,aAAa;IAChD,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAS;IAC9B,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAS;IAC9B,YAAY,EAAE,MAAM,CAAC,cAAc,GAAG,IAAI,CAAQ;gBAEtC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM;IAMtC,OAAO,CAAC,UAAU;IAYlB,IAAI,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAoBvB,SAAS,IAAI,IAAI;IAUjB,KAAK,IAAI,IAAI;CAOd;AAID,MAAM,MAAM,aAAa,GAAG,QAAQ,GAAG,QAAQ,CAAC;AAYhD,qBAAa,kBAAmB,YAAW,aAAa;IACtD,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAS;IAC9B,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAS;IAC9B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAY;IACnC,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,OAAO,CAAS;IACxB,YAAY,EAAE,MAAM,CAAC,cAAc,GAAG,IAAI,CAAQ;IAElD,OAAO;IAWP,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,kBAAkB;IAO1E,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,kBAAkB;IAUhF,OAAO,CAAC,UAAU;IAWlB,mBAAmB,CAAC,CAAC,EAAE,MAAM,GAAG,IAAI;IAGpC,mBAAmB,IAAI,MAAM;IAG7B,uBAAuB,IAAI,MAAM;IAGjC,oBAAoB,IAAI,MAAM;IAI9B,IAAI,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IA8CvB,SAAS,IAAI,IAAI;IAmBjB,KAAK,IAAI,IAAI;CAOd"}

package/dist/transport.js

@@ -0,0 +1,208 @@
+// Beat transport abstractions — UDP and ChaCha20-Poly1305-AEAD UDP.
+//
+// UDS (AF_UNIX/SOCK_DGRAM) is intentionally NOT implemented in this
+// release. Node's stdlib `dgram` module accepts only `"udp4"` and
+// `"udp6"` socket types; the `"unix_dgram"` type that exists in some
+// platform sockets APIs is rejected with `ERR_SOCKET_BAD_TYPE`. Adding
+// UDS would require a native addon (breaking the zero-dep posture) or
+// pulling in `node:net.Socket(fd)` over a manually opened AF_UNIX FD
+// (no portable JS path exists). For same-host deployments, use
+// `Varta.connectUdp("127.0.0.1", port)` — loopback is the same
+// security domain as UDS on a single host.
+import { randomBytes } from "node:crypto";
+import { createSocket } from "node:dgram";
+import { encodeMaster, encodeShared, IV_RANDOM_BYTES, SESSION_SALT_BYTES, deriveIvPrefix, } from "./vlp_secure.js";
+// Common helper: drain a libuv async error captured on a previous
+// `socket.send` callback. Returns the error if one is queued and
+// clears the slot, or `null` if the slot is empty.
+function takePendingError(holder) {
+    const e = holder.pendingError;
+    holder.pendingError = null;
+    return e;
+}
+// ─── Plaintext UDP ──────────────────────────────────────────────
+export class UdpTransport {
+    socket;
+    host;
+    port;
+    pendingError = null;
+    constructor(host, port) {
+        this.host = host;
+        this.port = port;
+        this.socket = this.openSocket();
+    }
+    openSocket() {
+        const family = this.host.includes(":") ? "udp6" : "udp4";
+        const s = createSocket(family);
+        // Swallow `error` events; they would otherwise crash the process.
+        // The pending-error slot captures them for the next `send` call.
+        s.on("error", (err) => {
+            this.pendingError = err;
+        });
+        s.unref();
+        return s;
+    }
+    send(buf) {
+        const queued = takePendingError(this);
+        if (queued !== null)
+            throw queued;
+        // Use addressed sends instead of connected sends — `socket.connect`
+        // is async and a `send()` issued before its `connect` event lands
+        // fails with `ERR_SOCKET_DGRAM_NOT_CONNECTED`. The libuv callback
+        // path still surfaces kernel-level send errors via `pendingError`.
+        //
+        // Copy the caller's scratch buffer before handing off to libuv:
+        // `dgram.Socket.send` does NOT internally copy, and the agent
+        // reuses a single 32-byte buffer across beats, so a non-copy
+        // would let later beats overwrite earlier in-flight datagrams.
+        const owned = Buffer.from(buf);
+        this.socket.send(owned, this.port, this.host, (err) => {
+            if (err !== null && err !== undefined) {
+                this.pendingError = err;
+            }
+        });
+    }
+    reconnect() {
+        try {
+            this.socket.close();
+        }
+        catch {
+            // Already closed — fine.
+        }
+        this.pendingError = null;
+        this.socket = this.openSocket();
+    }
+    close() {
+        try {
+            this.socket.close();
+        }
+        catch {
+            // Already closed.
+        }
+    }
+}
+export class SecureUdpTransport {
+    socket;
+    host;
+    port;
+    secret;
+    sessionSalt;
+    ivPrefix;
+    prefixIndex;
+    counter;
+    pendingError = null;
+    constructor(host, port, secret) {
+        this.host = host;
+        this.port = port;
+        this.secret = secret;
+        this.sessionSalt = randomBytes(SESSION_SALT_BYTES);
+        this.prefixIndex = 0;
+        this.counter = 0;
+        this.ivPrefix = deriveIvPrefix(this.sessionSalt, this.prefixIndex);
+        this.socket = this.openSocket();
+    }
+    static shared(host, port, key) {
+        if (key.length !== 32) {
+            throw new RangeError("secure-UDP shared key must be 32 bytes");
+        }
+        return new SecureUdpTransport(host, port, { kind: "shared", key: Buffer.from(key) });
+    }
+    static master(host, port, masterKey) {
+        if (masterKey.length !== 32) {
+            throw new RangeError("secure-UDP master key must be 32 bytes");
+        }
+        return new SecureUdpTransport(host, port, {
+            kind: "master",
+            masterKey: Buffer.from(masterKey),
+        });
+    }
+    openSocket() {
+        const family = this.host.includes(":") ? "udp6" : "udp4";
+        const s = createSocket(family);
+        s.on("error", (err) => {
+            this.pendingError = err;
+        });
+        s.unref();
+        return s;
+    }
+    // Test hooks (matching Python `_set_*_for_test` and Go `*ForTest`).
+    __setCounterForTest(v) {
+        this.counter = v >>> 0;
+    }
+    __getCounterForTest() {
+        return this.counter;
+    }
+    __getPrefixIndexForTest() {
+        return this.prefixIndex;
+    }
+    __getIvPrefixForTest() {
+        return Buffer.from(this.ivPrefix);
+    }
+    send(buf) {
+        const queued = takePendingError(this);
+        if (queued !== null)
+            throw queued;
+        // The IV (8-byte prefix + 4-byte LE counter) is reserved
+        // synchronously here. The Rust client uses commit-on-success
+        // because its `send(2)` is synchronous and a `WouldBlock` lets it
+        // safely re-use the nonce on retry. Node's `dgram.send` queues
+        // datagrams via libuv async, so multiple concurrent calls would
+        // all see the same proposed counter and encrypt distinct
+        // plaintexts under the same nonce — that is the classic
+        // ChaCha20-Poly1305 nonce-reuse footgun. We reserve and advance
+        // synchronously here so every queued frame carries a unique IV;
+        // a callback-reported `pendingError` simply burns one nonce
+        // slot, which is harmless.
+        const ivRandom = Buffer.alloc(IV_RANDOM_BYTES);
+        this.ivPrefix.copy(ivRandom, 0, 0, IV_RANDOM_BYTES);
+        const counter = this.counter;
+        if (this.counter === 0xffffffff) {
+            this.prefixIndex = (this.prefixIndex + 1) >>> 0;
+            this.ivPrefix = deriveIvPrefix(this.sessionSalt, this.prefixIndex);
+            this.counter = 0;
+        }
+        else {
+            this.counter = (this.counter + 1) >>> 0;
+        }
+        let wire;
+        if (this.secret.kind === "shared") {
+            wire = encodeShared(this.secret.key, ivRandom, counter, buf);
+        }
+        else {
+            wire = encodeMaster(this.secret.masterKey, process.pid >>> 0, ivRandom, counter, buf);
+        }
+        this.socket.send(wire, this.port, this.host, (err) => {
+            if (err !== null && err !== undefined) {
+                this.pendingError = err;
+            }
+        });
+    }
+    reconnect() {
+        try {
+            this.socket.close();
+        }
+        catch {
+            // Already closed.
+        }
+        this.pendingError = null;
+        // Prepare a fresh session in locals; commit at the end without `?`.
+        const newSalt = randomBytes(SESSION_SALT_BYTES);
+        const newPrefixIndex = 0;
+        const newIvPrefix = deriveIvPrefix(newSalt, newPrefixIndex);
+        const newSocket = this.openSocket();
+        this.sessionSalt = newSalt;
+        this.prefixIndex = newPrefixIndex;
+        this.counter = 0;
+        this.ivPrefix = newIvPrefix;
+        this.socket = newSocket;
+    }
+    close() {
+        try {
+            this.socket.close();
+        }
+        catch {
+            // Already closed.
+        }
+    }
+}
+//# sourceMappingURL=transport.js.map

package/dist/transport.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"transport.js","sourceRoot":"","sources":["../src/transport.ts"],"names":[],"mappings":"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"}

package/dist/vlp.d.ts

@@ -0,0 +1,30 @@
+export declare const MAGIC: Buffer;
+export declare const VERSION: number;
+export declare const NONCE_TERMINAL: bigint;
+export declare const TIMESTAMP_INVALID: bigint;
+export declare const FRAME_BYTES: number;
+export declare enum Status {
+    Ok = 0,
+    Degraded = 1,
+    Critical = 2,
+    Stall = 3
+}
+export type StatusLike = Status | number | string;
+export type DecodeErrorKind = "BadMagic" | "BadVersion" | "BadCrc" | "BadStatus" | "StallOnWire" | "BadPid" | "BadTimestamp" | "BadNonce";
+export declare class DecodeError extends Error {
+    readonly kind: DecodeErrorKind;
+    constructor(kind: DecodeErrorKind, detail?: string);
+}
+export declare function crc32c(data: Buffer | Uint8Array): number;
+export interface Frame {
+    status: Status;
+    pid: number;
+    timestamp: bigint;
+    nonce: bigint;
+    payload: number;
+}
+export declare function encode(status: StatusLike, pid: number, timestamp: bigint, nonce: bigint, payload: number): Buffer;
+export declare function encodeInto(buf: Buffer, status: StatusLike, pid: number, timestamp: bigint, nonce: bigint, payload: number): void;
+export declare function decode(buf: Buffer | Uint8Array): Frame;
+export declare function decodeFrame(buf: Buffer | Uint8Array): Frame;
+//# sourceMappingURL=vlp.d.ts.map

package/dist/vlp.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"vlp.d.ts","sourceRoot":"","sources":["../src/vlp.ts"],"names":[],"mappings":"AAQA,eAAO,MAAM,KAAK,EAAE,MAAkC,CAAC;AACvD,eAAO,MAAM,OAAO,EAAE,MAAa,CAAC;AACpC,eAAO,MAAM,cAAc,EAAE,MAA4B,CAAC;AAC1D,eAAO,MAAM,iBAAiB,EAAE,MAA4B,CAAC;AAC7D,eAAO,MAAM,WAAW,EAAE,MAAW,CAAC;AAKtC,oBAAY,MAAM;IAChB,EAAE,IAAI;IACN,QAAQ,IAAI;IACZ,QAAQ,IAAI;IACZ,KAAK,IAAI;CACV;AAED,MAAM,MAAM,UAAU,GAAG,MAAM,GAAG,MAAM,GAAG,MAAM,CAAC;AAYlD,MAAM,MAAM,eAAe,GACvB,UAAU,GACV,YAAY,GACZ,QAAQ,GACR,WAAW,GACX,aAAa,GACb,QAAQ,GACR,cAAc,GACd,UAAU,CAAC;AAEf,qBAAa,WAAY,SAAQ,KAAK;IACpC,QAAQ,CAAC,IAAI,EAAE,eAAe,CAAC;gBACnB,IAAI,EAAE,eAAe,EAAE,MAAM,SAAK;CAK/C;AAoBD,wBAAgB,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,UAAU,GAAG,MAAM,CAOxD;AAID,MAAM,WAAW,KAAK;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,GAAG,EAAE,MAAM,CAAC;IACZ,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;CACjB;AAqBD,wBAAgB,MAAM,CACpB,MAAM,EAAE,UAAU,EAClB,GAAG,EAAE,MAAM,EACX,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,MAAM,GACd,MAAM,CAIR;AAGD,wBAAgB,UAAU,CACxB,GAAG,EAAE,MAAM,EACX,MAAM,EAAE,UAAU,EAClB,GAAG,EAAE,MAAM,EACX,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,MAAM,GACd,IAAI,CAeN;AAQD,wBAAgB,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,UAAU,GAAG,KAAK,CAmEtD;AAID,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,UAAU,GAAG,KAAK,CAE3D"}