@holochain/client 0.19.0-rc.1 → 0.20.0-dev.0

package/README.md

@@ -15,12 +15,12 @@ A JavaScript client for the Holochain Conductor API (works with browsers as well
 
 ## Installation
 
+**JS client v0.20.x** is compatible with **Holochain v0.6.x**.
+
 **JS client v0.19.x** is compatible with **Holochain v0.5.x**.
 
 **JS client v0.18.x** is compatible with **Holochain v0.4.x**.
 
-**JS client v0.17.x** is compatible with **Holochain v0.3.x**.
-
 To install from NPM, run
 ```bash
 npm install --save-exact @holochain/client
@@ -38,7 +38,7 @@ import {
   CellType,
   type ActionHash,
   type CallZomeRequest,
-} from "@holochain/client";
+} from "./lib/index.js";
 
 const adminWs = await AdminWebsocket.connect({
   url: new URL("ws://127.0.0.1:65000"),
@@ -48,16 +48,18 @@ const agent_key = await adminWs.generateAgentPubKey();
 const role_name = "foo";
 const installed_app_id = "test-app";
 const appInfo = await adminWs.installApp({
+  source: {
+    type: "path",
+    value: "./test/e2e/fixture/test.happ",
+  },
   agent_key,
-  path: "./test/e2e/fixture/test.happ",
   installed_app_id,
-  membrane_proofs: {},
 });
 await adminWs.enableApp({ installed_app_id });
-if (!(CellType.Provisioned in appInfo.cell_info[role_name][0])) {
+if (appInfo.cell_info[role_name][0].type !== CellType.Provisioned) {
   throw new Error(`No cell found under role name ${role_name}`);
 }
-const { cell_id } = appInfo.cell_info[role_name][0][CellType.Provisioned];
+const { cell_id } = appInfo.cell_info[role_name][0].value;
 await adminWs.authorizeSigningCredentials(cell_id);
 await adminWs.attachAppInterface({ port: 65001, allowed_origins: "my-happ" });
 const issuedToken = await adminWs.issueAppAuthenticationToken({
@@ -86,7 +88,7 @@ await adminWs.client.close();
 
 ### Subscribe to signals
 ```typescript
-import { AdminWebsocket, AppWebsocket, CellType } from "@holochain/client";
+import { AdminWebsocket, AppWebsocket, CellType } from "./lib/index.js";
 
 const adminWs = await AdminWebsocket.connect({
   url: new URL("ws://127.0.0.1:65000"),
@@ -96,16 +98,18 @@ const agent_key = await adminWs.generateAgentPubKey();
 const role_name = "foo";
 const installed_app_id = "test-app";
 const appInfo = await adminWs.installApp({
+  source: {
+    type: "path",
+    value: "./test/e2e/fixture/test.happ",
+  },
   agent_key,
-  path: "./test/e2e/fixture/test.happ",
   installed_app_id,
-  membrane_proofs: {},
 });
 await adminWs.enableApp({ installed_app_id });
-if (!(CellType.Provisioned in appInfo.cell_info[role_name][0])) {
+if (appInfo.cell_info[role_name][0].type !== CellType.Provisioned) {
   throw new Error(`No cell found under role name ${role_name}`);
 }
-const { cell_id } = appInfo.cell_info[role_name][0][CellType.Provisioned];
+const { cell_id } = appInfo.cell_info[role_name][0].value;
 await adminWs.authorizeSigningCredentials(cell_id);
 await adminWs.attachAppInterface({ port: 65001, allowed_origins: "my-happ" });
 const issuedToken = await adminWs.issueAppAuthenticationToken({

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

@@ -557,7 +557,7 @@ export type AgentInfoSigned = unknown;
  * @public
  */
 export type AgentInfoRequest = {
-    cell_id: CellId | null;
+    dna_hashes: DnaHash[] | null;
 };
 /**
  * @public
@@ -936,20 +936,15 @@ export interface DumpNetworkMetricsRequest {
  *
  * @public
  */
-export type DhtArc = {
-    /**
-     * No DHT locations are contained within this arc.
-     */
-    type: "empty";
-} | {
-    /**
-     * A specific range of DHT locations are contained within this arc.
-     *
-     * The lower and upper bounds are inclusive.
-     */
-    type: "arc";
-    value: [number, number];
-};
+export type DhtArc = /**
+ * No DHT locations are contained within this arc.
+ */ null
+/**
+ * A specific range of DHT locations are contained within this arc.
+ *
+ * The lower and upper bounds are inclusive.
+ */
+ | [number, number];
 /**
  * Summary of a local agent's network state.
  *

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

@@ -345,6 +345,9 @@ export declare enum SessionCompletionDecisionType {
 export type SessionCompletionDecision = {
     [SessionCompletionDecisionType.Complete]: SignedActionHashed;
 } | SessionCompletionDecisionType.Abandoned | SessionCompletionDecisionType.Indeterminate | SessionCompletionDecisionType.Failed;
+/**
+ * @public
+ */
 export declare enum SignalType {
     App = "app",
     System = "system"

package/lib/api/app/types.js

@@ -45,6 +45,9 @@ export var SessionCompletionDecisionType;
      */
     SessionCompletionDecisionType["Failed"] = "Failed";
 })(SessionCompletionDecisionType || (SessionCompletionDecisionType = {}));
+/**
+ * @public
+ */
 export var SignalType;
 (function (SignalType) {
     SignalType["App"] = "app";

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

@@ -1,6 +1,6 @@
 import { UnsubscribeFunction } from "emittery";
 import { AgentPubKey, InstalledAppId, RoleName } from "../../types.js";
-import { AppInfo, ClonedCell, DumpNetworkMetricsRequest, DumpNetworkMetricsResponse, DumpNetworkStatsResponse, MemproofMap } from "../admin/index.js";
+import { AgentInfoRequest, AgentInfoResponse, AppInfo, ClonedCell, DumpNetworkMetricsRequest, DumpNetworkMetricsResponse, DumpNetworkStatsResponse, MemproofMap } from "../admin/index.js";
 import { WsClient } from "../client.js";
 import { AbandonCountersigningSessionStateRequest, AppClient, AppEvents, AppWebsocketConnectionOptions, CallZomeRequest, CallZomeRequestSigned, CreateCloneCellRequest, DisableCloneCellRequest, EnableCloneCellRequest, GetCountersigningSessionStateRequest, GetCountersigningSessionStateResponse, PublishCountersigningSessionStateRequest, RoleNameCallZomeRequest, SignalCb } from "./types.js";
 /**
@@ -18,6 +18,7 @@ export declare class AppWebsocket implements AppClient {
     private readonly callZomeTransform;
     cachedAppInfo?: AppInfo | null;
     private readonly appInfoRequester;
+    private readonly agentInfoRequester;
     private readonly callZomeRequester;
     private readonly provideMemproofRequester;
     private readonly enableAppRequester;
@@ -45,6 +46,13 @@ export declare class AppWebsocket implements AppClient {
      * @returns The app's {@link AppInfo}.
      */
     appInfo(timeout?: number): Promise<AppInfo>;
+    /**
+     * Request the currently known agents of the app.
+     *
+     * @param req - An array of DNA hashes or null
+     * @returns The app's agent infos as JSON string.
+     */
+    agentInfo(req: AgentInfoRequest, timeout?: number): Promise<AgentInfoResponse>;
     /**
      * Request network stats.
      *

package/lib/api/app/websocket.js

@@ -24,6 +24,7 @@ export class AppWebsocket {
     callZomeTransform;
     cachedAppInfo;
     appInfoRequester;
+    agentInfoRequester;
     callZomeRequester;
     provideMemproofRequester;
     enableAppRequester;
@@ -44,6 +45,7 @@ export class AppWebsocket {
         this.emitter = new Emittery();
         this.cachedAppInfo = appInfo;
         this.appInfoRequester = AppWebsocket.requester(this.client, "app_info", this.defaultTimeout);
+        this.agentInfoRequester = AppWebsocket.requester(this.client, "agent_info", this.defaultTimeout);
         this.callZomeRequester = AppWebsocket.requester(this.client, "call_zome", this.defaultTimeout, this.callZomeTransform);
         this.provideMemproofRequester = AppWebsocket.requester(this.client, "provide_memproofs", this.defaultTimeout);
         this.enableAppRequester = AppWebsocket.requester(this.client, "enable_app", this.defaultTimeout);
@@ -109,6 +111,16 @@ export class AppWebsocket {
         this.cachedAppInfo = appInfo;
         return appInfo;
     }
+    /**
+     * Request the currently known agents of the app.
+     *
+     * @param req - An array of DNA hashes or null
+     * @returns The app's agent infos as JSON string.
+     */
+    async agentInfo(req, timeout) {
+        const agentInfos = await this.agentInfoRequester(req, timeout);
+        return agentInfos;
+    }
     /**
      * Request network stats.
      *

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@holochain/client",
-  "version": "0.19.0-rc.1",
+  "version": "0.20.0-dev.0",
   "description": "A JavaScript client for the Holochain Conductor API",
   "author": "Holochain Foundation <info@holochain.org> (https://holochain.org)",
   "license": "CAL-1.0",
@@ -18,7 +18,7 @@
   },
   "homepage": "https://github.com/holochain/holochain-client-js#readme",
   "engines": {
-    "node": ">=18.0.0 || >=20.0.0"
+    "node": ">=18.0.0 || >=20.0.0 || >= 22.0.0"
   },
   "main": "lib/index.js",
   "module": "lib/index.js",