@holochain/client 0.3.0

package/lib/types/common.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=common.js.map

package/lib/types/common.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"common.js","sourceRoot":"","sources":["../../src/types/common.ts"],"names":[],"mappings":""}

package/lib/types/dht-ops.d.ts

@@ -0,0 +1,45 @@
+import { CreateLink, Delete, DeleteLink, Header, NewEntryHeader, Update } from "./header";
+import { Entry } from "./entry";
+import { Signature } from "./common";
+export declare enum DhtOpType {
+    StoreElement = "StoreElement",
+    StoreEntry = "StoreEntry",
+    RegisterAgentActivity = "RegisterAgentActivity",
+    RegisterUpdatedContent = "RegisterUpdatedContent",
+    RegisterUpdatedElement = "RegisterUpdatedElement",
+    RegisterDeletedBy = "RegisterDeletedBy",
+    RegisterDeletedEntryHeader = "RegisterDeletedEntryHeader",
+    RegisterAddLink = "RegisterAddLink",
+    RegisterRemoveLink = "RegisterRemoveLink"
+}
+export declare type DhtOp = {
+    [DhtOpType.StoreElement]: [Signature, Header, Entry | undefined];
+} | {
+    [DhtOpType.StoreEntry]: [Signature, NewEntryHeader, Entry];
+} | {
+    [DhtOpType.RegisterAgentActivity]: [Signature, Header];
+} | {
+    [DhtOpType.RegisterUpdatedContent]: [
+        Signature,
+        Update,
+        Entry | undefined
+    ];
+} | {
+    [DhtOpType.RegisterUpdatedElement]: [
+        Signature,
+        Update,
+        Entry | undefined
+    ];
+} | {
+    [DhtOpType.RegisterDeletedBy]: [Signature, Delete];
+} | {
+    [DhtOpType.RegisterDeletedEntryHeader]: [Signature, Delete];
+} | {
+    [DhtOpType.RegisterAddLink]: [Signature, CreateLink];
+} | {
+    [DhtOpType.RegisterRemoveLink]: [Signature, DeleteLink];
+};
+export declare function getDhtOpType(op: DhtOp): DhtOpType;
+export declare function getDhtOpHeader(op: DhtOp): Header;
+export declare function getDhtOpEntry(op: DhtOp): Entry | undefined;
+export declare function getDhtOpSignature(op: DhtOp): Signature;

package/lib/types/dht-ops.js

@@ -0,0 +1,42 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getDhtOpSignature = exports.getDhtOpEntry = exports.getDhtOpHeader = exports.getDhtOpType = exports.DhtOpType = void 0;
+// https://github.com/holochain/holochain/blob/develop/crates/types/src/dht_op.rs
+var DhtOpType;
+(function (DhtOpType) {
+    DhtOpType["StoreElement"] = "StoreElement";
+    DhtOpType["StoreEntry"] = "StoreEntry";
+    DhtOpType["RegisterAgentActivity"] = "RegisterAgentActivity";
+    DhtOpType["RegisterUpdatedContent"] = "RegisterUpdatedContent";
+    DhtOpType["RegisterUpdatedElement"] = "RegisterUpdatedElement";
+    DhtOpType["RegisterDeletedBy"] = "RegisterDeletedBy";
+    DhtOpType["RegisterDeletedEntryHeader"] = "RegisterDeletedEntryHeader";
+    DhtOpType["RegisterAddLink"] = "RegisterAddLink";
+    DhtOpType["RegisterRemoveLink"] = "RegisterRemoveLink";
+})(DhtOpType = exports.DhtOpType || (exports.DhtOpType = {}));
+function getDhtOpType(op) {
+    return Object.keys(op)[0];
+}
+exports.getDhtOpType = getDhtOpType;
+function getDhtOpHeader(op) {
+    const header = Object.values(op)[0][1];
+    if (header.author)
+        return header;
+    else {
+        const headerType = Object.keys(header)[0];
+        return {
+            type: headerType,
+            ...header[headerType],
+        };
+    }
+}
+exports.getDhtOpHeader = getDhtOpHeader;
+function getDhtOpEntry(op) {
+    return Object.values(op)[0][2];
+}
+exports.getDhtOpEntry = getDhtOpEntry;
+function getDhtOpSignature(op) {
+    return Object.values(op)[0][1];
+}
+exports.getDhtOpSignature = getDhtOpSignature;
+//# sourceMappingURL=dht-ops.js.map

