@streamr/cli-tools 0.0.1-tatum.0

package/dist/src/command.d.ts

@@ -0,0 +1,13 @@
+import commander, { Command } from 'commander';
+import { StreamrClientConfig } from 'streamr-client';
+export interface Options {
+    privateKey?: string;
+    config?: string;
+    dev: boolean;
+}
+export declare const createCommand: () => commander.Command;
+export interface CommandOpts {
+    autoDestroyClient?: boolean;
+    clientOptionsFactory?: (options: any) => StreamrClientConfig;
+}
+export declare const createClientCommand: (action: (...handleArgs: any[]) => Promise<void>, opts?: CommandOpts) => commander.Command;

package/dist/src/command.js

@@ -0,0 +1,45 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createClientCommand = exports.createCommand = void 0;
+const commander_1 = require("commander");
+const package_json_1 = __importDefault(require("../package.json"));
+const client_1 = require("./client");
+const createCommand = () => {
+    return new commander_1.Command()
+        .version(package_json_1.default.version)
+        .showHelpAfterError()
+        .allowExcessArguments(false);
+};
+exports.createCommand = createCommand;
+const createClientCommand = (action, opts = {
+    autoDestroyClient: true,
+    clientOptionsFactory: () => ({})
+}) => {
+    return (0, exports.createCommand)()
+        .option('--private-key <key>', 'use an Ethereum private key to authenticate')
+        .option('--config <file>', 'read connection and authentication settings from a config file')
+        .option('--dev', 'use pre-defined development environment', false)
+        .action(async (...args) => {
+        const commandOptions = args[args.length - 1].opts();
+        try {
+            const client = (0, client_1.createClient)(commandOptions, opts.clientOptionsFactory(commandOptions));
+            try {
+                await action(...[client].concat(args));
+            }
+            finally {
+                if (opts.autoDestroyClient) {
+                    await client.destroy();
+                }
+            }
+        }
+        catch (e) {
+            console.error(e);
+            process.exit(1);
+        }
+    });
+};
+exports.createClientCommand = createClientCommand;
+//# sourceMappingURL=command.js.map

package/dist/src/command.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"command.js","sourceRoot":"","sources":["../../src/command.ts"],"names":[],"mappings":";;;;;;AAAA,yCAA8C;AAE9C,mEAAiC;AACjC,qCAAuC;AAQhC,MAAM,aAAa,GAAG,GAAsB,EAAE;IACjD,OAAO,IAAI,mBAAO,EAAE;SACf,OAAO,CAAC,sBAAG,CAAC,OAAO,CAAC;SACpB,kBAAkB,EAAE;SACpB,oBAAoB,CAAC,KAAK,CAAC,CAAA;AACpC,CAAC,CAAA;AALY,QAAA,aAAa,iBAKzB;AAOM,MAAM,mBAAmB,GAAG,CAC/B,MAA+C,EAC/C,OAAoB;IAChB,iBAAiB,EAAE,IAAI;IACvB,oBAAoB,EAAE,GAAG,EAAE,CAAC,CAAC,EAAE,CAAC;CACnC,EACgB,EAAE;IACnB,OAAO,IAAA,qBAAa,GAAE;SACjB,MAAM,CAAC,qBAAqB,EAAE,6CAA6C,CAAC;SAC5E,MAAM,CAAC,iBAAiB,EAAE,gEAAgE,CAAC;SAC3F,MAAM,CAAC,OAAO,EAAE,yCAAyC,EAAE,KAAK,CAAC;SACjE,MAAM,CAAC,KAAK,EAAE,GAAG,IAAW,EAAE,EAAE;QAC7B,MAAM,cAAc,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,CAAA;QACnD,IAAI;YACA,MAAM,MAAM,GAAG,IAAA,qBAAY,EAAC,cAAc,EAAE,IAAI,CAAC,oBAAqB,CAAC,cAAc,CAAC,CAAC,CAAA;YACvF,IAAI;gBACA,MAAM,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAA;aACzC;oBAAS;gBACN,IAAI,IAAI,CAAC,iBAAiB,EAAE;oBACxB,MAAM,MAAM,CAAC,OAAO,EAAE,CAAA;iBACzB;aACJ;SACJ;QAAC,OAAO,CAAM,EAAE;YACb,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAA;YAChB,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;SAClB;IACL,CAAC,CAAC,CAAA;AACV,CAAC,CAAA;AA3BY,QAAA,mBAAmB,uBA2B/B"}

package/dist/src/common.d.ts

