@macula-io/ts 0.16.0 → 0.18.0

package/dist/binding.js

@@ -1,133 +1,16 @@
-// Loads the compiled N-API addon (addon/binding.cc) and re-exports its
-// typed functions. Unlike the koffi-era version of this file, there is
-// no runtime signature declaration here -- the addon's C++ glue already
-// knows its own shapes, throws real JS errors on failure (no more
-// manual errOut-array/checkErr dance), and is a single self-contained
-// .node file (cabi/'s Go code is statically linked in via
-// -buildmode=c-archive, not loaded separately at runtime).
+// Loads the compiled N-API addon (addon/binding.cc) and types its functions.
+// cabi/'s Go code is linked into the addon statically, so it is one
+// self-contained .node file. node-gyp-build picks, at require time, a local
+// build (build/Release/*.node) or the published prebuild for this platform
+// (prebuilds/<platform>-<arch>/*.node), so a consumer installing from npm
+// never runs a compiler.
 //
-// node-gyp-build picks, at require time, whichever of these exists:
-// build/Release/*.node (a local dev build via `npm run build:addon:dev`)
-// or prebuilds/<platform>-<arch>/*.node (baked in by `npm run
-// build:prebuilds` / prebuildify, and published as part of the npm
-// package) -- this is the whole point: a consumer installing this
-// package from npm never runs a compiler or fetches anything, because
-// the matching prebuild is already sitting in the downloaded tarball.
+// Internal to the package: the public API is key.ts, pool.ts and stream.ts.
 import { createRequire } from "node:module";
 import { fileURLToPath } from "node:url";
 import { dirname, join } from "node:path";
 const require = createRequire(import.meta.url);
 const repoRoot = join(dirname(fileURLToPath(import.meta.url)), "..");
 // eslint-disable-next-line @typescript-eslint/no-var-requires
