@holochain/client 0.12.4 → 0.13.0

package/README.md

@@ -12,6 +12,11 @@ A JavaScript client for the Holochain Conductor API (works with browsers as well
 
 [Complete API reference](./docs/client.md)
 
+## Compatibility
+
+**JS client v0.12.x** is compatible with **Holochain v0.1.x**.
+**JS client v0.13.x** is compatible with **Holochain v0.2.x**.
+
 ## Installation
 
 To install from NPM, run

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

@@ -252,6 +252,16 @@ export declare type UninstallAppRequest = {
  * @public
  */
 export declare type UninstallAppResponse = null;
+/**
+ * @public
+ */
+export declare type UpdateCoordinatorsRequest = {
+    dna_hash: DnaHash;
+} & CoordinatorSource;
+/**
+ * @public
+ */
+export declare type UpdateCoordinatorsResponse = void;
 /**
  * @public
  */
@@ -500,13 +510,41 @@ export declare type InstallAppDnaPayload = {
  * @public
  */
 export declare type ZomeLocation = Location;
+/**
+ * @public
+ */
+export interface ZomeDependency {
+    name: ZomeName;
+}
 /**
  * @public
  */
 export declare 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 declare type CoordinatorSource = {
+    path: string;
+} | {
+    bundle: CoordinatorBundle;
+};
 /**
  * @public
  */
@@ -624,6 +662,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 declare type StorageInfoRequest = void;
+/**
+ * @public
+ */
+export declare type StorageInfoResponse = StorageInfo;
+/**
+ * @public
+ */
+export declare type DumpNetworkStatsRequest = void;
+/**
+ * @public
+ */
+export declare type DumpNetworkStatsResponse = string;
 /**
  * @public
  */
@@ -646,4 +724,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.
  *
@@ -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

@@ -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.

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

@@ -92,12 +92,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,

package/lib/api/client.js

@@ -64,16 +64,16 @@ export class WsClient extends Emittery {
                 console.error(`Got unrecognized Websocket message type: ${message.type}`);
             }
         };
-        socket.on("close", (event) => {
+        socket.onclose = (event) => {
             const pendingRequestIds = Object.keys(this.pendingRequests).map((id) => parseInt(id));
             if (pendingRequestIds.length) {
                 pendingRequestIds.forEach((id) => {
-                    const error = new Error(`Websocket closed with pending requests. Close event: ${event}, request id: ${id}`);
+                    const error = new Error(`Websocket 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.

package/lib/types.d.ts

@@ -78,7 +78,7 @@ export declare type CellId = [DnaHash, AgentPubKey];
 /**
  * @public
  */
-export declare type DnaProperties = any;
+export declare type DnaProperties = unknown;
 /**
  * @public
  */
@@ -113,6 +113,11 @@ export interface HoloHashed<T> {
  */
 export interface NetworkInfo {
     fetch_pool_info: FetchPoolInfo;
+    current_number_of_peers: number;
+    arc_size: number;
+    total_network_peers: number;
+    bytes_since_last_time_queried: number;
+    completed_rounds_since_last_time_queried: number;
 }
 /**
  * @public

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@holochain/client",
-  "version": "0.12.4",
+  "version": "0.13.0",
   "description": "A JavaScript client for the Holochain Conductor API",
   "author": "Holochain Foundation <info@holochain.org> (http://holochain.org)",
   "license": "CAL-1.0",