@@ -0,0 +1,6 @@
+export declare enum OptionType {
+    FLAG = 0,
+    ARGUMENT = 1
+}
+export declare const getOptionType: (value: string | boolean) => OptionType | never;
+export declare function createFnParseInt(name: string): (s: string) => number;

package/dist/src/common.js

@@ -0,0 +1,32 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createFnParseInt = exports.getOptionType = exports.OptionType = void 0;
+var OptionType;
+(function (OptionType) {
+    OptionType[OptionType["FLAG"] = 0] = "FLAG";
+    OptionType[OptionType["ARGUMENT"] = 1] = "ARGUMENT"; // e.g. "--private-key 0x1234"
+})(OptionType || (exports.OptionType = OptionType = {}));
+const getOptionType = (value) => {
+    if (typeof value === 'boolean') {
+        return OptionType.FLAG;
+    }
+    else if (typeof value === 'string') {
+        return OptionType.ARGUMENT;
+    }
+    else {
+        throw new Error(`unknown option type (value: ${value})`);
+    }
+};
+exports.getOptionType = getOptionType;
+function createFnParseInt(name) {
+    return (str) => {
+        const n = parseInt(str, 10);
+        if (isNaN(n)) {
+            console.error(`${name} must be an integer (was "${str}")`);
+            process.exit(1);
+        }
+        return n;
+    };
+}
+exports.createFnParseInt = createFnParseInt;
+//# sourceMappingURL=common.js.map

package/dist/src/common.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"common.js","sourceRoot":"","sources":["../../src/common.ts"],"names":[],"mappings":";;;AAAA,IAAY,UAGX;AAHD,WAAY,UAAU;IAClB,2CAAI,CAAA;IACJ,mDAAQ,CAAA,CAAE,8BAA8B;AAC5C,CAAC,EAHW,UAAU,0BAAV,UAAU,QAGrB;AAEM,MAAM,aAAa,GAAG,CAAC,KAAuB,EAAsB,EAAE;IACzE,IAAI,OAAO,KAAK,KAAK,SAAS,EAAE;QAC5B,OAAO,UAAU,CAAC,IAAI,CAAA;KACzB;SAAM,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE;QAClC,OAAO,UAAU,CAAC,QAAQ,CAAA;KAC7B;SAAM;QACH,MAAM,IAAI,KAAK,CAAC,+BAA+B,KAAK,GAAG,CAAC,CAAA;KAC3D;AACL,CAAC,CAAA;AARY,QAAA,aAAa,iBAQzB;AAED,SAAgB,gBAAgB,CAAC,IAAY;IACzC,OAAO,CAAC,GAAW,EAAE,EAAE;QACnB,MAAM,CAAC,GAAG,QAAQ,CAAC,GAAG,EAAE,EAAE,CAAC,CAAA;QAC3B,IAAI,KAAK,CAAC,CAAC,CAAC,EAAE;YACV,OAAO,CAAC,KAAK,CAAC,GAAG,IAAI,6BAA6B,GAAG,IAAI,CAAC,CAAA;YAC1D,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;SAClB;QACD,OAAO,CAAC,CAAA;IACZ,CAAC,CAAA;AACL,CAAC;AATD,4CASC"}

package/dist/src/config.d.ts

@@ -0,0 +1,6 @@
+import { StreamrClientConfig } from 'streamr-client';
+interface Config {
+    client: StreamrClientConfig;
+}
+export declare const getConfig: (id?: string) => Config | undefined;
+export {};

package/dist/src/config.js

@@ -0,0 +1,58 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getConfig = void 0;
+const path_1 = __importDefault(require("path"));
+const os_1 = __importDefault(require("os"));
+const fs_1 = require("fs");
+/*
+ * Validate that the config contains at least one root level element: the "client" block.
+ * The values of the "client" blocks are validated by StreamrClient when the configuration
+ * is used.
+ *
+ * We don't check other root level elements. It is ok to use a Broker config file as
+ * a cli-tools config file. In that case the file contains e.g. "plugins" block,
+ * but cli-tools can just ignore that block.
+ */
+const validateConfig = (config, fileName) => {
+    const CLIENT_CONFIG_BLOCK = 'client';
+    if (config[CLIENT_CONFIG_BLOCK] === undefined) {
+        throw new Error(`Missing root element "${CLIENT_CONFIG_BLOCK}" in ${fileName}`);
+    }
+};
+const tryReadConfigFile = (fileName) => {
+    let content;
+    try {
+        content = (0, fs_1.readFileSync)(fileName, 'utf8');
+    }
+    catch (e) {
+        return undefined;
+    }
+    const json = JSON.parse(content);
+    validateConfig(json, fileName);
+    return json;
+};
+const getConfig = (id) => {
+    const CONFIG_DIRECTORY = path_1.default.join(os_1.default.homedir(), '.streamr', 'config');
+    if (id !== undefined) {
+        const fileNames = [
+            id,
+            path_1.default.join(CONFIG_DIRECTORY, `${id}.json`),
+        ];
+        for (const fileName of fileNames) {
+            const content = tryReadConfigFile(fileName);
+            if (content !== undefined) {
+                return content;
+            }
+        }
+        throw new Error('Config file not found');
+    }
+    else {
+        const fileName = path_1.default.join(CONFIG_DIRECTORY, `default.json`);
+        return tryReadConfigFile(fileName);
+    }
+};
+exports.getConfig = getConfig;
+//# sourceMappingURL=config.js.map

