@holochain/client 0.12.6 → 0.12.7

package/lib/api/admin/types.d.ts

@@ -1,4 +1,3 @@
-/// <reference types="node" />
 import { Action, DhtOp, Entry, ZomeCallCapGrant } from "../../hdk/index.js";
 import { ActionHash, AgentPubKey, CellId, DnaHash, DnaProperties, Duration, HoloHash, HoloHashB64, InstalledAppId, KitsuneAgent, KitsuneSpace, RoleName, Signature, Timestamp, WasmHash } from "../../types.js";
 import { Requester } from "../common.js";
@@ -7,7 +6,7 @@ import { DisableCloneCellRequest } from "../index.js";
  * @public
  */
 export type AttachAppInterfaceRequest = {
-    port: number;
+    port?: number;
 };
 /**
  * @public
@@ -127,7 +126,7 @@ export type AppInfo = {
 /**
  * @public
  */
-export type MembraneProof = Buffer;
+export type MembraneProof = Uint8Array;
 /**
  * @public
  */
@@ -163,7 +162,7 @@ export type DumpStateResponse = any;
  */
 export type DumpFullStateRequest = {
     cell_id: CellId;
-    dht_ops_cursor: number | undefined;
+    dht_ops_cursor?: number;
 };
 /**
  * @public
@@ -195,7 +194,7 @@ export type RegisterDnaResponse = HoloHash;
  */
 export type DnaModifiers = {
     network_seed: NetworkSeed;
-    properties: DnaProperties;
+    properties: Uint8Array;
     origin_time: Timestamp;
     quantum_time: Duration;
 };