package/lib/types/dht-ops.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dht-ops.js","sourceRoot":"","sources":["../../src/types/dht-ops.ts"],"names":[],"mappings":";;;AAcA,iFAAiF;AAEjF,IAAY,SAUX;AAVD,WAAY,SAAS;IACnB,0CAA6B,CAAA;IAC7B,sCAAyB,CAAA;IACzB,4DAA+C,CAAA;IAC/C,8DAAiD,CAAA;IACjD,8DAAiD,CAAA;IACjD,oDAAuC,CAAA;IACvC,sEAAyD,CAAA;IACzD,gDAAmC,CAAA;IACnC,sDAAyC,CAAA;AAC3C,CAAC,EAVW,SAAS,GAAT,iBAAS,KAAT,iBAAS,QAUpB;AAyBD,SAAgB,YAAY,CAAC,EAAS;IACpC,OAAO,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,CAAc,CAAA;AACxC,CAAC;AAFD,oCAEC;AAED,SAAgB,cAAc,CAAC,EAAS;IACtC,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAA;IAEtC,IAAI,MAAM,CAAC,MAAM;QAAE,OAAO,MAAM,CAAA;SAC3B;QACH,MAAM,UAAU,GAAG,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAA;QACzC,OAAO;YACL,IAAI,EAAE,UAAU;YAChB,GAAG,MAAM,CAAC,UAAU,CAAC;SACtB,CAAA;KACF;AACH,CAAC;AAXD,wCAWC;AAED,SAAgB,aAAa,CAAC,EAAS;IACrC,OAAO,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAA;AAChC,CAAC;AAFD,sCAEC;AAED,SAAgB,iBAAiB,CAAC,EAAS;IACzC,OAAO,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAA;AAChC,CAAC;AAFD,8CAEC"}

package/lib/types/entry.d.ts

@@ -0,0 +1,16 @@
+import { CapClaim, ZomeCallCapGrant } from "./capabilities";
+import { AgentPubKey } from "./common";
+export declare type EntryVisibility = "Public" | "Private";
+export declare type AppEntryType = {
+    id: number;
+    zome_id: number;
+    visibility: EntryVisibility;
+};
+export declare type EntryType = "Agent" | {
+    App: AppEntryType;
+} | "CapClaim" | "CapGrant";
+export interface EntryContent<E extends string, C> {
+    entry_type: E;
+    entry: C;
+}
+export declare type Entry = EntryContent<"Agent", AgentPubKey> | EntryContent<"App", any> | EntryContent<"CapGrant", ZomeCallCapGrant> | EntryContent<"CapClaim", CapClaim>;

package/lib/types/entry.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=entry.js.map

package/lib/types/entry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"entry.js","sourceRoot":"","sources":["../../src/types/entry.ts"],"names":[],"mappings":""}

package/lib/types/header.d.ts