-const addon = require("node-gyp-build")(repoRoot);
-export const native = {
-    identityGenerate() {
-        return addon.identityGenerate();
-    },
-    identityFromSeedBytes(seed32) {
-        if (seed32.length !== 32) {
-            throw new Error(`macula-ts: seed must be exactly 32 bytes, got ${seed32.length}`);
-        }
-        return addon.identityFromSeedBytes(seed32);
-    },
-    identityNodeId(handle) {
-        return addon.identityNodeId(handle);
-    },
-    identityPrivateBytes(handle) {
-        return addon.identityPrivateBytes(handle);
-    },
-    identityFree(handle) {
-        addon.identityFree(handle);
-    },
-    identitySign(handle, data) {
-        return addon.identitySign(handle, data);
-    },
-    sessionConnect(host, port, identityHandle) {
-        return addon.sessionConnect(host, port, identityHandle);
-    },
-    sessionRemoteAddr(handle) {
-        return addon.sessionRemoteAddr(handle);
-    },
-    sessionStationNodeId(handle) {
-        return addon.sessionStationNodeId(handle);
-    },
-    sessionClose(handle, identityHandle, reason) {
-        return addon.sessionClose(handle, identityHandle, reason);
-    },
-    sessionCall(sessionHandle, identityHandle, procedure, realm, payloadJson, timeoutMs, bytesMode) {
-        return addon.sessionCall(sessionHandle, identityHandle, procedure, realm, payloadJson, timeoutMs, bytesMode);
-    },
-    ucanMint(identityHandle, issuer, audience, capabilitiesJson, expiresAt, notBefore, nonce, factsJson, proofsJson) {
-        return addon.ucanMint(identityHandle, issuer, audience, capabilitiesJson, expiresAt, notBefore, nonce, factsJson, proofsJson);
-    },
-    ucanDecode(token) {
-        return addon.ucanDecode(token);
-    },
-    sessionCallWithUcan(sessionHandle, identityHandle, procedure, realm, payloadJson, timeoutMs, ucanToken, bytesMode) {
-        return addon.sessionCallWithUcan(sessionHandle, identityHandle, procedure, realm, payloadJson, timeoutMs, ucanToken, bytesMode);
-    },
-    sessionAdvertise(sessionHandle, identityHandle, realm, procedure) {
-        return addon.sessionAdvertise(sessionHandle, identityHandle, realm, procedure);
-    },
-    sessionUnadvertise(sessionHandle, identityHandle, realm, procedure) {
-        return addon.sessionUnadvertise(sessionHandle, identityHandle, realm, procedure);
-    },
-    serveWaitForCall(sessionHandle, identityHandle, realm, procedure, timeoutMs) {
-        return addon.serveWaitForCall(sessionHandle, identityHandle, realm, procedure, timeoutMs);
-    },
-    pendingCallProcedure(pendingHandle) {
-        return addon.pendingCallProcedure(pendingHandle);
-    },
-    pendingCallPayloadJson(pendingHandle, bytesMode) {
-        return addon.pendingCallPayloadJson(pendingHandle, bytesMode);
-    },
-    pendingCallReplyResult(pendingHandle, resultJson) {
-        return addon.pendingCallReplyResult(pendingHandle, resultJson);
-    },
-    pendingCallReplyError(pendingHandle, detail) {
-        return addon.pendingCallReplyError(pendingHandle, detail);
-    },
-    dhtFindRecordsByType(sessionHandle, identityHandle, recordType) {
-        return addon.dhtFindRecordsByType(sessionHandle, identityHandle, recordType);
-    },
-    dhtFindRecords(sessionHandle, identityHandle, key32) {
-        return addon.dhtFindRecords(sessionHandle, identityHandle, key32);
-    },
-    dhtFindRecord(sessionHandle, identityHandle, key32) {
-        return addon.dhtFindRecord(sessionHandle, identityHandle, key32);
-    },
-    dhtPutProcedureAdvertisement(sessionHandle, identityHandle, realm, procedure, servingStation32, ttlMs) {
-        return addon.dhtPutProcedureAdvertisement(sessionHandle, identityHandle, realm, procedure, servingStation32, ttlMs);
-    },
-    dhtPutContentAnnouncement(sessionHandle, identityHandle, mcid34, endpoint, ttlMs) {
-        return addon.dhtPutContentAnnouncement(sessionHandle, identityHandle, mcid34, endpoint, ttlMs);
-    },
-    sessionPublish(sessionHandle, identityHandle, realm, topic, payloadJson, ttlMs) {
-        return addon.sessionPublish(sessionHandle, identityHandle, realm, topic, payloadJson, ttlMs);
-    },
-    sessionSubscribeStart(sessionHandle, identityHandle, realm, topic, onEvent, bytesMode) {
-        return addon.sessionSubscribeStart(sessionHandle, identityHandle, realm, topic, onEvent, bytesMode);
-    },
-    sessionSubscribeStop(subscriptionHandle) {
-        return addon.sessionSubscribeStop(subscriptionHandle);
-    },
-    contentPut(sessionHandle, identityHandle, data, name) {
-        return addon.contentPut(sessionHandle, identityHandle, data, name);
-    },
-    contentGet(sessionHandle, identityHandle, mcidHex) {
-        return addon.contentGet(sessionHandle, identityHandle, mcidHex);
-    },
-    directdialResolve(sessionHandle, identityHandle, realm, procedure, timeoutMs) {
-        return addon.directdialResolve(sessionHandle, identityHandle, realm, procedure, timeoutMs);
-    },
-    directdialCall(sessionHandle, identityHandle, procedure, realm, payloadJson, timeoutMs, bytesMode) {
-        return addon.directdialCall(sessionHandle, identityHandle, procedure, realm, payloadJson, timeoutMs, bytesMode);
-    },
-    directdialCallWithUcan(sessionHandle, identityHandle, procedure, realm, payloadJson, timeoutMs, ucanToken, bytesMode) {
-        return addon.directdialCallWithUcan(sessionHandle, identityHandle, procedure, realm, payloadJson, timeoutMs, ucanToken, bytesMode);
-    },
-    directdialAdvertise(sessionHandle, identityHandle, realm, procedure, ttlMs) {
-        return addon.directdialAdvertise(sessionHandle, identityHandle, realm, procedure, ttlMs);
-    },
-};
+export const native = require("node-gyp-build")(repoRoot);
 //# sourceMappingURL=binding.js.map

package/dist/binding.js.map