package/dist/src/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../src/config.ts"],"names":[],"mappings":";;;;;;AAAA,gDAAuB;AACvB,4CAAmB;AACnB,2BAAiC;AAOjC;;;;;;;;GAQG;AACH,MAAM,cAAc,GAAG,CAAC,MAAW,EAAE,QAAgB,EAAgB,EAAE;IACnE,MAAM,mBAAmB,GAAG,QAAQ,CAAA;IACpC,IAAI,MAAM,CAAC,mBAAmB,CAAC,KAAK,SAAS,EAAE;QAC3C,MAAM,IAAI,KAAK,CAAC,yBAAyB,mBAAmB,QAAQ,QAAQ,EAAE,CAAC,CAAA;KAClF;AACL,CAAC,CAAA;AAED,MAAM,iBAAiB,GAAG,CAAC,QAAgB,EAA8B,EAAE;IACvE,IAAI,OAAO,CAAA;IACX,IAAI;QACA,OAAO,GAAG,IAAA,iBAAY,EAAC,QAAQ,EAAE,MAAM,CAAC,CAAA;KAC3C;IAAC,OAAO,CAAM,EAAE;QACb,OAAO,SAAS,CAAA;KACnB;IACD,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAA;IAChC,cAAc,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAA;IAC9B,OAAO,IAAI,CAAA;AACf,CAAC,CAAA;AAEM,MAAM,SAAS,GAAG,CAAC,EAAW,EAAsB,EAAE;IACzD,MAAM,gBAAgB,GAAG,cAAI,CAAC,IAAI,CAAC,YAAE,CAAC,OAAO,EAAE,EAAE,UAAU,EAAE,QAAQ,CAAC,CAAA;IACtE,IAAI,EAAE,KAAK,SAAS,EAAE;QAClB,MAAM,SAAS,GAAG;YACd,EAAE;YACF,cAAI,CAAC,IAAI,CAAC,gBAAgB,EAAE,GAAG,EAAE,OAAO,CAAC;SAC5C,CAAA;QACD,KAAK,MAAM,QAAQ,IAAI,SAAS,EAAE;YAC9B,MAAM,OAAO,GAAG,iBAAiB,CAAC,QAAQ,CAAC,CAAA;YAC3C,IAAI,OAAO,KAAK,SAAS,EAAE;gBACvB,OAAO,OAAO,CAAA;aACjB;SACJ;QACD,MAAM,IAAI,KAAK,CAAC,uBAAuB,CAAC,CAAA;KAC3C;SAAM;QACH,MAAM,QAAQ,GAAG,cAAI,CAAC,IAAI,CAAC,gBAAgB,EAAE,cAAc,CAAC,CAAA;QAC5D,OAAO,iBAAiB,CAAC,QAAQ,CAAC,CAAA;KACrC;AACL,CAAC,CAAA;AAlBY,QAAA,SAAS,aAkBrB"}

package/dist/src/logLevel.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/src/logLevel.js

