@waku/interfaces 0.0.13 → 0.0.15

package/CHANGELOG.md

@@ -5,6 +5,24 @@ All notable changes to this project will be documented in this file.
 The file is maintained by [Release Please](https://github.com/googleapis/release-please) based on [Conventional Commits](https://www.conventionalcommits.org) specification,
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [0.0.15](https://github.com/waku-org/js-waku/compare/interfaces-v0.0.14...interfaces-v0.0.15) (2023-06-08)
+
+
+### Features
+
+* Allow passing of multiple ENR URLs to DNS Discovery & dial multiple peers in parallel ([#1379](https://github.com/waku-org/js-waku/issues/1379)) ([f32d7d9](https://github.com/waku-org/js-waku/commit/f32d7d9fe0b930b4fa9c46b8644e6d21be45d5c1))
+
+## [0.0.14](https://github.com/waku-org/js-waku/compare/interfaces-v0.0.13...interfaces-v0.0.14) (2023-05-26)
+
+
+### ⚠ BREAKING CHANGES
+
+* filter v2 ([#1332](https://github.com/waku-org/js-waku/issues/1332))
+
+### Features
+
+* Filter v2 ([#1332](https://github.com/waku-org/js-waku/issues/1332)) ([8d0e647](https://github.com/waku-org/js-waku/commit/8d0e64796695fbafad0a033552eb4412bdff3d78))
+
 ## [0.0.13](https://github.com/waku-org/js-waku/compare/interfaces-v0.0.12...interfaces-v0.0.13) (2023-05-18)
 
 

package/dist/connection_manager.d.ts

@@ -13,4 +13,8 @@ export interface ConnectionManagerOptions {
      * This is used to increase intention of dialing non-bootstrap peers, found using other discovery mechanisms (like Peer Exchange)
      */
     maxBootstrapPeersAllowed: number;
+    /**
+     * Max number of parallel dials allowed
+     */
+    maxParallelDials: number;
 }

package/dist/filter.d.ts

@@ -1,3 +1,18 @@
-import type { PointToPointProtocol } from "./protocols.js";
+import type { PeerId } from "@libp2p/interface-peer-id";
+import type { IDecodedMessage, IDecoder } from "./message.js";
+import type { ContentTopic } from "./misc.js";
+import type { Callback, PointToPointProtocol } from "./protocols.js";
 import type { IReceiver } from "./receiver.js";
+export type ContentFilter = {
+    contentTopic: string;
+};
 export type IFilter = IReceiver & PointToPointProtocol;
+export interface IFilterV2Subscription {
+    subscribe<T extends IDecodedMessage>(decoders: IDecoder<T> | IDecoder<T>[], callback: Callback<T>): Promise<void>;
+    unsubscribe(contentTopics: ContentTopic[]): Promise<void>;
+    ping(): Promise<void>;
+    unsubscribeAll(): Promise<void>;
+}
+export type IFilterV2 = IReceiver & PointToPointProtocol & {
+    createSubscription(pubSubTopic?: string, peerId?: PeerId): Promise<IFilterV2Subscription>;
+};

package/dist/misc.d.ts

@@ -6,3 +6,4 @@ export interface IAsyncIterator<T extends IDecodedMessage> {
 export type Unsubscribe = () => void | Promise<void>;
 export type PubSubTopic = string;
 export type ContentTopic = string;
+export type PeerIdStr = string;

package/dist/protocols.d.ts

@@ -45,6 +45,12 @@ export type ProtocolCreateOptions = {
      * Use recommended bootstrap method to discovery and connect to new nodes.
      */
     defaultBootstrap?: boolean;
+    /**
+     * FilterV2 has been set to default
+     * Use this flag to enable the previous version of the filter protocol
+     * See [Improved Filter protocol specifications](https://github.com/vacp2p/rfc/pull/562)
+     */
+    useFilterV1?: boolean;
 };
 export type ProtocolOptions = {
     /**

package/dist/protocols.js.map

@@ -1 +1 @@
-{"version":3,"file":"protocols.js","sourceRoot":"","sources":["../src/protocols.ts"],"names":[],"mappings":"AAMA,MAAM,CAAN,IAAY,SAKX;AALD,WAAY,SAAS;IACnB,4BAAe,CAAA;IACf,4BAAe,CAAA;IACf,oCAAuB,CAAA;IACvB,8BAAiB,CAAA;AACnB,CAAC,EALW,SAAS,KAAT,SAAS,QAKpB;AAqDD,MAAM,CAAN,IAAY,SAMX;AAND,WAAY,SAAS;IACnB,2CAA8B,CAAA;IAC9B,+CAAkC,CAAA;IAClC,+CAAkC,CAAA;IAClC,6CAAgC,CAAA;IAChC,gDAAmC,CAAA;AACrC,CAAC,EANW,SAAS,KAAT,SAAS,QAMpB"}
+{"version":3,"file":"protocols.js","sourceRoot":"","sources":["../src/protocols.ts"],"names":[],"mappings":"AAMA,MAAM,CAAN,IAAY,SAKX;AALD,WAAY,SAAS;IACnB,4BAAe,CAAA;IACf,4BAAe,CAAA;IACf,oCAAuB,CAAA;IACvB,8BAAiB,CAAA;AACnB,CAAC,EALW,SAAS,KAAT,SAAS,QAKpB;AA2DD,MAAM,CAAN,IAAY,SAMX;AAND,WAAY,SAAS;IACnB,2CAA8B,CAAA;IAC9B,+CAAkC,CAAA;IAClC,+CAAkC,CAAA;IAClC,6CAAgC,CAAA;IAChC,gDAAmC,CAAA;AACrC,CAAC,EANW,SAAS,KAAT,SAAS,QAMpB"}

package/dist/receiver.d.ts

@@ -1,9 +1,10 @@
 import type { IDecodedMessage, IDecoder } from "./message.js";
-import type { ContentTopic, IAsyncIterator, PubSubTopic, Unsubscribe } from "./misc.js";
+import type { IAsyncIterator, PubSubTopic, Unsubscribe } from "./misc.js";
 import type { Callback, ProtocolOptions } from "./protocols.js";
+type ContentTopic = string;
 export type ActiveSubscriptions = Map<PubSubTopic, ContentTopic[]>;
 export interface IReceiver {
     toSubscriptionIterator: <T extends IDecodedMessage>(decoders: IDecoder<T> | IDecoder<T>[], opts?: ProtocolOptions) => Promise<IAsyncIterator<T>>;
     subscribe: <T extends IDecodedMessage>(decoders: IDecoder<T> | IDecoder<T>[], callback: Callback<T>, opts?: ProtocolOptions) => Unsubscribe | Promise<Unsubscribe>;
-    getActiveSubscriptions: () => ActiveSubscriptions;
 }
+export {};

package/dist/waku.d.ts

@@ -2,7 +2,7 @@ import type { Stream } from "@libp2p/interface-connection";
 import type { Libp2p } from "@libp2p/interface-libp2p";
 import type { PeerId } from "@libp2p/interface-peer-id";
 import type { Multiaddr } from "@multiformats/multiaddr";
-import type { IFilter } from "./filter.js";
+import type { IFilter, IFilterV2 } from "./filter.js";
 import type { ILightPush } from "./light_push.js";
 import { Protocols } from "./protocols.js";
 import type { IRelay } from "./relay.js";
@@ -11,7 +11,7 @@ export interface Waku {
     libp2p: Libp2p;
     relay?: IRelay;
     store?: IStore;
-    filter?: IFilter;
+    filter?: IFilter | IFilterV2;
     lightPush?: ILightPush;
     dial(peer: PeerId | Multiaddr, protocols?: Protocols[]): Promise<Stream>;
     start(): Promise<void>;
@@ -21,7 +21,7 @@ export interface Waku {
 export interface LightNode extends Waku {
     relay: undefined;
     store: IStore;
-    filter: IFilter;
+    filter: IFilter | IFilterV2;
     lightPush: ILightPush;
 }
 export interface RelayNode extends Waku {
@@ -33,6 +33,6 @@ export interface RelayNode extends Waku {
 export interface FullNode extends Waku {
     relay: IRelay;
     store: IStore;
-    filter: IFilter;
+    filter: IFilter | IFilterV2;
     lightPush: ILightPush;
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@waku/interfaces",
-  "version": "0.0.13",
+  "version": "0.0.15",
   "description": "Definition of Waku interfaces",
   "types": "./dist/index.d.ts",
   "module": "./dist/index.js",
@@ -57,9 +57,9 @@
     "@libp2p/interface-registrar": "^2.0.8",
     "@multiformats/multiaddr": "^12.0.0",
     "@typescript-eslint/eslint-plugin": "^5.57.0",
-    "@typescript-eslint/parser": "^5.51.0",
+    "@typescript-eslint/parser": "^5.59.8",
     "cspell": "^6.31.1",
-    "eslint": "^8.35.0",
+    "eslint": "^8.41.0",
     "eslint-config-prettier": "^8.6.0",
     "eslint-plugin-eslint-comments": "^3.2.0",
     "eslint-plugin-functional": "^5.0.4",

package/src/connection_manager.ts

@@ -14,4 +14,8 @@ export interface ConnectionManagerOptions {
    * This is used to increase intention of dialing non-bootstrap peers, found using other discovery mechanisms (like Peer Exchange)
    */
   maxBootstrapPeersAllowed: number;
+  /**
+   * Max number of parallel dials allowed
+   */
+  maxParallelDials: number;
 }

package/src/filter.ts

@@ -1,4 +1,33 @@
-import type { PointToPointProtocol } from "./protocols.js";
+import type { PeerId } from "@libp2p/interface-peer-id";
+
+import type { IDecodedMessage, IDecoder } from "./message.js";
+import type { ContentTopic } from "./misc.js";
+import type { Callback, PointToPointProtocol } from "./protocols.js";
 import type { IReceiver } from "./receiver.js";
 
+export type ContentFilter = {
+  contentTopic: string;
+};
+
 export type IFilter = IReceiver & PointToPointProtocol;
+
+export interface IFilterV2Subscription {
+  subscribe<T extends IDecodedMessage>(
+    decoders: IDecoder<T> | IDecoder<T>[],
+    callback: Callback<T>
+  ): Promise<void>;
+
+  unsubscribe(contentTopics: ContentTopic[]): Promise<void>;
+
+  ping(): Promise<void>;
+
+  unsubscribeAll(): Promise<void>;
+}
+
+export type IFilterV2 = IReceiver &
+  PointToPointProtocol & {
+    createSubscription(
+      pubSubTopic?: string,
+      peerId?: PeerId
+    ): Promise<IFilterV2Subscription>;
+  };

package/src/misc.ts

@@ -9,3 +9,5 @@ export type Unsubscribe = () => void | Promise<void>;
 
 export type PubSubTopic = string;
 export type ContentTopic = string;
+
+export type PeerIdStr = string;

package/src/protocols.ts

@@ -49,6 +49,12 @@ export type ProtocolCreateOptions = {
    * Use recommended bootstrap method to discovery and connect to new nodes.
    */
   defaultBootstrap?: boolean;
+  /**
+   * FilterV2 has been set to default
+   * Use this flag to enable the previous version of the filter protocol
+   * See [Improved Filter protocol specifications](https://github.com/vacp2p/rfc/pull/562)
+   */
+  useFilterV1?: boolean;
 };
 
 export type ProtocolOptions = {

package/src/receiver.ts

@@ -1,12 +1,9 @@
 import type { IDecodedMessage, IDecoder } from "./message.js";
-import type {
-  ContentTopic,
-  IAsyncIterator,
-  PubSubTopic,
-  Unsubscribe,
-} from "./misc.js";
+import type { IAsyncIterator, PubSubTopic, Unsubscribe } from "./misc.js";
 import type { Callback, ProtocolOptions } from "./protocols.js";
 
+type ContentTopic = string;
+
 export type ActiveSubscriptions = Map<PubSubTopic, ContentTopic[]>;
 
 export interface IReceiver {
@@ -19,5 +16,4 @@ export interface IReceiver {
     callback: Callback<T>,
     opts?: ProtocolOptions
   ) => Unsubscribe | Promise<Unsubscribe>;
-  getActiveSubscriptions: () => ActiveSubscriptions;
 }

package/src/waku.ts

@@ -3,7 +3,7 @@ import type { Libp2p } from "@libp2p/interface-libp2p";
 import type { PeerId } from "@libp2p/interface-peer-id";
 import type { Multiaddr } from "@multiformats/multiaddr";
 
-import type { IFilter } from "./filter.js";
+import type { IFilter, IFilterV2 } from "./filter.js";
 import type { ILightPush } from "./light_push.js";
 import { Protocols } from "./protocols.js";
 import type { IRelay } from "./relay.js";
@@ -13,7 +13,7 @@ export interface Waku {
   libp2p: Libp2p;
   relay?: IRelay;
   store?: IStore;
-  filter?: IFilter;
+  filter?: IFilter | IFilterV2;
   lightPush?: ILightPush;
 
   dial(peer: PeerId | Multiaddr, protocols?: Protocols[]): Promise<Stream>;
@@ -28,7 +28,7 @@ export interface Waku {
 export interface LightNode extends Waku {
   relay: undefined;
   store: IStore;
-  filter: IFilter;
+  filter: IFilter | IFilterV2;
   lightPush: ILightPush;
 }
 
@@ -42,6 +42,6 @@ export interface RelayNode extends Waku {
 export interface FullNode extends Waku {
   relay: IRelay;
   store: IStore;
-  filter: IFilter;
+  filter: IFilter | IFilterV2;
   lightPush: ILightPush;
 }