@@ -0,0 +1,108 @@
+import { AgentPubKey, DnaHash, EntryHash, HeaderHash, Signature } from "./common";
+import { EntryType } from "./entry";
+import { HoloHashed, Timestamp } from "./common";
+export interface SignedHeaderHashed<H extends Header = Header> {
+    header: HoloHashed<H>;
+    signature: Signature;
+}
+export declare type HeaderHashed = HoloHashed<Header>;
+export declare enum HeaderType {
+    Dna = "Dna",
+    AgentValidationPkg = "AgentValidationPkg",
+    InitZomesComplete = "InitZomesComplete",
+    CreateLink = "CreateLink",
+    DeleteLink = "DeleteLink",
+    OpenChain = "OpenChain",
+    CloseChain = "CloseChain",
+    Create = "Create",
+    Update = "Update",
+    Delete = "Delete"
+}
+export declare type Header = Dna | AgentValidationPkg | InitZomesComplete | CreateLink | DeleteLink | OpenChain | CloseChain | Delete | NewEntryHeader;
+export declare type NewEntryHeader = Create | Update;
+export interface Dna {
+    type: HeaderType.Dna;
+    author: AgentPubKey;
+    timestamp: Timestamp;
+    hash: DnaHash;
+}
+export interface AgentValidationPkg {
+    type: HeaderType.AgentValidationPkg;
+    author: AgentPubKey;
+    timestamp: Timestamp;
+    header_seq: number;
+    prev_header: HeaderHash;
+    membrane_proof: any;
+}
+export interface InitZomesComplete {
+    type: HeaderType.InitZomesComplete;
+    author: AgentPubKey;
+    timestamp: Timestamp;
+    header_seq: number;
+    prev_header: HeaderHash;
+}
+export interface CreateLink {
+    type: HeaderType.CreateLink;
+    author: AgentPubKey;
+    timestamp: Timestamp;
+    header_seq: number;
+    prev_header: HeaderHash;
+    base_address: EntryHash;
+    target_address: EntryHash;
+    zome_id: number;
+    tag: any;
+}
+export interface DeleteLink {
+    type: HeaderType.DeleteLink;
+    author: AgentPubKey;
+    timestamp: Timestamp;
+    header_seq: number;
+    prev_header: HeaderHash;
+    base_address: EntryHash;
+    link_add_address: HeaderHash;
+}
+export interface OpenChain {
+    type: HeaderType.OpenChain;
+    author: AgentPubKey;
+    timestamp: Timestamp;
+    header_seq: number;
+    prev_header: HeaderHash;
+    prev_dna_hash: DnaHash;
+}
+export interface CloseChain {
+    type: HeaderType.CloseChain;
+    author: AgentPubKey;
+    timestamp: Timestamp;
+    header_seq: number;
+    prev_header: HeaderHash;
+    new_dna_hash: DnaHash;
+}
+export interface Update {
+    type: HeaderType.Update;
+    author: AgentPubKey;
+    timestamp: Timestamp;
+    header_seq: number;
+    prev_header: HeaderHash;
+    original_header_address: HeaderHash;
+    original_entry_address: EntryHash;
+    entry_type: EntryType;
+    entry_hash: EntryHash;
+}
+export interface Delete {
+    type: HeaderType.Delete;
+    author: AgentPubKey;
+    timestamp: Timestamp;
+    header_seq: number;
+    prev_header: HeaderHash;
+    deletes_address: HeaderHash;
+    deletes_entry_address: EntryHash;
+}
+export interface Create {
+    type: HeaderType.Create;
+    author: AgentPubKey;
+    timestamp: Timestamp;
+    header_seq: number;
+    prev_header: HeaderHash;
+    entry_type: EntryType;
+    entry_hash: EntryHash;
+}

package/lib/types/header.js

@@ -0,0 +1,17 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.HeaderType = void 0;
+var HeaderType;
+(function (HeaderType) {
+    HeaderType["Dna"] = "Dna";
+    HeaderType["AgentValidationPkg"] = "AgentValidationPkg";
+    HeaderType["InitZomesComplete"] = "InitZomesComplete";
+    HeaderType["CreateLink"] = "CreateLink";
+    HeaderType["DeleteLink"] = "DeleteLink";
+    HeaderType["OpenChain"] = "OpenChain";
+    HeaderType["CloseChain"] = "CloseChain";
+    HeaderType["Create"] = "Create";
+    HeaderType["Update"] = "Update";
+    HeaderType["Delete"] = "Delete";
+})(HeaderType = exports.HeaderType || (exports.HeaderType = {}));
+//# sourceMappingURL=header.js.map

package/lib/types/header.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"header.js","sourceRoot":"","sources":["../../src/types/header.ts"],"names":[],"mappings":";;;AAiBA,IAAY,UAWX;AAXD,WAAY,UAAU;IACpB,yBAAW,CAAA;IACX,uDAAyC,CAAA;IACzC,qDAAuC,CAAA;IACvC,uCAAyB,CAAA;IACzB,uCAAyB,CAAA;IACzB,qCAAuB,CAAA;IACvB,uCAAyB,CAAA;IACzB,+BAAiB,CAAA;IACjB,+BAAiB,CAAA;IACjB,+BAAiB,CAAA;AACnB,CAAC,EAXW,UAAU,GAAV,kBAAU,KAAV,kBAAU,QAWrB"}

package/lib/types/index.d.ts

@@ -0,0 +1,5 @@
+export * from "./capabilities";
+export * from "./common";
+export * from "./dht-ops";
+export * from "./entry";
+export * from "./header";

package/lib/types/index.js

@@ -0,0 +1,18 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    Object.defineProperty(o, k2, { enumerable: true, get: function() { return m[k]; } });
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./capabilities"), exports);
+__exportStar(require("./common"), exports);
+__exportStar(require("./dht-ops"), exports);
+__exportStar(require("./entry"), exports);
+__exportStar(require("./header"), exports);
+//# sourceMappingURL=index.js.map

