@streamr/cli-tools 0.0.1-tatum.0

package/OLD_CHANGELOG.md

@@ -0,0 +1,141 @@
+# Old Changelog
+
+Versions before 7.0.0 and below are collected into this file. Changelogs for
+newer versions of the cli-tool are available at the root-level CHANGELOG.md
+file.
+
+## [6.1.1] - 2022-11-03
+
+### Fixed
+
+- Fix `streamr governance vote` command
+
+
+## [6.1.0] - 2022-10-31
+
+### Added
+
+- Add command `streamr governance vote` for casting votes on Streamr governance proposals
+
+
+## [6.0.0] - 2022-02-23
+
+- Add new command `stream wallet whoami` to display Ethereum address
+- (Breaking) `stream create` argument is a stream ID, not a name
+- Support path notation when defining a stream ID
+- (Breaking) Remove `misc get-session-token` command
+- (Breaking) Change permission names and arguments:
+  - renamed `--operation` to `--permission` in `stream list`
+  - the data format of `permissions` returned by `--include-permissions` of `stream show` 
+  - enum values updated for all commands: `subscribe`, `publish`, `edit`, `delete` and `grant`
+- (Breaking) Remove `lastUpdated` and `name` columns from `stream list` output
+- (Breaking) Modify configuration management:
+  - can read config from `~/.streamr/config/default.json`
+  - `--config` argument added
+  - `--stg`, `--http-url` and `--ws-url` arguments removed
+- (Breaking) Rename `--config` argument to `--stream-config` in `stream create`
+- (Breaking) Remove `stream list` command
+- Add `stream search` command
+- (Breaking) Rename `--partition-key` argument to `--partition-key-field` in `stream publish`
+- Bump dependency streamr-client to 6.1.0
+- Bump dependency commander to 8.3.0
+
+## 5.0.1 - 2021-06-04
+
+- Add permission commands: `stream grant-permission` and `stream revoke-permission`
+- Remove `typescript` and `ts-node` as run-time dependencies
+- (Breaking) Remove `--msg-chain-id` parameter from `stream resend from`
+
+
+## [5.0.0] - 2021-05-05
+
+### Added
+- Add storage node commands under `streamr storage-node`
+
+### Changed
+- (Breaking) Commands are divided to subcommands: most of the existing command are under `streamr stream`, and `generate` command under `streamr mock-data`
+  - `streamr subscribe` is now `streamr stream subscribe`
+  - `streamr publish` is now `streamr stream publish`
+  - `streamr list` is now `streamr stream list`
+  - `streamr show` is now `streamr stream show`
+  - `streamr create` is now `streamr stream create`
+  - `streamr resend` is now `streamr stream resend`
+  - `streamr generate` is now `streamr mock-data generate`
+- Fixed examples of --private-key in README
+- Internal implementation was converted to TypeScript
+- Bump dependency streamr-client to 5.2.1
+- Bump dependency commander to 7.2.0
+
+
+## [4.1.1] - 2021-02-11
+
+### Changed
+- Bump dependency streamr-client to 5.0.0-beta.6
+- Bump dependency commander to ^6.1.0
+
+
+## [4.1.0] - 2020-10-12
+
+### Changed
+- Bump dependency streamr-client to ^4.1.1.
+- Turn option `--privateKey` into `--private-key` for consistency.
+- Turn `--apiKey` into `--api-key` for consistency.
+
+
+## [4.0.0] - 2020-06-18
+
+### Added
+
+- Ethereum authentication with `--privateKey <key>`. This also enables message signing when publishing messages.
+
+### Changed
+
+- (Breaking) Rename command `listen` to `subscribe`.
+- (Breaking) API key is now given with `--apiKey <key>`. API keys are deprecated. Option `--privateKey` should be preferred.
+
+## [3.1.1] - 2020-04-16
+
+### Added
+
+- Add `--subscribe` flag to commands `streamr resend from` and `streamr resend last`. This causes the command to resend and subscribe. 
+
+### Changed
+
+- Bump dependency streamr-client to ^3.1.3.
+
+
+## [3.1.0] - 2019-12-12
+
+### Added
+
+- Add `--disable-ordering` flag to command `streamr listen` for disabling
+ordering and gap filling.
+- Add `--disable-ordering` flag to commands `streamr resend *` to disabling
+ordering and gap filling.
+
+
+## [3.0.1] - 2019-10-14
+
+### Added
+
+- Start keeping a CHANGELOG.md.
+
+### Changed
+- Bump dependency streamr-client to ^2.2.7.
+- Bump dependency commander to ^4.0.1.
+- Re-organize README.md and a few touches to Developing section paragraphs.
+
+
+[Unreleased]: https://github.com/streamr-dev/network/compare/cli-tools%2fv8.3.1...HEAD
+[8.3.1]: https://github.com/streamr-dev/network/compare/cli-tools%2fv7.0.0...cli-tools%2fv8.3.1
+[7.0.0]: https://github.com/streamr-dev/network/compare/cli-tools%2fv6.1.1...cli-tools%2fv7.0.0
+[6.1.1]: https://github.com/streamr-dev/network/compare/cli-tools%2fv6.1.0...cli-tools%2fv6.1.1
+[6.1.0]: https://github.com/streamr-dev/network/compare/cli-tools%2fv6.0.0...cli-tools%2fv6.1.0
+[6.0.0]: https://github.com/streamr-dev/network/compare/cli-tools%2fv5.0.1...cli-tools%2fv6.0.0
+[5.0.0]: https://github.com/streamr-dev/cli-tools/compare/v4.1.1...v5.0.0
+[4.1.1]: https://github.com/streamr-dev/cli-tools/compare/v4.1.0...v4.1.1
+[4.1.0]: https://github.com/streamr-dev/cli-tools/compare/v4.0.0...v4.1.0
+[4.0.0]: https://github.com/streamr-dev/cli-tools/compare/v3.1.1...v4.0.0
+[3.1.1]: https://github.com/streamr-dev/cli-tools/compare/v3.1.0...v3.1.1
+[3.1.0]: https://github.com/streamr-dev/cli-tools/compare/v3.0.1...v3.1.0
+[3.0.1]: https://github.com/streamr-dev/cli-tools/compare/v3.0.0...v3.0.1

