@agoric/network 0.1.1-orchestration-dev-096c4e8.0 → 0.1.1-other-dev-fbe72e7.0.fbe72e7

package/src/types.d.ts

@@ -1,34 +1,43 @@
-type PromiseVow<T> = Promise<T | import('@agoric/vow').Vow<T>>;
-type Data = string | Buffer | ArrayBuffer;
-type Bytes = string;
+/**
+ * Rearrange the exo types to make a cast of the methods (M) and init function (I) to a specific type.
+ */
+export type ExoClassMethods<M extends import("@endo/exo").Methods, I extends (...args: any[]) => any> = M & ThisType<{
+    self: import("@endo/exo").Guarded<M>;
+    state: ReturnType<I>;
+}>;
+/**
+ * Each character code carries 8-bit octets.  Eventually we want to use passable Uint8Arrays.
+ */
+export type Bytes = string;
 /**
  * A local or remote address See multiaddr.js for an
  *   opinionated router implementation
  */
-type Endpoint = string;
+export type Endpoint = string;
 /**
  * A closable object
  */
-type Closable = {
+export type ClosableI = {
     /**
      * Terminate the object
      */
     close: () => PromiseVow<void>;
 };
+export type Closable = RemotableObject & ClosableI;
 /**
  * The network Protocol
  */
-type Protocol = {
+export type Protocol = {
     /**
      * Claim a port, or if
      * ending in ENDPOINT_SEPARATOR, a fresh name
      */
-    bind: (prefix: Endpoint) => PromiseVow<Port>;
+    bindPort: (prefix: Endpoint) => PromiseVow<Port>;
 };
 /**
  * A port that has been bound to a protocol
  */
-type Port = {
+export type Port = {
     /**
      * Get the locally bound name of this
      * port
@@ -37,53 +46,59 @@ type Port = {
     /**
      *   Begin accepting incoming connections
      */
-    addListener: (acceptHandler: ListenHandler) => PromiseVow<void>;
+    addListener: (acceptHandler: Remote<ListenHandler>) => PromiseVow<void>;
     /**
      *   Make an outbound connection
      */
-    connect: (remote: Endpoint, connectionHandler?: ConnectionHandler) => PromiseVow<Connection>;
+    connect: (remote: Endpoint, connectionHandler?: Remote<ConnectionHandler>) => PromiseVow<Connection>;
     /**
      *   Remove the currently-bound listener
      */
-    removeListener: (acceptHandler: ListenHandler) => PromiseVow<void>;
+    removeListener: (acceptHandler: Remote<ListenHandler>) => PromiseVow<void>;
     /**
      * Deallocate the port entirely, removing all
      * listeners and closing all active connections
      */
-    revoke: () => void;
+    revoke: () => PromiseVow<void>;
 };
 /**
  * A handler for incoming connections
  */
-type ListenHandler = {
+export type ListenHandler = {
     /**
-     * The
-     * listener has been registered
+     * The listener has been registered
      */
-    onListen?: ((port: Port, l: ListenHandler) => PromiseVow<void>) | undefined;
+    onListen?: ((port: Remote<Port>, l: Remote<ListenHandler>) => PromiseVow<void>) | undefined;
     /**
      *   A new connection is incoming
      */
-    onAccept: (port: Port, localAddr: Endpoint, remoteAddr: Endpoint, l: ListenHandler) => PromiseVow<ConnectionHandler>;
+    onAccept: (port: Remote<Port>, localAddr: Endpoint, remoteAddr: Endpoint, l: Remote<ListenHandler>) => PromiseVow<Remote<ConnectionHandler>>;
     /**
      * The connection was rejected
      */
-    onReject?: ((port: Port, localAddr: Endpoint, remoteAddr: Endpoint, l: ListenHandler) => PromiseVow<void>) | undefined;
+    onReject?: ((port: Remote<Port>, localAddr: Endpoint, remoteAddr: Endpoint, l: Remote<ListenHandler>) => PromiseVow<void>) | undefined;
     /**
      * There was an error while listening
      */
-    onError?: ((port: Port, rej: any, l: ListenHandler) => PromiseVow<void>) | undefined;
+    onError?: ((port: Remote<Port>, rej: any, l: Remote<ListenHandler>) => PromiseVow<void>) | undefined;
     /**
      * The
      * listener has been removed
      */
-    onRemove?: ((port: Port, l: ListenHandler) => PromiseVow<void>) | undefined;
+    onRemove?: ((port: Remote<Port>, l: Remote<ListenHandler>) => PromiseVow<void>) | undefined;
+};
+export type WellKnownSendOptions = {
+    /**
+     * timeout the packet if an ack is not received by this time
+     */
+    relativeTimeoutNs?: bigint | undefined;
 };
-type Connection = {
+export type SendOptions = WellKnownSendOptions & Record<string, any>;
+export type ConnectionI = {
     /**
      *   Send a packet on the connection
      */
-    send: (packetBytes: Data, opts?: Record<string, any>) => PromiseVow<Bytes>;
+    send: (packetBytes: Bytes, opts?: SendOptions) => PromiseVow<Bytes>;
     /**
      * Close both ends of the connection
      */
@@ -98,29 +113,30 @@ type Connection = {
      */
     getRemoteAddress: () => Endpoint;
 };
+export type Connection = RemotableObject & ConnectionI;
 /**
  * A handler for a given Connection
  */
-type ConnectionHandler = {
+export type ConnectionHandler = {
     /**
      * The connection has been opened
      */
-    onOpen?: ((connection: Connection, localAddr: Endpoint, remoteAddr: Endpoint, c: ConnectionHandler) => PromiseVow<void>) | undefined;
+    onOpen?: ((connection: Remote<Connection>, localAddr: Endpoint, remoteAddr: Endpoint, c: Remote<ConnectionHandler>) => PromiseVow<void>) | undefined;
     /**
      * The connection received a packet
      */
-    onReceive?: ((connection: Connection, ack: Bytes, c: ConnectionHandler, opts?: Record<string, any>) => PromiseVow<Data>) | undefined;
+    onReceive?: ((connection: Remote<Connection>, ack: Bytes, c: Remote<ConnectionHandler>, opts?: Record<string, any>) => PromiseVow<Bytes>) | undefined;
     /**
      * The connection has been closed
      */
-    onClose?: ((connection: Connection, reason?: CloseReason, c?: ConnectionHandler) => PromiseVow<void>) | undefined;
+    onClose?: ((connection: Remote<Connection>, reason?: CloseReason, c?: Remote<ConnectionHandler>) => PromiseVow<void>) | undefined;
 };
 /**
  * The reason a connection was closed
  */
-type CloseReason = any | null;
-type AttemptDescription = {
-    handler: ConnectionHandler;
+export type CloseReason = any | null;
+export type AttemptDescription = {
+    handler: Remote<ConnectionHandler>;
     remoteAddress?: string | undefined;
     localAddress?: string | undefined;
 };
@@ -128,44 +144,44 @@ type AttemptDescription = {
  * A handler for things the protocol
  *   implementation will invoke
  */
-type ProtocolHandler = {
+export type ProtocolHandler = {
     /**
      *   This protocol is created
      */
-    onCreate: (protocol: ProtocolImpl, p: ProtocolHandler) => PromiseVow<void>;
+    onCreate: (protocol: Remote<ProtocolImpl>, p: Remote<ProtocolHandler>) => PromiseVow<void>;
     /**
      *   Create a fresh port identifier for this protocol
      */
-    generatePortID: (localAddr: Endpoint, p: ProtocolHandler) => PromiseVow<string>;
+    generatePortID: (localAddr: Endpoint, p: Remote<ProtocolHandler>) => PromiseVow<string>;
     /**
      *   A port will be bound
      */
-    onBind: (port: Port, localAddr: Endpoint, p: ProtocolHandler) => PromiseVow<void>;
+    onBind: (port: Remote<Port>, localAddr: Endpoint, p: Remote<ProtocolHandler>) => PromiseVow<void>;
     /**
      *   A port was listening
      */
-    onListen: (port: Port, localAddr: Endpoint, listenHandler: ListenHandler, p: ProtocolHandler) => PromiseVow<void>;
+    onListen: (port: Remote<Port>, localAddr: Endpoint, listenHandler: Remote<ListenHandler>, p: Remote<ProtocolHandler>) => PromiseVow<void>;
     /**
      *   A port listener has been reset
      */
-    onListenRemove: (port: Port, localAddr: Endpoint, listenHandler: ListenHandler, p: ProtocolHandler) => PromiseVow<void>;
+    onListenRemove: (port: Remote<Port>, localAddr: Endpoint, listenHandler: Remote<ListenHandler>, p: Remote<ProtocolHandler>) => PromiseVow<void>;
     /**
      * Return unique suffix for local address
      */
-    onInstantiate?: ((port: Port, localAddr: Endpoint, remote: Endpoint, p: ProtocolHandler) => PromiseVow<Endpoint>) | undefined;
+    onInstantiate?: ((port: Remote<Port>, localAddr: Endpoint, remote: Endpoint, p: Remote<ProtocolHandler>) => PromiseVow<Endpoint>) | undefined;
     /**
      *   A port initiates an outbound connection
      */
-    onConnect: (port: Port, localAddr: Endpoint, remote: Endpoint, c: ConnectionHandler, p: ProtocolHandler) => PromiseVow<AttemptDescription>;
+    onConnect: (port: Remote<Port>, localAddr: Endpoint, remote: Endpoint, c: Remote<ConnectionHandler>, p: Remote<ProtocolHandler>) => PromiseVow<AttemptDescription>;
     /**
      *   The port is being completely destroyed
      */
-    onRevoke: (port: Port, localAddr: Endpoint, p: ProtocolHandler) => PromiseVow<void>;
+    onRevoke: (port: Remote<Port>, localAddr: Endpoint, p: Remote<ProtocolHandler>) => PromiseVow<void>;
 };
 /**
  * An inbound connection attempt
  */
-type InboundAttempt = {
+export type InboundAttempt = {
     /**
      *   Establish the connection
      */
@@ -188,12 +204,12 @@ type InboundAttempt = {
 /**
  * Things the protocol can do for us
  */
-type ProtocolImpl = {
+export type ProtocolImpl = {
     /**
      * Claim a port, or if
      * ending in ENDPOINT_SEPARATOR, a fresh name
      */
-    bind: (prefix: Endpoint) => PromiseVow<Port>;
+    bindPort: (prefix: Endpoint) => PromiseVow<Remote<Port>>;
     /**
      *   Make an attempt to connect into this protocol
      */
@@ -201,6 +217,9 @@ type ProtocolImpl = {
     /**
      *   Create an outbound connection
      */
-    outbound: (port: Port, remoteAddr: Endpoint, connectionHandler: ConnectionHandler) => PromiseVow<Connection>;
+    outbound: (port: Remote<Port>, remoteAddr: Endpoint, connectionHandler: Remote<ConnectionHandler>) => PromiseVow<Connection>;
 };
+import type { PromiseVow } from '@agoric/vow';
+import type { RemotableObject } from '@endo/pass-style';
+import type { Remote } from '@agoric/vow';
 //# sourceMappingURL=types.d.ts.map

package/src/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["types.js"],"names":[],"mappings":"qBAIa,QAAQ,CAAC,GAAG,OAAO,aAAa,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC;YAIzC,MAAM,GAAG,MAAM,GAAG,WAAW;aAE7B,MAAM;;;;;gBAIN,MAAM;;;;;;;;WAML,MAAM,WAAW,IAAI,CAAC;;;;;;;;;;mBAKb,QAAQ,KAAK,WAAW,IAAI,CAAC;;;;;;;;;;qBAMtC,MAAM,QAAQ;;;;iCAEE,aAAa,KAAK,WAAW,IAAI,CAAC;;;;sBAGnD,QAAQ,sBACI,iBAAiB,KAClC,WAAW,UAAU,CAAC;;;;oCAEA,aAAa,KAAK,WAAW,IAAI,CAAC;;;;;YAElD,MAAM,IAAI;;;;;;;;;;uBAMH,IAAI,KAAK,aAAa,KAAK,WAAW,IAAI,CAAC;;;;qBAGrD,IAAI,aACC,QAAQ,cACP,QAAQ,KACjB,aAAa,KACb,WAAW,iBAAiB,CAAC;;;;uBAG1B,IAAI,aACC,QAAQ,cACP,QAAQ,KACjB,aAAa,KACb,WAAW,IAAI,CAAC;;;;sBAEH,IAAI,OAAO,GAAG,KAAK,aAAa,KAAK,WAAW,IAAI,CAAC;;;;;uBAErD,IAAI,KAAK,aAAa,KAAK,WAAW,IAAI,CAAC;;;;;;wBAO9C,IAAI,SACV,OAAO,MAAM,EAAE,GAAG,CAAC,KACvB,WAAW,KAAK,CAAC;;;;WAEX,MAAM,WAAW,IAAI,CAAC;;;;;qBACtB,MAAM,QAAQ;;;;sBAEd,MAAM,QAAQ;;;;;;;;;2BAMX,UAAU,aACX,QAAQ,cACP,QAAQ,KACjB,iBAAiB,KACjB,WAAW,IAAI,CAAC;;;;8BAGP,UAAU,OACjB,KAAK,KACP,iBAAiB,SACb,OAAO,MAAM,EAAE,GAAG,CAAC,KACvB,WAAW,IAAI,CAAC;;;;4BAGP,UAAU,WACb,WAAW,MAChB,iBAAiB,KAClB,WAAW,IAAI,CAAC;;;;;mBAGX,GAAG,GAAG,IAAI;;aAKT,iBAAiB;;;;;;;;;;;;yBAQN,YAAY,KAAK,eAAe,KAAK,WAAW,IAAI,CAAC;;;;gCAEpD,QAAQ,KAAK,eAAe,KAAK,WAAW,MAAM,CAAC;;;;mBAGlE,IAAI,aACC,QAAQ,KAChB,eAAe,KACf,WAAW,IAAI,CAAC;;;;qBAGb,IAAI,aACC,QAAQ,iBACJ,aAAa,KACzB,eAAe,KACf,WAAW,IAAI,CAAC;;;;2BAGb,IAAI,aACC,QAAQ,iBACJ,aAAa,KACzB,eAAe,KACf,WAAW,IAAI,CAAC;;;;4BAGb,IAAI,aACC,QAAQ,UACX,QAAQ,KACb,eAAe,KACf,WAAW,QAAQ,CAAC;;;;sBAGjB,IAAI,aACC,QAAQ,UACX,QAAQ,KACb,iBAAiB,KACjB,eAAe,KACf,WAAW,kBAAkB,CAAC;;;;qBAG3B,IAAI,aACC,QAAQ,KAChB,eAAe,KACf,WAAW,IAAI,CAAC;;;;;;;;;mBAIH,kBAAkB,KAAK,WAAW,UAAU,CAAC;;;;;qBAEpD,MAAM,QAAQ;;;;;sBAEd,MAAM,QAAQ;;;;WAEd,MAAM,WAAW,IAAI,CAAC;;;;;;;;;;mBAGb,QAAQ,KAAK,WAAW,IAAI,CAAC;;;;0BAGnC,QAAQ,cACR,QAAQ,KACjB,WAAW,cAAc,CAAC;;;;qBAGvB,IAAI,cACE,QAAQ,qBACD,iBAAiB,KACjC,WAAW,UAAU,CAAC"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["types.js"],"names":[],"mappings":"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"}

package/src/types.js

@@ -1,14 +1,22 @@
 // @ts-check
 
+// Ensure this is a module.
+export {};
+
 /**
- * @template T
- * @typedef {Promise<T | import('@agoric/vow').Vow<T>>} PromiseVow
+ * @import {Passable, RemotableObject} from '@endo/pass-style';
+ * @import {PromiseVow, Remote} from '@agoric/vow';
  */
 
 /**
- * @typedef {string | Buffer | ArrayBuffer} Data
- *
- * @typedef {string} Bytes
+ * @template {import('@endo/exo').Methods} M
+ * @template {(...args: any[]) => any} I
+ * @typedef {M & ThisType<{ self: import('@endo/exo').Guarded<M>, state: ReturnType<I> }>} ExoClassMethods
+ * Rearrange the exo types to make a cast of the methods (M) and init function (I) to a specific type.
+ */
+
+/**
+ * @typedef {string} Bytes Each character code carries 8-bit octets.  Eventually we want to use passable Uint8Arrays.
  */
 
 /**
@@ -17,13 +25,16 @@
  */
 
 /**
- * @typedef {object} Closable A closable object
+ * @typedef {object} ClosableI A closable object
  * @property {() => PromiseVow<void>} close Terminate the object
  */
+/**
+ * @typedef {RemotableObject & ClosableI} Closable
+ */
 
 /**
  * @typedef {object} Protocol The network Protocol
- * @property {(prefix: Endpoint) => PromiseVow<Port>} bind Claim a port, or if
+ * @property {(prefix: Endpoint) => PromiseVow<Port>} bindPort Claim a port, or if
  *   ending in ENDPOINT_SEPARATOR, a fresh name
  */
 
@@ -31,48 +42,56 @@
  * @typedef {object} Port A port that has been bound to a protocol
  * @property {() => Endpoint} getLocalAddress Get the locally bound name of this
  *   port
- * @property {(acceptHandler: ListenHandler) => PromiseVow<void>} addListener
+ * @property {(acceptHandler: Remote<ListenHandler>) => PromiseVow<void>} addListener
  *   Begin accepting incoming connections
  * @property {(
  *   remote: Endpoint,
- *   connectionHandler?: ConnectionHandler,
+ *   connectionHandler?: Remote<ConnectionHandler>,
  * ) => PromiseVow<Connection>} connect
  *   Make an outbound connection
- * @property {(acceptHandler: ListenHandler) => PromiseVow<void>} removeListener
+ * @property {(acceptHandler: Remote<ListenHandler>) => PromiseVow<void>} removeListener
  *   Remove the currently-bound listener
- * @property {() => void} revoke Deallocate the port entirely, removing all
+ * @property {() => PromiseVow<void>} revoke Deallocate the port entirely, removing all
  *   listeners and closing all active connections
  */
 
 /**
  * @typedef {object} ListenHandler A handler for incoming connections
- * @property {(port: Port, l: ListenHandler) => PromiseVow<void>} [onListen] The
- *   listener has been registered
+ * @property {(port: Remote<Port>, l: Remote<ListenHandler>) => PromiseVow<void>} [onListen] The listener has been registered
  * @property {(
- *   port: Port,
+ *   port: Remote<Port>,
  *   localAddr: Endpoint,
  *   remoteAddr: Endpoint,
- *   l: ListenHandler,
- * ) => PromiseVow<ConnectionHandler>} onAccept
+ *   l: Remote<ListenHandler>,
+ * ) => PromiseVow<Remote<ConnectionHandler>>} onAccept
  *   A new connection is incoming
  * @property {(
- *   port: Port,
+ *   port: Remote<Port>,
  *   localAddr: Endpoint,
  *   remoteAddr: Endpoint,
- *   l: ListenHandler,
+ *   l: Remote<ListenHandler>,
  * ) => PromiseVow<void>} [onReject]
  *   The connection was rejected
- * @property {(port: Port, rej: any, l: ListenHandler) => PromiseVow<void>} [onError]
+ * @property {(port: Remote<Port>, rej: any, l: Remote<ListenHandler>) => PromiseVow<void>} [onError]
  *   There was an error while listening
- * @property {(port: Port, l: ListenHandler) => PromiseVow<void>} [onRemove] The
+ * @property {(port: Remote<Port>, l: Remote<ListenHandler>) => PromiseVow<void>} [onRemove] The
  *   listener has been removed
  */
 
 /**
- * @typedef {object} Connection
+ * @typedef {object} WellKnownSendOptions
+ * @property {bigint} [relativeTimeoutNs] timeout the packet if an ack is not received by this time
+ */
+
+/**
+ * @typedef {WellKnownSendOptions & Record<string, any>} SendOptions
+ */
+
+/**
+ * @typedef {object} ConnectionI
  * @property {(
- *   packetBytes: Data,
- *   opts?: Record<string, any>,
+ *   packetBytes: Bytes,
+ *   opts?: SendOptions,
  * ) => PromiseVow<Bytes>} send
  *   Send a packet on the connection
  * @property {() => PromiseVow<void>} close Close both ends of the connection
@@ -80,27 +99,30 @@
  *   connection
  * @property {() => Endpoint} getRemoteAddress Get the name of the counterparty
  */
+/**
+ * @typedef {RemotableObject & ConnectionI} Connection
+ */
 
 /**
  * @typedef {object} ConnectionHandler A handler for a given Connection
  * @property {(
- *   connection: Connection,
+ *   connection: Remote<Connection>,
  *   localAddr: Endpoint,
  *   remoteAddr: Endpoint,
- *   c: ConnectionHandler,
+ *   c: Remote<ConnectionHandler>,
  * ) => PromiseVow<void>} [onOpen]
  *   The connection has been opened
  * @property {(
- *   connection: Connection,
+ *   connection: Remote<Connection>,
  *   ack: Bytes,
- *   c: ConnectionHandler,
+ *   c: Remote<ConnectionHandler>,
  *   opts?: Record<string, any>,
- * ) => PromiseVow<Data>} [onReceive]
+ * ) => PromiseVow<Bytes>} [onReceive]
  *   The connection received a packet
  * @property {(
- *   connection: Connection,
+ *   connection: Remote<Connection>,
  *   reason?: CloseReason,
- *   c?: ConnectionHandler,
+ *   c?: Remote<ConnectionHandler>,
  * ) => PromiseVow<void>} [onClose]
  *   The connection has been closed
  *
@@ -109,7 +131,7 @@
 
 /**
  * @typedef {object} AttemptDescription
- * @property {ConnectionHandler} handler
+ * @property {Remote<ConnectionHandler>} handler
  * @property {Endpoint} [remoteAddress]
  * @property {Endpoint} [localAddress]
  */
@@ -117,49 +139,49 @@
 /**
  * @typedef {object} ProtocolHandler A handler for things the protocol
  *   implementation will invoke
- * @property {(protocol: ProtocolImpl, p: ProtocolHandler) => PromiseVow<void>} onCreate
+ * @property {(protocol: Remote<ProtocolImpl>, p: Remote<ProtocolHandler>) => PromiseVow<void>} onCreate
  *   This protocol is created
- * @property {(localAddr: Endpoint, p: ProtocolHandler) => PromiseVow<string>} generatePortID
+ * @property {(localAddr: Endpoint, p: Remote<ProtocolHandler>) => PromiseVow<string>} generatePortID
  *   Create a fresh port identifier for this protocol
  * @property {(
- *   port: Port,
+ *   port: Remote<Port>,
  *   localAddr: Endpoint,
- *   p: ProtocolHandler,
+ *   p: Remote<ProtocolHandler>,
  * ) => PromiseVow<void>} onBind
  *   A port will be bound
  * @property {(
- *   port: Port,
+ *   port: Remote<Port>,
  *   localAddr: Endpoint,
- *   listenHandler: ListenHandler,
- *   p: ProtocolHandler,
+ *   listenHandler: Remote<ListenHandler>,
+ *   p: Remote<ProtocolHandler>,
  * ) => PromiseVow<void>} onListen
  *   A port was listening
  * @property {(
- *   port: Port,
+ *   port: Remote<Port>,
  *   localAddr: Endpoint,
- *   listenHandler: ListenHandler,
- *   p: ProtocolHandler,
+ *   listenHandler: Remote<ListenHandler>,
+ *   p: Remote<ProtocolHandler>,
  * ) => PromiseVow<void>} onListenRemove
  *   A port listener has been reset
  * @property {(
- *   port: Port,
+ *   port: Remote<Port>,
  *   localAddr: Endpoint,
  *   remote: Endpoint,
- *   p: ProtocolHandler,
+ *   p: Remote<ProtocolHandler>,
  * ) => PromiseVow<Endpoint>} [onInstantiate]
  *   Return unique suffix for local address
  * @property {(
- *   port: Port,
+ *   port: Remote<Port>,
  *   localAddr: Endpoint,
  *   remote: Endpoint,
- *   c: ConnectionHandler,
- *   p: ProtocolHandler,
+ *   c: Remote<ConnectionHandler>,
+ *   p: Remote<ProtocolHandler>,
  * ) => PromiseVow<AttemptDescription>} onConnect
  *   A port initiates an outbound connection
  * @property {(
- *   port: Port,
+ *   port: Remote<Port>,
  *   localAddr: Endpoint,
- *   p: ProtocolHandler,
+ *   p: Remote<ProtocolHandler>,
  * ) => PromiseVow<void>} onRevoke
  *   The port is being completely destroyed
  *
@@ -173,7 +195,7 @@
  * @property {() => PromiseVow<void>} close Abort the attempt
  *
  * @typedef {object} ProtocolImpl Things the protocol can do for us
- * @property {(prefix: Endpoint) => PromiseVow<Port>} bind Claim a port, or if
+ * @property {(prefix: Endpoint) => PromiseVow<Remote<Port>>} bindPort Claim a port, or if
  *   ending in ENDPOINT_SEPARATOR, a fresh name
  * @property {(
  *   listenAddr: Endpoint,
@@ -181,9 +203,9 @@
  * ) => PromiseVow<InboundAttempt>} inbound
  *   Make an attempt to connect into this protocol
  * @property {(
- *   port: Port,
+ *   port: Remote<Port>,
  *   remoteAddr: Endpoint,
- *   connectionHandler: ConnectionHandler,
+ *   connectionHandler: Remote<ConnectionHandler>,
  * ) => PromiseVow<Connection>} outbound
  *   Create an outbound connection
  */

package/exported.js

@@ -1 +0,0 @@
-import './src/types.js';

package/tsconfig.build.json

@@ -1,6 +0,0 @@
-{
-    "extends": [
-        "./tsconfig.json",
-        "../../tsconfig-build-options.json"
-    ]
-}

package/tsconfig.json

@@ -1,14 +0,0 @@
-{
-  "extends": "../../tsconfig.json",
-  "compilerOptions": {
-    "checkJs": false,
-    "maxNodeModuleJsDepth": 1,
-  },
-  "include": [
-    "*.js",
-    "scripts/**/*.js",
-    "src/**/*.js",
-    "test/**/*.js",
-    "tools/**/*.js",
-  ],
-}

package/typedoc.json

@@ -1,9 +0,0 @@
-{
-    "extends": [
-        "../../typedoc.base.json"
-    ],
-    "entryPoints": [
-        "./src/index.js",
-        "./src/types.js",
-    ]
-}