package/lib/types/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":";;;;;;;;;;;;AAAA,iDAA8B;AAC9B,2CAAwB;AACxB,4CAAyB;AACzB,0CAAuB;AACvB,2CAAwB"}

package/lib/websocket/admin.d.ts

@@ -0,0 +1,47 @@
+/**
+ * Defines AdminWebsocket, an easy-to-use websocket implementation of the
+ * Conductor Admin API
+ *
+ *    const client = AdminWebsocket.connect(
+ *      'ws://localhost:9000'
+ *    )
+ *
+ *    client.generateAgentPubKey()
+ *      .then(agentPubKey => {
+ *        console.log('Agent successfully generated:', agentPubKey)
+ *      })
+ *      .catch(err => {
+ *        console.error('problem generating agent:', err)
+ *      })
+ */
+import * as Api from '../api/admin';
+import { WsClient } from './client';
+import { Transformer, Requester } from '../api/common';
+export declare class AdminWebsocket implements Api.AdminApi {
+    client: WsClient;
+    defaultTimeout: number;
+    constructor(client: WsClient, defaultTimeout?: number);
+    static connect(url: string, defaultTimeout?: number): Promise<AdminWebsocket>;
+    _requester: <ReqO, ReqI, ResI, ResO>(tag: string, transformer?: Transformer<ReqO, ReqI, ResI, ResO> | undefined) => (req: ReqO, timeout?: number | undefined) => Promise<ResO>;
+    attachAppInterface: Requester<Api.AttachAppInterfaceRequest, Api.AttachAppInterfaceResponse>;
+    activateApp: Requester<Api.ActivateAppRequest, Api.ActivateAppResponse>;
+    deactivateApp: Requester<Api.DeactivateAppRequest, Api.DeactivateAppResponse>;
+    enableApp: Requester<Api.EnableAppRequest, Api.EnableAppResponse>;
+    disableApp: Requester<Api.DisableAppRequest, Api.DisableAppResponse>;
+    startApp: Requester<Api.StartAppRequest, Api.StartAppResponse>;
+    dumpState: Requester<Api.DumpStateRequest, Api.DumpStateResponse>;
+    dumpFullState: Requester<Api.DumpFullStateRequest, Api.DumpFullStateResponse>;
+    generateAgentPubKey: Requester<Api.GenerateAgentPubKeyRequest, Api.GenerateAgentPubKeyResponse>;
+    registerDna: Requester<Api.RegisterDnaRequest, Api.RegisterDnaResponse>;
+    installApp: Requester<Api.InstallAppRequest, Api.InstallAppResponse>;
+    uninstallApp: Requester<Api.UninstallAppRequest, Api.UninstallAppResponse>;
+    installAppBundle: Requester<Api.InstallAppBundleRequest, Api.InstallAppBundleResponse>;
+    createCloneCell: Requester<Api.CreateCloneCellRequest, Api.CreateCloneCellResponse>;
+    listDnas: Requester<Api.ListDnasRequest, Api.ListDnasResponse>;
+    listCellIds: Requester<Api.ListCellIdsRequest, Api.ListCellIdsResponse>;
+    listActiveApps: Requester<Api.ListActiveAppsRequest, Api.ListActiveAppsResponse>;
+    listApps: Requester<Api.ListAppsRequest, Api.ListAppsResponse>;
+    listAppInterfaces: Requester<Api.ListAppInterfacesRequest, Api.ListAppInterfacesResponse>;
+    requestAgentInfo: Requester<Api.RequestAgentInfoRequest, Api.RequestAgentInfoResponse>;
+    addAgentInfo: Requester<Api.AddAgentInfoRequest, Api.AddAgentInfoResponse>;
+}

package/lib/websocket/admin.js

