@holochain/client 0.18.0-dev.8 → 0.18.0-rc.0

package/README.md

@@ -179,8 +179,9 @@ You need `holochain` and `hc` on your path, best to get them from nix with `nix-
 
 To perform the pre-requisite DNA compilation steps, and run the Nodejs test, run:
 ```bash
-nix-shell
-./run-test.sh
+nix develop
+./build-fixture.sh
+npm run test
 ```
 
 ## Contribute

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

@@ -180,6 +180,22 @@ export type GenerateAgentPubKeyRequest = void;
  * @public
  */
 export type GenerateAgentPubKeyResponse = AgentPubKey;
+/**
+ * @public
+ */
+export type RevokeAgentKeyRequest = {
+    agent_key: AgentPubKey;
+    app_id: InstalledAppId;
+};
+/**
+ * Contains a list of errors of the cells where deletion was unsuccessful.
+ *
+ * If the key could not be deleted from all cells, the call
+ * {@link RevokeAgentKeyRequest} can be re-attempted to delete the key from the remaining cells.
+ *
+ * @public
+ */
+export type RevokeAgentKeyResponse = Array<[CellId, string]>;
 /**
  * @public
  */
@@ -398,8 +414,11 @@ export type NetworkSeed = string;
 export type InstallAppRequest = {
     /**
      * The agent to use when creating Cells for this App.
+     * If not specified, a new agent will be generated by Holochain.
+     * If DPKI is enabled (default), and the agent key is not specified here,
+     * a new agent key will be derived from the DPKI device seed and registered with DPKI.
      */
-    agent_key: AgentPubKey;
+    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.
@@ -523,7 +542,7 @@ export interface DeleteCloneCellRequest {
     /**
      * The clone id or cell id of the clone cell
      */
-    clone_cell_id: RoleName | CellId;
+    clone_cell_id: RoleName | DnaHash;
 }
 /**
  * @public

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

@@ -2,7 +2,7 @@ import { CapSecret, GrantedFunctions } from "../../hdk/index.js";
 import type { AgentPubKey, CellId } from "../../types.js";
 import { WsClient } from "../client.js";
 import { Requester, Transformer, WebsocketConnectionOptions } from "../common.js";
-import { AddAgentInfoRequest, AddAgentInfoResponse, AdminApi, AgentInfoRequest, AgentInfoResponse, AttachAppInterfaceRequest, AttachAppInterfaceResponse, DeleteCloneCellRequest, DeleteCloneCellResponse, DisableAppRequest, DisableAppResponse, DumpFullStateRequest, DumpFullStateResponse, DumpNetworkStatsRequest, DumpNetworkStatsResponse, DumpStateRequest, DumpStateResponse, EnableAppRequest, EnableAppResponse, GenerateAgentPubKeyRequest, GenerateAgentPubKeyResponse, GetCompatibleCellsRequest, GetCompatibleCellsResponse, GetDnaDefinitionRequest, GetDnaDefinitionResponse, GrantZomeCallCapabilityRequest, GrantZomeCallCapabilityResponse, InstallAppRequest, InstallAppResponse, IssueAppAuthenticationTokenRequest, IssueAppAuthenticationTokenResponse, ListAppInterfacesRequest, ListAppInterfacesResponse, ListAppsRequest, ListAppsResponse, ListCellIdsRequest, ListCellIdsResponse, ListDnasRequest, ListDnasResponse, RegisterDnaRequest, RegisterDnaResponse, StorageInfoRequest, StorageInfoResponse, UninstallAppRequest, UninstallAppResponse, UpdateCoordinatorsRequest, UpdateCoordinatorsResponse } 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, GetCompatibleCellsRequest, GetCompatibleCellsResponse, GetDnaDefinitionRequest, GetDnaDefinitionResponse, GrantZomeCallCapabilityRequest, GrantZomeCallCapabilityResponse, InstallAppRequest, InstallAppResponse, IssueAppAuthenticationTokenRequest, IssueAppAuthenticationTokenResponse, ListAppInterfacesRequest, ListAppInterfacesResponse, ListAppsRequest, ListAppsResponse, ListCellIdsRequest, ListCellIdsResponse, ListDnasRequest, ListDnasResponse, RegisterDnaRequest, RegisterDnaResponse, RevokeAgentKeyRequest, RevokeAgentKeyResponse, StorageInfoRequest, StorageInfoResponse, UninstallAppRequest, UninstallAppResponse, UpdateCoordinatorsRequest, UpdateCoordinatorsResponse } from "./types.js";
 /**
  * A class for interacting with a conductor's Admin API.
  *
@@ -51,6 +51,10 @@ export declare class AdminWebsocket implements AdminApi {
      * Generate a new agent pub key.
      */
     generateAgentPubKey: Requester<GenerateAgentPubKeyRequest, GenerateAgentPubKeyResponse>;
+    /**
+     * Generate a new agent pub key.
+     */
+    revokeAgentKey: Requester<RevokeAgentKeyRequest, RevokeAgentKeyResponse>;
     /**
      * Register a DNA for later app installation.
      *

package/lib/api/admin/websocket.js

@@ -68,6 +68,10 @@ export class AdminWebsocket {
      * Generate a new agent pub key.
      */
     generateAgentPubKey = this._requester("generate_agent_pub_key");
+    /**
+     * Generate a new agent pub key.
+     */
+    revokeAgentKey = this._requester("revoke_agent_key");
     /**
      * Register a DNA for later app installation.
      *

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

@@ -1,5 +1,5 @@
 import { UnsubscribeFunction } from "emittery";
-import { AgentPubKey, AppAuthenticationToken, AppInfo, CapSecret, CellId, ClonedCell, DnaHash, DnaProperties, FunctionName, InstalledAppId, MembraneProof, MemproofMap, NetworkInfo, NetworkSeed, Nonce256Bit, RoleName, Timestamp, Transformer, WebsocketConnectionOptions, ZomeName } from "../../index.js";
+import { AgentPubKey, AppAuthenticationToken, AppInfo, CapSecret, CellId, ClonedCell, DnaHash, DnaProperties, EntryHash, FunctionName, InstalledAppId, MembraneProof, MemproofMap, NetworkInfo, NetworkSeed, Nonce256Bit, RoleName, Timestamp, Transformer, WebsocketConnectionOptions, ZomeName } from "../../index.js";
 /**
  * @public
  */
@@ -40,7 +40,7 @@ export type AppNetworkInfoRequest = Omit<NetworkInfoRequest, "agent_pub_key">;
  * @public
  */
 export interface AppEvents {
-    signal: AppSignal;
+    signal: Signal;
 }
 /**
  * @public
@@ -152,7 +152,7 @@ export interface DisableCloneCellRequest {
     /**
      * The clone id or cell id of the clone cell
      */
-    clone_cell_id: RoleName | CellId;
+    clone_cell_id: RoleName | DnaHash;
 }
 /**
  * @public
@@ -193,10 +193,18 @@ export declare const SignalType: {
 /**
  * @public
  */
-export type Signal = {
+export type RawSignal = {
     [SignalType.App]: EncodedAppSignal;
 } | {
-    [SignalType.System]: unknown;
+    [SignalType.System]: SystemSignal;
+};
+/**
+ * @public
+ */
+export type Signal = {
+    [SignalType.App]: AppSignal;
+} | {
+    [SignalType.System]: SystemSignal;
 };
 /**
  * @public
@@ -217,7 +225,13 @@ export type AppSignal = {
 /**
  * @public
  */
-export type AppSignalCb = (signal: AppSignal) => void;
+export type SystemSignal = {
+    SuccessfulCountersigning: EntryHash;
+};
+/**
+ * @public
+ */
+export type SignalCb = (signal: Signal) => void;
 /**
  * @public
  */
@@ -227,7 +241,7 @@ export type NetworkInfoResponse = NetworkInfo[];
  */
 export interface AppClient {
     callZome(args: AppCallZomeRequest, timeout?: number): Promise<any>;
-    on<Name extends keyof AppEvents>(eventName: Name | readonly Name[], listener: AppSignalCb): UnsubscribeFunction;
+    on<Name extends keyof AppEvents>(eventName: Name | readonly Name[], listener: SignalCb): UnsubscribeFunction;
     appInfo(): Promise<AppInfoResponse>;
     myPubKey: AgentPubKey;
     installedAppId: InstalledAppId;

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

@@ -1,7 +1,7 @@
 import { UnsubscribeFunction } from "emittery";
 import { AgentPubKey, CellId, InstalledAppId, RoleName } from "../../types.js";
 import { AppInfo, MemproofMap } from "../admin/index.js";
-import { AppCallZomeRequest, AppClient, AppEvents, AppNetworkInfoRequest, AppCreateCloneCellRequest, AppDisableCloneCellRequest, AppEnableCloneCellRequest, AppSignalCb, CallZomeRequest, CallZomeRequestSigned, CallZomeResponse, CreateCloneCellResponse, DisableCloneCellResponse, EnableCloneCellResponse, NetworkInfoResponse, AppWebsocketConnectionOptions } from "./types.js";
+import { AppCallZomeRequest, AppClient, AppEvents, AppNetworkInfoRequest, AppCreateCloneCellRequest, AppDisableCloneCellRequest, AppEnableCloneCellRequest, SignalCb, CallZomeRequest, CallZomeRequestSigned, CallZomeResponse, CreateCloneCellResponse, DisableCloneCellResponse, EnableCloneCellResponse, NetworkInfoResponse, AppWebsocketConnectionOptions } from "./types.js";
 import { WsClient } from "../client.js";
 /**
  * A class to establish a websocket connection to an App interface, for a
@@ -16,6 +16,7 @@ export declare class AppWebsocket implements AppClient {
     private readonly defaultTimeout;
     private readonly emitter;
     private readonly callZomeTransform;
+    private readonly appAuthenticationToken;
     cachedAppInfo?: AppInfo | null;
     private readonly appInfoRequester;
     private readonly callZomeRequester;
@@ -101,9 +102,8 @@ export declare class AppWebsocket implements AppClient {
      * @param listener - The function to call when event is triggered.
      * @returns A function to unsubscribe the event listener.
      */
-    on<Name extends keyof AppEvents>(eventName: Name | readonly Name[], listener: AppSignalCb): UnsubscribeFunction;
+    on<Name extends keyof AppEvents>(eventName: Name | readonly Name[], listener: SignalCb): UnsubscribeFunction;
     private static requester;
-    private containsCell;
 }
 /**
  * @public

package/lib/api/app/websocket.js

@@ -1,6 +1,6 @@
 import Emittery from "emittery";
 import { omit } from "lodash-es";
-import { CellType } from "../admin/index.js";
+import { CellType, } from "../admin/index.js";
 import { catchError, DEFAULT_TIMEOUT, getBaseRoleNameFromCloneId, HolochainError, isCloneId, promiseTimeout, requesterTransformer, } from "../common.js";
 import { getHostZomeCallSigner, getLauncherEnvironment, } from "../../environments/launcher.js";
 import { decode, encode } from "@msgpack/msgpack";
@@ -22,6 +22,7 @@ export class AppWebsocket {
     defaultTimeout;
     emitter;
     callZomeTransform;
+    appAuthenticationToken;
     cachedAppInfo;
     appInfoRequester;
     callZomeRequester;
@@ -31,12 +32,13 @@ export class AppWebsocket {
     enableCloneCellRequester;
     disableCloneCellRequester;
     networkInfoRequester;
-    constructor(client, appInfo, callZomeTransform, defaultTimeout) {
+    constructor(client, appInfo, token, callZomeTransform, defaultTimeout) {
         this.client = client;
         this.myPubKey = appInfo.agent_pub_key;
         this.installedAppId = appInfo.installed_app_id;
         this.defaultTimeout = defaultTimeout ?? DEFAULT_TIMEOUT;
         this.callZomeTransform = callZomeTransform ?? defaultCallZomeTransform;
+        this.appAuthenticationToken = token;
         this.emitter = new Emittery();
         this.cachedAppInfo = appInfo;
         this.appInfoRequester = AppWebsocket.requester(this.client, "app_info", this.defaultTimeout);
@@ -57,9 +59,7 @@ export class AppWebsocket {
             }
         });
         this.client.on("signal", (signal) => {
-            if (this.containsCell(signal.cell_id)) {
-                this.emitter.emit("signal", signal).catch(console.error);
-            }
+            this.emitter.emit("signal", signal).catch(console.error);
         });
     }
     /**
@@ -79,21 +79,15 @@ export class AppWebsocket {
             throw new HolochainError("ConnectionUrlMissing", `unable to connect to Conductor API - no url provided and not in a launcher environment.`);
         }
         const client = await WsClient.connect(options.url, options.wsClientOptions);
-        if (env?.APP_INTERFACE_TOKEN) {
-            // Note: This will only work for multiple connections if a single_use = false token is provided
-            await client.authenticate({ token: env.APP_INTERFACE_TOKEN });
-        }
-        else {
-            if (!options.token) {
-                throw new HolochainError("AppAuthenticationTokenMissing", `unable to connect to Conductor API - no app authentication token provided.`);
-            }
-            await client.authenticate({ token: options.token });
-        }
+        const token = options.token ?? env?.APP_INTERFACE_TOKEN;
+        if (!token)
+            throw new HolochainError("AppAuthenticationTokenMissing", `unable to connect to Conductor API - no app authentication token provided.`);
+        await client.authenticate({ token });
         const appInfo = await AppWebsocket.requester(client, "app_info", DEFAULT_TIMEOUT)(null);
         if (!appInfo) {
             throw new HolochainError("AppNotFound", `The app your connection token was issued for was not found. The app needs to be installed and enabled.`);
         }
-        return new AppWebsocket(client, appInfo, options.callZomeTransform, options.defaultTimeout);
+        return new AppWebsocket(client, appInfo, token, options.callZomeTransform, options.defaultTimeout);
     }
     /**
      * Request the app's info, including all cell infos.
@@ -239,25 +233,6 @@ export class AppWebsocket {
     static requester(client, tag, defaultTimeout, transformer) {
         return requesterTransformer((req, timeout) => promiseTimeout(client.request(req), tag, timeout || defaultTimeout).then(catchError), tag, transformer);
     }
-    containsCell(cellId) {
-        const appInfo = this.cachedAppInfo;
-        if (!appInfo) {
-            return false;
-        }
-        for (const roleName of Object.keys(appInfo.cell_info)) {
-            for (const cellInfo of appInfo.cell_info[roleName]) {
-                const currentCellId = CellType.Provisioned in cellInfo
-                    ? cellInfo[CellType.Provisioned].cell_id
-                    : CellType.Cloned in cellInfo
-                        ? cellInfo[CellType.Cloned].cell_id
-                        : undefined;
-                if (currentCellId && isSameCell(currentCellId, cellId)) {
-                    return true;
-                }
-            }
-        }
-        return false;
-    }
 }
 const defaultCallZomeTransform = {
     input: async (request) => {

package/lib/api/client.d.ts

@@ -23,8 +23,8 @@ export declare class WsClient extends Emittery {
     options: WsClientOptions;
     private pendingRequests;
     private index;
+    private authenticationToken;
     constructor(socket: IsoWebSocket, url?: URL, options?: WsClientOptions);
-    private setupSocket;
     /**
      * Instance factory for creating WsClients.
      *
@@ -47,6 +47,10 @@ export declare class WsClient extends Emittery {
      * @param request - The authentication request, containing an app authentication token.
      */
     authenticate(request: AppAuthenticationRequest): Promise<void>;
+    /**
+     * Close the websocket connection.
+     */
+    close(code?: number): Promise<IsoWebSocket.CloseEvent>;
     /**
      * Send requests to the connected websocket.
      *
@@ -56,10 +60,9 @@ export declare class WsClient extends Emittery {
     request<Response>(request: unknown): Promise<Response>;
     private exchange;
     private sendMessage;
+    private registerMessageListener;
+    private registerCloseListener;
+    private reconnectWebsocket;
     private handleResponse;
-    /**
-     * Close the websocket connection.
-     */
-    close(code?: number): Promise<CloseEvent>;
 }
 export { IsoWebSocket };

package/lib/api/client.js

@@ -17,71 +17,16 @@ export class WsClient extends Emittery {
     options;
     pendingRequests;
     index;
+    authenticationToken;
     constructor(socket, url, options) {
         super();
+        this.registerMessageListener(socket);
+        this.registerCloseListener(socket);
         this.socket = socket;
         this.url = url;
         this.options = options || {};
         this.pendingRequests = {};
         this.index = 0;
-        this.setupSocket();
-    }
-    setupSocket() {
-        this.socket.onmessage = async (serializedMessage) => {
-            // If data is not a buffer (nodejs), it will be a blob (browser)
-            let deserializedData;
-            if (globalThis.window &&
-                serializedMessage.data instanceof globalThis.window.Blob) {
-                deserializedData = await serializedMessage.data.arrayBuffer();
-            }
-            else {
-                if (typeof Buffer !== "undefined" &&
-                    Buffer.isBuffer(serializedMessage.data)) {
-                    deserializedData = serializedMessage.data;
-                }
-                else {
-                    throw new HolochainError("UnknownMessageFormat", `incoming message has unknown message format - ${deserializedData}`);
-                }
-            }
-            const message = decode(deserializedData);
-            assertHolochainMessage(message);
-            if (message.type === "signal") {
-                if (message.data === null) {
-                    throw new HolochainError("UnknownSignalFormat", "incoming signal has no data");
-                }
-                const deserializedSignal = decode(message.data);
-                assertHolochainSignal(deserializedSignal);
-                if (SignalType.System in deserializedSignal) {
-                    // We have received a system signal, do nothing
-                    return;
-                }
-                const encodedAppSignal = deserializedSignal[SignalType.App];
-                // In order to return readable content to the UI, the signal payload must also be deserialized.
-                const payload = decode(encodedAppSignal.signal);
-                const signal = {
-                    cell_id: encodedAppSignal.cell_id,
-                    zome_name: encodedAppSignal.zome_name,
-                    payload,
-                };
-                this.emit("signal", signal);
-            }
-            else if (message.type === "response") {
-                this.handleResponse(message);
-            }
-            else {
-                throw new HolochainError("UnknownMessageType", `incoming message has unknown type - ${message.type}`);
-            }
-        };
-        this.socket.onclose = (event) => {
-            const pendingRequestIds = Object.keys(this.pendingRequests).map((id) => parseInt(id));
-            if (pendingRequestIds.length) {
-                pendingRequestIds.forEach((id) => {
-                    const error = new HolochainError("ClientClosedWithPendingRequests", `client closed with pending requests - close event code: ${event.code}, request id: ${id}`);
-                    this.pendingRequests[id].reject(error);
-                    delete this.pendingRequests[id];
-                });
-            }
-        };
     }
     /**
      * Instance factory for creating WsClients.
@@ -93,13 +38,13 @@ export class WsClient extends Emittery {
     static connect(url, options) {
         return new Promise((resolve, reject) => {
             const socket = new IsoWebSocket(url, options);
-            socket.onerror = (errorEvent) => {
+            socket.addEventListener("error", (errorEvent) => {
                 reject(new HolochainError("ConnectionError", `could not connect to Holochain Conductor API at ${url} - ${errorEvent.error}`));
-            };
-            socket.onopen = () => {
+            });
+            socket.addEventListener("open", (_) => {
                 const client = new WsClient(socket, url, options);
                 resolve(client);
-            };
+            }, { once: true });
         });
     }
     /**
@@ -122,16 +67,35 @@ export class WsClient extends Emittery {
      * @param request - The authentication request, containing an app authentication token.
      */
     async authenticate(request) {
-        return this.exchange(request, (request, resolve) => {
+        this.authenticationToken = request.token;
+        return this.exchange(request, (request, resolve, reject) => {
+            const invalidTokenCloseListener = (closeEvent) => {
+                this.authenticationToken = undefined;
+                reject(new HolochainError("InvalidTokenError", `could not connect to ${this.url} due to an invalid app authentication token - close code ${closeEvent.code}`));
+            };
+            this.socket.addEventListener("close", invalidTokenCloseListener, {
+                once: true,
+            });
             const encodedMsg = encode({
                 type: "authenticate",
                 data: encode(request),
             });
             this.socket.send(encodedMsg);
-            // Message just needs to be sent first, no need to wait for a response or even require a flush
-            resolve(null);
+            // Wait before resolving in case authentication fails.
+            setTimeout(() => {
+                this.socket.removeEventListener("close", invalidTokenCloseListener);
+                resolve(null);
+            }, 10);
         });
     }
+    /**
+     * Close the websocket connection.
+     */
+    close(code = 1000) {
+        const closedPromise = new Promise((resolve) => this.socket.addEventListener("close", (closeEvent) => resolve(closeEvent), { once: true }));
+        this.socket.close(code);
+        return closedPromise;
+    }
     /**
      * Send requests to the connected websocket.
      *
@@ -141,15 +105,22 @@ export class WsClient extends Emittery {
     async request(request) {
         return this.exchange(request, this.sendMessage.bind(this));
     }
-    exchange(request, sendHandler) {
+    async exchange(request, sendHandler) {
         if (this.socket.readyState === this.socket.OPEN) {
             const promise = new Promise((resolve, reject) => {
                 sendHandler(request, resolve, reject);
             });
             return promise;
         }
+        else if (this.url && this.authenticationToken) {
+            await this.reconnectWebsocket(this.url, this.authenticationToken);
+            this.registerMessageListener(this.socket);
+            this.registerCloseListener(this.socket);
+            const promise = new Promise((resolve, reject) => sendHandler(request, resolve, reject));
+            return promise;
+        }
         else {
-            return Promise.reject(new Error("Socket is not open"));
+            return Promise.reject(new HolochainError("WebsocketClosedError", "Websocket is not open"));
         }
     }
     sendMessage(request, resolve, reject) {
@@ -163,6 +134,97 @@ export class WsClient extends Emittery {
         this.pendingRequests[id] = { resolve, reject };
         this.index += 1;
     }
+    registerMessageListener(socket) {
+        socket.onmessage = async (serializedMessage) => {
+            // If data is not a buffer (nodejs), it will be a blob (browser)
+            let deserializedData;
+            if (globalThis.window &&
+                serializedMessage.data instanceof globalThis.window.Blob) {
+                deserializedData = await serializedMessage.data.arrayBuffer();
+            }
+            else {
+                if (typeof Buffer !== "undefined" &&
+                    Buffer.isBuffer(serializedMessage.data)) {
+                    deserializedData = serializedMessage.data;
+                }
+                else {
+                    throw new HolochainError("UnknownMessageFormat", `incoming message has unknown message format - ${deserializedData}`);
+                }
+            }
+            const message = decode(deserializedData);
+            assertHolochainMessage(message);
+            if (message.type === "signal") {
+                if (message.data === null) {
+                    throw new HolochainError("UnknownSignalFormat", "incoming signal has no data");
+                }
+                const deserializedSignal = decode(message.data);
+                assertHolochainSignal(deserializedSignal);
+                if (SignalType.System in deserializedSignal) {
+                    this.emit("signal", {
+                        System: deserializedSignal[SignalType.System],
+                    });
+                }
+                else {
+                    const encodedAppSignal = deserializedSignal[SignalType.App];
+                    // In order to return readable content to the UI, the signal payload must also be deserialized.
+                    const payload = decode(encodedAppSignal.signal);
+                    const signal = {
+                        cell_id: encodedAppSignal.cell_id,
+                        zome_name: encodedAppSignal.zome_name,
+                        payload,
+                    };
+                    this.emit("signal", { App: signal });
+                }
+            }
+            else if (message.type === "response") {
+                this.handleResponse(message);
+            }
+            else {
+                throw new HolochainError("UnknownMessageType", `incoming message has unknown type - ${message.type}`);
+            }
+        };
+    }
+    registerCloseListener(socket) {
+        socket.addEventListener("close", (closeEvent) => {
+            const pendingRequestIds = Object.keys(this.pendingRequests).map((id) => parseInt(id));
+            if (pendingRequestIds.length) {
+                pendingRequestIds.forEach((id) => {
+                    const error = new HolochainError("ClientClosedWithPendingRequests", `client closed with pending requests - close event code: ${closeEvent.code}, request id: ${id}`);
+                    this.pendingRequests[id].reject(error);
+                    delete this.pendingRequests[id];
+                });
+            }
+        }, { once: true });
+    }
+    async reconnectWebsocket(url, token) {
+        return new Promise((resolve, reject) => {
+            this.socket = new IsoWebSocket(url, this.options);
+            // This error event never occurs in tests. Could be removed?
+            this.socket.addEventListener("error", (errorEvent) => {
+                this.authenticationToken = undefined;
+                reject(new HolochainError("ConnectionError", `could not connect to Holochain Conductor API at ${url} - ${errorEvent.message}`));
+            }, { once: true });
+            const invalidTokenCloseListener = (closeEvent) => {
+                this.authenticationToken = undefined;
+                reject(new HolochainError("InvalidTokenError", `could not connect to ${this.url} due to an invalid app authentication token - close code ${closeEvent.code}`));
+            };
+            this.socket.addEventListener("close", invalidTokenCloseListener, {
+                once: true,
+            });
+            this.socket.addEventListener("open", async (_) => {
+                const encodedMsg = encode({
+                    type: "authenticate",
+                    data: encode({ token }),
+                });
+                this.socket.send(encodedMsg);
+                // Wait in case authentication fails.
+                setTimeout(() => {
+                    this.socket.removeEventListener("close", invalidTokenCloseListener);
+                    resolve();
+                }, 10);
+            }, { once: true });
+        });
+    }
     handleResponse(msg) {
         const id = msg.id;
         if (this.pendingRequests[id]) {
@@ -178,20 +240,6 @@ export class WsClient extends Emittery {
             console.error(`got response with no matching request. id = ${id} msg = ${msg}`);
         }
     }
-    /**
-     * Close the websocket connection.
-     */
-    close(code = 1000) {
-        const closedPromise = new Promise((resolve) => 
-        // for an unknown reason "addEventListener" is seen as a non-callable
-        // property and gives a ts2349 error
-        // type assertion as workaround
-        this.socket.addEventListener("close", (event) => resolve(event))
-        // }
-        );
-        this.socket.close(code);
-        return closedPromise;
-    }
 }
 function assertHolochainMessage(message) {
     if (typeof message === "object" &&

package/lib/api/common.js

@@ -52,6 +52,7 @@ export const promiseTimeout = (promise, tag, ms) => {
         return res(a);
     })
         .catch((e) => {
+        clearTimeout(id);
         return rej(e);
     }));
 };

package/lib/hdk/countersigning.d.ts

@@ -18,6 +18,23 @@ export interface PreflightRequest {
     action_base: ActionBase;
     preflight_bytes: PreflightBytes;
 }
+/**
+ * @public
+ */
+export interface PreflightResponse {
+    /**
+     * The request associated with this response.
+     */
+    request: PreflightRequest;
+    /**
+     * The chain state declaration for the agent that produced this response.
+     */
+    agent_state: CountersigningAgentState;
+    /**
+     * The signature of this response, by the agent that created it.
+     */
+    signature: Signature;
+}
 /**
  * @public
  */

package/lib/tsdoc-metadata.json

@@ -5,7 +5,7 @@
   "toolPackages": [
     {
       "packageName": "@microsoft/api-extractor",
-      "packageVersion": "7.47.0"
+      "packageVersion": "7.47.11"
     }
   ]
 }

package/lib/utils/cell.d.ts

@@ -0,0 +1,11 @@
+import { CellId } from "../types.js";
+/**
+ * Check if two cell ids are identical.
+ *
+ * @param cellId1 - Cell id 1 to compare.
+ * @param cellId2 - Cell id 1 to compare.
+ * @returns True if the cell ids are identical.
+ *
+ * @public
+ */
+export declare const isSameCell: (cellId1: CellId, cellId2: CellId) => boolean;

package/lib/utils/cell.js

@@ -0,0 +1,17 @@
+import { encodeHashToBase64 } from "./base64.js";
+/**
+ * Check if two cell ids are identical.
+ *
+ * @param cellId1 - Cell id 1 to compare.
+ * @param cellId2 - Cell id 1 to compare.
+ * @returns True if the cell ids are identical.
+ *
+ * @public
+ */
+export const isSameCell = (cellId1, cellId2) => {
+    const dnaHashB64_1 = encodeHashToBase64(cellId1[0]);
+    const agentPubKeyB64_1 = encodeHashToBase64(cellId1[1]);
+    const dnaHashB64_2 = encodeHashToBase64(cellId2[0]);
+    const agentPubKeyB64_2 = encodeHashToBase64(cellId2[1]);
+    return dnaHashB64_1 === dnaHashB64_2 && agentPubKeyB64_1 === agentPubKeyB64_2;
+};

package/lib/utils/index.d.ts

@@ -1,3 +1,4 @@
 export * from "./base64.js";
 export * from "./fake-hash.js";
 export * from "./hash-parts.js";
+export * from "./cell.js";

package/lib/utils/index.js

@@ -1,3 +1,4 @@
 export * from "./base64.js";
 export * from "./fake-hash.js";
 export * from "./hash-parts.js";
+export * from "./cell.js";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@holochain/client",
-  "version": "0.18.0-dev.8",
+  "version": "0.18.0-rc.0",
   "description": "A JavaScript client for the Holochain Conductor API",
   "author": "Holochain Foundation <info@holochain.org> (https://holochain.org)",
   "license": "CAL-1.0",
@@ -72,4 +72,4 @@
     "tsx": "^4.7.2",
     "typescript": "^4.9.5"
   }
-}
+}