@@ -1 +1 @@
-{"version":3,"file":"binding.js","sourceRoot":"","sources":["../src/binding.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"binding.js","sourceRoot":"","sources":["../src/binding.ts"],"names":[],"mappings":"AAAA,6EAA6E;AAC7E,oEAAoE;AACpE,4EAA4E;AAC5E,2EAA2E;AAC3E,0EAA0E;AAC1E,yBAAyB;AACzB,EAAE;AACF,4EAA4E;AAC5E,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAE1C,MAAM,OAAO,GAAG,aAAa,CAAC,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC;AAC/C,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC;AAgBrE,8DAA8D;AAC9D,MAAM,CAAC,MAAM,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAAC,QAAQ,CA2CvD,CAAC"}

package/dist/index.d.ts

@@ -1,9 +1,4 @@
-export { Identity } from "./identity.js";
-export { Session, type CallOptions, type ServeOptions } from "./session.js";
-export { Pool, NoHealthyStationError, type Seed, type PoolOptions, type PoolStatus } from "./pool.js";
-export { MaculaCallError, type JsonValue, type Bolt4ErrorInfo, type BytesOutput } from "./rpc.js";
-export { DhtRecordType, DHT_DEFAULT_TTL_MS, type DhtRecord } from "./dht.js";
-export type { PublishOptions, PubsubEvent, SubscribeOptions } from "./pubsub.js";
-export { ContentNotFoundError } from "./content.js";
-export { Ucan, type UcanCapability, type UcanFactValue, type UcanMintOptions } from "./ucan.js";
-export { keepAdvertisedDirect, KEEP_ADVERTISED_DIRECT_INTERVAL_MS, type DirectDialTarget, type AdvertiseDirectOptions, type KeepAdvertisedDirectOptions, } from "./directdial.js";
+export { NodeKey, type Profile } from "./key.js";
+export { Pool, Subscription, Served, RecordType, type Seed, type PoolOptions, type LinkStatus, type Provider, type Event, type Request, type DhtRecord, } from "./pool.js";
+export { Stream, StreamMode, type StreamEvent, type StreamRequest } from "./stream.js";
+export { ProviderError, RelayError, StreamError, DEFAULT_CALL_TIMEOUT_MS, type JsonValue, type BytesOutput, type Id, } from "./wire.js";

package/dist/index.js

@@ -1,9 +1,6 @@
-export { Identity } from "./identity.js";
-export { Session } from "./session.js";
-export { Pool, NoHealthyStationError } from "./pool.js";
-export { MaculaCallError } from "./rpc.js";
-export { DhtRecordType, DHT_DEFAULT_TTL_MS } from "./dht.js";
-export { ContentNotFoundError } from "./content.js";
-export { Ucan } from "./ucan.js";
-export { keepAdvertisedDirect, KEEP_ADVERTISED_DIRECT_INTERVAL_MS, } from "./directdial.js";
+// @macula-io/ts: the macula 12 mesh from TypeScript, over macula-go.
+export { NodeKey } from "./key.js";
+export { Pool, Subscription, Served, RecordType, } from "./pool.js";
+export { Stream, StreamMode } from "./stream.js";
+export { ProviderError, RelayError, StreamError, DEFAULT_CALL_TIMEOUT_MS, } from "./wire.js";
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AACzC,OAAO,EAAE,OAAO,EAAuC,MAAM,cAAc,CAAC;AAC5E,OAAO,EAAE,IAAI,EAAE,qBAAqB,EAAgD,MAAM,WAAW,CAAC;AACtG,OAAO,EAAE,eAAe,EAAyD,MAAM,UAAU,CAAC;AAClG,OAAO,EAAE,aAAa,EAAE,kBAAkB,EAAkB,MAAM,UAAU,CAAC;AAE7E,OAAO,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AACpD,OAAO,EAAE,IAAI,EAAiE,MAAM,WAAW,CAAC;AAChG,OAAO,EACL,oBAAoB,EACpB,kCAAkC,GAInC,MAAM,iBAAiB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,qEAAqE;AACrE,OAAO,EAAE,OAAO,EAAgB,MAAM,UAAU,CAAC;AACjD,OAAO,EACL,IAAI,EACJ,YAAY,EACZ,MAAM,EACN,UAAU,GAQX,MAAM,WAAW,CAAC;AACnB,OAAO,EAAE,MAAM,EAAE,UAAU,EAAwC,MAAM,aAAa,CAAC;AACvF,OAAO,EACL,aAAa,EACb,UAAU,EACV,WAAW,EACX,uBAAuB,GAIxB,MAAM,WAAW,CAAC"}

package/dist/key.d.ts

@@ -0,0 +1,31 @@
+import { type Handle } from "./binding.js";
+/** A crypto profile: "pq_hybrid" (the fleet's) or "pq_pure". */
+export type Profile = "pq_hybrid" | "pq_pure";
+export declare class NodeKey {
+    private handle;
+    private constructor();
+    /** A new key whose node_id solves the admission puzzle; takes a second or
+     * so, off the event loop. */
+    static generate(profile?: Profile): Promise<NodeKey>;
+    /** The key in the key file at path. A file its group or others can read,
+     * or holding a key of another profile, is refused. */
+    static load(path: string, profile?: Profile): Promise<NodeKey>;
+    /** The key at path, or a new one saved there when the file does not exist. */
+    static loadOrCreate(path: string, profile?: Profile): Promise<NodeKey>;
+    /** Writes the key to path, readable by its owner only. */
+    save(path: string): Promise<void>;
+    /** The key's 32-byte node_id. */
+    nodeId(): Uint8Array;
+    /** The node_id as lowercase hex. */
+    nodeIdHex(): string;
+    /** The public key as carried on the wire. */
+    publicKey(): Uint8Array;
+    /** The key's profile. */
+    profile(): Profile;
+    /** Signs data as given. */
+    sign(data: Uint8Array): Promise<Uint8Array>;
+    /** Frees the native key. The NodeKey is unusable after. */
+    free(): void;
+    /** @internal */
+    live(): Handle;
+}

package/dist/key.js

@@ -0,0 +1,72 @@
+// A node's identity key, as macula 12 has it: ML-DSA-87 (pq_pure) or the LAMPS
+// composite ML-DSA-87 + RSA-4096-PSS (pq_hybrid, the fleet's profile), whose
+// node_id solves the admission puzzle. Stored in a key file readable by its
+// owner only.
+import { access } from "node:fs/promises";
+import { native } from "./binding.js";
+import { hex } from "./wire.js";
+export class NodeKey {
+    handle;
+    constructor(handle) {
+        this.handle = handle;
+    }
+    /** A new key whose node_id solves the admission puzzle; takes a second or
+     * so, off the event loop. */
+    static async generate(profile = "pq_hybrid") {
+        return new NodeKey(await native.keyGenerate(profile));
+    }
+    /** The key in the key file at path. A file its group or others can read,
+     * or holding a key of another profile, is refused. */
+    static async load(path, profile = "pq_hybrid") {
+        return new NodeKey(await native.keyLoad(path, profile));
+    }
+    /** The key at path, or a new one saved there when the file does not exist. */
+    static async loadOrCreate(path, profile = "pq_hybrid") {
+        try {
+            await access(path);
+        }
+        catch {
+            const key = await NodeKey.generate(profile);
+            await key.save(path);
+            return key;
+        }
+        return NodeKey.load(path, profile);
+    }
+    /** Writes the key to path, readable by its owner only. */
+    async save(path) {
+        await native.keySave(this.live(), path);
+    }
+    /** The key's 32-byte node_id. */
+    nodeId() {
+        return native.keyNodeId(this.live());
+    }
+    /** The node_id as lowercase hex. */
+    nodeIdHex() {
+        return hex(this.nodeId());
+    }
+    /** The public key as carried on the wire. */
+    publicKey() {
+        return native.keyPublicKey(this.live());
+    }
+    /** The key's profile. */
+    profile() {
+        return native.keyProfile(this.live());
+    }
+    /** Signs data as given. */
+    async sign(data) {
+        return native.keySign(this.live(), data);
+    }
+    /** Frees the native key. The NodeKey is unusable after. */
+    free() {
+        if (this.handle !== null)
+            native.keyFree(this.handle);
+        this.handle = null;
+    }
+    /** @internal */
+    live() {
+        if (this.handle === null)
+            throw new Error("macula-ts: this NodeKey was freed");
+        return this.handle;
+    }
+}
+//# sourceMappingURL=key.js.map

package/dist/key.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"key.js","sourceRoot":"","sources":["../src/key.ts"],"names":[],"mappings":"AAAA,+EAA+E;AAC/E,6EAA6E;AAC7E,4EAA4E;AAC5E,cAAc;AACd,OAAO,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAC1C,OAAO,EAAE,MAAM,EAAe,MAAM,cAAc,CAAC;AACnD,OAAO,EAAE,GAAG,EAAE,MAAM,WAAW,CAAC;AAKhC,MAAM,OAAO,OAAO;IACU,MAAM;IAAlC,YAA4B,MAAqB;sBAArB,MAAM;IAAkB,CAAC;IAErD;iCAC6B;IAC7B,MAAM,CAAC,KAAK,CAAC,QAAQ,CAAC,OAAO,GAAY,WAAW;QAClD,OAAO,IAAI,OAAO,CAAC,MAAM,MAAM,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC,CAAC;IACxD,CAAC;IAED;0DACsD;IACtD,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,IAAY,EAAE,OAAO,GAAY,WAAW;QAC5D,OAAO,IAAI,OAAO,CAAC,MAAM,MAAM,CAAC,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC;IAC1D,CAAC;IAED,8EAA8E;IAC9E,MAAM,CAAC,KAAK,CAAC,YAAY,CAAC,IAAY,EAAE,OAAO,GAAY,WAAW;QACpE,IAAI,CAAC;YACH,MAAM,MAAM,CAAC,IAAI,CAAC,CAAC;QACrB,CAAC;QAAC,MAAM,CAAC;YACP,MAAM,GAAG,GAAG,MAAM,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;YAC5C,MAAM,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACrB,OAAO,GAAG,CAAC;QACb,CAAC;QACD,OAAO,OAAO,CAAC,IAAI,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;IACrC,CAAC;IAED,0DAA0D;IAC1D,KAAK,CAAC,IAAI,CAAC,IAAY;QACrB,MAAM,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,EAAE,EAAE,IAAI,CAAC,CAAC;IAC1C,CAAC;IAED,iCAAiC;IACjC,MAAM;QACJ,OAAO,MAAM,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC;IACvC,CAAC;IAED,oCAAoC;IACpC,SAAS;QACP,OAAO,GAAG,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC;IAC5B,CAAC;IAED,6CAA6C;IAC7C,SAAS;QACP,OAAO,MAAM,CAAC,YAAY,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC;IAC1C,CAAC;IAED,yBAAyB;IACzB,OAAO;QACL,OAAO,MAAM,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,EAAE,CAAY,CAAC;IACnD,CAAC;IAED,2BAA2B;IAC3B,KAAK,CAAC,IAAI,CAAC,IAAgB;QACzB,OAAO,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,EAAE,EAAE,IAAI,CAAC,CAAC;IAC3C,CAAC;IAED,2DAA2D;IAC3D,IAAI;QACF,IAAI,IAAI,CAAC,MAAM,KAAK,IAAI;YAAE,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QACtD,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC;IACrB,CAAC;IAED,gBAAgB;IAChB,IAAI;QACF,IAAI,IAAI,CAAC,MAAM,KAAK,IAAI;YAAE,MAAM,IAAI,KAAK,CAAC,mCAAmC,CAAC,CAAC;QAC/E,OAAO,IAAI,CAAC,MAAM,CAAC;IACrB,CAAC;CACF"}

package/dist/pool.d.ts

@@ -1,146 +1,182 @@
-import { Identity } from "./identity.js";
-import type { PubsubEvent } from "./pubsub.js";
-import { type BytesOutput, type JsonValue } from "./rpc.js";
-/** One configured connection target. */
+import { type Handle } from "./binding.js";
+import { NodeKey } from "./key.js";
+import { Stream, StreamMode, type StreamRequest } from "./stream.js";
+import { type BytesOutput, type Id, type JsonValue } from "./wire.js";
+/** A station to link to, pinned by the node_id it must prove. */
 export interface Seed {
-    host: string;
-    port: number;
+    readonly host: string;
+    readonly port: number;
+    readonly nodeId: Id;
 }
 export interface PoolOptions {
-    /** How many currently-live control links a publish() fans out to
-     * before resolving -- partial success counts as success, matching
-     * macula_client:publish/5's own documented semantics. Default 1.
-     * NOT YET FULLY AT PARITY above 1: the Erlang reference stamps ONE
-     * seq across every replica specifically so a receiver's own
-     * (publisher, seq, topic) dedup collapses the redundant copies into
-     * one event. This SDK's Session.publish() has no caller-supplied-seq
-     * parameter to do the same (each call mints its own fresh seq), so
-     * setting this above 1 would deliver N distinct, non-deduplicable
-     * copies to every subscriber -- clamped to 1 until that's fixed. */
-    replicationFactor?: number;
-    /** How long a recorded (realm, publisher, seq, topic) key is treated
-     * as a duplicate before it ages out. Default 60_000, matching the
-     * Erlang reference's own `dedup_window_ms` default. */
-    dedupWindowMs?: number;
-    /** How often the dedup table is swept for expired entries. Default
-     * 30_000, matching the Erlang reference's own `dedup_sweep_ms`. */
-    dedupSweepMs?: number;
-    /** How often a live control link is health-checked (see
-     * #armHealthCheck's own doc for why publish() alone can't be trusted
-     * to ever notice a dead connection). Default 10_000. */
-    healthCheckIntervalMs?: number;
+    /** Each realm's key as carried (hex or bytes), by realm id: an
+     * advertisement in a realm is trusted only when its authorization verifies
+     * against it, and a procedure is served only in a realm it names. */
+    readonly realmTrust?: ReadonlyArray<{
+        readonly realm: Id;
+        readonly key: string | Uint8Array;
+    }>;
+    readonly replicationFactor?: number;
+    readonly maxDirectLinks?: number;
+    readonly respawnDelayMs?: number;
+    /** How long connect waits for a first link, 30 s by default. */
+    readonly timeoutMs?: number;
 }
-export interface PoolStatus {
-    /** Seeds whose control link is currently connected. */
-    healthyLinks: number;
-    /** Seeds whose control link is not currently connected (connecting
-     * or backing off). Every configured seed is exactly one or the
-     * other -- a link backs off and retries forever, it is never given
-     * up on and dropped from the pool, same as the Erlang reference. */
-    failedLinks: number;
+/** One of the pool's links. */
+export interface LinkStatus {
+    readonly station: string;
+    readonly host: string;
+    readonly port: number;
+    readonly direct: boolean;
+    readonly up: boolean;
 }
-/** Thrown by publish()/call() when the pool has zero live control links
- * to try -- a distinct, identifiable condition from any one link's own
- * transient error, matching macula_client:publish/5's own `{error,
- * {transient, no_healthy_station}}`. */
-export declare class NoHealthyStationError extends Error {
-    constructor();
+/** A trusted provider of a procedure and the station it serves from. */
+export interface Provider {
+    readonly node: string;
+    readonly station: string;
+}
+/** An event a subscription heard, verified. */
+export interface Event {
+    readonly publisher: string;
+    readonly realm: string;
+    readonly topic: string;
+    readonly seq: number;
+    readonly publishedAt: number;
+    readonly payload: JsonValue;
+    readonly deliveredVia: string;
+}
+/** A served call's request. */
+export interface Request {
+    readonly caller: string;
+    readonly realm: string;
+    readonly procedure: string;
+    readonly payload: JsonValue;
+    readonly deadlineMs: number;
+}
+/** A verified DHT record: its type, signer's key id, times, payload, and wire
+ * bytes (tagged). */
+export interface DhtRecord {
+    readonly type: number;
+    readonly keyId: string;
+    readonly createdAt: number;
+    readonly expiresAt: number;
+    readonly payload: JsonValue;
+    readonly wire: JsonValue;
+}
+/** macula 12's record types. */
+export declare enum RecordType {
+    NodeRecord = 1,
+    ProcedureAdvertisement = 6,
+    Tombstone = 12,
+    ContentAnnouncement = 17,
+    StationEndpoint = 18,
+    OrgDirectory = 21,
+    ProcedureDelegation = 22
+}
+/** A subscription, until stop() or the pool closes. */
+export declare class Subscription {
+    private readonly handle;
+    readonly closed: Promise<string | null>;
+    /** @internal */
+    constructor(handle: Handle, closed: Promise<string | null>);
+    /** Ends the subscription on every link. */
+    stop(): Promise<void>;
+}
+/** A served procedure, until stop(). */
+export declare class Served {
+    private readonly handle;
+    private stopped;
+    /** @internal */
+    constructor(handle: Handle);
+    /** Withdraws the procedure on every link. */
+    stop(): Promise<void>;
 }
-/**
- * A resilient multi-station client: live connections to every configured
- * seed held concurrently, each independently monitored and respawned
- * with backoff on disconnect, every tracked subscription re-established
- * automatically when its own link reconnects. See this module's own
- * header doc for the full design, why a "link" is a small role-scoped
- * session set rather than one Session, and its one deliberate deviation
- * from the Erlang reference (topic-scoped dedup).
- */
 export declare class Pool {
-    #private;
+    private readonly handle;
+    private closed;
     private constructor();
-    /** Dials the control role against every seed concurrently under
-     * `controlIdentity` (the caller's own identity -- publish()/call()
-     * are attributed to it on the wire) and resolves once every seed's
-     * FIRST connect attempt has settled (success or a logged failure
-     * headed into backoff) -- matches tapRoom()'s own "await the first
-     * attempt, not the eventual outcome" reasoning (macula-mcp's
-     * lobby_observer.ts): a caller that publishes/calls immediately
-     * after connect() must not race links still mid-handshake. */
-    static connect(seeds: Seed[], controlIdentity: Identity, opts?: PoolOptions): Promise<Pool>;
-    /** Publishes to `replicationFactor` currently-live control links
-     * (default 1); partial success counts as success. A link whose
-     * publish attempt fails is marked for respawn immediately -- this is
-     * this v1's only liveness signal for the control role, since it
-     * cannot also carry a liveness-only subscribe (see this module's own
-     * header doc). Throws NoHealthyStationError if zero links are live.
-     *
-     * `realm`/`payload` are validated before any link is touched. Found
-     * live 2026-09-05: a malformed realm or an unserializable payload
-     * throws inside session.publish() itself, well before any wire I/O --
-     * treating that throw as evidence of a dead connection (the pre-fix
-     * behavior) tore down a perfectly healthy link over a caller-side
-     * argument bug. */
-    publish(realm: string | undefined, topic: string, payload: JsonValue, opts?: {
+    /** Links the key's node to every seed, and resolves once one link is up. */
+    static connect(key: NodeKey, seeds: readonly Seed[], options?: PoolOptions): Promise<Pool>;
+    /** The node_id the pool links as. */
+    nodeId(): string;
+    /** name in this node's own namespace, `~<node_id>/<name>`: a procedure it
+     * serves with no org and no realm key, authorized by its advertisement's
+     * signature alone, and that any node calls with no realm key pinned. */
+    ownProcedure(name: string): string;
+    /** Every link the pool holds. */
+    status(): LinkStatus[];
+    /** Calls procedure in realm at a provider (any trusted one unless
+     * `provider` names one) by direct dial. A provider's ERROR is thrown as a
+     * ProviderError, a station's relay error as a RelayError. */
+    call(realm: Id, procedure: string, payload?: JsonValue, options?: {
+        provider?: Id;
+        timeoutMs?: number;
+        bytes?: BytesOutput;
+    }): Promise<JsonValue>;
+    /** The procedure's trusted providers, freshest first. */
+    providers(realm: Id, procedure: string, options?: {
+        timeoutMs?: number;
+    }): Promise<Provider[]>;
+    /** Publishes payload on topic in realm. Topics name a kind of fact; ids go
+     * in the payload. */
+    publish(realm: Id, topic: string, payload: JsonValue, options?: {
         ttlMs?: number;
     }): Promise<void>;
-    /** Calls `procedure` against the pool's live control links in order
-     * until one succeeds or all have been tried. Throws
-     * NoHealthyStationError if zero links are live.
-     *
-     * `realm`/`payload`/`opts.bytes` are validated before any link is
-     * touched, for the
-     * same reason as publish() -- a malformed realm is a caller bug, not
-     * evidence of a dead connection, and must never be attributed to one.
-     *
-     * A `MaculaCallError` (a real BOLT#4 response -- e.g.
-     * unknown_next_peer, unauthorized, a procedure nobody serves, a gated
-     * call this identity isn't authorized for) does NOT mark its link for
-     * respawn: the connection plainly worked, it answered. call() still
-     * falls through to the next link either way, matching the Erlang
-     * reference's own keep_or_next (macula_client.erl) -- a non-idempotent
-     * provider handler genuinely can be re-invoked on each live link this
-     * reaches; that is parity with the reference, not a bug this fixes.
-     *
-     * Any OTHER thrown error (never a wire-level answer at all) is
-     * ambiguous, not automatically a dead link: session.call()'s own
-     * deadlineMs elapsing looks identical to a genuinely severed
-     * connection, but means the far end is merely slow, not gone. Found
-     * live 2026-09-05: treating every such error as a dead link meant one
-     * slow provider response tore down and reconnected EVERY live control
-     * link in turn as call() moved through them re-trying the same call.
-     * #probeLiveness's own dedicated liveness call is the tiebreaker --
-     * only a link that ALSO fails to get a wire-level answer on that
-     * fresh probe is scheduled for reconnect. Each link's own `session`
-     * reference is re-checked both before probing and before scheduling a
-     * reconnect, in case a concurrent operation already superseded it. */
-    call(realm: string | undefined, procedure: string, payload: JsonValue, opts?: {
+    /** Subscribes to topic in realm: onEvent hears each verified event once,
+     * however many links deliver it. `closed` resolves when the subscription
+     * ends, with why or null. */
+    subscribe(realm: Id, topic: string, onEvent: (event: Event) => void, options?: {
+        bytes?: BytesOutput;
+    }): Promise<Subscription>;
+    /** Serves procedure in realm: handler answers each call, and its thrown
+     * error goes back as a handler_error with its message. An org procedure
+     * needs the realm's key pinned and the org's delegation to this node in the
+     * DHT; a procedure in this node's own namespace (ownProcedure) needs
+     * neither, and another node's namespace is refused. */
+    serve(realm: Id, procedure: string, handler: (request: Request) => JsonValue | Promise<JsonValue>, options?: {
+        bytes?: BytesOutput;
+    }): Promise<Served>;
+    /** Serves procedure in realm as a stream of mode: handler drives each
+     * session. The stream is closed when the handler returns without ending
+     * it, aborted with code error when it throws, and released either way. */
+    serveStream(realm: Id, procedure: string, mode: StreamMode, handler: (stream: Stream, request: StreamRequest) => void | Promise<void>, options?: {
+        bytes?: BytesOutput;
+    }): Promise<Served>;
+    /** Opens a stream of mode on procedure in realm at a provider, by direct
+     * dial. A refusal arrives on its first recv(). */
+    openStream(realm: Id, procedure: string, mode: StreamMode, payload?: JsonValue, options?: {
+        provider?: Id;
         deadlineMs?: number;
+        timeoutMs?: number;
         bytes?: BytesOutput;
-    }): Promise<JsonValue>;
-    /** Subscribes `handler` to `(realm, topic)`: opens one subscribe-only
-     * session against every configured seed, replayed automatically on
-     * every future respawn. Mints a dedicated identity for this topic by
-     * default (disposed on unsubscribe); pass `identity` to supply the
-     * pool's own instead (e.g. for a stable, caller-controlled identity
-     * across restarts, matching macula-mcp's own observeRoomIdentityPath
-     * pattern) -- the pool never disposes an identity it didn't mint.
-     * `opts.bytes` picks how bytes in each event's payload reach `handler`
-     * (rpc.ts's BytesOutput), on every seed and after every respawn.
-     * Returns an unsubscribe function. */
-    subscribe(realm: string | undefined, topic: string, handler: (evt: PubsubEvent) => void, identity?: Identity, opts?: {
+    }): Promise<Stream>;
+    /** The verified record under key, or null when there is none. */
+    findRecord(key: Id, options?: {
+        timeoutMs?: number;
         bytes?: BytesOutput;
-    }): Promise<() => Promise<void>>;
-    /** Live/backing-off CONTROL link counts (publish/call reachability).
-     * Every configured seed is exactly one or the other. Per-topic
-     * subscription link health is not reflected here -- inspect a
-     * specific subscription's own behavior (events arriving or not)
-     * instead; exposing N independent per-topic health vectors here
-     * would not simplify what a caller actually needs to know. */
-    status(): PoolStatus;
-    /** Closes every control and subscription link and disposes every
-     * identity this pool owns (the caller-supplied control identity
-     * included). Awaits each link's in-flight connect/reconnect first,
-     * so a still-connecting link never has its identity yanked out from
-     * under it. */
+    }): Promise<DhtRecord | null>;
+    /** Every verified record under key, and how many did not verify. */
+    findRecords(key: Id, options?: {
+        timeoutMs?: number;
+        bytes?: BytesOutput;
+    }): Promise<{
+        records: DhtRecord[];
+        dropped: number;
+    }>;
+    /** Every verified record of type the station holds, and how many did not
+     * verify. */
+    findRecordsByType(type: RecordType | number, options?: {
+        timeoutMs?: number;
+        bytes?: BytesOutput;
+    }): Promise<{
+        records: DhtRecord[];
+        dropped: number;
+    }>;
+    /** Puts a signed record's wire bytes in the DHT. */
+    putRecord(wire: Uint8Array, options?: {
+        timeoutMs?: number;
+    }): Promise<void>;
+    /** Closes every link and subscription. */
     close(): Promise<void>;
+    private live;
 }