@bitsocial/bitsocial-cli 0.19.43 → 0.19.45

package/README.md

@@ -344,7 +344,7 @@ EXAMPLES
   $ bitsocial challenge install ./my-local-challenge
 ```
 
-_See code: [src/cli/commands/challenge/install.ts](https://github.com/bitsocialnet/bitsocial-cli/blob/v0.19.43/src/cli/commands/challenge/install.ts)_
+_See code: [src/cli/commands/challenge/install.ts](https://github.com/bitsocialnet/bitsocial-cli/blob/v0.19.45/src/cli/commands/challenge/install.ts)_
 
 ## `bitsocial challenge list`
 
@@ -367,7 +367,7 @@ EXAMPLES
   $ bitsocial challenge list -q
 ```
 
-_See code: [src/cli/commands/challenge/list.ts](https://github.com/bitsocialnet/bitsocial-cli/blob/v0.19.43/src/cli/commands/challenge/list.ts)_
+_See code: [src/cli/commands/challenge/list.ts](https://github.com/bitsocialnet/bitsocial-cli/blob/v0.19.45/src/cli/commands/challenge/list.ts)_
 
 ## `bitsocial challenge remove NAME`
 
@@ -392,7 +392,7 @@ EXAMPLES
   $ bitsocial challenge remove @scope/my-challenge
 ```
 
-_See code: [src/cli/commands/challenge/remove.ts](https://github.com/bitsocialnet/bitsocial-cli/blob/v0.19.43/src/cli/commands/challenge/remove.ts)_
+_See code: [src/cli/commands/challenge/remove.ts](https://github.com/bitsocialnet/bitsocial-cli/blob/v0.19.45/src/cli/commands/challenge/remove.ts)_
 
 ## `bitsocial community create`
 
@@ -417,7 +417,7 @@ EXAMPLES
     $ bitsocial community create --title 'Hello Plebs' --description 'Welcome'
 ```
 
-_See code: [src/cli/commands/community/create.ts](https://github.com/bitsocialnet/bitsocial-cli/blob/v0.19.43/src/cli/commands/community/create.ts)_
+_See code: [src/cli/commands/community/create.ts](https://github.com/bitsocialnet/bitsocial-cli/blob/v0.19.45/src/cli/commands/community/create.ts)_
 
 ## `bitsocial community delete ADDRESSES`
 
@@ -442,7 +442,7 @@ EXAMPLES
   $ bitsocial community delete 12D3KooWG3XbzoVyAE6Y9vHZKF64Yuuu4TjdgQKedk14iYmTEPWu
 ```
 
-_See code: [src/cli/commands/community/delete.ts](https://github.com/bitsocialnet/bitsocial-cli/blob/v0.19.43/src/cli/commands/community/delete.ts)_
+_See code: [src/cli/commands/community/delete.ts](https://github.com/bitsocialnet/bitsocial-cli/blob/v0.19.45/src/cli/commands/community/delete.ts)_
 
 ## `bitsocial community edit ADDRESS`
 
@@ -450,13 +450,14 @@ Edit a community's properties. For a list of properties, visit https://github.co
 
 ```
 USAGE
-  $ bitsocial community edit ADDRESS --pkcRpcUrl <value>
+  $ bitsocial community edit ADDRESS --pkcRpcUrl <value> [-f <value>]
 
 ARGUMENTS
-  ADDRESS  Address of the community to edit
+  ADDRESS  Address of the community to edit. It could be the name domain, or a public key
 
 FLAGS
-  --pkcRpcUrl=<value>  (required) [default: ws://localhost:9138/] URL to PKC RPC
+  -f, --jsonFile=<value>   Path to a JSON file containing edit options
+      --pkcRpcUrl=<value>  (required) [default: ws://localhost:9138/] URL to PKC RPC
 
 DESCRIPTION
   Edit a community's properties. For a list of properties, visit https://github.com/pkcprotocol/pkc-js
@@ -468,33 +469,38 @@ EXAMPLES
 
   Add the author address 'esteban.bso' as an admin on the community
 
-    $ bitsocial community edit mysub.bso '--roles["esteban.bso"].role' admin
+    $ bitsocial community edit mycommunity.bso '--roles["esteban.bso"].role' admin
 
   Add two challenges to the community. The first challenge will be a question and answer, and the second will be an
   image captcha
 
-    $ bitsocial community edit mysub.bso --settings.challenges[0].name question \
+    $ bitsocial community edit mycommunity.bso --settings.challenges[0].name question \
       --settings.challenges[0].options.question "what is the password?" --settings.challenges[0].options.answer \
       thepassword --settings.challenges[1].name captcha-canvas-v3
 
   Change the title and description
 
-    $ bitsocial community edit mysub.bso --title "This is the new title" --description "This is the new description"
+    $ bitsocial community edit mycommunity.bso --title "This is the new title" --description "This is the new \
+      description"
 
   Remove a role from a moderator/admin/owner
 
-    $ bitsocial community edit plebbit.bso --roles['rinse12.bso'] null
+    $ bitsocial community edit bitsocial.bso --roles['rinse12.bso'] null
 
   Enable settings.fetchThumbnailUrls to fetch the thumbnail of url submitted by authors
 
-    $ bitsocial community edit plebbit.bso --settings.fetchThumbnailUrls
+    $ bitsocial community edit bitsocial.bso --settings.fetchThumbnailUrls
 
   disable settings.fetchThumbnailUrls
 
-    $ bitsocial community edit plebbit.bso --settings.fetchThumbnailUrls=false
+    $ bitsocial community edit bitsocial.bso --settings.fetchThumbnailUrls=false
+
+  Edit a community using options from a JSON file
+
+    $ bitsocial community edit bitsocial.bso --jsonFile ./edit-options.json
 ```
 
-_See code: [src/cli/commands/community/edit.ts](https://github.com/bitsocialnet/bitsocial-cli/blob/v0.19.43/src/cli/commands/community/edit.ts)_
+_See code: [src/cli/commands/community/edit.ts](https://github.com/bitsocialnet/bitsocial-cli/blob/v0.19.45/src/cli/commands/community/edit.ts)_
 
 ## `bitsocial community get [ADDRESS]`
 
@@ -525,7 +531,7 @@ EXAMPLES
   $ bitsocial community get --publicKey 12D3KooWG3XbzoVyAE6Y9vHZKF64Yuuu4TjdgQKedk14iYmTEPWu
 ```
 
-_See code: [src/cli/commands/community/get.ts](https://github.com/bitsocialnet/bitsocial-cli/blob/v0.19.43/src/cli/commands/community/get.ts)_
+_See code: [src/cli/commands/community/get.ts](https://github.com/bitsocialnet/bitsocial-cli/blob/v0.19.45/src/cli/commands/community/get.ts)_
 
 ## `bitsocial community list`
 
@@ -548,7 +554,7 @@ EXAMPLES
   $ bitsocial community list
 ```
 
-_See code: [src/cli/commands/community/list.ts](https://github.com/bitsocialnet/bitsocial-cli/blob/v0.19.43/src/cli/commands/community/list.ts)_
+_See code: [src/cli/commands/community/list.ts](https://github.com/bitsocialnet/bitsocial-cli/blob/v0.19.45/src/cli/commands/community/list.ts)_
 
 ## `bitsocial community start ADDRESSES`
 
@@ -577,7 +583,7 @@ EXAMPLES
     $ bitsocial community start $(bitsocial community list -q)
 ```
 
-_See code: [src/cli/commands/community/start.ts](https://github.com/bitsocialnet/bitsocial-cli/blob/v0.19.43/src/cli/commands/community/start.ts)_
+_See code: [src/cli/commands/community/start.ts](https://github.com/bitsocialnet/bitsocial-cli/blob/v0.19.45/src/cli/commands/community/start.ts)_
 
 ## `bitsocial community stop ADDRESSES`
 
@@ -602,7 +608,7 @@ EXAMPLES
   $ bitsocial community stop Qmb99crTbSUfKXamXwZBe829Vf6w5w5TktPkb6WstC9RFW
 ```
 
-_See code: [src/cli/commands/community/stop.ts](https://github.com/bitsocialnet/bitsocial-cli/blob/v0.19.43/src/cli/commands/community/stop.ts)_
+_See code: [src/cli/commands/community/stop.ts](https://github.com/bitsocialnet/bitsocial-cli/blob/v0.19.45/src/cli/commands/community/stop.ts)_
 
 ## `bitsocial daemon`
 
@@ -643,7 +649,7 @@ EXAMPLES
   $ bitsocial daemon --chainProviderUrls https://mainnet.infura.io/v3/YOUR_KEY
 ```
 
-_See code: [src/cli/commands/daemon.ts](https://github.com/bitsocialnet/bitsocial-cli/blob/v0.19.43/src/cli/commands/daemon.ts)_
+_See code: [src/cli/commands/daemon.ts](https://github.com/bitsocialnet/bitsocial-cli/blob/v0.19.45/src/cli/commands/daemon.ts)_
 
 ## `bitsocial help [COMMAND]`
 
@@ -700,7 +706,7 @@ EXAMPLES
   $ bitsocial logs --since 1h -f
 ```
 
-_See code: [src/cli/commands/logs.ts](https://github.com/bitsocialnet/bitsocial-cli/blob/v0.19.43/src/cli/commands/logs.ts)_
+_See code: [src/cli/commands/logs.ts](https://github.com/bitsocialnet/bitsocial-cli/blob/v0.19.45/src/cli/commands/logs.ts)_
 
 ## `bitsocial update check`
 
@@ -717,7 +723,7 @@ EXAMPLES
   $ bitsocial update check
 ```
 
-_See code: [src/cli/commands/update/check.ts](https://github.com/bitsocialnet/bitsocial-cli/blob/v0.19.43/src/cli/commands/update/check.ts)_
+_See code: [src/cli/commands/update/check.ts](https://github.com/bitsocialnet/bitsocial-cli/blob/v0.19.45/src/cli/commands/update/check.ts)_
 
 ## `bitsocial update install [VERSION]`
 
@@ -749,7 +755,7 @@ EXAMPLES
   $ bitsocial update install --no-restart-daemons
 ```
 
-_See code: [src/cli/commands/update/install.ts](https://github.com/bitsocialnet/bitsocial-cli/blob/v0.19.43/src/cli/commands/update/install.ts)_
+_See code: [src/cli/commands/update/install.ts](https://github.com/bitsocialnet/bitsocial-cli/blob/v0.19.45/src/cli/commands/update/install.ts)_
 
 ## `bitsocial update versions`
 
@@ -771,7 +777,7 @@ EXAMPLES
   $ bitsocial update versions --limit 5
 ```
 
-_See code: [src/cli/commands/update/versions.ts](https://github.com/bitsocialnet/bitsocial-cli/blob/v0.19.43/src/cli/commands/update/versions.ts)_
+_See code: [src/cli/commands/update/versions.ts](https://github.com/bitsocialnet/bitsocial-cli/blob/v0.19.45/src/cli/commands/update/versions.ts)_
 <!-- commandsstop -->
 
 ## Contribution

package/bin/update-webuis.js

@@ -0,0 +1,129 @@
+import { createHash } from "node:crypto";
+import { createWriteStream } from "node:fs";
+import fs from "node:fs/promises";
+import os from "node:os";
+import path from "node:path";
+import { Readable } from "node:stream";
+import { finished as streamFinished } from "node:stream/promises";
+import { fileURLToPath } from "node:url";
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = path.dirname(__filename);
+const packageRoot = path.join(__dirname, "..");
+
+const dryRun = process.argv.includes("--dry-run");
+
+async function main() {
+    const pkgPath = path.join(packageRoot, "package.json");
+    const pkg = JSON.parse(await fs.readFile(pkgPath, "utf-8"));
+    const webuis = pkg.webuis;
+    if (!webuis || webuis.length === 0) {
+        console.log("No webuis configured in package.json");
+        return;
+    }
+
+    const githubToken = process.env["GITHUB_TOKEN"];
+    if (githubToken) console.log("Using GITHUB_TOKEN for API requests");
+    const headers = githubToken ? { authorization: `Bearer ${githubToken}` } : undefined;
+
+    let updatedCount = 0;
+
+    for (const entry of webuis) {
+        const { url, sha256OfHtmlZip } = entry;
+
+        // Parse "https://github.com/{owner}/{repo}/releases/tag/{tag}"
+        const match = url.match(/github\.com\/([^/]+\/[^/]+)\/releases\/tag\/(.+)$/);
+        if (!match) {
+            console.warn(`Warning: Could not parse GitHub release URL: ${url}. Skipping.`);
+            continue;
+        }
+        const [, ownerRepo, currentTag] = match;
+        const repoName = ownerRepo.split("/")[1];
+
+        // Fetch latest release
+        const latestRes = await fetch(`https://api.github.com/repos/${ownerRepo}/releases/latest`, { headers });
+        if (!latestRes.ok) {
+            if (latestRes.status === 403) {
+                console.warn(`Warning: GitHub API rate limited for ${ownerRepo}. Set GITHUB_TOKEN to avoid this. Skipping.`);
+            } else {
+                console.warn(`Warning: Failed to fetch latest release for ${ownerRepo}, status ${latestRes.status}. Skipping.`);
+            }
+            continue;
+        }
+
+        const latest = await latestRes.json();
+        const latestTag = latest.tag_name;
+
+        if (latestTag === currentTag) {
+            console.log(`${repoName}: ${currentTag} (already latest)`);
+            continue;
+        }
+
+        // Find html zip asset
+        const htmlZipAsset = latest.assets.find((asset) => asset.name.includes("html"));
+        if (!htmlZipAsset) {
+            console.warn(`Warning: No HTML zip asset found in ${ownerRepo}@${latestTag}. Skipping.`);
+            continue;
+        }
+
+        if (dryRun) {
+            console.log(`${repoName}: ${currentTag} -> ${latestTag} (would update)`);
+            updatedCount++;
+            continue;
+        }
+
+        // Download zip to temp dir
+        const tmpPath = path.join(os.tmpdir(), htmlZipAsset.name);
+        const downloadRes = await fetch(htmlZipAsset["browser_download_url"], { headers });
+        if (!downloadRes.ok || !downloadRes.body) {
+            console.warn(`Warning: Failed to download ${htmlZipAsset.name}, status ${downloadRes.status}. Skipping.`);
+            continue;
+        }
+
+        const writer = createWriteStream(tmpPath);
+        await streamFinished(Readable.fromWeb(downloadRes.body).pipe(writer));
+        writer.close();
+
+        // Compute SHA256
+        const fileBuffer = await fs.readFile(tmpPath);
+        const newHash = createHash("sha256").update(fileBuffer).digest("hex");
+
+        // Clean up temp file
+        await fs.rm(tmpPath);
+
+        // Update entry
+        entry.url = `https://github.com/${ownerRepo}/releases/tag/${latestTag}`;
+        entry.sha256OfHtmlZip = newHash;
+        updatedCount++;
+        console.log(`${repoName}: ${currentTag} -> ${latestTag} (updated)`);
+    }
+
+    if (updatedCount === 0) {
+        console.log("\nAll web UIs are already at their latest versions.");
+        return;
+    }
+
+    if (dryRun) {
+        console.log(`\n${updatedCount} web UI(s) would be updated (dry run, no changes made).`);
+        return;
+    }
+
+    // Write updated package.json
+    pkg.webuis = webuis;
+    await fs.writeFile(pkgPath, JSON.stringify(pkg, null, 4) + "\n");
+    console.log(`\nUpdated ${updatedCount} web UI(s) in package.json.`);
+
+    // Remove dist/webuis/ so postinstall re-downloads
+    const distWebuis = path.join(packageRoot, "dist", "webuis");
+    try {
+        await fs.rm(distWebuis, { recursive: true });
+        console.log("Removed dist/webuis/ — run 'npm run ci:download-web-uis' to re-download.");
+    } catch (e) {
+        if (e.code !== "ENOENT") throw e;
+    }
+}
+
+main().catch((err) => {
+    console.error(err);
+    process.exit(1);
+});

package/dist/challenge-packages/challenge-utils.js

@@ -208,9 +208,11 @@ export async function runNpmInstall(challengeDir) {
     const originalContent = await fs.readFile(pkgJsonPath, "utf-8");
     const pkg = JSON.parse(originalContent);
     const hadDevDeps = pkg.devDependencies !== undefined;
-    if (hadDevDeps) {
+    const hadScripts = pkg.scripts !== undefined;
+    if (hadDevDeps || hadScripts) {
         const stripped = { ...pkg };
         delete stripped.devDependencies;
+        delete stripped.scripts;
         await fs.writeFile(pkgJsonPath, JSON.stringify(stripped, null, 2) + "\n");
     }
     try {
@@ -243,7 +245,7 @@ export async function runNpmInstall(challengeDir) {
         });
     }
     finally {
-        if (hadDevDeps) {
+        if (hadDevDeps || hadScripts) {
             await fs.writeFile(pkgJsonPath, originalContent);
         }
     }

package/dist/cli/commands/community/edit.d.ts

@@ -4,6 +4,9 @@ export default class Edit extends BaseCommand {
     static args: {
         address: import("@oclif/core/interfaces").Arg<string, Record<string, unknown>>;
     };
+    static flags: {
+        jsonFile: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+    };
     static examples: {
         description: string;
         command: string;

package/dist/cli/commands/community/edit.js

@@ -1,6 +1,7 @@
 //@ts-expect-error
 import DataObjectParser from "dataobject-parser";
-import { Args } from "@oclif/core";
+import { Args, Flags } from "@oclif/core";
+import fs from "fs";
 import { BaseCommand } from "../../base-command.js";
 import { PKCLogger, mergeDeep } from "../../../util.js";
 import * as remeda from "remeda";
@@ -10,37 +11,51 @@ export default class Edit extends BaseCommand {
         address: Args.string({
             name: "address",
             required: true,
-            description: "Address of the community to edit"
+            description: "Address of the community to edit. It could be the name domain, or a public key"
+        })
+    };
+    static flags = {
+        jsonFile: Flags.file({
+            char: "f",
+            exists: true,
+            description: "Path to a JSON file containing edit options"
         })
     };
     static examples = [
+        // TODO update this to change the name instead
+        // Also are we testing modifying name properly?
+        // in theory user should not modify address, they should modify name
         {
             description: "Change the address of the community to a new domain address",
             command: "bitsocial community edit 12D3KooWG3XbzoVyAE6Y9vHZKF64Yuuu4TjdgQKedk14iYmTEPWu --address newAddress.bso"
         },
         {
             description: "Add the author address 'esteban.bso' as an admin on the community",
-            command: `bitsocial community edit mysub.bso '--roles["esteban.bso"].role' admin`
+            command: `bitsocial community edit mycommunity.bso '--roles["esteban.bso"].role' admin`
         },
         {
             description: "Add two challenges to the community. The first challenge will be a question and answer, and the second will be an image captcha",
-            command: `bitsocial community edit mysub.bso --settings.challenges[0].name question --settings.challenges[0].options.question "what is the password?" --settings.challenges[0].options.answer thepassword --settings.challenges[1].name captcha-canvas-v3`
+            command: `bitsocial community edit mycommunity.bso --settings.challenges[0].name question --settings.challenges[0].options.question "what is the password?" --settings.challenges[0].options.answer thepassword --settings.challenges[1].name captcha-canvas-v3`
         },
         {
             description: "Change the title and description",
-            command: `bitsocial community edit mysub.bso --title "This is the new title" --description "This is the new description" `
+            command: `bitsocial community edit mycommunity.bso --title "This is the new title" --description "This is the new description" `
         },
         {
             description: "Remove a role from a moderator/admin/owner",
-            command: "bitsocial community edit plebbit.bso --roles['rinse12.bso'] null"
+            command: "bitsocial community edit bitsocial.bso --roles['rinse12.bso'] null"
         },
         {
             description: "Enable settings.fetchThumbnailUrls to fetch the thumbnail of url submitted by authors",
-            command: "bitsocial community edit plebbit.bso --settings.fetchThumbnailUrls"
+            command: "bitsocial community edit bitsocial.bso --settings.fetchThumbnailUrls"
         },
         {
             description: "disable settings.fetchThumbnailUrls",
-            command: "bitsocial community edit plebbit.bso --settings.fetchThumbnailUrls=false"
+            command: "bitsocial community edit bitsocial.bso --settings.fetchThumbnailUrls=false"
+        },
+        {
+            description: "Edit a community using options from a JSON file",
+            command: "bitsocial community edit bitsocial.bso --jsonFile ./edit-options.json"
         }
     ];
     async run() {
@@ -48,8 +63,39 @@ export default class Edit extends BaseCommand {
         const log = PKCLogger("bitsocial-cli:commands:community:edit");
         log(`flags: `, flags);
         const pkc = await this._connectToPkcRpc(flags.pkcRpcUrl.toString());
-        const editOptions = DataObjectParser.transpose(remeda.omit(flags, ["pkcRpcUrl"]))["_data"];
-        log("Edit options parsed:", editOptions);
+        const cliEditOptions = DataObjectParser.transpose(remeda.omit(flags, ["pkcRpcUrl", "jsonFile"]))["_data"];
+        log("CLI edit options parsed:", cliEditOptions);
+        // Parse JSON file if provided
+        let jsonFileOptions = {};
+        if (flags.jsonFile) {
+            try {
+                const fileContent = await fs.promises.readFile(flags.jsonFile, "utf-8");
+                const parsed = JSON.parse(fileContent);
+                if (parsed === null || typeof parsed !== "object" || Array.isArray(parsed)) {
+                    this.error("JSON file must contain a JSON object (not an array, null, string, or number)");
+                }
+                jsonFileOptions = parsed;
+                log("JSON file options parsed:", jsonFileOptions);
+            }
+            catch (e) {
+                if (e instanceof SyntaxError) {
+                    this.error(`Invalid JSON in file ${flags.jsonFile}: ${e.message}`);
+                }
+                throw e;
+            }
+        }
+        // Merge: JSON file options first, then CLI flags override
+        let editOptions;
+        if (flags.jsonFile && Object.keys(cliEditOptions).length > 0) {
+            editOptions = mergeDeep(jsonFileOptions, cliEditOptions);
+        }
+        else if (flags.jsonFile) {
+            editOptions = jsonFileOptions;
+        }
+        else {
+            editOptions = cliEditOptions;
+        }
+        log("Final edit options:", editOptions);
         const localCommunities = pkc.communities;
         if (!localCommunities.includes(args.address))
             this.error("Can't edit a remote community, make sure you're editing a local community");

package/dist/cli/commands/daemon.js

@@ -223,7 +223,6 @@ export default class Daemon extends Command {
             // Create BSO name resolvers for .bso/.eth domain resolution
             const bsoResolvers = createBsoResolvers(flags.chainProviderUrls, mergedPkcOptions.dataPath);
             mergedPkcOptions.nameResolvers = [...(mergedPkcOptions.nameResolvers || []), ...bsoResolvers];
-            console.log(".bso name resolvers:", bsoResolvers.map((r) => r.provider).join(", "));
             let mainProcessExited = false;
             let pendingKuboStart;
             // Kubo Node may fail randomly, we need to set a listener so when it exits because of an error we restart it

package/dist/cli/commands/update/install.d.ts

@@ -11,4 +11,6 @@ export default class Install extends Command {
     static examples: string[];
     run(): Promise<void>;
     private _restartDaemons;
+    private _connectToRpc;
+    private _reportCommunityStatus;
 }

package/dist/cli/commands/update/install.js

@@ -4,6 +4,11 @@ import tcpPortUsed from "tcp-port-used";
 import { fetchLatestVersion, installGlobal } from "../../../update/npm-registry.js";
 import { compareVersions } from "../../../update/semver.js";
 import { getAliveDaemonStates } from "../../../common-utils/daemon-state.js";
+import PKC from "@pkcprotocol/pkc-js";
+const getPKCConnectOverride = () => {
+    const globalWithOverride = globalThis;
+    return globalWithOverride.__PKC_RPC_CONNECT_OVERRIDE;
+};
 export default class Install extends Command {
     static description = "Install a specific version of bitsocial from npm";
     static args = {
@@ -122,10 +127,64 @@ export default class Install extends Command {
             const started = await tcpPortUsed.waitUntilUsed(port, 500, 30000).then(() => true).catch(() => false);
             if (started) {
                 this.log(`  Daemon started (port ${port}).`);
+                await this._reportCommunityStatus(d.pkcRpcUrl);
             }
             else {
                 this.warn(`  Daemon may not have started — port ${port} not responding after 30s. Check logs with: bitsocial logs`);
             }
         }
     }
+    async _connectToRpc(pkcRpcUrl) {
+        const connectOverride = getPKCConnectOverride();
+        if (connectOverride) {
+            return connectOverride(pkcRpcUrl);
+        }
+        const pkc = await PKC({ pkcRpcClientsOptions: [pkcRpcUrl] });
+        const errors = [];
+        pkc.on("error", (err) => {
+            errors.push(err);
+        });
+        await new Promise((resolve, reject) => {
+            const timeout = setTimeout(() => {
+                const lastError = errors[errors.length - 1];
+                reject(lastError ?? new Error(`Timed out waiting for RPC server at ${pkcRpcUrl} to respond`));
+            }, 20000);
+            pkc.once("communitieschange", () => {
+                clearTimeout(timeout);
+                resolve();
+            });
+        });
+        return pkc;
+    }
+    async _reportCommunityStatus(pkcRpcUrl) {
+        let pkc;
+        try {
+            pkc = await this._connectToRpc(pkcRpcUrl);
+            const communities = pkc.communities;
+            if (communities.length === 0)
+                return;
+            const statuses = await Promise.all(communities.map(async (address) => {
+                const community = await pkc.createCommunity({ address });
+                return community.started;
+            }));
+            const startedCount = statuses.filter(Boolean).length;
+            const total = communities.length;
+            if (startedCount === total) {
+                this.log(`  ${startedCount} ${startedCount === 1 ? "community" : "communities"} started.`);
+            }
+            else if (startedCount > 0) {
+                this.log(`  ${startedCount} of ${total} communities started (remaining still loading).`);
+            }
+            else {
+                this.log(`  ${total} ${total === 1 ? "community" : "communities"} in data path (still loading). Check with: bitsocial community list`);
+            }
+        }
+        catch {
+            this.warn("Could not check community status.");
+        }
+        finally {
+            if (pkc)
+                await pkc.destroy().catch(() => { });
+        }
+    }
 }

package/dist/cli/hooks/prerun/parse-dynamic-flags-hook.js

@@ -60,6 +60,10 @@ const traverseObjectToSetAsFlagInOclif = (opts, flagsGrouped, path = "") => {
             if (Object.keys(flagsGrouped[flagName]).length !== 0)
                 continue;
         }
+        const fullFlagName = path + flagName;
+        // Skip flags that are already statically declared on the command
+        if (opts.Command.flags && fullFlagName in opts.Command.flags)
+            continue;
         const flagsIndices = Object.assign({}, ...Object.keys(flagsGrouped).map((flag) => ({ [flag]: 0 })));
         const multipleValues = Array.isArray(flagsGrouped[flagName]) && flagsGrouped[flagName].length > 1;
         const parsedValue = flagsGrouped[flagName];
@@ -76,9 +80,18 @@ const traverseObjectToSetAsFlagInOclif = (opts, flagsGrouped, path = "") => {
             });
     }
 };
+// Tracks original static flags per Command class so dynamic flags can be reset across invocations (e.g. in tests)
+const originalStaticFlags = new WeakMap();
 const hook = async function (opts) {
     // Need to parse flag here and add it to opts.Command._flags
     if (opts.Command.id === "community:edit" || opts.Command.id === "community:create" || opts.Command.id === "daemon") {
+        // Snapshot static flags on first run; restore on subsequent runs (test isolation)
+        if (!originalStaticFlags.has(opts.Command)) {
+            originalStaticFlags.set(opts.Command, opts.Command.flags ? { ...opts.Command.flags } : {});
+        }
+        else {
+            opts.Command.flags = { ...originalStaticFlags.get(opts.Command) };
+        }
         // Parse the dynamic flags and add them to opts.Command.flags so that it wouldn't throw
         if (opts.argv.length <= 1)
             return; // if no flags are provided, then we don't need to do anything

package/oclif.manifest.json

@@ -350,7 +350,7 @@
       "aliases": [],
       "args": {
         "address": {
-          "description": "Address of the community to edit",
+          "description": "Address of the community to edit. It could be the name domain, or a public key",
           "name": "address",
           "required": true
         }
@@ -363,27 +363,31 @@
         },
         {
           "description": "Add the author address 'esteban.bso' as an admin on the community",
-          "command": "bitsocial community edit mysub.bso '--roles[\"esteban.bso\"].role' admin"
+          "command": "bitsocial community edit mycommunity.bso '--roles[\"esteban.bso\"].role' admin"
         },
         {
           "description": "Add two challenges to the community. The first challenge will be a question and answer, and the second will be an image captcha",
-          "command": "bitsocial community edit mysub.bso --settings.challenges[0].name question --settings.challenges[0].options.question \"what is the password?\" --settings.challenges[0].options.answer thepassword --settings.challenges[1].name captcha-canvas-v3"
+          "command": "bitsocial community edit mycommunity.bso --settings.challenges[0].name question --settings.challenges[0].options.question \"what is the password?\" --settings.challenges[0].options.answer thepassword --settings.challenges[1].name captcha-canvas-v3"
         },
         {
           "description": "Change the title and description",
-          "command": "bitsocial community edit mysub.bso --title \"This is the new title\" --description \"This is the new description\" "
+          "command": "bitsocial community edit mycommunity.bso --title \"This is the new title\" --description \"This is the new description\" "
         },
         {
           "description": "Remove a role from a moderator/admin/owner",
-          "command": "bitsocial community edit plebbit.bso --roles['rinse12.bso'] null"
+          "command": "bitsocial community edit bitsocial.bso --roles['rinse12.bso'] null"
         },
         {
           "description": "Enable settings.fetchThumbnailUrls to fetch the thumbnail of url submitted by authors",
-          "command": "bitsocial community edit plebbit.bso --settings.fetchThumbnailUrls"
+          "command": "bitsocial community edit bitsocial.bso --settings.fetchThumbnailUrls"
         },
         {
           "description": "disable settings.fetchThumbnailUrls",
-          "command": "bitsocial community edit plebbit.bso --settings.fetchThumbnailUrls=false"
+          "command": "bitsocial community edit bitsocial.bso --settings.fetchThumbnailUrls=false"
+        },
+        {
+          "description": "Edit a community using options from a JSON file",
+          "command": "bitsocial community edit bitsocial.bso --jsonFile ./edit-options.json"
         }
       ],
       "flags": {
@@ -395,6 +399,14 @@
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
+        },
+        "jsonFile": {
+          "char": "f",
+          "description": "Path to a JSON file containing edit options",
+          "name": "jsonFile",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
         }
       },
       "hasDynamicHelp": false,
@@ -713,5 +725,5 @@
       ]
     }
   },
-  "version": "0.19.43"
+  "version": "0.19.45"
 }

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@bitsocial/bitsocial-cli",
-    "version": "0.19.43",
+    "version": "0.19.45",
     "description": "Command line interface to Bitsocial API",
     "types": "./dist/index.d.ts",
     "homepage": "https://github.com/bitsocialnet/bitsocial-cli",
@@ -25,7 +25,8 @@
         "postinstall": "node bin/postinstall.js",
         "generate:readme": "oclif readme && sed -i 's@/src/commands/@/src/cli/commands/@g' README.md && sed -i 's@src/commands@src/cli/commands@g' README.md",
         "ci:download-web-uis": "node bin/postinstall.js",
-        "ci:daemon:test-before-release": "node --loader ts-node/esm ci-bin/run-daemon-before-release.ts"
+        "ci:daemon:test-before-release": "node --loader ts-node/esm ci-bin/run-daemon-before-release.ts",
+        "update-webuis": "node bin/update-webuis.js"
     },
     "files": [
         "/bin",
@@ -93,7 +94,7 @@
         "@types/node": "22.19.13",
         "@types/prettier": "2.7.1",
         "@types/tcp-port-used": "1.0.4",
-        "@types/ws": "^8.18.1",
+        "@types/ws": "8.18.1",
         "commitizen": "4.2.5",
         "cz-conventional-changelog": "3.3.0",
         "eslint": "8.27.0",
@@ -111,7 +112,7 @@
         "wait-on": "6.0.1"
     },
     "dependencies": {
-        "@bitsocial/bso-resolver": "0.0.5",
+        "@bitsocial/bso-resolver": "0.0.6",
         "@multiformats/multiaddr": "13.0.1",
         "@oclif/core": "4.8.0",
         "@oclif/plugin-help": "6.2.36",
@@ -139,8 +140,8 @@
             "sha256OfHtmlZip": "14653b19e88868fda6fef26601f477947e44251cc52bd95d7d6fec158ae67b6f"
         },
         {
-            "url": "https://github.com/bitsocialnet/5chan/releases/tag/v0.6.4",
-            "sha256OfHtmlZip": "b47685f868c868c6afe96e865897876fabac2ddf121a00d194cee36fdff9d348"
+            "url": "https://github.com/bitsocialnet/5chan/releases/tag/v0.7.4",
+            "sha256OfHtmlZip": "c768bd40a6f9e6c3889d2e57df843e667594974c6f3048357e2b6148aeec3385"
         }
     ]
 }