@@ -0,0 +1,11 @@
+"use strict";
+/*
+ * Minimal logging for NetworkNode and other users of Logger.ts in the network package.
+ * This file needs to be imported before any of the network package classes
+ * so that the environment variable is updated before any Logger instances are created.
+ * The import is needed for the files where network packages are used (typically
+ * the files which call createClientCommand()).
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+process.env.LOG_LEVEL = process.env.LOG_LEVEL ?? 'error';
+//# sourceMappingURL=logLevel.js.map

package/dist/src/logLevel.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logLevel.js","sourceRoot":"","sources":["../../src/logLevel.ts"],"names":[],"mappings":";AAAA;;;;;;GAMG;;AAEH,OAAO,CAAC,GAAG,CAAC,SAAS,GAAG,OAAO,CAAC,GAAG,CAAC,SAAS,IAAI,OAAO,CAAA"}

package/dist/src/permission.d.ts

@@ -0,0 +1,5 @@
+import { PermissionAssignment, Stream, StreamPermission } from 'streamr-client';
+export declare const PERMISSIONS: Map<string, StreamPermission>;
+export declare const getPermission: (id: string) => StreamPermission | never;
+export declare const getPermissionId: (permission: StreamPermission) => string;
+export declare const runModifyPermissionsCommand: (modify: (stream: Stream, assignment: PermissionAssignment) => Promise<void>, modification: string) => void;

package/dist/src/permission.js

@@ -0,0 +1,53 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.runModifyPermissionsCommand = exports.getPermissionId = exports.getPermission = exports.PERMISSIONS = void 0;
+const commander_1 = require("commander");
+const streamr_client_1 = require("streamr-client");
+const command_1 = require("./command");
+const PUBLIC_USER_ID = 'public';
+exports.PERMISSIONS = new Map([
+    ['subscribe', streamr_client_1.StreamPermission.SUBSCRIBE],
+    ['publish', streamr_client_1.StreamPermission.PUBLISH],
+    ['edit', streamr_client_1.StreamPermission.EDIT],
+    ['delete', streamr_client_1.StreamPermission.DELETE],
+    ['grant', streamr_client_1.StreamPermission.GRANT]
+]);
+const getPermission = (id) => {
+    const result = exports.PERMISSIONS.get(id);
+    if (result === undefined) {
+        throw new Error(`unknown permission: ${id}`);
+    }
+    return result;
+};
+exports.getPermission = getPermission;
+const getPermissionId = (permission) => {
+    return Array.from(exports.PERMISSIONS.entries()).find(([_id, p]) => p === permission)[0];
+};
+exports.getPermissionId = getPermissionId;
+const runModifyPermissionsCommand = (modify, modification) => {
+    (0, command_1.createClientCommand)(async (client, streamId, user, permissionIds) => {
+        const stream = await client.getStream(streamId);
+        const permissions = permissionIds.map((permissionId) => (0, exports.getPermission)(permissionId));
+        let assignment;
+        if (user === PUBLIC_USER_ID) {
+            assignment = {
+                permissions,
+                public: true
+            };
+        }
+        else {
+            assignment = {
+                permissions,
+                user
+            };
+        }
+        await modify(stream, assignment);
+    })
+        .addArgument(new commander_1.Argument('<streamId>'))
+        .addArgument(new commander_1.Argument('<user>'))
+        .addArgument(new commander_1.Argument('<permissions...>').choices(Array.from(exports.PERMISSIONS.keys())))
+        .description(`${modification} permission: use keyword "public" as a user to ${modification} a public permission`)
+        .parseAsync(process.argv);
+};
+exports.runModifyPermissionsCommand = runModifyPermissionsCommand;
+//# sourceMappingURL=permission.js.map

package/dist/src/permission.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"permission.js","sourceRoot":"","sources":["../../src/permission.ts"],"names":[],"mappings":";;;AAAA,yCAAoC;AACpC,mDAA8F;AAC9F,uCAA+C;AAE/C,MAAM,cAAc,GAAG,QAAQ,CAAA;AAElB,QAAA,WAAW,GAAG,IAAI,GAAG,CAA2B;IACzD,CAAC,WAAW,EAAE,iCAAgB,CAAC,SAAS,CAAC;IACzC,CAAC,SAAS,EAAE,iCAAgB,CAAC,OAAO,CAAC;IACrC,CAAC,MAAM,EAAE,iCAAgB,CAAC,IAAI,CAAC;IAC/B,CAAC,QAAQ,EAAE,iCAAgB,CAAC,MAAM,CAAC;IACnC,CAAC,OAAO,EAAE,iCAAgB,CAAC,KAAK,CAAC;CACpC,CAAC,CAAA;AAEK,MAAM,aAAa,GAAG,CAAC,EAAU,EAA4B,EAAE;IAClE,MAAM,MAAM,GAAG,mBAAW,CAAC,GAAG,CAAC,EAAE,CAAC,CAAA;IAClC,IAAI,MAAM,KAAK,SAAS,EAAE;QACtB,MAAM,IAAI,KAAK,CAAC,uBAAuB,EAAE,EAAE,CAAC,CAAA;KAC/C;IACD,OAAO,MAAM,CAAA;AACjB,CAAC,CAAA;AANY,QAAA,aAAa,iBAMzB;AAEM,MAAM,eAAe,GAAG,CAAC,UAA4B,EAAU,EAAE;IACpE,OAAO,KAAK,CAAC,IAAI,CAAC,mBAAW,CAAC,OAAO,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,UAAU,CAAE,CAAC,CAAC,CAAC,CAAA;AACrF,CAAC,CAAA;AAFY,QAAA,eAAe,mBAE3B;AAEM,MAAM,2BAA2B,GAAG,CACvC,MAA2E,EAC3E,YAAoB,EAChB,EAAE;IACN,IAAA,6BAAmB,EAAC,KAAK,EAAE,MAAqB,EAAE,QAAgB,EAAE,IAAY,EAAE,aAAuB,EAAE,EAAE;QACzG,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAA;QAC/C,MAAM,WAAW,GAAuB,aAAa,CAAC,GAAG,CAAC,CAAC,YAAY,EAAE,EAAE,CAAC,IAAA,qBAAa,EAAC,YAAY,CAAC,CAAC,CAAA;QACxG,IAAI,UAAgC,CAAA;QACpC,IAAI,IAAI,KAAK,cAAc,EAAE;YACzB,UAAU,GAAG;gBACT,WAAW;gBACX,MAAM,EAAE,IAAI;aACf,CAAA;SACJ;aAAM;YACH,UAAU,GAAG;gBACT,WAAW;gBACX,IAAI;aACP,CAAA;SACJ;QACD,MAAM,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,CAAA;IACpC,CAAC,CAAC;SACG,WAAW,CAAC,IAAI,oBAAQ,CAAC,YAAY,CAAC,CAAC;SACvC,WAAW,CAAC,IAAI,oBAAQ,CAAC,QAAQ,CAAC,CAAC;SACnC,WAAW,CAAC,IAAI,oBAAQ,CAAC,kBAAkB,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,mBAAW,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;SACrF,WAAW,CAAC,GAAG,YAAY,kDAAkD,YAAY,sBAAsB,CAAC;SAChH,UAAU,CAAC,OAAO,CAAC,IAAI,CAAC,CAAA;AACjC,CAAC,CAAA;AA1BY,QAAA,2BAA2B,+BA0BvC"}

package/dist/src/resend.d.ts

@@ -0,0 +1,3 @@
+import { StreamrClient, ResendOptions } from 'streamr-client';
+export declare const assertBothOrNoneDefined: <T extends object>(option1: keyof T, option2: keyof T, errorMessage: string, commandOptions: T) => void | never;
+export declare const resend: (streamId: string, resendOpts: ResendOptions, client: StreamrClient, subscribe: boolean) => Promise<void>;

package/dist/src/resend.js

@@ -0,0 +1,32 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.resend = exports.assertBothOrNoneDefined = void 0;
+const assertBothOrNoneDefined = (option1, option2, errorMessage, commandOptions) => {
+    if ((option1 in commandOptions && !(option2 in commandOptions)) || (option2 in commandOptions && !(option1 in commandOptions))) {
+        console.error(`option ${errorMessage}`);
+        process.exit(1);
+    }
+};
+exports.assertBothOrNoneDefined = assertBothOrNoneDefined;
+const resend = async (streamId, resendOpts, client, subscribe) => {
+    try {
+        const handler = (message) => {
+            console.info(JSON.stringify(message));
+        };
+        if (subscribe) {
+            await client.subscribe({
+                stream: streamId,
+                resend: resendOpts
+            }, handler);
+        }
+        else {
+            await client.resend(streamId, resendOpts, handler);
+        }
+    }
+    catch (err) {
+        console.error(err.message ? err.message : err);
+        process.exit(1);
+    }
+};
+exports.resend = resend;
+//# sourceMappingURL=resend.js.map

package/dist/src/resend.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resend.js","sourceRoot":"","sources":["../../src/resend.ts"],"names":[],"mappings":";;;AAEO,MAAM,uBAAuB,GAAG,CACnC,OAAgB,EAChB,OAAgB,EAChB,YAAoB,EACpB,cAAiB,EACL,EAAE;IACd,IAAI,CAAC,OAAO,IAAI,cAAc,IAAI,CAAC,CAAC,OAAO,IAAI,cAAc,CAAC,CAAC,IAAI,CAAC,OAAO,IAAI,cAAc,IAAI,CAAC,CAAC,OAAO,IAAI,cAAc,CAAC,CAAC,EAAE;QAC5H,OAAO,CAAC,KAAK,CAAC,UAAU,YAAY,EAAE,CAAC,CAAA;QACvC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;KAClB;AACL,CAAC,CAAA;AAVY,QAAA,uBAAuB,2BAUnC;AAEM,MAAM,MAAM,GAAG,KAAK,EACvB,QAAgB,EAChB,UAAyB,EACzB,MAAqB,EACrB,SAAkB,EACL,EAAE;IACf,IAAI;QACA,MAAM,OAAO,GAAG,CAAC,OAAY,EAAE,EAAE;YAC7B,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC,CAAA;QACzC,CAAC,CAAA;QACD,IAAI,SAAS,EAAE;YACX,MAAM,MAAM,CAAC,SAAS,CAAC;gBACnB,MAAM,EAAE,QAAQ;gBAChB,MAAM,EAAE,UAAU;aACrB,EAAE,OAAO,CAAC,CAAA;SACd;aAAM;YACH,MAAM,MAAM,CAAC,MAAM,CAAC,QAAQ,EAAE,UAAU,EAAE,OAAO,CAAC,CAAA;SACrD;KACJ;IAAC,OAAO,GAAG,EAAE;QACV,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,CAAA;QAC9C,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;KAClB;AACL,CAAC,CAAA;AAtBY,QAAA,MAAM,UAsBlB"}

package/package.json

@@ -0,0 +1,45 @@
+{
+  "name": "@streamr/cli-tools",
+  "version": "0.0.1-tatum.0",
+  "description": "Command line tools for Streamr",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/streamr-dev/network.git",
+    "directory": "packages/cli-tools"
+  },
+  "bin": {
+    "streamr": "dist/bin/streamr.js"
+  },
+  "scripts": {
+    "build": "tsc -b tsconfig.json",
+    "check": "tsc -p ./tsconfig.json --noEmit",
+    "clean": "jest --clearCache || true; rm -rf dist *.tsbuildinfo node_modules/.cache || true",
+    "eslint": "eslint --cache --cache-location=node_modules/.cache/.eslintcache/ '*/**/*.{js,ts}'",
+    "test": "npm run build && jest --forceExit"
+  },
+  "keywords": [
+    "streamr",
+    "cli",
+    "tool",
+    "utility"
+  ],
+  "author": "Streamr Network AG <contact@streamr.com>",
+  "license": "AGPL-3.0",
+  "dependencies": {
+    "@ethersproject/wallet": "^5.5.0",
+    "@snapshot-labs/snapshot.js": "^0.5.4",
+    "@streamr/utils": "0.0.1-tatum.0",
+    "commander": "^11.0.0",
+    "easy-table": "^1.1.1",
+    "event-stream": "^4.0.1",
+    "lodash": "^4.17.21",
+    "streamr-client": "0.0.1-tatum.0"
+  },
+  "devDependencies": {
+    "@streamr/test-utils": "0.0.1-tatum.0",
+    "@types/event-stream": "^4.0.0",
+    "@types/lodash": "^4.14.197",
+    "@types/merge2": "^1.4.0",
+    "merge2": "^1.4.1"
+  }
+}

package/src/client.ts

@@ -0,0 +1,35 @@
+import omit from 'lodash/omit'
+import merge from 'lodash/merge'
+import { StreamrClientConfig, StreamrClient, CONFIG_TEST } from 'streamr-client'
+import { Options } from './command'
+import { getConfig } from './config'
+
+export const getClientConfig = (commandOptions: Options, overridenOptions: StreamrClientConfig = {}): StreamrClientConfig => {
+    const environmentOptions = commandOptions.dev ? omit(CONFIG_TEST, 'auth') : undefined
+    const configFileJson = getConfig(commandOptions.config)?.client
+    const authenticationOptions = (commandOptions.privateKey !== undefined) ? { auth: { privateKey: commandOptions.privateKey } } : undefined
+    return merge(
+        environmentOptions,
+        configFileJson,
+        authenticationOptions,
+        overridenOptions
+    )
+}
+
+const addInterruptHandler = (client: StreamrClient) => {
+    process.on('SIGINT', async () => {
+        try {
+            await client.destroy()
+        } catch {
+            // no-op
+        }
+        process.exit()
+    })
+}
+
+export const createClient = (commandOptions: Options, overridenOptions: StreamrClientConfig = {}): StreamrClient => {
+    const config = getClientConfig(commandOptions, overridenOptions)
+    const client = new StreamrClient(config)
+    addInterruptHandler(client)
+    return client
+}

package/src/command.ts

@@ -0,0 +1,51 @@
+import commander, { Command } from 'commander'
+import { StreamrClientConfig } from 'streamr-client'
+import pkg from '../package.json'
+import { createClient } from './client'
+
+export interface Options {
+    privateKey?: string
+    config?: string
+    dev: boolean
+}
+
+export const createCommand = (): commander.Command => {
+    return new Command()
+        .version(pkg.version)
+        .showHelpAfterError()
+        .allowExcessArguments(false)
+}
+
+export interface CommandOpts {
+    autoDestroyClient?: boolean
+    clientOptionsFactory?: (options: any) => StreamrClientConfig
+}
+
+export const createClientCommand = (
+    action: (...handleArgs: any[]) => Promise<void>, 
+    opts: CommandOpts = {
+        autoDestroyClient: true,
+        clientOptionsFactory: () => ({})
+    }
+): commander.Command => {
+    return createCommand()
+        .option('--private-key <key>', 'use an Ethereum private key to authenticate')
+        .option('--config <file>', 'read connection and authentication settings from a config file')
+        .option('--dev', 'use pre-defined development environment', false)
+        .action(async (...args: any[]) => {
+            const commandOptions = args[args.length - 1].opts()
+            try {
+                const client = createClient(commandOptions, opts.clientOptionsFactory!(commandOptions))
+                try {
+                    await action(...[client].concat(args))
+                } finally {
+                    if (opts.autoDestroyClient) {
+                        await client.destroy()
+                    }
+                }
+            } catch (e: any) {
+                console.error(e)
+                process.exit(1)
+            }
+        })
+}

package/src/common.ts

@@ -0,0 +1,25 @@
+export enum OptionType {
+    FLAG, // e.g. "--enable"
+    ARGUMENT  // e.g. "--private-key 0x1234"
+}
+
+export const getOptionType = (value: string | boolean): OptionType | never => {
+    if (typeof value === 'boolean') {
+        return OptionType.FLAG
+    } else if (typeof value === 'string') {
+        return OptionType.ARGUMENT
+    } else {
+        throw new Error(`unknown option type (value: ${value})`)
+    }
+}
+
+export function createFnParseInt(name: string): (s: string) => number {
+    return (str: string) => {
+        const n = parseInt(str, 10)
+        if (isNaN(n)) {
+            console.error(`${name} must be an integer (was "${str}")`)
+            process.exit(1)
+        }
+        return n
+    }
+}

package/src/config.ts

@@ -0,0 +1,56 @@
+import path from 'path'
+import os from 'os'
+import { readFileSync } from 'fs'
+import { StreamrClientConfig } from 'streamr-client'
+
+interface Config {
+    client: StreamrClientConfig
+}
+
+/*
+ * Validate that the config contains at least one root level element: the "client" block.
+ * The values of the "client" blocks are validated by StreamrClient when the configuration 
+ * is used.
+ *  
+ * We don't check other root level elements. It is ok to use a Broker config file as
+ * a cli-tools config file. In that case the file contains e.g. "plugins" block, 
+ * but cli-tools can just ignore that block.
+ */
+const validateConfig = (config: any, fileName: string): void | never => {
+    const CLIENT_CONFIG_BLOCK = 'client'
+    if (config[CLIENT_CONFIG_BLOCK] === undefined) {
+        throw new Error(`Missing root element "${CLIENT_CONFIG_BLOCK}" in ${fileName}`)
+    }
+}
+
+const tryReadConfigFile = (fileName: string): Config | undefined | never => {
+    let content
+    try {
+        content = readFileSync(fileName, 'utf8')
+    } catch (e: any) {
+        return undefined
+    }
+    const json = JSON.parse(content)
+    validateConfig(json, fileName)
+    return json
+}
+
+export const getConfig = (id?: string): Config | undefined => {
+    const CONFIG_DIRECTORY = path.join(os.homedir(), '.streamr', 'config')
+    if (id !== undefined) {
+        const fileNames = [
+            id,
+            path.join(CONFIG_DIRECTORY, `${id}.json`),
+        ]
+        for (const fileName of fileNames) {
+            const content = tryReadConfigFile(fileName)
+            if (content !== undefined) {
+                return content
+            }
+        }
+        throw new Error('Config file not found')
+    } else {
+        const fileName = path.join(CONFIG_DIRECTORY, `default.json`)
+        return tryReadConfigFile(fileName)
+    }
+}