package/README.md

@@ -0,0 +1,225 @@
+<p align="center">
+  <a href="https://streamr.network">
+    <img alt="Streamr" src="https://raw.githubusercontent.com/streamr-dev/network-monorepo/main/packages/client/readme-header.png" width="1320" />
+  </a>
+</p>
+
+# @streamr/cli-tools
+
+Command line tool for interacting with [Streamr](https://streamr.network).
+
+See [Changelog](CHANGELOG.md) for version information and changes.
+
+## Table of Contents
+- [Install](#install)
+- [Use](#use)
+
+## Install
+```
+npm install -g @streamr/cli-tools
+```
+Node.js `16.13.x` is the minimum required version. Node.js `18.12.x`, NPM `8.x` and later versions are recommended.
+
+## Use
+All commands follow pattern `streamr <command> <subcommand>`, e.g.
+```
+streamr stream subscribe
+streamr mock-data generate
+```
+
+To get a list of all commands simply run `streamr`. To list subcommands run e.g. `streamr stream`
+
+Run `streamr <command> <subcommand> --help` to get more information about a a command, its options, and so forth.
+
+If there is a stream parameter in a command, it can be defined as a full id (e.g. `0x1234567890123456789012345678901234567890/foo/bar`) or a path (e.g. `/foo/bar`). If path notation is used, the stream ID is made by prefixing the authenticated Ethereum address (`--private-key <key>`) to the path.
+
+### Subscribe
+Used to subscribe to a stream and output real-time JSON objects to stdout line-by-line.
+
+For example, to subscribe to a public stream such as the tram demo do
+```
+streamr stream subscribe streamr.eth/demos/helsinki-trams
+```
+
+To subscribe to a private stream and authenticate with an Ethereum private key:
+
+```
+streamr stream subscribe streamId --private-key <key>
+```
+
+To subscribe to a particular [stream partition](https://streamr.network/docs/streams/partitioning), use the partition flag:
+
+```
+streamr stream subscribe streamId -p <partition_number>
+```
+
+###  Publish
+Used to publish events to a stream from stdin line-by-line. Each line should be a valid JSON object.
+
+Example of use:
+```
+streamr stream publish <streamId> --private-key <key>
+```
+
+
+### Generate
+Generate random JSON objects to stdout line-by-line.
+
+Useful for generating test data to be published to a stream with `publish`, e.g.:
+```
+streamr mock-data generate | streamr stream publish <streamId> --private-key <key>
+```
+
+### Search
+Query a list of streams by a search term and/or permissions. E.g.:
+```
+streamr stream search foobar --user 0x1234567890123456789012345678901234567890
+```
+
+#### Search term
+A search term query searchers over the stream id field. E.g:
+```
+streamr stream search foobar
+```
+It could find these streams:
+```
+0x1234567890123456789012345678901234567890/abc/foobar/1
+foobar.eth/lorem-ipsum
+```
+
+#### Permission
+A permission query searches over stream permissions. You can either query by direct permissions (which are explicitly granted to a user), or by all permissions (including public permissions, which apply to all users).
+
+E.g. all streams where a user has some direct permission:
+```
+streamr stream search --user 0x1234567890123456789012345678901234567890
+```
+All streams accessible by a user:
+```
+streamr stream search --user 0x1234567890123456789012345678901234567890 --public
+```
+
+The argument of the `--user` option can be omitted. In that case, it defaults to the authenticated user (specified by `--private-key`).
+
+It is also possible to filter by specific permissions by using `--all` and `--any`. E.g. if you want to find the streams you can subscribe to:
+```
+streamr stream search --user --public --all subscribe --private-key <key>
+```
+
+If more than one permission is needed, specify the permissions in a comma-separated list (e.g. `--all subscribe,publish`). It returns streams where _all_ listed permissions are granted. If just _any_ of the permissions is required, use `--any` instead of `--all`. Please prefer `--all` to `--any` when possible as it has better query performance.
+
+### Show
+Show detailed information about a specific stream
+```
+streamr stream show <streamId> --private-key <key>
+```
+
+### Create
+Create a new stream
+```
+streamr stream create <streamId> --private-key <key>
+```
+E.g.
+```
+streamr stream create /foo/bar
+streamr stream create 0x1234567890123456789012345678901234567890/foobar
+streamr stream create yourdomain.ens/foobar
+```
+
+
+### Resend
+Request a resend of historical data printed as JSON objects to stdout line-by-line.
+
+For example, to fetch the 10 latest messages of a public stream such as the tram demo do
+```
+streamr stream resend last 10 streamr.eth/demos/helsinki-trams
+```
+
+
+To fetch data starting from a particular date-time
+```
+streamr stream resend from 2019-05-10T17:00:00 <streamId> --private-key <key>
+```
+
+To fetch data between two date-times
+```
+streamr stream resend range 2019-05-10T17:00:00 2019-05-11T21:00:00 <streamId> --private-key <key>
+```
+
+### Vote
+
+The CLI tool can be used to vote on Streamr governance proposals as an alternative to doing it manually in the [voting UI](https://vote.streamr.network). This is useful if you have tokens in a large number of wallets (for example due to staking) and you therefore prefer to cast your votes programmatically.
+
+```
+streamr governance vote <proposalId> <choiceId> --private-key <key>
+```
+
+The easiest way to find the `proposalId` is to click on a proposal in the [voting UI](https://vote.streamr.network) and then look at the browser URL. The URL has the form `https://vote.streamr.network/#/proposal/<proposalId>`, i.e. the last part of the URL is the `proposalId`. It starts with `0x...`.
+
+The `choiceId` is just a sequence number. You can again use the UI to check what the choices are. The first option from the top is `1`, the next one is `2`, and so on. For example:
+
+```
+streamr governance vote 0x2109759e060ba5a37d70be00522e00da77397f838c01c12f74c8d834ad4f4b0c 1 --private-key <key>
+```
+
+You must pass either the `--private-key` or `--config` option.
+
+### Configuration
+
+User can specify environment and authentication details with the following command line arguments:
+- `--private-key <key>`, e.g. `--private-key 0x1234567890123456789012345678901234567890123456789012345678901234`
+- `--config <file>`, e.g. `--config foobar.json`
+- `--dev` use the pre-defined [development environment](https://github.com/streamr-dev/streamr-docker-dev)
+
+The `--config` argument tries to read a configuration file from the current working directory (either without a file extension, or with `.json` extension added). It also tries to read it from `~/.streamr/config/${id}.json` dotfile.
+
+If no `--config` argument is specified, default settings are read from `~/.streamr/config/default.json`, if that file exists.
+
+The configuration file is a JSON. It has one root-level property `client`, which contains any configuration properties for the [streamr-client-javascript](https://github.com/streamr-dev/network-monorepo/blob/main/packages/client/) client. Example:
+```
+{
+    "client": {
+        "auth": {
+            "privateKey": ...
+        }
+    }
+}
+```
+
+### Examples: Piping with subscribe and publish
+
+You can use the piping facilities of your *nix operating system with commands `publish` and `subscribe` to achieve some
+useful operations. Below is a list of some ideas.
+
+#### Subscribing to a stream from any programming language
+You can pipe the line-by-line JSON objects output by `subscribe` to
+your program written in any language. Just make the program read JSON objects
+from stdin.
+```
+streamr stream subscribe streamr.eth/demos/helsinki-trams | ruby calculate-average-speed.rb
+```
+
+#### Publishing to a stream from any programming language
+If your program produces JSON objects to stdout (line-by-line), you can
+redirect it to command `publish` to publish the JSON objects to a stream.
+```
+python printSensorReadingsAsJson.py | streamr stream publish <streamId> --private-key <key>
+```
+
+#### Transforming streams
+You can also subscribe to a stream, apply a transformation, and then pipe the
+transformed output into another stream.
+```
+streamr stream subscribe <sourceStream> | ./calculateMovingAverages | streamr stream publish <destinationStream> --private-key <key>
+```
+
+Same rules apply here as before. Your program should accept line-by-line JSON
+objects via stdin and output JSON objects to stdout line-by-line.
+
+#### Copying a production stream into development environment
+If you have a working stream in production that you'd also like to use in your
+development environment, you can combine the `subscribe` and `publish` commands to effectively copy
+the real-time events.
+```
+streamr stream subscribe streamr.eth/demos/helsinki-trams | streamr stream publish --dev <streamId> --private-key <key>
+```

package/bin/streamr-governance-vote.ts

@@ -0,0 +1,51 @@
+#!/usr/bin/env node
+import { createCommand } from '../src/command'
+import { getClientConfig } from '../src/client'
+import snapshot from '@snapshot-labs/snapshot.js'
+import { Wallet } from '@ethersproject/wallet'
+import { PrivateKeyAuthConfig } from 'streamr-client'
+
+const hub = 'https://hub.snapshot.org'
+const snapshotClient = new snapshot.Client712(hub)
+
+const vote = async (privateKey: string, proposal: string, choice: number) => {
+    const wallet = new Wallet(privateKey)
+    try {
+        console.log(`Wallet ${wallet.address} voting for choice ${choice} on proposal ${proposal}...`)
+        await snapshotClient.vote(wallet, wallet.address, {
+            space: 'streamr.eth',
+            proposal,
+            type: 'single-choice', // support only this type for now
+            choice,
+            app: 'cli-tool'
+        })
+        console.log(`Wallet ${wallet.address} successfully voted for choice ${choice} on proposal ${proposal}`)
+    } catch (err) {
+        console.error(err)
+        process.exit(1)
+    }
+}
+
+createCommand()
+    .description('vote on a Streamr governance proposal')
+    .arguments('<proposalId> <choiceId>')
+    .option('--private-key <key>', 'use an Ethereum private key to authenticate')
+    .option('--config <file>', 'read connection and authentication settings from a config file')
+    .action(async (proposalId: string, choiceId: string, options, command) => {
+        const config = getClientConfig(options)
+        if (!config.auth || !(config.auth as PrivateKeyAuthConfig).privateKey) {
+            console.error('You must pass a private key either via --private-key or via a config file using --config')
+            command.help()
+            process.exit(1)
+        } 
+
+        const choiceIdAsNumber = parseInt(choiceId)
+        if (Number.isNaN(choiceIdAsNumber) || choiceIdAsNumber <= 0) {
+            console.error(`Invalid choice number: ${choiceId}. The first choice is 1, second is 2, and so on.`)
+            command.help()
+            process.exit(1)
+        }
+
+        await vote((config.auth as PrivateKeyAuthConfig).privateKey, proposalId, choiceIdAsNumber)
+    })
+    .parseAsync()

package/bin/streamr-governance.ts

@@ -0,0 +1,10 @@
+#!/usr/bin/env node
+import { program } from 'commander'
+import pkg from '../package.json'
+
+program
+    .version(pkg.version)
+    .usage('<command> [<args>]')
+    .description('governance subcommands')
+    .command('vote', 'votes on a governance proposal')
+    .parse()

package/bin/streamr-mock-data-generate.ts

@@ -0,0 +1,40 @@
+#!/usr/bin/env node
+import pkg from '../package.json'
+import { createFnParseInt } from '../src/common'
+import { createCommand, Options as BaseOptions } from '../src/command'
+import { randomString } from '@streamr/utils'
+
+interface Options extends BaseOptions {
+    rate: number
+}
+
+function genArray<T>(size: number, elementFn: () => T): T[] {
+    const arr = []
+    for (let i = 0; i < size; ++i) {
+        arr.push(elementFn())
+    }
+    return arr
+}
+
+export const generate = (rate: number): void => {
+    setInterval(() => {
+        console.info(JSON.stringify({
+            someText: randomString(64),
+            aNumber: Math.random() * 10000,
+            bNumber: Math.random(),
+            yesOrNo: Math.random() > 0.5,
+            arrayOfStrings: genArray(Math.floor(Math.random() * 20), () => randomString(8)),
+            arrayOfIntegers: genArray(Math.floor(Math.random() * 10), () => Math.floor(Math.random() * 100))
+
+        }))
+    }, rate)
+}
+
+createCommand()
+    .description('generate and print semi-random JSON data to stdout')
+    .option('-r, --rate <n>', 'rate in milliseconds', createFnParseInt('--rate'), 500)
+    .version(pkg.version)
+    .action((options: Options) => {
+        generate(options.rate)
+    })
+    .parse()

package/bin/streamr-mock-data.ts

@@ -0,0 +1,10 @@
+#!/usr/bin/env node
+import { program } from 'commander'
+import pkg from '../package.json'
+
+program
+    .version(pkg.version)
+    .usage('<command> [<args>]')
+    .description('mock-data subcommands')
+    .command('generate', 'generate JSON data')
+    .parse()

package/bin/streamr-storage-node-add-stream.ts

@@ -0,0 +1,12 @@
+#!/usr/bin/env node
+import '../src/logLevel'
+import StreamrClient from 'streamr-client'
+import { createClientCommand } from '../src/command'
+
+createClientCommand(async (client: StreamrClient, storageNodeAddress: string, streamId: string) => {
+    const stream = await client.getStream(streamId)
+    await stream.addToStorageNode(storageNodeAddress)
+})
+    .arguments('<storageNodeAddress> <streamId>')
+    .description('add stream to a storage node')
+    .parseAsync()

package/bin/streamr-storage-node-list-streams.ts

@@ -0,0 +1,20 @@
+#!/usr/bin/env node
+import '../src/logLevel'
+import EasyTable from 'easy-table'
+import StreamrClient from 'streamr-client'
+import { createClientCommand } from '../src/command'
+
+createClientCommand((async (client: StreamrClient, storageNodeAddress: string) => {
+    const { streams } = await client.getStoredStreams(storageNodeAddress)
+    if (streams.length > 0) {
+        console.info(EasyTable.print(streams.map((stream) => {
+            return {
+                id: stream.id,
+                partitions: stream.getMetadata().partitions
+            }
+        })))
+    }
+}))
+    .arguments('<storageNodeAddress>')
+    .description('list stream parts in a storage node')
+    .parseAsync()

package/bin/streamr-storage-node-list.ts

@@ -0,0 +1,22 @@
+#!/usr/bin/env node
+import '../src/logLevel'
+import { StreamrClient } from 'streamr-client'
+import EasyTable from 'easy-table'
+import { createClientCommand, Options as BaseOptions } from '../src/command'
+
+interface Options extends BaseOptions {
+    stream?: string
+}
+
+createClientCommand(async (client: StreamrClient, options: Options) => {
+    const streamId = options.stream
+    const addresses = await client.getStorageNodes(streamId)
+    if (addresses.length > 0) {
+        console.info(EasyTable.print(addresses.map((address: string) => ({
+            address
+        }))))
+    }
+})
+    .description('fetch a list of storage nodes')
+    .option('-s, --stream <streamId>', 'only storage nodes which store the given stream (needs authentication)')
+    .parseAsync()

package/bin/streamr-storage-node-remove-stream.ts

@@ -0,0 +1,12 @@
+#!/usr/bin/env node
+import '../src/logLevel'
+import StreamrClient from 'streamr-client'
+import { createClientCommand } from '../src/command'
+
+createClientCommand(async (client: StreamrClient, storageNodeAddress: string, streamId: string) => {
+    const stream = await client.getStream(streamId)
+    await stream.removeFromStorageNode(storageNodeAddress)
+})
+    .arguments('<storageNodeAddress> <streamId>')
+    .description('remove stream from a storage node')
+    .parseAsync()

package/bin/streamr-storage-node.ts

@@ -0,0 +1,13 @@
+#!/usr/bin/env node
+import { program } from 'commander'
+import pkg from '../package.json'
+
+program
+    .version(pkg.version)
+    .usage('<command> [<args>]')
+    .description('storage node subcommands')
+    .command('list', 'list storage nodes')
+    .command('add-stream', 'add stream')
+    .command('remove-stream', 'remove stream')
+    .command('list-streams', 'list stream in a storage node')
+    .parse()

package/bin/streamr-stream-create.ts

@@ -0,0 +1,29 @@
+#!/usr/bin/env node
+import '../src/logLevel'
+import StreamrClient from 'streamr-client'
+import { createFnParseInt } from '../src/common'
+import { createClientCommand, Options as BaseOptions } from '../src/command'
+
+interface Options extends BaseOptions {
+    description?: string
+    streamConfig?: any
+    partitions?: number
+}
+
+createClientCommand(async (client: StreamrClient, streamIdOrPath: string, options: Options) => {
+    const body: any = {
+        id: streamIdOrPath,
+        description: options.description,
+        config: options.streamConfig,
+        partitions: options.partitions
+    }
+    const stream = await client.createStream(body)
+    console.info(JSON.stringify({ id: stream.id, ...stream.getMetadata() }, null, 2))
+})
+    .arguments('<streamId>')
+    .description('create a new stream')
+    .option('-d, --description <description>', 'define a description')
+    .option('-c, --stream-config <config>', 'define a configuration as JSON', (s: string) => JSON.parse(s))
+    .option('-p, --partitions <count>', 'define a partition count',
+        createFnParseInt('--partitions'))
+    .parseAsync()

package/bin/streamr-stream-grant-permission.ts

@@ -0,0 +1,9 @@
+#!/usr/bin/env node
+import '../src/logLevel'
+import { PermissionAssignment, Stream } from 'streamr-client'
+import { runModifyPermissionsCommand } from '../src/permission'
+
+runModifyPermissionsCommand(
+    (stream: Stream, assigment: PermissionAssignment) => stream.grantPermissions(assigment),
+    'grant'
+)

package/bin/streamr-stream-publish.ts

@@ -0,0 +1,66 @@
+#!/usr/bin/env node
+import '../src/logLevel'
+import { Writable } from 'stream'
+import { StreamrClient } from 'streamr-client'
+import { wait } from '@streamr/utils'
+import es from 'event-stream'
+import { createClientCommand, Options as BaseOptions } from '../src/command'
+
+interface Options extends BaseOptions {
+    partitionKeyField?: string
+}
+
+const publishStream = (
+    stream: string,
+    partitionKeyField: string | undefined,
+    client: StreamrClient
+): Writable => {
+    const writable = new Writable({
+        objectMode: true,
+        write: (data: any, _: any, done: any) => {
+            let json = null
+            // ignore newlines, etc
+            if (!data || String(data).trim() === '') {
+                done()
+                return
+            }
+            try {
+                json = JSON.parse(data)
+            } catch (e) {
+                console.error(data.toString())
+                done(e)
+                return
+            }
+            const partitionKey = (partitionKeyField !== undefined) ? json[partitionKeyField] : undefined
+            client.publish(stream, json, { partitionKey }).then(
+                () => done(),
+                (err) => done(err)
+            )
+        }
+    })
+    return writable
+}
+
+createClientCommand(async (client: StreamrClient, streamId: string, options: Options) => {
+    const ps = publishStream(streamId, options.partitionKeyField, client)
+    return new Promise((resolve, reject) => {
+        process.stdin
+            .pipe(es.split())
+            .pipe(ps)
+            .once('finish', async () => {
+                // We need to wait some time because the client.publish() may resolve the promise
+                // before the node has propagated the message. That may happend if the node
+                // has not yet connected to Tracker when client.publish() is called. In that case
+                // the message is put to the propagation queue (activeTaskStore.add call in
+                // network Propagation.ts:59) and the client.publish() promise resolves immeditatelly.
+                // TODO Remove this wait when NET-604 has been resolved
+                await wait(2000)
+                resolve(undefined)
+            })
+            .once('error', (err: any) => reject(err) )
+    })
+})
+    .arguments('<streamId>')
+    .description('publish to a stream by reading JSON messages from stdin line-by-line')
+    .option('-k, --partition-key-field <string>', 'field name in each message to use for assigning the message to a stream partition')
+    .parseAsync()