@holochain/client 0.12.5 → 0.14.0

package/README.md

@@ -1,7 +1,8 @@
 [![Project](https://img.shields.io/badge/Project-Holochain-blue.svg?style=flat-square)](http://holochain.org/)
 [![Discord](https://img.shields.io/badge/Discord-DEV.HC-blue.svg?style=flat-square)](https://discord.gg/k55DS5dmPH)
 [![License: CAL 1.0](https://img.shields.io/badge/License-CAL%201.0-blue.svg)](https://github.com/holochain/cryptographic-autonomy-license)
-![Test](https://github.com/holochain/holochain-client-js/actions/workflows/test.yml/badge.svg?branch=main)
+![Integration Tests](https://github.com/holochain/holochain-client-js/actions/workflows/integration-test.yml/badge.svg?branch=main)
+![Bundling Tests](https://github.com/holochain/holochain-client-js/actions/workflows/bundling-test.yml/badge.svg?branch=main)
 [![Twitter Follow](https://img.shields.io/twitter/follow/holochain.svg?style=social&label=Follow)](https://twitter.com/holochain)
 
 # Holochain Client - JavaScript
@@ -12,6 +13,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

@@ -6,32 +6,32 @@ import { DisableCloneCellRequest } from "../index.js";
 /**
  * @public
  */
-export declare type AttachAppInterfaceRequest = {
+export type AttachAppInterfaceRequest = {
     port: number;
 };
 /**
  * @public
  */
-export declare type AttachAppInterfaceResponse = {
+export type AttachAppInterfaceResponse = {
     port: number;
 };
 /**
  * @public
  */
-export declare type EnableAppRequest = {
+export type EnableAppRequest = {
     installed_app_id: InstalledAppId;
 };
 /**
  * @public
  */
-export declare type EnableAppResponse = {
+export type EnableAppResponse = {
     app: AppInfo;
     errors: Array<[CellId, string]>;
 };
 /**
  * @public
  */
-export declare type DeactivationReason = {
+export type DeactivationReason = {
     never_activated: null;
 } | {
     normal: null;
@@ -43,13 +43,13 @@ export declare type DeactivationReason = {
 /**
  * @public
  */
-export declare type PausedAppReason = {
+export type PausedAppReason = {
     error: string;
 };
 /**
  * @public
  */
-export declare type DisabledAppReason = {
+export type DisabledAppReason = {
     never_started: null;
 } | {
     user: null;
@@ -59,7 +59,7 @@ export declare type DisabledAppReason = {
 /**
  * @public
  */
-export declare type InstalledAppInfoStatus = {
+export type InstalledAppInfoStatus = {
     paused: {
         reason: PausedAppReason;
     };
@@ -108,7 +108,7 @@ export declare enum CellType {
 /**
  * @public
  */
-export declare type CellInfo = {
+export type CellInfo = {
     [CellType.Provisioned]: ProvisionedCell;
 } | {
     [CellType.Cloned]: ClonedCell;
@@ -118,7 +118,7 @@ export declare type CellInfo = {
 /**
  * @public
  */
-export declare type AppInfo = {
+export type AppInfo = {
     agent_pub_key: AgentPubKey;
     installed_app_id: InstalledAppId;
     cell_info: Record<RoleName, Array<CellInfo>>;
@@ -127,60 +127,60 @@ export declare type AppInfo = {
 /**
  * @public
  */
-export declare type MembraneProof = Buffer;
+export type MembraneProof = Buffer;
 /**
  * @public
  */
-export declare type DisableAppRequest = {
+export type DisableAppRequest = {
     installed_app_id: InstalledAppId;
 };
 /**
  * @public
  */
-export declare type DisableAppResponse = null;
+export type DisableAppResponse = null;
 /**
  * @public
  */
-export declare type StartAppRequest = {
+export type StartAppRequest = {
     installed_app_id: InstalledAppId;
 };
 /**
  * @public
  */
-export declare type StartAppResponse = boolean;
+export type StartAppResponse = boolean;
 /**
  * @public
  */
-export declare type DumpStateRequest = {
+export type DumpStateRequest = {
     cell_id: CellId;
 };
 /**
  * @public
  */
-export declare type DumpStateResponse = any;
+export type DumpStateResponse = any;
 /**
  * @public
  */
-export declare type DumpFullStateRequest = {
+export type DumpFullStateRequest = {
     cell_id: CellId;
     dht_ops_cursor: number | undefined;
 };
 /**
  * @public
  */
-export declare type DumpFullStateResponse = FullStateDump;
+export type DumpFullStateResponse = FullStateDump;
 /**
  * @public
  */
-export declare type GenerateAgentPubKeyRequest = void;
+export type GenerateAgentPubKeyRequest = void;
 /**
  * @public
  */
-export declare type GenerateAgentPubKeyResponse = AgentPubKey;
+export type GenerateAgentPubKeyResponse = AgentPubKey;
 /**
  * @public
  */
-export declare type RegisterDnaRequest = {
+export type RegisterDnaRequest = {
     modifiers?: {
         network_seed?: string;
         properties?: DnaProperties;
@@ -189,11 +189,11 @@ export declare type RegisterDnaRequest = {
 /**
  * @public
  */
-export declare type RegisterDnaResponse = HoloHash;
+export type RegisterDnaResponse = HoloHash;
 /**
  * @public
  */
-export declare type DnaModifiers = {
+export type DnaModifiers = {
     network_seed: NetworkSeed;
     properties: DnaProperties;
     origin_time: Timestamp;
@@ -202,15 +202,15 @@ export declare type DnaModifiers = {
 /**
  * @public
  */
-export declare type FunctionName = string;
+export type FunctionName = string;
 /**
  * @public
  */
-export declare type ZomeName = string;
+export type ZomeName = string;
 /**
  * @public
  */
-export declare type ZomeDefinition = [
+export type ZomeDefinition = [
     ZomeName,
     {
         wasm_hash: WasmHash;
@@ -220,15 +220,15 @@ export declare type ZomeDefinition = [
 /**
  * @public
  */
-export declare type IntegrityZome = ZomeDefinition;
+export type IntegrityZome = ZomeDefinition;
 /**
  * @public
  */
-export declare type CoordinatorZome = ZomeDefinition;
+export type CoordinatorZome = ZomeDefinition;
 /**
  * @public
  */
-export declare type DnaDefinition = {
+export type DnaDefinition = {
     name: string;
     modifiers: DnaModifiers;
     integrity_zomes: IntegrityZome[];
@@ -237,29 +237,39 @@ export declare type DnaDefinition = {
 /**
  * @public
  */
-export declare type GetDnaDefinitionRequest = DnaHash;
+export type GetDnaDefinitionRequest = DnaHash;
 /**
  * @public
  */
-export declare type GetDnaDefinitionResponse = DnaDefinition;
+export type GetDnaDefinitionResponse = DnaDefinition;
 /**
  * @public
  */
-export declare type UninstallAppRequest = {
+export type UninstallAppRequest = {
     installed_app_id: InstalledAppId;
 };
 /**
  * @public
  */
-export declare type UninstallAppResponse = null;
+export type UninstallAppResponse = null;
 /**
  * @public
  */
-export declare type ResourceBytes = Uint8Array;
+export type UpdateCoordinatorsRequest = {
+    dna_hash: DnaHash;
+} & CoordinatorSource;
 /**
  * @public
  */
-export declare type ResourceMap = {
+export type UpdateCoordinatorsResponse = void;
+/**
+ * @public
+ */
+export type ResourceBytes = Uint8Array;
+/**
+ * @public
+ */
+export type ResourceMap = {
     [key: string]: ResourceBytes;
 };
 /**
@@ -297,7 +307,7 @@ export interface CellProvisioning {
 /**
  * @public
  */
-export declare type Location = {
+export type Location = {
     /**
      * Expect file to be part of this bundle
      */
@@ -316,11 +326,11 @@ export declare type Location = {
 /**
  * @public
  */
-export declare type DnaVersionSpec = Array<HoloHashB64>;
+export type DnaVersionSpec = Array<HoloHashB64>;
 /**
  * @public
  */
-export declare type DnaVersionFlexible = {
+export type DnaVersionFlexible = {
     singleton: HoloHashB64;
 } | {
     multiple: DnaVersionSpec;
@@ -328,7 +338,7 @@ export declare type DnaVersionFlexible = {
 /**
  * @public
  */
-export declare type AppRoleDnaManifest = {
+export type AppRoleDnaManifest = {
     clone_limit?: number;
     modifiers?: Partial<DnaModifiers>;
     version?: DnaVersionFlexible;
@@ -336,7 +346,7 @@ export declare type AppRoleDnaManifest = {
 /**
  * @public
  */
-export declare type AppRoleManifest = {
+export type AppRoleManifest = {
     name: RoleName;
     provisioning?: CellProvisioning;
     dna: AppRoleDnaManifest;
@@ -344,7 +354,7 @@ export declare type AppRoleManifest = {
 /**
  * @public
  */
-export declare type AppManifest = {
+export type AppManifest = {
     manifest_version: string;
     name: string;
     description?: string;
@@ -353,14 +363,14 @@ export declare type AppManifest = {
 /**
  * @public
  */
-export declare type AppBundle = {
+export type AppBundle = {
     manifest: AppManifest;
     resources: ResourceMap;
 };
 /**
  * @public
  */
-export declare type AppBundleSource = {
+export type AppBundleSource = {
     bundle: AppBundle;
 } | {
     path: string;
@@ -368,11 +378,11 @@ export declare type AppBundleSource = {
 /**
  * @public
  */
-export declare type NetworkSeed = string;
+export type NetworkSeed = string;
 /**
  * @public
  */
-export declare type InstallAppRequest = {
+export type InstallAppRequest = {
     agent_key: AgentPubKey;
     installed_app_id?: InstalledAppId;
     membrane_proofs: {
@@ -383,31 +393,31 @@ export declare type InstallAppRequest = {
 /**
  * @public
  */
-export declare type InstallAppResponse = AppInfo;
+export type InstallAppResponse = AppInfo;
 /**
  * @public
  */
-export declare type ListDnasRequest = void;
+export type ListDnasRequest = void;
 /**
  * @public
  */
-export declare type ListDnasResponse = Array<string>;
+export type ListDnasResponse = Array<string>;
 /**
  * @public
  */
-export declare type ListCellIdsRequest = void;
+export type ListCellIdsRequest = void;
 /**
  * @public
  */
-export declare type ListCellIdsResponse = Array<CellId>;
+export type ListCellIdsResponse = Array<CellId>;
 /**
  * @public
  */
-export declare type ListActiveAppsRequest = void;
+export type ListActiveAppsRequest = void;
 /**
  * @public
  */
-export declare type ListActiveAppsResponse = Array<InstalledAppId>;
+export type ListActiveAppsResponse = Array<InstalledAppId>;
 /**
  * @public
  */
@@ -421,55 +431,55 @@ export declare enum AppStatusFilter {
 /**
  * @public
  */
-export declare type ListAppsRequest = {
+export type ListAppsRequest = {
     status_filter?: AppStatusFilter;
 };
 /**
  * @public
  */
-export declare type ListAppsResponse = Array<AppInfo>;
+export type ListAppsResponse = Array<AppInfo>;
 /**
  * @public
  */
-export declare type ListAppInterfacesRequest = void;
+export type ListAppInterfacesRequest = void;
 /**
  * @public
  */
-export declare type ListAppInterfacesResponse = Array<number>;
+export type ListAppInterfacesResponse = Array<number>;
 /**
  * This type is meant to be opaque
  *
  * @public
  */
-export declare type AgentInfoSigned = unknown;
+export type AgentInfoSigned = unknown;
 /**
  * @public
  */
-export declare type AgentInfoRequest = {
+export type AgentInfoRequest = {
     cell_id: CellId | null;
 };
 /**
  * @public
  */
-export declare type AgentInfoResponse = Array<AgentInfoSigned>;
+export type AgentInfoResponse = Array<AgentInfoSigned>;
 /**
  * @public
  */
-export declare type AddAgentInfoRequest = {
+export type AddAgentInfoRequest = {
     agent_infos: Array<AgentInfoSigned>;
 };
 /**
  * @public
  */
-export declare type AddAgentInfoResponse = any;
+export type AddAgentInfoResponse = any;
 /**
  * @public
  */
-export declare type DeleteCloneCellRequest = DisableCloneCellRequest;
+export type DeleteCloneCellRequest = DisableCloneCellRequest;
 /**
  * @public
  */
-export declare type DeleteCloneCellResponse = void;
+export type DeleteCloneCellResponse = void;
 /**
  * @public
  */
@@ -487,11 +497,11 @@ export interface GrantZomeCallCapabilityRequest {
 /**
  * @public
  */
-export declare type GrantZomeCallCapabilityResponse = void;
+export type GrantZomeCallCapabilityResponse = void;
 /**
  * @public
  */
-export declare type InstallAppDnaPayload = {
+export type InstallAppDnaPayload = {
     hash: HoloHash;
     role_name: RoleName;
     membrane_proof?: MembraneProof;
@@ -499,18 +509,46 @@ export declare type InstallAppDnaPayload = {
 /**
  * @public
  */
-export declare type ZomeLocation = Location;
+export type ZomeLocation = Location;
 /**
  * @public
  */
-export declare type ZomeManifest = {
+export interface ZomeDependency {
+    name: ZomeName;
+}
+/**
+ * @public
+ */
+export type ZomeManifest = {
     name: string;
     hash?: string;
+    dependencies?: ZomeDependency[];
 } & ZomeLocation;
 /**
  * @public
  */
-export declare type DnaManifest = {
+export interface CoordinatorManifest {
+    zomes: Array<ZomeManifest>;
+}
+/**
+ * @public
+ */
+export interface CoordinatorBundle {
+    manifest: CoordinatorManifest;
+    resources: ResourceMap;
+}
+/**
+ * @public
+ */
+export type CoordinatorSource = {
+    path: string;
+} | {
+    bundle: CoordinatorBundle;
+};
+/**
+ * @public
+ */
+export type DnaManifest = {
     /**
      * Currently one "1" is supported
      */
@@ -536,14 +574,14 @@ export declare type DnaManifest = {
 /**
  * @public
  */
-export declare type DnaBundle = {
+export type DnaBundle = {
     manifest: DnaManifest;
     resources: ResourceMap;
 };
 /**
  * @public
  */
-export declare type DnaSource = {
+export type DnaSource = {
     hash: HoloHash;
 } | {
     path: string;
@@ -553,13 +591,13 @@ export declare type DnaSource = {
 /**
  * @public
  */
-export declare type Zomes = Array<[string, {
+export type Zomes = Array<[string, {
     wasm_hash: Array<HoloHash>;
 }]>;
 /**
  * @public
  */
-export declare type WasmCode = [HoloHash, {
+export type WasmCode = [HoloHash, {
     code: Array<number>;
 }];
 /**
@@ -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 type StorageInfoRequest = void;
+/**
+ * @public
+ */
+export type StorageInfoResponse = StorageInfo;
+/**
+ * @public
+ */
+export type DumpNetworkStatsRequest = void;
+/**
+ * @public
+ */
+export 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.
@@ -128,7 +134,7 @@ export class AdminWebsocket {
      * @returns The cap secret of the created capability.
      */
     grantSigningKey = async (cellId, functions, signingKey) => {
-        const capSecret = await randomCapSecret();
+        const capSecret = randomCapSecret();
         await this.grantZomeCallCapability({
             cell_id: cellId,
             cap_grant: {
@@ -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 });
     };