package/src/logLevel.ts

@@ -0,0 +1,9 @@
+/*
+ * Minimal logging for NetworkNode and other users of Logger.ts in the network package.
+ * This file needs to be imported before any of the network package classes
+ * so that the environment variable is updated before any Logger instances are created.
+ * The import is needed for the files where network packages are used (typically
+ * the files which call createClientCommand()).
+ */
+
+process.env.LOG_LEVEL = process.env.LOG_LEVEL ?? 'error'

package/src/permission.ts

@@ -0,0 +1,53 @@
+import { Argument } from 'commander'
+import { PermissionAssignment, Stream, StreamPermission, StreamrClient } from 'streamr-client'
+import { createClientCommand } from './command'
+
+const PUBLIC_USER_ID = 'public'
+
+export const PERMISSIONS = new Map<string, StreamPermission>([
+    ['subscribe', StreamPermission.SUBSCRIBE],
+    ['publish', StreamPermission.PUBLISH],
+    ['edit', StreamPermission.EDIT],
+    ['delete', StreamPermission.DELETE],
+    ['grant', StreamPermission.GRANT]
+])
+
+export const getPermission = (id: string): StreamPermission | never => {
+    const result = PERMISSIONS.get(id)
+    if (result === undefined) {
+        throw new Error(`unknown permission: ${id}`)
+    }
+    return result
+}
+
+export const getPermissionId = (permission: StreamPermission): string => {
+    return Array.from(PERMISSIONS.entries()).find(([_id, p]) => p === permission)![0]
+}
+
+export const runModifyPermissionsCommand = (
+    modify: (stream: Stream, assignment: PermissionAssignment) => Promise<void>,
+    modification: string,
+): void => {
+    createClientCommand(async (client: StreamrClient, streamId: string, user: string, permissionIds: string[]) => {
+        const stream = await client.getStream(streamId)
+        const permissions: StreamPermission[] = permissionIds.map((permissionId) => getPermission(permissionId))
+        let assignment: PermissionAssignment
+        if (user === PUBLIC_USER_ID) {
+            assignment = {
+                permissions,
+                public: true
+            }
+        } else {
+            assignment = {
+                permissions,
+                user
+            }
+        }
+        await modify(stream, assignment) 
+    })
+        .addArgument(new Argument('<streamId>'))
+        .addArgument(new Argument('<user>'))
+        .addArgument(new Argument('<permissions...>').choices(Array.from(PERMISSIONS.keys())))
+        .description(`${modification} permission: use keyword "public" as a user to ${modification} a public permission`)
+        .parseAsync(process.argv)
+}

