@bitsocial/bitsocial-cli 0.19.51 → 0.19.53

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.51/src/cli/commands/challenge/install.ts)_
+_See code: [src/cli/commands/challenge/install.ts](https://github.com/bitsocialnet/bitsocial-cli/blob/v0.19.53/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.51/src/cli/commands/challenge/list.ts)_
+_See code: [src/cli/commands/challenge/list.ts](https://github.com/bitsocialnet/bitsocial-cli/blob/v0.19.53/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.51/src/cli/commands/challenge/remove.ts)_
+_See code: [src/cli/commands/challenge/remove.ts](https://github.com/bitsocialnet/bitsocial-cli/blob/v0.19.53/src/cli/commands/challenge/remove.ts)_
 
 ## `bitsocial community create`
 
@@ -422,7 +422,7 @@ EXAMPLES
     $ bitsocial community create --jsonFile ./create-options.json
 ```
 
-_See code: [src/cli/commands/community/create.ts](https://github.com/bitsocialnet/bitsocial-cli/blob/v0.19.51/src/cli/commands/community/create.ts)_
+_See code: [src/cli/commands/community/create.ts](https://github.com/bitsocialnet/bitsocial-cli/blob/v0.19.53/src/cli/commands/community/create.ts)_
 
 ## `bitsocial community delete ADDRESSES`
 
@@ -447,7 +447,7 @@ EXAMPLES
   $ bitsocial community delete 12D3KooWG3XbzoVyAE6Y9vHZKF64Yuuu4TjdgQKedk14iYmTEPWu
 ```
 
-_See code: [src/cli/commands/community/delete.ts](https://github.com/bitsocialnet/bitsocial-cli/blob/v0.19.51/src/cli/commands/community/delete.ts)_
+_See code: [src/cli/commands/community/delete.ts](https://github.com/bitsocialnet/bitsocial-cli/blob/v0.19.53/src/cli/commands/community/delete.ts)_
 
 ## `bitsocial community edit ADDRESS`
 
@@ -517,7 +517,7 @@ EXAMPLES
     $ 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.51/src/cli/commands/community/edit.ts)_
+_See code: [src/cli/commands/community/edit.ts](https://github.com/bitsocialnet/bitsocial-cli/blob/v0.19.53/src/cli/commands/community/edit.ts)_
 
 ## `bitsocial community get [ADDRESS]`
 
@@ -548,7 +548,7 @@ EXAMPLES
   $ bitsocial community get --publicKey 12D3KooWG3XbzoVyAE6Y9vHZKF64Yuuu4TjdgQKedk14iYmTEPWu
 ```
 
-_See code: [src/cli/commands/community/get.ts](https://github.com/bitsocialnet/bitsocial-cli/blob/v0.19.51/src/cli/commands/community/get.ts)_
+_See code: [src/cli/commands/community/get.ts](https://github.com/bitsocialnet/bitsocial-cli/blob/v0.19.53/src/cli/commands/community/get.ts)_
 
 ## `bitsocial community list`
 
@@ -571,7 +571,7 @@ EXAMPLES
   $ bitsocial community list
 ```
 
-_See code: [src/cli/commands/community/list.ts](https://github.com/bitsocialnet/bitsocial-cli/blob/v0.19.51/src/cli/commands/community/list.ts)_
+_See code: [src/cli/commands/community/list.ts](https://github.com/bitsocialnet/bitsocial-cli/blob/v0.19.53/src/cli/commands/community/list.ts)_
 
 ## `bitsocial community start ADDRESSES`
 
@@ -605,7 +605,7 @@ EXAMPLES
     $ bitsocial community start $(bitsocial community list -q) --concurrency 1
 ```
 
-_See code: [src/cli/commands/community/start.ts](https://github.com/bitsocialnet/bitsocial-cli/blob/v0.19.51/src/cli/commands/community/start.ts)_
+_See code: [src/cli/commands/community/start.ts](https://github.com/bitsocialnet/bitsocial-cli/blob/v0.19.53/src/cli/commands/community/start.ts)_
 
 ## `bitsocial community stop ADDRESSES`
 
@@ -630,7 +630,7 @@ EXAMPLES
   $ bitsocial community stop Qmb99crTbSUfKXamXwZBe829Vf6w5w5TktPkb6WstC9RFW
 ```
 
-_See code: [src/cli/commands/community/stop.ts](https://github.com/bitsocialnet/bitsocial-cli/blob/v0.19.51/src/cli/commands/community/stop.ts)_
+_See code: [src/cli/commands/community/stop.ts](https://github.com/bitsocialnet/bitsocial-cli/blob/v0.19.53/src/cli/commands/community/stop.ts)_
 
 ## `bitsocial daemon`
 
@@ -671,7 +671,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.51/src/cli/commands/daemon.ts)_
+_See code: [src/cli/commands/daemon.ts](https://github.com/bitsocialnet/bitsocial-cli/blob/v0.19.53/src/cli/commands/daemon.ts)_
 
 ## `bitsocial help [COMMAND]`
 
@@ -737,7 +737,7 @@ EXAMPLES
   $ bitsocial logs --stdout -f
 ```
 
-_See code: [src/cli/commands/logs.ts](https://github.com/bitsocialnet/bitsocial-cli/blob/v0.19.51/src/cli/commands/logs.ts)_
+_See code: [src/cli/commands/logs.ts](https://github.com/bitsocialnet/bitsocial-cli/blob/v0.19.53/src/cli/commands/logs.ts)_
 
 ## `bitsocial update check`
 
@@ -754,7 +754,7 @@ EXAMPLES
   $ bitsocial update check
 ```
 
-_See code: [src/cli/commands/update/check.ts](https://github.com/bitsocialnet/bitsocial-cli/blob/v0.19.51/src/cli/commands/update/check.ts)_
+_See code: [src/cli/commands/update/check.ts](https://github.com/bitsocialnet/bitsocial-cli/blob/v0.19.53/src/cli/commands/update/check.ts)_
 
 ## `bitsocial update install [VERSION]`
 
@@ -786,7 +786,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.51/src/cli/commands/update/install.ts)_
+_See code: [src/cli/commands/update/install.ts](https://github.com/bitsocialnet/bitsocial-cli/blob/v0.19.53/src/cli/commands/update/install.ts)_
 
 ## `bitsocial update versions`
 
@@ -808,7 +808,7 @@ EXAMPLES
   $ bitsocial update versions --limit 5
 ```
 
-_See code: [src/cli/commands/update/versions.ts](https://github.com/bitsocialnet/bitsocial-cli/blob/v0.19.51/src/cli/commands/update/versions.ts)_
+_See code: [src/cli/commands/update/versions.ts](https://github.com/bitsocialnet/bitsocial-cli/blob/v0.19.53/src/cli/commands/update/versions.ts)_
 <!-- commandsstop -->
 
 ## Contribution

package/dist/cli/commands/daemon.d.ts

@@ -1,4 +1,26 @@
 import { Command } from "@oclif/core";
+export interface KeepKuboUpTickDeps {
+    pkcRpcUrl: URL;
+    tcpPortUsedCheck: (port: number, host: string) => Promise<boolean>;
+    pkcOptionsFromFlag: {
+        kuboRpcClientsOptions?: unknown;
+    } | undefined;
+    usingDifferentProcessRpc: boolean;
+    hasKuboProcess: boolean;
+    hasPendingKuboStart: boolean;
+    keepKuboUp: () => Promise<void>;
+    createOrConnectRpc: () => Promise<void>;
+    onError: (message: string) => void;
+}
+/**
+ * Runs one tick of the keepKuboUp interval. Exported so it can be unit-tested.
+ *
+ * Both `tcpPortUsedCheck` and the downstream `keepKuboUp`/`createOrConnectRpc` calls
+ * are wrapped in try/catch — a transient ETIMEDOUT from the port check (or any other
+ * error from this tick) must not propagate to the setInterval callback, which would
+ * become an unhandledRejection (issue #37 bug 3).
+ */
+export declare function runKeepKuboUpTick(deps: KeepKuboUpTickDeps): Promise<void>;
 export default class Daemon extends Command {
     static description: string;
     static flags: {

package/dist/cli/commands/daemon.js

@@ -10,6 +10,7 @@ import { loadChallengesIntoPKC } from "../../challenge-packages/challenge-utils.
 import { migrateDataDirectory } from "../../common-utils/data-migration.js";
 import { createBsoResolvers, DEFAULT_PROVIDERS } from "../../common-utils/resolvers.js";
 import { pruneStaleStates, writeDaemonState, deleteDaemonState } from "../../common-utils/daemon-state.js";
+import { createDaemonFileLogger } from "../../common-utils/daemon-file-logger.js";
 import fs from "fs";
 import fsPromise from "fs/promises";
 /** Replace wildcard bind addresses with loopback for connectivity checks (macOS rejects connect to 0.0.0.0 with EINVAL) */
@@ -32,6 +33,36 @@ const defaultPkcOptions = {
     dataPath: defaults.PKC_DATA_PATH,
     httpRoutersOptions: defaults.HTTP_TRACKERS
 };
+/**
+ * Runs one tick of the keepKuboUp interval. Exported so it can be unit-tested.
+ *
+ * Both `tcpPortUsedCheck` and the downstream `keepKuboUp`/`createOrConnectRpc` calls
+ * are wrapped in try/catch — a transient ETIMEDOUT from the port check (or any other
+ * error from this tick) must not propagate to the setInterval callback, which would
+ * become an unhandledRejection (issue #37 bug 3).
+ */
+export async function runKeepKuboUpTick(deps) {
+    let isRpcPortTaken = false;
+    try {
+        isRpcPortTaken = await deps.tcpPortUsedCheck(Number(deps.pkcRpcUrl.port), deps.pkcRpcUrl.hostname);
+        if (!deps.pkcOptionsFromFlag?.kuboRpcClientsOptions && !isRpcPortTaken && !deps.usingDifferentProcessRpc)
+            await deps.keepKuboUp();
+        else if (deps.pkcOptionsFromFlag?.kuboRpcClientsOptions && !deps.usingDifferentProcessRpc)
+            await deps.keepKuboUp();
+        // Retry if kubo died and onKuboExit's restart attempt failed (e.g. transient port conflict)
+        else if (!deps.hasKuboProcess && !deps.hasPendingKuboStart && !deps.usingDifferentProcessRpc)
+            await deps.keepKuboUp();
+    }
+    catch (error) {
+        deps.onError(`keepKuboUp tick error (will retry): ${error instanceof Error ? error.message : String(error)}`);
+    }
+    try {
+        await deps.createOrConnectRpc();
+    }
+    catch (error) {
+        deps.onError(`createOrConnectRpc tick error (will retry): ${error instanceof Error ? error.message : String(error)}`);
+    }
+}
 export default class Daemon extends Command {
     static description = `Run a network-connected Bitsocial node. Once the daemon is running you can create and start your communities and receive publications from users. The daemon will also serve web ui on http that can be accessed through a browser on any machine. Within the web ui users are able to browse, create and manage their communities fully P2P.
     Options can be passed to the RPC's instance through flag --pkcOptions.optionName. For a list of pkc options (https://github.com/pkcprotocol/pkc-js?tab=readme-ov-file#pkcoptions)
@@ -92,20 +123,9 @@ export default class Daemon extends Command {
     }
     async _pipeDebugLogsToLogFile(logPath, Logger) {
         const { logFilePath, deletedLogFile, logfilesCapacity } = await this._getNewLogfileByEvacuatingOldLogsIfNeeded(logPath);
-        const logFile = fs.createWriteStream(logFilePath, { flags: "a" });
+        const fileLogger = createDaemonFileLogger({ logFilePath });
         const stdoutWrite = process.stdout.write.bind(process.stdout);
         const stderrWrite = process.stderr.write.bind(process.stderr);
-        const isLogFileOverLimit = () => logFile.bytesWritten > 20000000; // 20mb
-        const writeTimestampedLine = (text, stream) => {
-            if (isLogFileOverLimit())
-                return;
-            if (!text || text.trim().length === 0)
-                return;
-            const timestamp = `[${new Date().toISOString()}] [${stream}] `;
-            const lines = text.split("\n");
-            const timestamped = lines.map((line, i) => (i === 0 ? timestamp + line : line)).join("\n");
-            logFile.write(timestamped);
-        };
         // Redirect debug library output directly to the log file
         // instead of stderr, so only real errors appear in the terminal
         const require = createRequire(import.meta.url);
@@ -115,21 +135,30 @@ export default class Daemon extends Command {
         debugModule.inspectOpts.colors = true;
         debugModule.inspectOpts.hideDate = true;
         debugModule.log = (...args) => {
-            writeTimestampedLine(formatWithOptions({ depth: Logger.inspectOpts?.depth || 10, colors: true }, ...args).trimStart() + EOL, "stderr");
+            const text = formatWithOptions({ depth: Logger.inspectOpts?.depth || 10, colors: true }, ...args).trimStart() + EOL;
+            const wrote = fileLogger.writeTimestampedLine(text, "stderr");
+            // If the file logger could not accept the write (closed / pending buffer full),
+            // fall back to original stderr so debug output is never silently lost
+            if (!wrote)
+                stderrWrite(text);
         };
         const asString = (data) => (typeof data === "string" ? data : Buffer.from(data).toString());
         process.stdout.write = (...args) => {
             //@ts-expect-error
             const res = stdoutWrite(...args);
-            writeTimestampedLine(asString(args[0]), "stdout");
+            fileLogger.writeTimestampedLine(asString(args[0]), "stdout");
             return res;
         };
         process.stderr.write = (...args) => {
-            // Only write stderr to the log file, not to the terminal.
-            // Debug output goes to stderr; we want it in logs only.
-            // Real errors are caught by uncaughtException/unhandledRejection handlers
-            // which use console.error -> stderr.write -> this override -> log file.
-            writeTimestampedLine(asString(args[0]).trimStart(), "stderr");
+            // Debug output goes to stderr; route it to the log file.
+            // If the file logger is unavailable (closed, errored), fall back to original stderr
+            // so output is never silently swallowed.
+            const text = asString(args[0]);
+            const wrote = fileLogger.writeTimestampedLine(text.trimStart(), "stderr");
+            if (!wrote) {
+                //@ts-expect-error
+                return stderrWrite(...args);
+            }
             return true;
         };
         const log = Logger("bitsocial-cli:daemon");
@@ -150,8 +179,12 @@ export default class Daemon extends Command {
             writeErrorToTerminal(err);
             console.error(err);
         });
-        process.on("exit", () => logFile.close());
-        return { logFilePath, stdoutWrite };
+        process.on("exit", () => {
+            // close() returns a promise but exit handlers must be synchronous.
+            // Best-effort: trigger the close; the underlying writeStream flushes on process exit.
+            fileLogger.close().catch(() => { });
+        });
+        return { logFilePath, stdoutWrite, fileLogger };
     }
     async run() {
         printBanner();
@@ -221,7 +254,7 @@ export default class Daemon extends Command {
                 pkcRpcUrl: pkcRpcUrl.toString()
             });
             // Create BSO name resolvers for .bso/.eth domain resolution
-            const bsoResolvers = createBsoResolvers(flags.chainProviderUrls, mergedPkcOptions.dataPath);
+            const bsoResolvers = createBsoResolvers(flags.chainProviderUrls);
             mergedPkcOptions.nameResolvers = [...(mergedPkcOptions.nameResolvers || []), ...bsoResolvers];
             let mainProcessExited = false;
             let pendingKuboStart;
@@ -466,20 +499,17 @@ export default class Daemon extends Command {
             keepKuboUpInterval = setInterval(async () => {
                 if (mainProcessExited)
                     return;
-                const isRpcPortTaken = await tcpPortUsed.check(Number(pkcRpcUrl.port), pkcRpcUrl.hostname);
-                try {
-                    if (!pkcOptionsFromFlag?.kuboRpcClientsOptions && !isRpcPortTaken && !usingDifferentProcessRpc)
-                        await keepKuboUp();
-                    else if (pkcOptionsFromFlag?.kuboRpcClientsOptions && !usingDifferentProcessRpc)
-                        await keepKuboUp();
-                    // Retry if kubo died and onKuboExit's restart attempt failed (e.g. transient port conflict)
-                    else if (!kuboProcess && !pendingKuboStart && !usingDifferentProcessRpc)
-                        await keepKuboUp();
-                }
-                catch (error) {
-                    log.trace(`keepKuboUp error (will retry): ${error instanceof Error ? error.message : String(error)}`);
-                }
-                await createOrConnectRpc();
+                await runKeepKuboUpTick({
+                    pkcRpcUrl,
+                    tcpPortUsedCheck: (port, host) => tcpPortUsed.check(port, host),
+                    pkcOptionsFromFlag,
+                    usingDifferentProcessRpc,
+                    hasKuboProcess: !!kuboProcess,
+                    hasPendingKuboStart: !!pendingKuboStart,
+                    keepKuboUp,
+                    createOrConnectRpc,
+                    onError: (msg) => log.trace(msg)
+                });
             }, 5000);
         }
         catch (err) {

package/dist/common-utils/daemon-file-logger.d.ts

@@ -0,0 +1,23 @@
+export interface DaemonFileLoggerOptions {
+    logFilePath: string;
+    /** Trigger a trim once the current writer's bytesWritten exceeds this. Defaults to 20 MB. */
+    maxBytes?: number;
+    /** Target file size after trim. Must be < maxBytes. Defaults to 15 MB. */
+    trimToBytes?: number;
+    /** Bound on how many bytes of writes are buffered while a trim cycle is running. */
+    pendingByteCap?: number;
+}
+export interface DaemonFileLogger {
+    /**
+     * Append a timestamped line to the log file. Returns false when the write was
+     * dropped (e.g. the logger is closed or the in-flight pending buffer is full),
+     * letting the caller decide whether to fall back to terminal output.
+     */
+    writeTimestampedLine(text: string, stream: "stdout" | "stderr"): boolean;
+    close(): Promise<void>;
+    /** Force-run a trim cycle — for tests. */
+    _trimNow(): Promise<void>;
+    readonly currentPath: string;
+    readonly bytesWritten: number;
+}
+export declare function createDaemonFileLogger(options: DaemonFileLoggerOptions): DaemonFileLogger;

package/dist/common-utils/daemon-file-logger.js

@@ -0,0 +1,112 @@
+import fs from "fs";
+import fsPromise from "fs/promises";
+const DEFAULT_MAX = 20_000_000;
+const DEFAULT_TRIM_TO = 15_000_000;
+const DEFAULT_PENDING_CAP = 5_000_000;
+export function createDaemonFileLogger(options) {
+    const maxBytes = options.maxBytes ?? DEFAULT_MAX;
+    const trimToBytes = options.trimToBytes ?? DEFAULT_TRIM_TO;
+    const pendingByteCap = options.pendingByteCap ?? DEFAULT_PENDING_CAP;
+    if (trimToBytes >= maxBytes) {
+        throw new Error(`trimToBytes (${trimToBytes}) must be less than maxBytes (${maxBytes})`);
+    }
+    const logFilePath = options.logFilePath;
+    let stream = fs.createWriteStream(logFilePath, { flags: "a" });
+    stream.on("error", () => { });
+    let trimming;
+    let pending = [];
+    let pendingBytes = 0;
+    let closed = false;
+    const reopenStream = () => {
+        stream.removeAllListeners("error");
+        stream = fs.createWriteStream(logFilePath, { flags: "a" });
+        stream.on("error", () => { });
+    };
+    const trim = async () => {
+        // End the current stream first so its buffered writes flush to disk before we read the file
+        await new Promise((res) => stream.end(() => res()));
+        const stat = await fsPromise.stat(logFilePath).catch(() => null);
+        if (stat && stat.size > trimToBytes) {
+            const fd = await fsPromise.open(logFilePath, "r");
+            try {
+                const buf = Buffer.alloc(trimToBytes);
+                await fd.read(buf, 0, trimToBytes, stat.size - trimToBytes);
+                // Skip a partial line at the start so the file always starts on a line boundary
+                const firstNewline = buf.indexOf(0x0a);
+                const tail = firstNewline >= 0 ? buf.subarray(firstNewline + 1) : buf;
+                await fsPromise.writeFile(logFilePath, tail);
+            }
+            finally {
+                await fd.close();
+            }
+        }
+        reopenStream();
+    };
+    const drainPending = () => {
+        if (pending.length === 0)
+            return;
+        const drained = pending;
+        pending = [];
+        pendingBytes = 0;
+        for (const chunk of drained) {
+            stream.write(chunk);
+        }
+    };
+    const scheduleTrim = () => {
+        if (trimming)
+            return;
+        trimming = trim()
+            .catch(() => {
+            // If trim fails (FS error, etc.) we drop the pending buffer rather than
+            // hold memory forever. The next write will hit the same condition and retry.
+            pending = [];
+            pendingBytes = 0;
+        })
+            .finally(() => {
+            trimming = undefined;
+            drainPending();
+        });
+    };
+    const writeTimestampedLine = (text, streamLabel) => {
+        if (closed)
+            return false;
+        if (!text || text.trim().length === 0)
+            return false;
+        const timestamp = `[${new Date().toISOString()}] [${streamLabel}] `;
+        const lines = text.split("\n");
+        const timestamped = lines.map((line, i) => (i === 0 ? timestamp + line : line)).join("\n");
+        if (trimming) {
+            // A trim cycle is in flight — buffer up to pendingByteCap, then drop with false
+            // so the caller can fall back to writing to the terminal.
+            if (pendingBytes + timestamped.length > pendingByteCap)
+                return false;
+            pending.push(timestamped);
+            pendingBytes += timestamped.length;
+            return true;
+        }
+        stream.write(timestamped);
+        if (stream.bytesWritten > maxBytes)
+            scheduleTrim();
+        return true;
+    };
+    return {
+        writeTimestampedLine,
+        async close() {
+            closed = true;
+            if (trimming)
+                await trimming.catch(() => { });
+            await new Promise((res) => stream.end(() => res()));
+        },
+        async _trimNow() {
+            scheduleTrim();
+            if (trimming)
+                await trimming;
+        },
+        get currentPath() {
+            return logFilePath;
+        },
+        get bytesWritten() {
+            return stream.bytesWritten;
+        }
+    };
+}

package/dist/common-utils/resolvers.d.ts

@@ -1,3 +1,3 @@
 import { BsoResolver } from "@bitsocial/bso-resolver";
 export declare const DEFAULT_PROVIDERS: string[];
-export declare function createBsoResolvers(providers?: string[], dataPath?: string): BsoResolver[];
+export declare function createBsoResolvers(providers?: string[]): BsoResolver[];

package/dist/common-utils/resolvers.js

@@ -7,7 +7,7 @@ export const DEFAULT_PROVIDERS = [
     "https://1rpc.io/eth",
     "https://eth-pokt.nodies.app"
 ];
-export function createBsoResolvers(providers, dataPath) {
+export function createBsoResolvers(providers) {
     const resolverProviders = providers && providers.length > 0 ? providers : DEFAULT_PROVIDERS;
-    return resolverProviders.map((provider) => new BsoResolver({ key: `bso-${provider}`, provider, dataPath }));
+    return resolverProviders.map((provider) => new BsoResolver({ key: `bso-${provider}`, provider }));
 }

package/oclif.manifest.json

@@ -153,133 +153,6 @@
         "logs.js"
       ]
     },
-    "challenge:install": {
-      "aliases": [],
-      "args": {
-        "package": {
-          "description": "Package specifier — anything npm can install (name, name@version, git URL, tarball URL, local path)",
-          "name": "package",
-          "required": true
-        }
-      },
-      "description": "Install a challenge package (npm package name, git URL, tarball URL, or local path)",
-      "examples": [
-        "bitsocial challenge install @bitsocial/mintpass-challenge",
-        "bitsocial challenge install @bitsocial/mintpass-challenge@1.0.0",
-        "bitsocial challenge install github:user/repo",
-        "bitsocial challenge install https://example.com/my-challenge-1.0.0.tar.gz",
-        "bitsocial challenge install ./my-local-challenge"
-      ],
-      "flags": {
-        "pkcOptions.dataPath": {
-          "description": "Data path to install the challenge into",
-          "name": "pkcOptions.dataPath",
-          "required": false,
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        }
-      },
-      "hasDynamicHelp": false,
-      "hiddenAliases": [],
-      "id": "challenge:install",
-      "pluginAlias": "@bitsocial/bitsocial-cli",
-      "pluginName": "@bitsocial/bitsocial-cli",
-      "pluginType": "core",
-      "strict": true,
-      "enableJsonFlag": false,
-      "isESM": true,
-      "relativePath": [
-        "dist",
-        "cli",
-        "commands",
-        "challenge",
-        "install.js"
-      ]
-    },
-    "challenge:list": {
-      "aliases": [],
-      "args": {},
-      "description": "List installed challenge packages",
-      "examples": [
-        "bitsocial challenge list",
-        "bitsocial challenge list -q"
-      ],
-      "flags": {
-        "quiet": {
-          "char": "q",
-          "name": "quiet",
-          "summary": "Only display challenge names",
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "pkcOptions.dataPath": {
-          "description": "Data path where challenges are installed",
-          "name": "pkcOptions.dataPath",
-          "required": false,
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        }
-      },
-      "hasDynamicHelp": false,
-      "hiddenAliases": [],
-      "id": "challenge:list",
-      "pluginAlias": "@bitsocial/bitsocial-cli",
-      "pluginName": "@bitsocial/bitsocial-cli",
-      "pluginType": "core",
-      "strict": true,
-      "enableJsonFlag": false,
-      "isESM": true,
-      "relativePath": [
-        "dist",
-        "cli",
-        "commands",
-        "challenge",
-        "list.js"
-      ]
-    },
-    "challenge:remove": {
-      "aliases": [],
-      "args": {
-        "name": {
-          "description": "The challenge package name (e.g., my-challenge or @scope/my-challenge)",
-          "name": "name",
-          "required": true
-        }
-      },
-      "description": "Remove an installed challenge package",
-      "examples": [
-        "bitsocial challenge remove my-challenge",
-        "bitsocial challenge remove @scope/my-challenge"
-      ],
-      "flags": {
-        "pkcOptions.dataPath": {
-          "description": "Data path where challenges are installed",
-          "name": "pkcOptions.dataPath",
-          "required": false,
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        }
-      },
-      "hasDynamicHelp": false,
-      "hiddenAliases": [],
-      "id": "challenge:remove",
-      "pluginAlias": "@bitsocial/bitsocial-cli",
-      "pluginName": "@bitsocial/bitsocial-cli",
-      "pluginType": "core",
-      "strict": true,
-      "enableJsonFlag": false,
-      "isESM": true,
-      "relativePath": [
-        "dist",
-        "cli",
-        "commands",
-        "challenge",
-        "remove.js"
-      ]
-    },
     "community:create": {
       "aliases": [],
       "args": {},
@@ -660,6 +533,133 @@
         "stop.js"
       ]
     },
+    "challenge:install": {
+      "aliases": [],
+      "args": {
+        "package": {
+          "description": "Package specifier — anything npm can install (name, name@version, git URL, tarball URL, local path)",
+          "name": "package",
+          "required": true
+        }
+      },
+      "description": "Install a challenge package (npm package name, git URL, tarball URL, or local path)",
+      "examples": [
+        "bitsocial challenge install @bitsocial/mintpass-challenge",
+        "bitsocial challenge install @bitsocial/mintpass-challenge@1.0.0",
+        "bitsocial challenge install github:user/repo",
+        "bitsocial challenge install https://example.com/my-challenge-1.0.0.tar.gz",
+        "bitsocial challenge install ./my-local-challenge"
+      ],
+      "flags": {
+        "pkcOptions.dataPath": {
+          "description": "Data path to install the challenge into",
+          "name": "pkcOptions.dataPath",
+          "required": false,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "challenge:install",
+      "pluginAlias": "@bitsocial/bitsocial-cli",
+      "pluginName": "@bitsocial/bitsocial-cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "cli",
+        "commands",
+        "challenge",
+        "install.js"
+      ]
+    },
+    "challenge:list": {
+      "aliases": [],
+      "args": {},
+      "description": "List installed challenge packages",
+      "examples": [
+        "bitsocial challenge list",
+        "bitsocial challenge list -q"
+      ],
+      "flags": {
+        "quiet": {
+          "char": "q",
+          "name": "quiet",
+          "summary": "Only display challenge names",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "pkcOptions.dataPath": {
+          "description": "Data path where challenges are installed",
+          "name": "pkcOptions.dataPath",
+          "required": false,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "challenge:list",
+      "pluginAlias": "@bitsocial/bitsocial-cli",
+      "pluginName": "@bitsocial/bitsocial-cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "cli",
+        "commands",
+        "challenge",
+        "list.js"
+      ]
+    },
+    "challenge:remove": {
+      "aliases": [],
+      "args": {
+        "name": {
+          "description": "The challenge package name (e.g., my-challenge or @scope/my-challenge)",
+          "name": "name",
+          "required": true
+        }
+      },
+      "description": "Remove an installed challenge package",
+      "examples": [
+        "bitsocial challenge remove my-challenge",
+        "bitsocial challenge remove @scope/my-challenge"
+      ],
+      "flags": {
+        "pkcOptions.dataPath": {
+          "description": "Data path where challenges are installed",
+          "name": "pkcOptions.dataPath",
+          "required": false,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "challenge:remove",
+      "pluginAlias": "@bitsocial/bitsocial-cli",
+      "pluginName": "@bitsocial/bitsocial-cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "cli",
+        "commands",
+        "challenge",
+        "remove.js"
+      ]
+    },
     "update:check": {
       "aliases": [],
       "args": {},
@@ -770,5 +770,5 @@
       ]
     }
   },
-  "version": "0.19.51"
+  "version": "0.19.53"
 }

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@bitsocial/bitsocial-cli",
-    "version": "0.19.51",
+    "version": "0.19.53",
     "description": "Command line interface to Bitsocial API",
     "types": "./dist/index.d.ts",
     "homepage": "https://github.com/bitsocialnet/bitsocial-cli",
@@ -93,6 +93,7 @@
         "@types/express": "4.17.21",
         "@types/node": "22.19.13",
         "@types/prettier": "2.7.1",
+        "@types/sinon": "17.0.4",
         "@types/tcp-port-used": "1.0.4",
         "@types/ws": "8.18.1",
         "commitizen": "4.2.5",
@@ -112,13 +113,13 @@
         "wait-on": "6.0.1"
     },
     "dependencies": {
-        "@bitsocial/bso-resolver": "0.0.6",
+        "@bitsocial/bso-resolver": "0.0.8",
         "@multiformats/multiaddr": "13.0.1",
         "@oclif/core": "4.8.0",
         "@oclif/plugin-help": "6.2.36",
         "@oclif/plugin-not-found": "3.2.73",
         "@oclif/table": "0.5.1",
-        "@pkcprotocol/pkc-js": "0.0.20",
+        "@pkcprotocol/pkc-js": "0.0.28",
         "dataobject-parser": "1.2.22",
         "decompress": "4.2.1",
         "env-paths": "2.2.1",
@@ -142,8 +143,8 @@
             "sha256OfHtmlZip": "14653b19e88868fda6fef26601f477947e44251cc52bd95d7d6fec158ae67b6f"
         },
         {
-            "url": "https://github.com/bitsocialnet/5chan/releases/tag/v0.8.0",
-            "sha256OfHtmlZip": "8954fd1965ab386d41ea17858f0b3436b3534eaf8a751936c47061b36314ef8b"
+            "url": "https://github.com/bitsocialnet/5chan/releases/tag/v0.8.3",
+            "sha256OfHtmlZip": "37081cf4511ca3bd553955500ec62227355ef925a46b81dc8cebc265362cf77f"
         }
     ]
 }