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

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

@@ -573,6 +573,24 @@ export type AddAgentInfoRequest = {
  * @public
  */
 export type AddAgentInfoResponse = unknown;
+/**
+ * @public
+ */
+export interface AgentMetaInfoRequest {
+    url: string;
+    dna_hashes?: DnaHash[];
+}
+/**
+ * @public
+ */
+export type AgentMetaInfoResponse = Record<DnaHashB64, Record<string, AgentMetaInfo>>;
+/**
+ * @public
+ */
+export interface AgentMetaInfo {
+    meta_value: string;
+    expires_at: number;
+}
 /**
  * @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, DumpNetworkMetricsRequest, DumpNetworkMetricsResponse, DumpNetworkStatsRequest, DumpNetworkStatsResponse, DumpStateRequest, DumpStateResponse, EnableAppRequest, EnableAppResponse, GenerateAgentPubKeyRequest, GenerateAgentPubKeyResponse, 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";
+import { AddAgentInfoRequest, AddAgentInfoResponse, AdminApi, AgentInfoRequest, AgentInfoResponse, AgentMetaInfoResponse, AgentMetaInfoRequest, AttachAppInterfaceRequest, AttachAppInterfaceResponse, DeleteCloneCellRequest, DeleteCloneCellResponse, DisableAppRequest, DisableAppResponse, DumpFullStateRequest, DumpFullStateResponse, DumpNetworkMetricsRequest, DumpNetworkMetricsResponse, DumpNetworkStatsRequest, DumpNetworkStatsResponse, DumpStateRequest, DumpStateResponse, EnableAppRequest, EnableAppResponse, GenerateAgentPubKeyRequest, GenerateAgentPubKeyResponse, 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.
  *
@@ -101,6 +101,10 @@ export declare class AdminWebsocket implements AdminApi {
      * Add an existing agent to Holochain.
      */
     addAgentInfo: Requester<AddAgentInfoRequest, AddAgentInfoResponse>;
+    /**
+     * Request agent meta info about an agent.
+     */
+    agentMetaInfo: Requester<AgentMetaInfoRequest, AgentMetaInfoResponse>;
     /**
      * Delete a disabled clone cell.
      */

package/lib/api/admin/websocket.js

@@ -117,6 +117,10 @@ export class AdminWebsocket {
      * Add an existing agent to Holochain.
      */
     addAgentInfo = this._requester("add_agent_info");
+    /**
+     * Request agent meta info about an agent.
+     */
+    agentMetaInfo = this._requester("agent_meta_info");
     /**
      * Delete a disabled clone cell.
      */

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

@@ -1,6 +1,6 @@
 import { UnsubscribeFunction } from "emittery";
 import { AgentPubKey, InstalledAppId, RoleName } from "../../types.js";
-import { AgentInfoRequest, AgentInfoResponse, AppInfo, ClonedCell, DumpNetworkMetricsRequest, DumpNetworkMetricsResponse, DumpNetworkStatsResponse, MemproofMap } from "../admin/index.js";
+import { AgentInfoRequest, AgentInfoResponse, AgentMetaInfoRequest, 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";
 /**
@@ -19,6 +19,7 @@ export declare class AppWebsocket implements AppClient {
     cachedAppInfo?: AppInfo | null;
     private readonly appInfoRequester;
     private readonly agentInfoRequester;
+    private readonly agentMetaInfoRequester;
     private readonly callZomeRequester;
     private readonly provideMemproofRequester;
     private readonly enableAppRequester;
@@ -53,6 +54,13 @@ export declare class AppWebsocket implements AppClient {
      * @returns The app's agent infos as JSON string.
      */
     agentInfo(req: AgentInfoRequest, timeout?: number): Promise<AgentInfoResponse>;
+    /**
+     * Request agent meta info for an agent by peer Url.
+     *
+     * @param req - The peer Url of the agent and an optional array of DNA hashes
+     * @returns The app's agent infos as JSON string.
+     */
+    agentMetaInfo(req: AgentMetaInfoRequest, timeout?: number): Promise<AgentInfoResponse>;
     /**
      * Request network stats.
      *

package/lib/api/app/websocket.js

@@ -25,6 +25,7 @@ export class AppWebsocket {
     cachedAppInfo;
     appInfoRequester;
     agentInfoRequester;
+    agentMetaInfoRequester;
     callZomeRequester;
     provideMemproofRequester;
     enableAppRequester;
@@ -46,6 +47,7 @@ export class AppWebsocket {
         this.cachedAppInfo = appInfo;
         this.appInfoRequester = AppWebsocket.requester(this.client, "app_info", this.defaultTimeout);
         this.agentInfoRequester = AppWebsocket.requester(this.client, "agent_info", this.defaultTimeout);
+        this.agentMetaInfoRequester = AppWebsocket.requester(this.client, "agent_meta_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);
@@ -121,6 +123,16 @@ export class AppWebsocket {
         const agentInfos = await this.agentInfoRequester(req, timeout);
         return agentInfos;
     }
+    /**
+     * Request agent meta info for an agent by peer Url.
+     *
+     * @param req - The peer Url of the agent and an optional array of DNA hashes
+     * @returns The app's agent infos as JSON string.
+     */
+    async agentMetaInfo(req, timeout) {
+        const agentInfos = await this.agentMetaInfoRequester(req, timeout);
+        return agentInfos;
+    }
     /**
      * Request network stats.
      *

package/lib/api/client.d.ts

@@ -20,7 +20,7 @@ export interface AppAuthenticationRequest {
 export declare class WsClient extends Emittery {
     socket: IsoWebSocket;
     url: URL | undefined;
-    options: WsClientOptions;
+    options: WsClientOptions | undefined;
     private pendingRequests;
     private index;
     private authenticationToken;

package/lib/api/client.js

@@ -25,7 +25,7 @@ export class WsClient extends Emittery {
         this.registerCloseListener(socket);
         this.socket = socket;
         this.url = url;
-        this.options = options || {};
+        this.options = options;
         this.pendingRequests = {};
         this.index = 0;
     }

package/package.json

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