@bitsocial/bitsocial-cli 0.19.39 → 0.19.40

package/README.md

@@ -311,6 +311,9 @@ $ bitsocial community edit mysub.bso '--roles["author-address.bso"]' null
 * [`bitsocial daemon`](#bitsocial-daemon)
 * [`bitsocial help [COMMAND]`](#bitsocial-help-command)
 * [`bitsocial logs`](#bitsocial-logs)
+* [`bitsocial update check`](#bitsocial-update-check)
+* [`bitsocial update install [VERSION]`](#bitsocial-update-install-version)
+* [`bitsocial update versions`](#bitsocial-update-versions)
 
 ## `bitsocial challenge install PACKAGE`
 
@@ -341,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.38/src/cli/commands/challenge/install.ts)_
+_See code: [src/cli/commands/challenge/install.ts](https://github.com/bitsocialnet/bitsocial-cli/blob/v0.19.40/src/cli/commands/challenge/install.ts)_
 
 ## `bitsocial challenge list`
 
@@ -364,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.38/src/cli/commands/challenge/list.ts)_
+_See code: [src/cli/commands/challenge/list.ts](https://github.com/bitsocialnet/bitsocial-cli/blob/v0.19.40/src/cli/commands/challenge/list.ts)_
 
 ## `bitsocial challenge remove NAME`
 
@@ -389,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.38/src/cli/commands/challenge/remove.ts)_
+_See code: [src/cli/commands/challenge/remove.ts](https://github.com/bitsocialnet/bitsocial-cli/blob/v0.19.40/src/cli/commands/challenge/remove.ts)_
 
 ## `bitsocial community create`
 
@@ -414,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.38/src/cli/commands/community/create.ts)_
+_See code: [src/cli/commands/community/create.ts](https://github.com/bitsocialnet/bitsocial-cli/blob/v0.19.40/src/cli/commands/community/create.ts)_
 
 ## `bitsocial community delete ADDRESSES`
 
@@ -439,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.38/src/cli/commands/community/delete.ts)_
+_See code: [src/cli/commands/community/delete.ts](https://github.com/bitsocialnet/bitsocial-cli/blob/v0.19.40/src/cli/commands/community/delete.ts)_
 
 ## `bitsocial community edit ADDRESS`
 
@@ -491,7 +494,7 @@ EXAMPLES
     $ bitsocial community edit plebbit.bso --settings.fetchThumbnailUrls=false
 ```
 
-_See code: [src/cli/commands/community/edit.ts](https://github.com/bitsocialnet/bitsocial-cli/blob/v0.19.38/src/cli/commands/community/edit.ts)_
+_See code: [src/cli/commands/community/edit.ts](https://github.com/bitsocialnet/bitsocial-cli/blob/v0.19.40/src/cli/commands/community/edit.ts)_
 
 ## `bitsocial community get ADDRESS`
 
@@ -516,7 +519,7 @@ EXAMPLES
   $ bitsocial community get 12D3KooWG3XbzoVyAE6Y9vHZKF64Yuuu4TjdgQKedk14iYmTEPWu
 ```
 
-_See code: [src/cli/commands/community/get.ts](https://github.com/bitsocialnet/bitsocial-cli/blob/v0.19.38/src/cli/commands/community/get.ts)_
+_See code: [src/cli/commands/community/get.ts](https://github.com/bitsocialnet/bitsocial-cli/blob/v0.19.40/src/cli/commands/community/get.ts)_
 
 ## `bitsocial community list`
 
@@ -539,7 +542,7 @@ EXAMPLES
   $ bitsocial community list
 ```
 
-_See code: [src/cli/commands/community/list.ts](https://github.com/bitsocialnet/bitsocial-cli/blob/v0.19.38/src/cli/commands/community/list.ts)_
+_See code: [src/cli/commands/community/list.ts](https://github.com/bitsocialnet/bitsocial-cli/blob/v0.19.40/src/cli/commands/community/list.ts)_
 
 ## `bitsocial community start ADDRESSES`
 
@@ -568,7 +571,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.38/src/cli/commands/community/start.ts)_
+_See code: [src/cli/commands/community/start.ts](https://github.com/bitsocialnet/bitsocial-cli/blob/v0.19.40/src/cli/commands/community/start.ts)_
 
 ## `bitsocial community stop ADDRESSES`
 
@@ -593,7 +596,7 @@ EXAMPLES
   $ bitsocial community stop Qmb99crTbSUfKXamXwZBe829Vf6w5w5TktPkb6WstC9RFW
 ```
 
-_See code: [src/cli/commands/community/stop.ts](https://github.com/bitsocialnet/bitsocial-cli/blob/v0.19.38/src/cli/commands/community/stop.ts)_
+_See code: [src/cli/commands/community/stop.ts](https://github.com/bitsocialnet/bitsocial-cli/blob/v0.19.40/src/cli/commands/community/stop.ts)_
 
 ## `bitsocial daemon`
 
@@ -635,7 +638,7 @@ EXAMPLES
   $ bitsocial daemon --chainProviderUrls viem --chainProviderUrls https://mainnet.infura.io/v3/YOUR_KEY
 ```
 
-_See code: [src/cli/commands/daemon.ts](https://github.com/bitsocialnet/bitsocial-cli/blob/v0.19.38/src/cli/commands/daemon.ts)_
+_See code: [src/cli/commands/daemon.ts](https://github.com/bitsocialnet/bitsocial-cli/blob/v0.19.40/src/cli/commands/daemon.ts)_
 
 ## `bitsocial help [COMMAND]`
 
@@ -663,15 +666,16 @@ View the latest BitSocial daemon log file. By default dumps the full log and exi
 
 ```
 USAGE
-  $ bitsocial logs [-f] [-n <value>] [--since <value>] [--until <value>]
+  $ bitsocial logs [-f] [-n <value>] [--since <value>] [--until <value>] [--logPath <value>]
 
 FLAGS
-  -f, --follow         Follow log output in real-time (like tail -f)
-  -n, --tail=<value>   [default: all] Number of log entries to show from the end. Use "all" to show everything.
-      --since=<value>  Show logs since timestamp (ISO 8601, e.g. 2026-01-02T13:23:37Z) or relative time (e.g. 30s, 42m,
-                       2h, 1d)
-      --until=<value>  Show logs before timestamp (ISO 8601, e.g. 2026-01-02T13:23:37Z) or relative time (e.g. 30s, 42m,
-                       2h, 1d)
+  -f, --follow           Follow log output in real-time (like tail -f)
+  -n, --tail=<value>     [default: all] Number of log entries to show from the end. Use "all" to show everything.
+      --logPath=<value>  Specify the directory containing log files
+      --since=<value>    Show logs since timestamp (ISO 8601, e.g. 2026-01-02T13:23:37Z) or relative time (e.g. 30s,
+                         42m, 2h, 1d)
+      --until=<value>    Show logs before timestamp (ISO 8601, e.g. 2026-01-02T13:23:37Z) or relative time (e.g. 30s,
+                         42m, 2h, 1d)
 
 DESCRIPTION
   View the latest BitSocial daemon log file. By default dumps the full log and exits. Use --follow to stream new output
@@ -691,7 +695,75 @@ EXAMPLES
   $ bitsocial logs --since 1h -f
 ```
 
-_See code: [src/cli/commands/logs.ts](https://github.com/bitsocialnet/bitsocial-cli/blob/v0.19.38/src/cli/commands/logs.ts)_
+_See code: [src/cli/commands/logs.ts](https://github.com/bitsocialnet/bitsocial-cli/blob/v0.19.40/src/cli/commands/logs.ts)_
+
+## `bitsocial update check`
+
+Check if a newer version of bitsocial is available on npm
+
+```
+USAGE
+  $ bitsocial update check
+
+DESCRIPTION
+  Check if a newer version of bitsocial is available on npm
+
+EXAMPLES
+  $ bitsocial update check
+```
+
+_See code: [src/cli/commands/update/check.ts](https://github.com/bitsocialnet/bitsocial-cli/blob/v0.19.40/src/cli/commands/update/check.ts)_
+
+## `bitsocial update install [VERSION]`
+
+Install a specific version of bitsocial from npm
+
+```
+USAGE
+  $ bitsocial update install [VERSION] [--force]
+
+ARGUMENTS
+  [VERSION]  [default: latest] Version to install (e.g. "0.19.40" or "latest")
+
+FLAGS
+  --force  Reinstall even if already on the requested version
+
+DESCRIPTION
+  Install a specific version of bitsocial from npm
+
+EXAMPLES
+  $ bitsocial update install
+
+  $ bitsocial update install latest
+
+  $ bitsocial update install 0.19.40
+
+  $ bitsocial update install --force
+```
+
+_See code: [src/cli/commands/update/install.ts](https://github.com/bitsocialnet/bitsocial-cli/blob/v0.19.40/src/cli/commands/update/install.ts)_
+
+## `bitsocial update versions`
+
+List available bitsocial versions on npm
+
+```
+USAGE
+  $ bitsocial update versions [--limit <value>]
+
+FLAGS
+  --limit=<value>  [default: 20] Maximum number of versions to display
+
+DESCRIPTION
+  List available bitsocial versions on npm
+
+EXAMPLES
+  $ bitsocial update versions
+
+  $ bitsocial update versions --limit 5
+```
+
+_See code: [src/cli/commands/update/versions.ts](https://github.com/bitsocialnet/bitsocial-cli/blob/v0.19.40/src/cli/commands/update/versions.ts)_
 <!-- commandsstop -->
 
 ## Contribution

package/dist/cli/base-command.js

@@ -1,7 +1,7 @@
 import { Command, Flags } from "@oclif/core";
 import defaults from "../common-utils/defaults.js";
 import PKC from "@pkcprotocol/pkc-js";
-import { getPKCLogger, setupDebugLogger } from "../util.js";
+import { PKCLogger, setupDebugLogger } from "../util.js";
 const getPKCConnectOverride = () => {
     const globalWithOverride = globalThis;
     return globalWithOverride.__PKC_RPC_CONNECT_OVERRIDE;
@@ -16,8 +16,7 @@ export class BaseCommand extends Command {
     };
     async init() {
         await super.init();
-        const Logger = await getPKCLogger();
-        setupDebugLogger(Logger, { enableDefaultNamespace: false });
+        setupDebugLogger(PKCLogger, { enableDefaultNamespace: false });
     }
     async _connectToPkcRpc(pkcRpcUrl) {
         const connectOverride = getPKCConnectOverride();
@@ -28,7 +27,6 @@ export class BaseCommand extends Command {
         const errors = [];
         pkc.on("error", (err) => {
             errors.push(err);
-            console.error("Error from pkc instance", err);
         });
         await new Promise((resolve, reject) => {
             const timeout = setTimeout(() => {
@@ -39,6 +37,11 @@ export class BaseCommand extends Command {
                 clearTimeout(timeout);
                 resolve();
             });
+        }).catch((err) => {
+            if (err && typeof err === "object" && "code" in err && err.code === "ERR_RPC_AUTH_REQUIRED") {
+                throw err;
+            }
+            throw new Error(`Could not connect to the daemon at ${pkcRpcUrl}. Is it running? Start it with: bitsocial daemon`);
         });
         return pkc;
     }

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

@@ -3,7 +3,7 @@ import { Flags } from "@oclif/core";
 import DataObjectParser from "dataobject-parser";
 import fs from "fs";
 import { BaseCommand } from "../../base-command.js";
-import { getPKCLogger } from "../../../util.js";
+import { PKCLogger } from "../../../util.js";
 import * as remeda from "remeda";
 export default class Create extends BaseCommand {
     static description = "Create a community with specific properties. A newly created community will be started after creation and be able to receive publications. For a list of properties, visit https://github.com/pkcprotocol/pkc-js";
@@ -21,7 +21,7 @@ export default class Create extends BaseCommand {
     };
     async run() {
         const { flags } = await this.parse(Create);
-        const log = (await getPKCLogger())("bitsocial-cli:commands:community:create");
+        const log = PKCLogger("bitsocial-cli:commands:community:create");
         log(`flags: `, flags);
         const pkc = await this._connectToPkcRpc(flags.pkcRpcUrl.toString());
         const createOptions = DataObjectParser.transpose(remeda.omit(flags, ["pkcRpcUrl", "privateKeyPath"]))["_data"];

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

@@ -1,4 +1,4 @@
-import { getPKCLogger } from "../../../util.js";
+import { PKCLogger } from "../../../util.js";
 import { BaseCommand } from "../../base-command.js";
 import { Args } from "@oclif/core";
 export default class Delete extends BaseCommand {
@@ -17,7 +17,7 @@ export default class Delete extends BaseCommand {
     ];
     async run() {
         const { argv, flags } = await this.parse(Delete);
-        const log = (await getPKCLogger())("bitsocial-cli:commands:community:delete");
+        const log = PKCLogger("bitsocial-cli:commands:community:delete");
         log(`addresses: `, argv);
         log(`flags: `, flags);
         const addresses = argv;

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

@@ -2,7 +2,7 @@
 import DataObjectParser from "dataobject-parser";
 import { Args } from "@oclif/core";
 import { BaseCommand } from "../../base-command.js";
-import { getPKCLogger, mergeDeep } from "../../../util.js";
+import { PKCLogger, mergeDeep } from "../../../util.js";
 import * as remeda from "remeda";
 export default class Edit extends BaseCommand {
     static description = "Edit a community's properties. For a list of properties, visit https://github.com/pkcprotocol/pkc-js";
@@ -45,7 +45,7 @@ export default class Edit extends BaseCommand {
     ];
     async run() {
         const { flags, args } = await this.parse(Edit);
-        const log = (await getPKCLogger())("bitsocial-cli:commands:community:edit");
+        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"];

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

@@ -1,7 +1,7 @@
 import { Flags } from "@oclif/core";
 import { BaseCommand } from "../../base-command.js";
 import { EOL } from "os";
-import { getPKCLogger } from "../../../util.js";
+import { PKCLogger } from "../../../util.js";
 import { printTable } from "@oclif/table";
 export default class List extends BaseCommand {
     static description = "List your communities";
@@ -11,7 +11,7 @@ export default class List extends BaseCommand {
     };
     async run() {
         const { flags } = await this.parse(List);
-        const log = (await getPKCLogger())("bitsocial-cli:commands:community:list");
+        const log = PKCLogger("bitsocial-cli:commands:community:list");
         log(`flags: `, flags);
         const pkc = await this._connectToPkcRpc(flags.pkcRpcUrl.toString());
         const communities = pkc.communities;

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

@@ -1,4 +1,4 @@
-import { getPKCLogger } from "../../../util.js";
+import { PKCLogger } from "../../../util.js";
 import { BaseCommand } from "../../base-command.js";
 import { Args } from "@oclif/core";
 export default class Start extends BaseCommand {
@@ -22,7 +22,7 @@ export default class Start extends BaseCommand {
     async run() {
         const { argv, flags } = await this.parse(Start);
         const addresses = argv;
-        const log = (await getPKCLogger())("bitsocial-cli:commands:community:start");
+        const log = PKCLogger("bitsocial-cli:commands:community:start");
         log(`addresses: `, addresses);
         log(`flags: `, flags);
         const pkc = await this._connectToPkcRpc(flags.pkcRpcUrl.toString());

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

@@ -1,4 +1,4 @@
-import { getPKCLogger } from "../../../util.js";
+import { PKCLogger } from "../../../util.js";
 import { BaseCommand } from "../../base-command.js";
 import { Args } from "@oclif/core";
 export default class Stop extends BaseCommand {
@@ -17,7 +17,7 @@ export default class Stop extends BaseCommand {
     ];
     async run() {
         const { argv, flags } = await this.parse(Stop);
-        const log = (await getPKCLogger())("bitsocial-cli:commands:community:stop");
+        const log = PKCLogger("bitsocial-cli:commands:community:stop");
         log(`addresses: `, argv);
         log(`flags: `, flags);
         const addresses = argv;

package/dist/cli/commands/daemon.js

@@ -3,7 +3,7 @@ import defaults from "../../common-utils/defaults.js";
 import { startKuboNode } from "../../ipfs/startIpfs.js";
 import path from "path";
 import tcpPortUsed from "tcp-port-used";
-import { getLanIpV4Address, getPKCLogger, setupDebugLogger, loadKuboConfigFile, parseMultiAddrKuboRpcToUrl, parseMultiAddrIpfsGatewayToUrl } from "../../util.js";
+import { getLanIpV4Address, PKCLogger, setupDebugLogger, loadKuboConfigFile, parseMultiAddrKuboRpcToUrl, parseMultiAddrIpfsGatewayToUrl } from "../../util.js";
 import { startDaemonServer } from "../../webui/daemon-server.js";
 import { loadChallengesIntoPKC } from "../../challenge-packages/challenge-utils.js";
 import { migrateDataDirectory } from "../../common-utils/data-migration.js";
@@ -161,10 +161,9 @@ export default class Daemon extends Command {
         process.env["DEBUG_COLORS"] = "1";
         process.env["DEBUG_HIDE_DATE"] = "1";
         const { flags } = await this.parse(Daemon);
-        const Logger = await getPKCLogger();
-        this._setupLogger(Logger);
-        const { logFilePath, stdoutWrite } = await this._pipeDebugLogsToLogFile(flags.logPath, Logger);
-        const log = Logger("bitsocial-cli:daemon");
+        this._setupLogger(PKCLogger);
+        const { logFilePath, stdoutWrite } = await this._pipeDebugLogsToLogFile(flags.logPath, PKCLogger);
+        const log = PKCLogger("bitsocial-cli:daemon");
         try {
             // Log debug info after pipe is set up so it goes to the log file, not terminal
             const envDebug = process.env["_PKC_DEBUG"] || process.env["DEBUG"];

package/dist/ipfs/startIpfs.js

@@ -5,7 +5,7 @@ import * as fsPromises from "fs/promises";
 import assert from "assert";
 import tcpPortUsed from "tcp-port-used";
 import { path as ipfsExePathFunc } from "kubo";
-import { getPKCLogger } from "../util.js";
+import { PKCLogger } from "../util.js";
 async function getKuboExePath() {
     return ipfsExePathFunc();
 }
@@ -189,7 +189,7 @@ async function ensureIpfsPortsAreAvailable(log, configPath, apiUrl, gatewayUrl)
 }
 export async function startKuboNode(apiUrl, gatewayUrl, dataPath, onSpawn) {
     return new Promise(async (resolve, reject) => {
-        const log = (await getPKCLogger())("bitsocial-cli:ipfs:startKuboNode");
+        const log = PKCLogger("bitsocial-cli:ipfs:startKuboNode");
         const ipfsDataPath = process.env["IPFS_PATH"] || path.join(dataPath, ".bitsocial-cli.ipfs");
         await fs.promises.mkdir(ipfsDataPath, { recursive: true });
         const ipfsConfigPath = path.join(ipfsDataPath, "config");

package/dist/util.d.ts

@@ -1,11 +1,12 @@
-export type PKCLogger = Awaited<ReturnType<typeof getPKCLogger>> & {
+import PKCLogger from "@pkcprotocol/pkc-logger";
+export { PKCLogger };
+export type PKCLoggerType = typeof PKCLogger & {
     inspectOpts?: {
         depth?: number;
         colors?: boolean;
         [key: string]: any;
     };
 };
-export declare function getPKCLogger(): Promise<typeof import("@pkcprotocol/pkc-logger").default>;
 /**
  * Read _PKC_DEBUG / DEBUG env vars and configure the Logger instance.
  * Does NOT redirect output — debug logs go to stderr (the default for the debug module).
@@ -14,7 +15,7 @@ export declare function getPKCLogger(): Promise<typeof import("@pkcprotocol/pkc-
  *   when no DEBUG env is set (used by daemon). If false, only enable if user
  *   explicitly set DEBUG or _PKC_DEBUG (used by non-daemon commands).
  */
-export declare function setupDebugLogger(Logger: PKCLogger, options?: {
+export declare function setupDebugLogger(Logger: PKCLoggerType, options?: {
     enableDefaultNamespace?: boolean;
 }): {
     debugNamespace: string | undefined;

package/dist/util.js

@@ -2,10 +2,8 @@ import os from "os";
 import path from "path";
 import fs from "fs";
 import * as fsPromises from "fs/promises";
-export async function getPKCLogger() {
-    const Logger = await import("@pkcprotocol/pkc-logger");
-    return Logger.default;
-}
+import PKCLogger from "@pkcprotocol/pkc-logger";
+export { PKCLogger };
 /**
  * Read _PKC_DEBUG / DEBUG env vars and configure the Logger instance.
  * Does NOT redirect output — debug logs go to stderr (the default for the debug module).

package/dist/webui/daemon-server.js

@@ -3,7 +3,7 @@ import { fileURLToPath } from "url";
 const __filename = fileURLToPath(import.meta.url);
 const __dirname = path.dirname(__filename);
 import fs from "fs/promises";
-import { getPKCLogger } from "../util.js";
+import { PKCLogger } from "../util.js";
 import { randomBytes } from "crypto";
 import express from "express";
 import { loadChallengesIntoPKC } from "../challenge-packages/challenge-utils.js";
@@ -40,7 +40,7 @@ async function _generateRpcAuthKeyIfNotExisting(pkcDataPath) {
 // The daemon server will host both RPC and webui on the same port
 export async function startDaemonServer(rpcUrl, ipfsGatewayUrl, pkcOptions) {
     // Start pkc-js RPC
-    const log = (await getPKCLogger())("bitsocial-cli:daemon:startDaemonServer");
+    const log = PKCLogger("bitsocial-cli:daemon:startDaemonServer");
     const webuiExpressApp = express();
     const httpServer = webuiExpressApp.listen(Number(rpcUrl.port));
     log("HTTP server is running on", "0.0.0.0" + ":" + rpcUrl.port);