package/src/resend.ts

@@ -0,0 +1,37 @@
+import { StreamrClient, ResendOptions } from 'streamr-client'
+
+export const assertBothOrNoneDefined = <T extends object>(
+    option1: keyof T,
+    option2: keyof T,
+    errorMessage: string,
+    commandOptions: T
+): void | never => { 
+    if ((option1 in commandOptions && !(option2 in commandOptions)) || (option2 in commandOptions && !(option1 in commandOptions))) {
+        console.error(`option ${errorMessage}`)
+        process.exit(1)
+    }
+}
+
+export const resend = async (
+    streamId: string,
+    resendOpts: ResendOptions,
+    client: StreamrClient,
+    subscribe: boolean
+): Promise<void> => {
+    try {
+        const handler = (message: any) => {
+            console.info(JSON.stringify(message))
+        }
+        if (subscribe) {
+            await client.subscribe({
+                stream: streamId,
+                resend: resendOpts
+            }, handler)
+        } else {
+            await client.resend(streamId, resendOpts, handler)
+        }
+    } catch (err) {
+        console.error(err.message ? err.message : err)
+        process.exit(1)
+    }
+}

package/test/mock-data.test.ts

@@ -0,0 +1,19 @@
+import { collect } from '@streamr/utils'
+import 'jest-extended'
+import { startCommand } from './utils'
+
+describe('mock-data', () => {
+
+    it('generate', async () => {
+        const abortController = new AbortController()
+        const outputIterable = startCommand('mock-data generate', {
+            abortSignal: abortController.signal,
+            devEnvironment: false
+        })
+        const firstLine = (await collect(outputIterable, 1))[0]
+        abortController.abort()
+        const json = JSON.parse(firstLine)
+        expect(json).toBeObject()
+    })
+
+})