@@ -252,6 +251,16 @@ export type UninstallAppRequest = {
  * @public
  */
 export type UninstallAppResponse = null;
+/**
+ * @public
+ */
+export type UpdateCoordinatorsRequest = {
+    dna_hash: DnaHash;
+} & CoordinatorSource;
+/**
+ * @public
+ */
+export type UpdateCoordinatorsResponse = void;
 /**
  * @public
  */
@@ -373,12 +382,33 @@ export type NetworkSeed = string;
  * @public
  */
 export type InstallAppRequest = {
+    /**
+     * The agent to use when creating Cells for this App.
+     */
     agent_key: AgentPubKey;
+    /**
+     * The unique identifier for an installed app in this conductor.
+     * If not specified, it will be derived from the app name in the bundle manifest.
+     */
     installed_app_id?: InstalledAppId;
+    /**
+     * Include proof-of-membrane-membership data for cells that require it,
+     * keyed by the CellNick specified in the app bundle manifest.
+     */
     membrane_proofs: {
         [key: string]: MembraneProof;
     };
+    /**
+     * Optional global network seed override.  If set will override the network seed value for all
+     * DNAs in the bundle.
+     */
     network_seed?: NetworkSeed;
+    /**
+     * Optional: If app installation fails due to genesis failure, normally the app will be immediately uninstalled.
+     * When this flag is set, the app is left installed with empty cells intact. This can be useful for
+     * using graft_records_onto_source_chain, or for diagnostics.
+     */
+    ignore_genesis_failure?: boolean;
 } & AppBundleSource;
 /**
  * @public
@@ -500,13 +530,41 @@ export type InstallAppDnaPayload = {
  * @public
  */
 export type ZomeLocation = Location;
+/**
+ * @public
+ */
+export interface ZomeDependency {
+    name: ZomeName;
+}
 /**
  * @public
  */
 export type ZomeManifest = {
     name: string;
     hash?: string;
+    dependencies?: ZomeDependency[];
 } & ZomeLocation;
+/**
+ * @public
+ */
+export interface CoordinatorManifest {
+    zomes: Array<ZomeManifest>;
+}
+/**
+ * @public
+ */
+export interface CoordinatorBundle {
+    manifest: CoordinatorManifest;
+    resources: ResourceMap;
+}
+/**
+ * @public
+ */
+export type CoordinatorSource = {
+    path: string;
+} | {
+    bundle: CoordinatorBundle;
+};
 /**
  * @public
  */
@@ -624,6 +682,46 @@ export interface FullStateDump {
     source_chain_dump: SourceChainJsonDump;
     integration_dump: FullIntegrationStateDump;
 }
+/**
+ * @public
+ */
+export interface DnaStorageInfo {
+    authored_data_size: number;
+    authored_data_size_on_disk: number;
+    dht_data_size: number;
+    dht_data_size_on_disk: number;
+    cache_data_size: number;
+    cache_data_size_on_disk: number;
+    used_by: Array<InstalledAppId>;
+}
+/**
+ * @public
+ */
+export interface DnaStorageBlob {
+    dna: DnaStorageInfo;
+}
+/**
+ * @public
+ */
+export interface StorageInfo {
+    blobs: Array<DnaStorageBlob>;
+}
+/**
+ * @public
+ */
+export type StorageInfoRequest = void;
+/**
+ * @public
+ */
+export type StorageInfoResponse = StorageInfo;
+/**
+ * @public
+ */
+export type DumpNetworkStatsRequest = void;
+/**
+ * @public
+ */
+export type DumpNetworkStatsResponse = string;
 /**
  * @public
  */
@@ -646,4 +744,6 @@ export interface AdminApi {
     addAgentInfo: Requester<AddAgentInfoRequest, AddAgentInfoResponse>;
     deleteCloneCell: Requester<DeleteCloneCellRequest, DeleteCloneCellResponse>;
     grantZomeCallCapability: Requester<GrantZomeCallCapabilityRequest, GrantZomeCallCapabilityResponse>;
+    storageInfo: Requester<StorageInfoRequest, StorageInfoResponse>;
+    dumpNetworkStats: Requester<DumpNetworkStatsRequest, DumpNetworkStatsResponse>;
 }

package/lib/api/admin/websocket.d.ts

@@ -2,7 +2,7 @@ import { CapSecret, GrantedFunctions } from "../../hdk/capabilities.js";
 import type { AgentPubKey, CellId } from "../../types.js";
 import { WsClient } from "../client.js";
 import { Requester, Transformer } from "../common.js";
-import { AddAgentInfoRequest, AddAgentInfoResponse, AdminApi, AgentInfoRequest, AgentInfoResponse, AttachAppInterfaceRequest, AttachAppInterfaceResponse, DeleteCloneCellRequest, DeleteCloneCellResponse, DisableAppRequest, DisableAppResponse, DumpFullStateRequest, DumpFullStateResponse, DumpStateRequest, DumpStateResponse, EnableAppRequest, EnableAppResponse, GenerateAgentPubKeyRequest, GenerateAgentPubKeyResponse, GetDnaDefinitionRequest, GetDnaDefinitionResponse, GrantZomeCallCapabilityRequest, GrantZomeCallCapabilityResponse, InstallAppRequest, InstallAppResponse, ListAppInterfacesRequest, ListAppInterfacesResponse, ListAppsRequest, ListAppsResponse, ListCellIdsRequest, ListCellIdsResponse, ListDnasRequest, ListDnasResponse, RegisterDnaRequest, RegisterDnaResponse, UninstallAppRequest, UninstallAppResponse } from "./types.js";
+import { AddAgentInfoRequest, AddAgentInfoResponse, AdminApi, AgentInfoRequest, AgentInfoResponse, AttachAppInterfaceRequest, AttachAppInterfaceResponse, DeleteCloneCellRequest, DeleteCloneCellResponse, DisableAppRequest, DisableAppResponse, DumpFullStateRequest, DumpFullStateResponse, DumpNetworkStatsRequest, DumpNetworkStatsResponse, DumpStateRequest, DumpStateResponse, EnableAppRequest, EnableAppResponse, GenerateAgentPubKeyRequest, GenerateAgentPubKeyResponse, GetDnaDefinitionRequest, GetDnaDefinitionResponse, GrantZomeCallCapabilityRequest, GrantZomeCallCapabilityResponse, InstallAppRequest, InstallAppResponse, ListAppInterfacesRequest, ListAppInterfacesResponse, ListAppsRequest, ListAppsResponse, ListCellIdsRequest, ListCellIdsResponse, ListDnasRequest, ListDnasResponse, RegisterDnaRequest, RegisterDnaResponse, StorageInfoRequest, StorageInfoResponse, UninstallAppRequest, UninstallAppResponse, UpdateCoordinatorsRequest, UpdateCoordinatorsResponse } from "./types.js";
 /**
  * A class for interacting with a conductor's Admin API.
  *
@@ -25,7 +25,7 @@ export declare class AdminWebsocket implements AdminApi {
      * @param defaultTimeout - The default timeout for any request.
      * @returns A promise for a new connected instance.
      */
-    static connect(url: string, defaultTimeout?: number): Promise<AdminWebsocket>;
+    static connect(url: URL, defaultTimeout?: number): Promise<AdminWebsocket>;
     _requester<ReqI, ReqO, ResI, ResO>(tag: string, transformer?: Transformer<ReqI, ReqO, ResI, ResO>): (req: ReqI, timeout?: number | undefined) => Promise<ResO>;
     /**
      * Send a request to open the given port for {@link AppWebsocket} connections.
@@ -70,6 +70,10 @@ export declare class AdminWebsocket implements AdminApi {
      * Install the specified app into Holochain.
      */
     installApp: Requester<InstallAppRequest, InstallAppResponse>;
+    /**
+     * Update coordinators for an installed app.
+     */
+    updateCoordinators: Requester<UpdateCoordinatorsRequest, UpdateCoordinatorsResponse>;
     /**
      * List all registered DNAs.
      */
@@ -103,6 +107,8 @@ export declare class AdminWebsocket implements AdminApi {
      * calls.
      */
     grantZomeCallCapability: Requester<GrantZomeCallCapabilityRequest, GrantZomeCallCapabilityResponse>;
+    storageInfo: Requester<StorageInfoRequest, StorageInfoResponse>;
+    dumpNetworkStats: Requester<DumpNetworkStatsRequest, DumpNetworkStatsResponse>;
     /**
      * Grant a capability for signing zome calls.
      *

package/lib/api/admin/websocket.js

@@ -34,7 +34,7 @@ export class AdminWebsocket {
         // Check if we are in the launcher's environment, and if so, redirect the url to connect to
         const env = getLauncherEnvironment();
         if (env?.ADMIN_INTERFACE_PORT) {
-            url = `ws://127.0.0.1:${env.ADMIN_INTERFACE_PORT}`;
+            url = new URL(`ws://127.0.0.1:${env.ADMIN_INTERFACE_PORT}`);
         }
         const wsClient = await WsClient.connect(url);
         return new AdminWebsocket(wsClient, defaultTimeout);
@@ -85,6 +85,10 @@ export class AdminWebsocket {
      * Install the specified app into Holochain.
      */
     installApp = this._requester("install_app");
+    /**
+     * Update coordinators for an installed app.
+     */
+    updateCoordinators = this._requester("update_coordinators");
     /**
      * List all registered DNAs.
      */
@@ -118,6 +122,8 @@ export class AdminWebsocket {
      * calls.
      */
     grantZomeCallCapability = this._requester("grant_zome_call_capability");
+    storageInfo = this._requester("storage_info");
+    dumpNetworkStats = this._requester("dump_network_stats");
     // zome call signing related methods
     /**
      * Grant a capability for signing zome calls.
@@ -153,7 +159,7 @@ export class AdminWebsocket {
      * granted for all zomes and functions.
      */
     authorizeSigningCredentials = async (cellId, functions) => {
-        const [keyPair, signingKey] = generateSigningKeyPair();
+        const [keyPair, signingKey] = await generateSigningKeyPair();
         const capSecret = await this.grantSigningKey(cellId, functions || { [GrantedFunctionsType.All]: null }, signingKey);
         setSigningCredentials(cellId, { capSecret, keyPair, signingKey });
     };

package/lib/api/app/types.d.ts

@@ -1,5 +1,5 @@
 import { AgentPubKey, CellId, DnaHash, DnaProperties, InstalledAppId, NetworkInfo, RoleName, Timestamp } from "../../types.js";
-import { AppInfo, ClonedCell, FunctionName, MembraneProof, NetworkSeed, ZomeName } from "../admin/index.js";
+import { AppInfo, ClonedCell, FunctionName, MembraneProof, NetworkSeed, ZomeName } from "../admin/types.js";
 import { Requester } from "../common.js";
 /**
  * @public
@@ -114,9 +114,17 @@ export type EnableCloneCellResponse = CreateCloneCellResponse;
  */
 export interface NetworkInfoRequest {
     /**
-     * The DNAs for which to get network info
+     * The calling agent
+     */
+    agent_pub_key: AgentPubKey;
+    /**
+     * Get network info for these DNAs
      */
     dnas: DnaHash[];
+    /**
+     * Timestamp in ms since which received amount of bytes from peers will be returned. Defaults to UNIX_EPOCH.
+     */
+    last_time_queried?: number;
 }
 /**
  * @public

package/lib/api/app/websocket.d.ts

@@ -23,8 +23,8 @@ export declare class AppWebsocket extends Emittery implements AppApi {
      * @param defaultTimeout - Timeout to default to for all operations.
      * @returns A new instance of an AppWebsocket.
      */
-    static connect(url: string, defaultTimeout?: number): Promise<AppWebsocket>;
-    _requester: <ReqI, ReqO, ResI, ResO>(tag: string, transformer?: Transformer<ReqI, ReqO, ResI, ResO> | undefined) => (req: ReqI, timeout?: number | undefined) => Promise<ResO>;
+    static connect(url: URL, defaultTimeout?: number): Promise<AppWebsocket>;
+    _requester<ReqI, ReqO, ResI, ResO>(tag: string, transformer?: Transformer<ReqI, ReqO, ResI, ResO>): (req: ReqI, timeout?: number | undefined) => Promise<ResO>;
     /**
      * Request the app's info, including all cell infos.
      *

package/lib/api/app/websocket.js

@@ -1,11 +1,11 @@
 import { hashZomeCall } from "@holochain/serialization";
 import { decode, encode } from "@msgpack/msgpack";
+import _sodium from "libsodium-wrappers";
 import Emittery from "emittery";
-import nacl from "tweetnacl";
-import { getHostZomeCallSigner, getLauncherEnvironment, isLauncher, signZomeCallTauri, } from "../../environments/launcher.js";
+import { getLauncherEnvironment, signZomeCallTauri, signZomeCallElectron, getHostZomeCallSigner, } from "../../environments/launcher.js";
 import { encodeHashToBase64 } from "../../utils/base64.js";
 import { WsClient } from "../client.js";
-import { catchError, DEFAULT_TIMEOUT, promiseTimeout, requesterTransformer, } from "../common.js";
+import { DEFAULT_TIMEOUT, catchError, promiseTimeout, requesterTransformer, } from "../common.js";
 import { getNonceExpiration, getSigningCredentials, randomNonce, } from "../zome-call-signing.js";
 /**
  * A class to establish a websocket connection to an App interface of a
@@ -19,6 +19,15 @@ export class AppWebsocket extends Emittery {
     overrideInstalledAppId;
     constructor(client, defaultTimeout, overrideInstalledAppId) {
         super();
+        // Ensure all super methods are bound to this instance because Emittery relies on `this` being the instance.
+        // Please retain until the upstream is fixed https://github.com/sindresorhus/emittery/issues/86.
+        Object.getOwnPropertyNames(Emittery.prototype).forEach((name) => {
+            const to_bind = this[name];
+            if (typeof to_bind === "function") {
+                this[name] =
+                    to_bind.bind(this);
+            }
+        });
         this.client = client;
         this.defaultTimeout =
             defaultTimeout === undefined ? DEFAULT_TIMEOUT : defaultTimeout;
@@ -35,14 +44,16 @@ export class AppWebsocket extends Emittery {
         // Check if we are in the launcher's environment, and if so, redirect the url to connect to
         const env = getLauncherEnvironment();
         if (env?.APP_INTERFACE_PORT) {
-            url = `ws://127.0.0.1:${env.APP_INTERFACE_PORT}`;
+            url = new URL(`ws://127.0.0.1:${env.APP_INTERFACE_PORT}`);
         }
         const wsClient = await WsClient.connect(url);
         const appWebsocket = new AppWebsocket(wsClient, defaultTimeout, env?.INSTALLED_APP_ID);
         wsClient.on("signal", (signal) => appWebsocket.emit("signal", signal));
         return appWebsocket;
     }
-    _requester = (tag, transformer) => requesterTransformer((req, timeout) => promiseTimeout(this.client.request(req), tag, timeout || this.defaultTimeout).then(catchError), tag, transformer);
+    _requester(tag, transformer) {
+        return requesterTransformer((req, timeout) => promiseTimeout(this.client.request(req), tag, timeout || this.defaultTimeout).then(catchError), tag, transformer);
+    }
     /**
      * Request the app's info, including all cell infos.
      *
@@ -91,10 +102,16 @@ const callZomeTransform = {
         if (hostSigner) {
             return hostSigner.signZomeCall(request);
         }
-        else if (isLauncher) {
+        else {
+            const env = getLauncherEnvironment();
+            if (!env) {
+                return signZomeCall(request);
+            }
+            if (env.FRAMEWORK === "electron") {
+                return signZomeCallElectron(request);
+            }
             return signZomeCallTauri(request);
         }
-        return signZomeCall(request);
     },
     output: (response) => decode(response),
 };
@@ -128,9 +145,11 @@ export const signZomeCall = async (request) => {
         expires_at: getNonceExpiration(),
     };
     const hashedZomeCall = await hashZomeCall(unsignedZomeCallPayload);
-    const signature = nacl
-        .sign(hashedZomeCall, signingCredentialsForCell.keyPair.secretKey)
-        .subarray(0, nacl.sign.signatureLength);
+    await _sodium.ready;
+    const sodium = _sodium;
+    const signature = sodium
+        .crypto_sign(hashedZomeCall, signingCredentialsForCell.keyPair.privateKey)
+        .subarray(0, sodium.crypto_sign_BYTES);
     const signedZomeCall = {
         ...unsignedZomeCallPayload,
         signature,

package/lib/api/app-agent/types.d.ts

@@ -1,6 +1,6 @@
 import { UnsubscribeFunction } from "emittery";
 import { AgentPubKey, RoleName } from "../../index.js";
-import { AppInfoResponse, AppSignal, AppSignalCb, CallZomeRequest, CallZomeRequestSigned, DisableCloneCellRequest, EnableCloneCellRequest, EnableCloneCellResponse } from "../app/index.js";
+import { AppInfoResponse, AppSignal, AppSignalCb, CallZomeRequest, CallZomeRequestSigned, DisableCloneCellRequest, EnableCloneCellRequest, EnableCloneCellResponse, NetworkInfoRequest, NetworkInfoResponse } from "../app/index.js";
 import { CreateCloneCellRequest, CreateCloneCellResponse, DisableCloneCellResponse } from "../index.js";
 /**
  * @public
@@ -34,6 +34,10 @@ export type AppEnableCloneCellRequest = Omit<EnableCloneCellRequest, "app_id">;
  * @public
  */
 export type AppDisableCloneCellRequest = Omit<DisableCloneCellRequest, "app_id">;
+/**
+ * @public
+ */
+export type AppAgentNetworkInfoRequest = Omit<NetworkInfoRequest, "agent_pub_key">;
 /**
  * @public
  */
@@ -51,4 +55,5 @@ export interface AppAgentClient {
     createCloneCell(args: AppCreateCloneCellRequest): Promise<CreateCloneCellResponse>;
     enableCloneCell(args: AppEnableCloneCellRequest): Promise<EnableCloneCellResponse>;
     disableCloneCell(args: AppDisableCloneCellRequest): Promise<DisableCloneCellResponse>;
+    networkInfo(args: AppAgentNetworkInfoRequest): Promise<NetworkInfoResponse>;
 }

package/lib/api/app-agent/websocket.d.ts

@@ -1,7 +1,9 @@
 import Emittery, { UnsubscribeFunction } from "emittery";
 import { AgentPubKey, CellId, InstalledAppId, RoleName } from "../../types.js";
-import { AppInfo, AppSignalCb, AppWebsocket, CallZomeResponse, CreateCloneCellResponse, DisableCloneCellResponse, EnableCloneCellResponse } from "../index.js";
-import { AppAgentCallZomeRequest, AppAgentClient, AppAgentEvents, AppCreateCloneCellRequest, AppDisableCloneCellRequest, AppEnableCloneCellRequest } from "./types.js";
+import { AppInfo } from "../admin/types.js";
+import { AppSignalCb, CallZomeResponse, CreateCloneCellResponse, DisableCloneCellResponse, EnableCloneCellResponse, NetworkInfoResponse } from "../app/types.js";
+import { AppWebsocket } from "../app/websocket.js";
+import { AppAgentCallZomeRequest, AppAgentClient, AppAgentEvents, AppAgentNetworkInfoRequest, AppCreateCloneCellRequest, AppDisableCloneCellRequest, AppEnableCloneCellRequest } from "./types.js";
 /**
  * A class to establish a websocket connection to an App interface, for a
  * specific agent and app.
@@ -29,7 +31,7 @@ export declare class AppAgentWebsocket implements AppAgentClient {
      * @param defaultTimeout - Timeout to default to for all operations.
      * @returns A new instance of an AppAgentWebsocket.
      */
-    static connect(url: string, installed_app_id: InstalledAppId, defaultTimeout?: number): Promise<AppAgentWebsocket>;
+    static connect(url: URL, installed_app_id: InstalledAppId, defaultTimeout?: number): Promise<AppAgentWebsocket>;
     /**
      * Get a cell id by its role name or clone id.
      *
@@ -66,6 +68,12 @@ export declare class AppAgentWebsocket implements AppAgentClient {
      * @param args - Specify the clone cell to disable.
      */
     disableCloneCell(args: AppDisableCloneCellRequest): Promise<DisableCloneCellResponse>;
+    /**
+     * Request network info about gossip status.
+     *  @param args - Specify the DNAs for which you want network info
+     *  @returns Network info for the specified DNAs
+     */
+    networkInfo(args: AppAgentNetworkInfoRequest): Promise<NetworkInfoResponse>;
     /**
      * Register an event listener for signals.
      *

package/lib/api/app-agent/websocket.js

@@ -1,8 +1,9 @@
 import Emittery from "emittery";
 import { omit } from "lodash-es";
 import { getLauncherEnvironment } from "../../environments/launcher.js";
+import { CellType } from "../admin/types.js";
+import { AppWebsocket } from "../app/websocket.js";
 import { getBaseRoleNameFromCloneId, isCloneId } from "../common.js";
-import { AppWebsocket, CellType, } from "../index.js";
 /**
  * A class to establish a websocket connection to an App interface, for a
  * specific agent and app.
@@ -18,6 +19,15 @@ export class AppAgentWebsocket {
     constructor(appWebsocket, installedAppId, myPubKey) {
         this.appWebsocket = appWebsocket;
         this.emitter = new Emittery();
+        // Ensure all super methods are bound to this instance because Emittery relies on `this` being the instance.
+        // Please retain until the upstream is fixed https://github.com/sindresorhus/emittery/issues/86.
+        Object.getOwnPropertyNames(Emittery.prototype).forEach((name) => {
+            const to_bind = this.emitter[name];
+            if (typeof to_bind === "function") {
+                this.emitter[name] =
+                    to_bind.bind(this.emitter);
+            }
+        });
         const env = getLauncherEnvironment();
         this.installedAppId = env?.INSTALLED_APP_ID || installedAppId;
         this.myPubKey = myPubKey;
@@ -92,12 +102,7 @@ export class AppAgentWebsocket {
      * @returns The zome call's response.
      */
     async callZome(request, timeout) {
-        if ("provenance" in request) {
-            if ("role_name" in request && request.role_name) {
-                throw new Error("Cannot find other agent's cells based on role name. Use cell id when providing a provenance.");
-            }
-        }
-        else {
+        if (!("provenance" in request)) {
             request = {
                 ...request,
                 provenance: this.myPubKey,
@@ -155,6 +160,17 @@ export class AppAgentWebsocket {
             ...args,
         });
     }
+    /**
+     * Request network info about gossip status.
+     *  @param args - Specify the DNAs for which you want network info
+     *  @returns Network info for the specified DNAs
+     */
+    async networkInfo(args) {
+        return this.appWebsocket.networkInfo({
+            ...args,
+            agent_pub_key: this.myPubKey,
+        });
+    }
     /**
      * Register an event listener for signals.
      *

package/lib/api/client.d.ts

@@ -1,30 +1,28 @@
 /// <reference types="ws" />
-import { decode } from "@msgpack/msgpack";
 import Emittery from "emittery";
-import Websocket from "isomorphic-ws";
+import IsoWebSocket from "isomorphic-ws";
 /**
- * A Websocket client which can make requests and receive responses,
+ * A WebSocket client which can make requests and receive responses,
  * as well as send and receive signals.
  *
- * Uses Holochain's websocket WireMessage for communication.
+ * Uses Holochain's WireMessage for communication.
  *
  * @public
  */
 export declare class WsClient extends Emittery {
-    socket: Websocket;
-    pendingRequests: Record<number, {
-        resolve: (msg: unknown) => ReturnType<typeof decode>;
-        reject: (error: Error) => void;
-    }>;
-    index: number;
-    constructor(socket: Websocket);
+    socket: IsoWebSocket;
+    url: URL | undefined;
+    private pendingRequests;
+    private index;
+    constructor(socket: IsoWebSocket, url: URL);
+    private setupSocket;
     /**
      * Instance factory for creating WsClients.
      *
-     * @param url - The `ws://` URL to connect to.
+     * @param url - The WebSocket URL to connect to.
      * @returns An new instance of the WsClient.
      */
-    static connect(url: string): Promise<WsClient>;
+    static connect(url: URL): Promise<WsClient>;
     /**
      * Sends data as a signal.
      *
@@ -37,10 +35,12 @@ export declare class WsClient extends Emittery {
      * @param request - The request to send over the websocket.
      * @returns
      */
-    request<Req, Res>(request: Req): Promise<Res>;
+    request<Response>(request: unknown): Promise<Response>;
+    private sendMessage;
     private handleResponse;
     /**
      * Close the websocket connection.
      */
-    close(code?: number): Promise<void>;
+    close(code?: number): Promise<CloseEvent>;
 }
+export { IsoWebSocket };