@@ -0,0 +1,127 @@
+"use strict";
+/**
+ * Defines AdminWebsocket, an easy-to-use websocket implementation of the
+ * Conductor Admin API
+ *
+ *    const client = AdminWebsocket.connect(
+ *      'ws://localhost:9000'
+ *    )
+ *
+ *    client.generateAgentPubKey()
+ *      .then(agentPubKey => {
+ *        console.log('Agent successfully generated:', agentPubKey)
+ *      })
+ *      .catch(err => {
+ *        console.error('problem generating agent:', err)
+ *      })
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    Object.defineProperty(o, k2, { enumerable: true, get: function() { return m[k]; } });
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || function (mod) {
+    if (mod && mod.__esModule) return mod;
+    var result = {};
+    if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
+    __setModuleDefault(result, mod);
+    return result;
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AdminWebsocket = void 0;
+const Api = __importStar(require("../api/admin"));
+const client_1 = require("./client");
+const common_1 = require("./common");
+const common_2 = require("../api/common");
+const launcher_1 = require("../environments/launcher");
+class AdminWebsocket {
+    constructor(client, defaultTimeout) {
+        this._requester = (tag, transformer) => (0, common_2.requesterTransformer)((req, timeout) => (0, common_1.promiseTimeout)(this.client.request(req), tag, timeout || this.defaultTimeout).then(common_1.catchError), tag, transformer);
+        // the specific request/response types come from the Interface
+        // which this class implements
+        this.attachAppInterface = this._requester('attach_app_interface');
+        // Deprecated
+        this.activateApp = this._requester('activate_app');
+        // Deprecated
+        this.deactivateApp = this._requester('deactivate_app');
+        this.enableApp = this._requester('enable_app');
+        this.disableApp = this._requester('disable_app');
+        this.startApp = this._requester('start_app');
+        this.dumpState = this._requester('dump_state', dumpStateTransform);
+        this.dumpFullState = this._requester('dump_full_state');
+        this.generateAgentPubKey = this._requester('generate_agent_pub_key');
+        this.registerDna = this._requester('register_dna');
+        this.installApp = this._requester('install_app');
+        this.uninstallApp = this._requester('uninstall_app');
+        this.installAppBundle = this._requester('install_app_bundle');
+        this.createCloneCell = this._requester('create_clone_cell');
+        this.listDnas = this._requester('list_dnas');
+        this.listCellIds = this._requester('list_cell_ids');
+        // Deprecated
+        this.listActiveApps = this._requester('list_active_apps');
+        this.listApps = this._requester('list_apps', listAppsTransform);
+        this.listAppInterfaces = this._requester('list_app_interfaces');
+        this.requestAgentInfo = this._requester('request_agent_info');
+        this.addAgentInfo = this._requester('add_agent_info');
+        this.client = client;
+        this.defaultTimeout = defaultTimeout === undefined ? common_1.DEFAULT_TIMEOUT : defaultTimeout;
+    }
+    static async connect(url, defaultTimeout) {
+        // Check if we are in the launcher's environment, and if so, redirect the url to connect to
+        const env = await (0, launcher_1.getLauncherEnvironment)();
+        if (env) {
+            url = `ws://localhost:${env.ADMIN_INTERFACE_PORT}`;
+        }
+        const wsClient = await client_1.WsClient.connect(url);
+        return new AdminWebsocket(wsClient, defaultTimeout);
+    }
+}
+exports.AdminWebsocket = AdminWebsocket;
+const listAppsTransform = {
+    input: (req) => {
+        const args = {};
+        if (req.status_filter) {
+            args.status_filter = getAppStatusInApiForm(req.status_filter);
+        }
+        return args;
+    },
+    output: (res) => res,
+};
+const dumpStateTransform = {
+    input: (req) => req,
+    output: (res) => {
+        return JSON.parse(res);
+    },
+};
+function getAppStatusInApiForm(status_filter) {
+    switch (status_filter) {
+        case Api.AppStatusFilter.Running:
+            return {
+                Running: null,
+            };
+        case Api.AppStatusFilter.Enabled:
+            return {
+                Enabled: null,
+            };
+        case Api.AppStatusFilter.Paused:
+            return {
+                Paused: null,
+            };
+        case Api.AppStatusFilter.Disabled:
+            return {
+                Disabled: null,
+            };
+        case Api.AppStatusFilter.Stopped:
+            return {
+                Stopped: null,
+            };
+    }
+}
+//# sourceMappingURL=admin.js.map

package/lib/websocket/admin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"admin.js","sourceRoot":"","sources":["../../src/websocket/admin.ts"],"names":[],"mappings":"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"}

package/lib/websocket/app.d.ts

@@ -0,0 +1,13 @@
+import { AppApi, AppInfoRequest, AppInfoResponse, CallZomeRequestGeneric, CallZomeResponseGeneric, AppSignalCb } from '../api/app';
+import { WsClient } from './client';
+import { Transformer, Requester } from '../api/common';
+export declare class AppWebsocket implements AppApi {
+    protected overrideInstalledAppId?: string | undefined;
+    client: WsClient;
+    defaultTimeout: number;
+    constructor(client: WsClient, defaultTimeout?: number, overrideInstalledAppId?: string | undefined);
+    static connect(url: string, defaultTimeout?: number, signalCb?: AppSignalCb): Promise<AppWebsocket>;
+    _requester: <ReqO, ReqI, ResI, ResO>(tag: string, transformer?: Transformer<ReqO, ReqI, ResI, ResO> | undefined) => (req: ReqO, timeout?: number | undefined) => Promise<ResO>;
+    appInfo: Requester<AppInfoRequest, AppInfoResponse>;
+    callZome: Requester<CallZomeRequestGeneric<any>, CallZomeResponseGeneric<any>>;
+}

package/lib/websocket/app.js

@@ -0,0 +1,70 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AppWebsocket = void 0;
+/**
+ * Defines AppWebsocket, an easy-to-use websocket implementation of the
+ * Conductor API for apps
+ *
+ *    const client = AppWebsocket.connect(
+ *      'ws://localhost:9000',
+ *      signal => console.log('got a signal:', signal)
+ *    )
+ *
+ *    client.callZome({...})  // TODO: show what's in here
+ *      .then(() => {
+ *        console.log('DNA successfully installed')
+ *      })
+ *      .catch(err => {
+ *        console.error('problem installing DNA:', err)
+ *      })
+ */
+const msgpack_1 = require("@msgpack/msgpack");
+const client_1 = require("./client");
+const common_1 = require("./common");
+const common_2 = require("../api/common");
+const launcher_1 = require("../environments/launcher");
+class AppWebsocket {
+    constructor(client, defaultTimeout, overrideInstalledAppId) {
+        this.overrideInstalledAppId = overrideInstalledAppId;
+        this._requester = (tag, transformer) => (0, common_2.requesterTransformer)((req, timeout) => (0, common_1.promiseTimeout)(this.client.request(req), tag, timeout || this.defaultTimeout).then(common_1.catchError), tag, transformer);
+        this.appInfo = this._requester('app_info', appInfoTransform(this.overrideInstalledAppId));
+        this.callZome = this._requester('zome_call', callZomeTransform);
+        this.client = client;
+        this.defaultTimeout = defaultTimeout === undefined ? common_1.DEFAULT_TIMEOUT : defaultTimeout;
+    }
+    static async connect(url, defaultTimeout, signalCb) {
+        // Check if we are in the launcher's environment, and if so, redirect the url to connect to
+        const env = await (0, launcher_1.getLauncherEnvironment)();
+        if (env) {
+            url = `ws://localhost:${env.APP_INTERFACE_PORT}`;
+        }
+        const wsClient = await client_1.WsClient.connect(url, signalCb);
+        return new AppWebsocket(wsClient, defaultTimeout, env ? env.INSTALLED_APP_ID : undefined);
+    }
+}
+exports.AppWebsocket = AppWebsocket;
+const callZomeTransform = {
+    input: (req) => {
+        return {
+            ...req,
+            payload: (0, msgpack_1.encode)(req.payload),
+        };
+    },
+    output: (res) => {
+        return (0, msgpack_1.decode)(res);
+    },
+};
+const appInfoTransform = (overrideInstalledAppId) => ({
+    input: (req) => {
+        if (overrideInstalledAppId) {
+            return {
+                installed_app_id: overrideInstalledAppId,
+            };
+        }
+        return req;
+    },
+    output: (res) => {
+        return res;
+    },
+});
+//# sourceMappingURL=app.js.map

package/lib/websocket/app.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"app.js","sourceRoot":"","sources":["../../src/websocket/app.ts"],"names":[],"mappings":";;;AAAA;;;;;;;;;;;;;;;;GAgBG;AACH,8CAAiD;AAGjD,qCAAmC;AACnC,qCAAsE;AACtE,0CAA4E;AAC5E,uDAAiE;AAGjE,MAAa,YAAY;IAIvB,YAAY,MAAgB,EAAE,cAAuB,EAAY,sBAAuC;QAAvC,2BAAsB,GAAtB,sBAAsB,CAAiB;QAiBxG,eAAU,GAAG,CAAyB,GAAW,EAAE,WAAiD,EAAE,EAAE,CACtG,IAAA,6BAAoB,EAClB,CAAC,GAAG,EAAE,OAAO,EAAE,EAAE,CAAC,IAAA,uBAAc,EAAC,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,GAAG,EAAE,OAAO,IAAI,IAAI,CAAC,cAAc,CAAC,CAAC,IAAI,CAAC,mBAAU,CAAC,EAChH,GAAG,EACH,WAAW,CACZ,CAAA;QAEH,YAAO,GACH,IAAI,CAAC,UAAU,CAAC,UAAU,EAAE,gBAAgB,CAAC,IAAI,CAAC,sBAAsB,CAAC,CAAC,CAAA;QAC9E,aAAQ,GACJ,IAAI,CAAC,UAAU,CAAC,WAAW,EAAE,iBAAiB,CAAC,CAAA;QA1BjD,IAAI,CAAC,MAAM,GAAG,MAAM,CAAA;QACpB,IAAI,CAAC,cAAc,GAAG,cAAc,KAAK,SAAS,CAAC,CAAC,CAAC,wBAAe,CAAC,CAAC,CAAC,cAAc,CAAA;IACvF,CAAC;IAED,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,GAAW,EAAE,cAAuB,EAAE,QAAsB;QAC/E,2FAA2F;QAC3F,MAAM,GAAG,GAAG,MAAM,IAAA,iCAAsB,GAAE,CAAA;QAE1C,IAAI,GAAG,EAAE;YACP,GAAG,GAAG,kBAAkB,GAAG,CAAC,kBAAkB,EAAE,CAAA;SACjD;QAED,MAAM,QAAQ,GAAG,MAAM,iBAAQ,CAAC,OAAO,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAA;QACtD,OAAO,IAAI,YAAY,CAAC,QAAQ,EAAE,cAAc,EAAE,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,gBAAgB,CAAC,CAAC,CAAC,SAAS,CAAC,CAAA;IAC3F,CAAC;CAaF;AAhCD,oCAgCC;AAED,MAAM,iBAAiB,GAAoJ;IACzK,KAAK,EAAE,CAAC,GAAgC,EAAsC,EAAE;QAC9E,OAAO;YACL,GAAG,GAAG;YACN,OAAO,EAAE,IAAA,gBAAM,EAAC,GAAG,CAAC,OAAO,CAAC;SAC7B,CAAA;IACH,CAAC;IACD,MAAM,EAAE,CAAC,GAAwC,EAAgC,EAAE;QACjF,OAAO,IAAA,gBAAM,EAAC,GAAG,CAAC,CAAA;IACpB,CAAC;CACF,CAAA;AAED,MAAM,gBAAgB,GAAG,CAAC,sBAAuC,EAAiF,EAAE,CAAC,CAAC;IACpJ,KAAK,EAAE,CAAC,GAAmB,EAAkB,EAAE;QAC7C,IAAI,sBAAsB,EAAE;YAC1B,OAAO;gBACL,gBAAgB,EAAE,sBAAsB;aACzC,CAAA;SACF;QAED,OAAO,GAAG,CAAA;IACZ,CAAC;IACD,MAAM,EAAE,CAAC,GAAoB,EAAmB,EAAE;QAChD,OAAO,GAAG,CAAA;IACZ,CAAC;CACF,CAAC,CAAA"}

package/lib/websocket/client.d.ts

@@ -0,0 +1,25 @@
+import Websocket from "isomorphic-ws";
+import { decode } from "@msgpack/msgpack";
+import { AppSignalCb } from "../api/app";
+/**
+ * A Websocket client which can make requests and receive responses,
+ * as well as send and receive signals
+ *
+ * Uses Holochain's websocket WireMessage for communication.
+ */
+export declare class WsClient {
+    socket: Websocket;
+    pendingRequests: Record<number, {
+        fulfill: (msg: unknown) => ReturnType<typeof decode>;
+        reject: (error: Error) => void;
+    }>;
+    index: number;
+    alreadyWarnedNoSignalCb: boolean;
+    constructor(socket: any, signalCb?: AppSignalCb);
+    emitSignal(data: any): void;
+    request<Req, Res>(data: Req): Promise<Res>;
+    handleResponse(msg: any): void;
+    close(): Promise<void>;
+    awaitClose(): Promise<void>;
+    static connect(url: string, signalCb?: AppSignalCb): Promise<WsClient>;
+}