bkper 4.3.0 → 4.4.0

package/lib/cli.js

@@ -18,6 +18,10 @@ import { registerGroupCommands } from './commands/groups/register.js';
 import { registerTransactionCommands } from './commands/transactions/register.js';
 import { registerBalanceCommands } from './commands/balances/register.js';
 import { registerCollectionCommands } from './commands/collections/register.js';
+import { registerUpgradeCommand } from './commands/upgrade.js';
+import { VERSION, autoUpgrade } from './upgrade/index.js';
+// Version
+program.version(VERSION, '-v, --version');
 // Global output format options
 program.option('--format <format>', 'Output format: table, json, or csv', 'table');
 program.option('--json', 'Output as JSON (alias for --format json)');
@@ -42,5 +46,11 @@ registerGroupCommands(program);
 registerTransactionCommands(program);
 registerBalanceCommands(program);
 registerCollectionCommands(program);
+// Upgrade command
+registerUpgradeCommand(program);
+// Trigger silent auto-upgrade in the background (non-blocking, never fails)
+if (!process.env.BKPER_DISABLE_AUTOUPDATE) {
+    autoUpgrade().catch(() => { });
+}
 program.parse(process.argv);
 //# sourceMappingURL=cli.js.map

package/lib/cli.js.map

@@ -1 +1 @@
-{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";;;;;;;;;;AAEA,OAAO,eAAe,CAAC,CAAC,sDAAsD;AAE9E,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,8BAA8B,CAAC;AAC7D,OAAO,EAAE,mBAAmB,EAAE,MAAM,6BAA6B,CAAC;AAClE,OAAO,EAAE,oBAAoB,EAAE,MAAM,8BAA8B,CAAC;AACpE,OAAO,EAAE,uBAAuB,EAAE,MAAM,iCAAiC,CAAC;AAC1E,OAAO,EAAE,qBAAqB,EAAE,MAAM,+BAA+B,CAAC;AACtE,OAAO,EAAE,2BAA2B,EAAE,MAAM,qCAAqC,CAAC;AAClF,OAAO,EAAE,uBAAuB,EAAE,MAAM,iCAAiC,CAAC;AAC1E,OAAO,EAAE,0BAA0B,EAAE,MAAM,oCAAoC,CAAC;AAEhF,+BAA+B;AAC/B,OAAO,CAAC,MAAM,CAAC,mBAAmB,EAAE,oCAAoC,EAAE,OAAO,CAAC,CAAC;AACnF,OAAO,CAAC,MAAM,CAAC,QAAQ,EAAE,0CAA0C,CAAC,CAAC;AAErE,gBAAgB;AAChB,OAAO;KACF,OAAO,CAAC,OAAO,CAAC;KAChB,WAAW,CAAC,aAAa,CAAC;KAC1B,MAAM,CAAC,GAAS,EAAE;IACf,MAAM,KAAK,EAAE,CAAC;AAClB,CAAC,CAAA,CAAC,CAAC;AAEP,OAAO;KACF,OAAO,CAAC,QAAQ,CAAC;KACjB,WAAW,CAAC,cAAc,CAAC;KAC3B,MAAM,CAAC,GAAG,EAAE;IACT,MAAM,EAAE,CAAC;AACb,CAAC,CAAC,CAAC;AAEP,oBAAoB;AACpB,mBAAmB,CAAC,OAAO,CAAC,CAAC;AAC7B,oBAAoB,CAAC,OAAO,CAAC,CAAC;AAC9B,uBAAuB,CAAC,OAAO,CAAC,CAAC;AACjC,qBAAqB,CAAC,OAAO,CAAC,CAAC;AAC/B,2BAA2B,CAAC,OAAO,CAAC,CAAC;AACrC,uBAAuB,CAAC,OAAO,CAAC,CAAC;AACjC,0BAA0B,CAAC,OAAO,CAAC,CAAC;AAEpC,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC"}
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";;;;;;;;;;AAEA,OAAO,eAAe,CAAC,CAAC,sDAAsD;AAE9E,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,8BAA8B,CAAC;AAC7D,OAAO,EAAE,mBAAmB,EAAE,MAAM,6BAA6B,CAAC;AAClE,OAAO,EAAE,oBAAoB,EAAE,MAAM,8BAA8B,CAAC;AACpE,OAAO,EAAE,uBAAuB,EAAE,MAAM,iCAAiC,CAAC;AAC1E,OAAO,EAAE,qBAAqB,EAAE,MAAM,+BAA+B,CAAC;AACtE,OAAO,EAAE,2BAA2B,EAAE,MAAM,qCAAqC,CAAC;AAClF,OAAO,EAAE,uBAAuB,EAAE,MAAM,iCAAiC,CAAC;AAC1E,OAAO,EAAE,0BAA0B,EAAE,MAAM,oCAAoC,CAAC;AAChF,OAAO,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAC;AAC/D,OAAO,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAE1D,UAAU;AACV,OAAO,CAAC,OAAO,CAAC,OAAO,EAAE,eAAe,CAAC,CAAC;AAE1C,+BAA+B;AAC/B,OAAO,CAAC,MAAM,CAAC,mBAAmB,EAAE,oCAAoC,EAAE,OAAO,CAAC,CAAC;AACnF,OAAO,CAAC,MAAM,CAAC,QAAQ,EAAE,0CAA0C,CAAC,CAAC;AAErE,gBAAgB;AAChB,OAAO;KACF,OAAO,CAAC,OAAO,CAAC;KAChB,WAAW,CAAC,aAAa,CAAC;KAC1B,MAAM,CAAC,GAAS,EAAE;IACf,MAAM,KAAK,EAAE,CAAC;AAClB,CAAC,CAAA,CAAC,CAAC;AAEP,OAAO;KACF,OAAO,CAAC,QAAQ,CAAC;KACjB,WAAW,CAAC,cAAc,CAAC;KAC3B,MAAM,CAAC,GAAG,EAAE;IACT,MAAM,EAAE,CAAC;AACb,CAAC,CAAC,CAAC;AAEP,oBAAoB;AACpB,mBAAmB,CAAC,OAAO,CAAC,CAAC;AAC7B,oBAAoB,CAAC,OAAO,CAAC,CAAC;AAC9B,uBAAuB,CAAC,OAAO,CAAC,CAAC;AACjC,qBAAqB,CAAC,OAAO,CAAC,CAAC;AAC/B,2BAA2B,CAAC,OAAO,CAAC,CAAC;AACrC,uBAAuB,CAAC,OAAO,CAAC,CAAC;AACjC,0BAA0B,CAAC,OAAO,CAAC,CAAC;AAEpC,kBAAkB;AAClB,sBAAsB,CAAC,OAAO,CAAC,CAAC;AAEhC,4EAA4E;AAC5E,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,wBAAwB,EAAE,CAAC;IACxC,WAAW,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;AAClC,CAAC;AAED,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC"}

package/lib/commands/upgrade.d.ts

@@ -0,0 +1,3 @@
+import type { Command } from 'commander';
+export declare function registerUpgradeCommand(program: Command): void;
+//# sourceMappingURL=upgrade.d.ts.map

package/lib/commands/upgrade.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"upgrade.d.ts","sourceRoot":"","sources":["../../src/commands/upgrade.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAGzC,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAQ7D"}

package/lib/commands/upgrade.js

@@ -0,0 +1,20 @@
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+import { foregroundUpgrade } from '../upgrade/index.js';
+export function registerUpgradeCommand(program) {
+    program
+        .command('upgrade [version]')
+        .description('Upgrade bkper CLI to the latest version')
+        .option('--method <method>', 'Override install method detection (npm, bun, yarn)')
+        .action((version, options) => __awaiter(this, void 0, void 0, function* () {
+        yield foregroundUpgrade(version, options.method);
+    }));
+}
+//# sourceMappingURL=upgrade.js.map

package/lib/commands/upgrade.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"upgrade.js","sourceRoot":"","sources":["../../src/commands/upgrade.ts"],"names":[],"mappings":";;;;;;;;;AACA,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAExD,MAAM,UAAU,sBAAsB,CAAC,OAAgB;IACnD,OAAO;SACF,OAAO,CAAC,mBAAmB,CAAC;SAC5B,WAAW,CAAC,yCAAyC,CAAC;SACtD,MAAM,CAAC,mBAAmB,EAAE,oDAAoD,CAAC;SACjF,MAAM,CAAC,CAAO,OAA2B,EAAE,OAA4B,EAAE,EAAE;QACxE,MAAM,iBAAiB,CAAC,OAAO,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC;IACrD,CAAC,CAAA,CAAC,CAAC;AACX,CAAC"}

package/lib/upgrade/index.d.ts

@@ -0,0 +1,5 @@
+export { VERSION } from './installation.js';
+export { autoUpgrade, foregroundUpgrade, isNewerVersion } from './upgrade.js';
+export { detectMethod, fetchLatestVersion, getUpgradeCommand } from './installation.js';
+export type { InstallMethod } from './installation.js';
+//# sourceMappingURL=index.d.ts.map

package/lib/upgrade/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/upgrade/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AAC5C,OAAO,EAAE,WAAW,EAAE,iBAAiB,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAC9E,OAAO,EAAE,YAAY,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AACxF,YAAY,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC"}

package/lib/upgrade/index.js

@@ -0,0 +1,4 @@
+export { VERSION } from './installation.js';
+export { autoUpgrade, foregroundUpgrade, isNewerVersion } from './upgrade.js';
+export { detectMethod, fetchLatestVersion, getUpgradeCommand } from './installation.js';
+//# sourceMappingURL=index.js.map

package/lib/upgrade/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/upgrade/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AAC5C,OAAO,EAAE,WAAW,EAAE,iBAAiB,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAC9E,OAAO,EAAE,YAAY,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC"}

package/lib/upgrade/installation.d.ts

@@ -0,0 +1,24 @@
+/** Current installed version of the CLI. */
+export declare const VERSION: string;
+/** Supported installation methods. */
+export type InstallMethod = 'npm' | 'bun' | 'yarn' | 'unknown';
+/**
+ * Detects how the CLI was installed by checking global package lists
+ * for each supported package manager.
+ */
+export declare function detectMethod(): InstallMethod;
+/**
+ * Fetches the latest published version from the npm registry.
+ * Returns null if the fetch fails.
+ */
+export declare function fetchLatestVersion(): Promise<string | null>;
+/**
+ * Returns the shell command to upgrade the CLI for a given install method and version.
+ */
+export declare function getUpgradeCommand(method: InstallMethod, version: string): string | null;
+/**
+ * Executes the upgrade to the specified version using the given install method.
+ * Throws if the upgrade command fails.
+ */
+export declare function executeUpgrade(method: InstallMethod, version: string): void;
+//# sourceMappingURL=installation.d.ts.map

package/lib/upgrade/installation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"installation.d.ts","sourceRoot":"","sources":["../../src/upgrade/installation.ts"],"names":[],"mappings":"AAMA,4CAA4C;AAC5C,eAAO,MAAM,OAAO,EAAE,MAAoB,CAAC;AAK3C,sCAAsC;AACtC,MAAM,MAAM,aAAa,GAAG,KAAK,GAAG,KAAK,GAAG,MAAM,GAAG,SAAS,CAAC;AAE/D;;;GAGG;AACH,wBAAgB,YAAY,IAAI,aAAa,CAmB5C;AAED;;;GAGG;AACH,wBAAsB,kBAAkB,IAAI,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAYjE;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,aAAa,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAWvF;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,aAAa,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,CAS3E"}

package/lib/upgrade/installation.js

@@ -0,0 +1,90 @@
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+import { execSync } from 'child_process';
+import { createRequire } from 'module';
+const require = createRequire(import.meta.url);
+const pkg = require('../../package.json');
+/** Current installed version of the CLI. */
+export const VERSION = pkg.version;
+/** Package name on npm. */
+const PACKAGE_NAME = 'bkper';
+/**
+ * Detects how the CLI was installed by checking global package lists
+ * for each supported package manager.
+ */
+export function detectMethod() {
+    const checks = [
+        { method: 'bun', command: `bun pm ls -g 2>/dev/null` },
+        { method: 'npm', command: `npm list -g ${PACKAGE_NAME} --depth=0 2>/dev/null` },
+        { method: 'yarn', command: `yarn global list --depth=0 2>/dev/null` },
+    ];
+    for (const { method, command } of checks) {
+        try {
+            const output = execSync(command, { encoding: 'utf-8', timeout: 10000 });
+            if (output.includes(PACKAGE_NAME)) {
+                return method;
+            }
+        }
+        catch (_a) {
+            // Package manager not available or command failed — try next
+        }
+    }
+    return 'unknown';
+}
+/**
+ * Fetches the latest published version from the npm registry.
+ * Returns null if the fetch fails.
+ */
+export function fetchLatestVersion() {
+    return __awaiter(this, void 0, void 0, function* () {
+        var _a;
+        try {
+            const response = yield fetch(`https://registry.npmjs.org/${PACKAGE_NAME}/latest`, {
+                headers: { Accept: 'application/json' },
+                signal: AbortSignal.timeout(5000),
+            });
+            if (!response.ok)
+                return null;
+            const data = (yield response.json());
+            return (_a = data.version) !== null && _a !== void 0 ? _a : null;
+        }
+        catch (_b) {
+            return null;
+        }
+    });
+}
+/**
+ * Returns the shell command to upgrade the CLI for a given install method and version.
+ */
+export function getUpgradeCommand(method, version) {
+    switch (method) {
+        case 'npm':
+            return `npm install -g ${PACKAGE_NAME}@${version}`;
+        case 'bun':
+            return `bun add -g ${PACKAGE_NAME}@${version}`;
+        case 'yarn':
+            return `yarn global add ${PACKAGE_NAME}@${version}`;
+        default:
+            return null;
+    }
+}
+/**
+ * Executes the upgrade to the specified version using the given install method.
+ * Throws if the upgrade command fails.
+ */
+export function executeUpgrade(method, version) {
+    const command = getUpgradeCommand(method, version);
+    if (!command) {
+        throw new Error(`Unable to auto-upgrade: unknown installation method. ` +
+            `Please upgrade manually: npm install -g ${PACKAGE_NAME}@${version}`);
+    }
+    execSync(command, { stdio: 'pipe', timeout: 60000 });
+}
+//# sourceMappingURL=installation.js.map

package/lib/upgrade/installation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"installation.js","sourceRoot":"","sources":["../../src/upgrade/installation.ts"],"names":[],"mappings":";;;;;;;;;AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AACzC,OAAO,EAAE,aAAa,EAAE,MAAM,QAAQ,CAAC;AAEvC,MAAM,OAAO,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAC/C,MAAM,GAAG,GAAG,OAAO,CAAC,oBAAoB,CAAC,CAAC;AAE1C,4CAA4C;AAC5C,MAAM,CAAC,MAAM,OAAO,GAAW,GAAG,CAAC,OAAO,CAAC;AAE3C,2BAA2B;AAC3B,MAAM,YAAY,GAAG,OAAO,CAAC;AAK7B;;;GAGG;AACH,MAAM,UAAU,YAAY;IACxB,MAAM,MAAM,GAAsD;QAC9D,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,0BAA0B,EAAE;QACtD,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,eAAe,YAAY,wBAAwB,EAAE;QAC/E,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,wCAAwC,EAAE;KACxE,CAAC;IAEF,KAAK,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,IAAI,MAAM,EAAE,CAAC;QACvC,IAAI,CAAC;YACD,MAAM,MAAM,GAAG,QAAQ,CAAC,OAAO,EAAE,EAAE,QAAQ,EAAE,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC,CAAC;YACxE,IAAI,MAAM,CAAC,QAAQ,CAAC,YAAY,CAAC,EAAE,CAAC;gBAChC,OAAO,MAAM,CAAC;YAClB,CAAC;QACL,CAAC;QAAC,WAAM,CAAC;YACL,6DAA6D;QACjE,CAAC;IACL,CAAC;IAED,OAAO,SAAS,CAAC;AACrB,CAAC;AAED;;;GAGG;AACH,MAAM,UAAgB,kBAAkB;;;QACpC,IAAI,CAAC;YACD,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,8BAA8B,YAAY,SAAS,EAAE;gBAC9E,OAAO,EAAE,EAAE,MAAM,EAAE,kBAAkB,EAAE;gBACvC,MAAM,EAAE,WAAW,CAAC,OAAO,CAAC,IAAI,CAAC;aACpC,CAAC,CAAC;YACH,IAAI,CAAC,QAAQ,CAAC,EAAE;gBAAE,OAAO,IAAI,CAAC;YAC9B,MAAM,IAAI,GAAG,CAAC,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAyB,CAAC;YAC7D,OAAO,MAAA,IAAI,CAAC,OAAO,mCAAI,IAAI,CAAC;QAChC,CAAC;QAAC,WAAM,CAAC;YACL,OAAO,IAAI,CAAC;QAChB,CAAC;IACL,CAAC;CAAA;AAED;;GAEG;AACH,MAAM,UAAU,iBAAiB,CAAC,MAAqB,EAAE,OAAe;IACpE,QAAQ,MAAM,EAAE,CAAC;QACb,KAAK,KAAK;YACN,OAAO,kBAAkB,YAAY,IAAI,OAAO,EAAE,CAAC;QACvD,KAAK,KAAK;YACN,OAAO,cAAc,YAAY,IAAI,OAAO,EAAE,CAAC;QACnD,KAAK,MAAM;YACP,OAAO,mBAAmB,YAAY,IAAI,OAAO,EAAE,CAAC;QACxD;YACI,OAAO,IAAI,CAAC;IACpB,CAAC;AACL,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,cAAc,CAAC,MAAqB,EAAE,OAAe;IACjE,MAAM,OAAO,GAAG,iBAAiB,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACnD,IAAI,CAAC,OAAO,EAAE,CAAC;QACX,MAAM,IAAI,KAAK,CACX,uDAAuD;YACnD,2CAA2C,YAAY,IAAI,OAAO,EAAE,CAC3E,CAAC;IACN,CAAC;IACD,QAAQ,CAAC,OAAO,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC,CAAC;AACzD,CAAC"}

package/lib/upgrade/upgrade.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Compares two semver version strings.
+ * Returns true if `latest` is newer than `current`.
+ */
+export declare function isNewerVersion(current: string, latest: string): boolean;
+/**
+ * Runs the silent auto-upgrade check in the background.
+ *
+ * Called on every CLI invocation. This function:
+ * 1. Fetches the latest version from npm
+ * 2. Compares with the current installed version
+ * 3. If newer, silently upgrades using the detected install method
+ * 4. Prints a brief message to stderr on success
+ *
+ * All errors are swallowed silently to never disrupt the user's command.
+ */
+export declare function autoUpgrade(): Promise<void>;
+/**
+ * Runs an explicit foreground upgrade with user-facing output.
+ * Used by the `bkper upgrade` command.
+ */
+export declare function foregroundUpgrade(targetVersion?: string, methodOverride?: string): Promise<void>;
+//# sourceMappingURL=upgrade.d.ts.map

package/lib/upgrade/upgrade.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"upgrade.d.ts","sourceRoot":"","sources":["../../src/upgrade/upgrade.ts"],"names":[],"mappings":"AASA;;;GAGG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAQvE;AAED;;;;;;;;;;GAUG;AACH,wBAAsB,WAAW,IAAI,OAAO,CAAC,IAAI,CAAC,CAsBjD;AAED;;;GAGG;AACH,wBAAsB,iBAAiB,CACnC,aAAa,CAAC,EAAE,MAAM,EACtB,cAAc,CAAC,EAAE,MAAM,GACxB,OAAO,CAAC,IAAI,CAAC,CAsCf"}

package/lib/upgrade/upgrade.js

@@ -0,0 +1,99 @@
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+import { VERSION, fetchLatestVersion, detectMethod, executeUpgrade, getUpgradeCommand, } from './installation.js';
+/**
+ * Compares two semver version strings.
+ * Returns true if `latest` is newer than `current`.
+ */
+export function isNewerVersion(current, latest) {
+    const parse = (v) => v.split('.').map(Number);
+    const [cMajor, cMinor, cPatch] = parse(current);
+    const [lMajor, lMinor, lPatch] = parse(latest);
+    if (lMajor !== cMajor)
+        return lMajor > cMajor;
+    if (lMinor !== cMinor)
+        return lMinor > cMinor;
+    return lPatch > cPatch;
+}
+/**
+ * Runs the silent auto-upgrade check in the background.
+ *
+ * Called on every CLI invocation. This function:
+ * 1. Fetches the latest version from npm
+ * 2. Compares with the current installed version
+ * 3. If newer, silently upgrades using the detected install method
+ * 4. Prints a brief message to stderr on success
+ *
+ * All errors are swallowed silently to never disrupt the user's command.
+ */
+export function autoUpgrade() {
+    return __awaiter(this, void 0, void 0, function* () {
+        try {
+            const latest = yield fetchLatestVersion();
+            if (!latest)
+                return;
+            if (!isNewerVersion(VERSION, latest))
+                return;
+            const method = detectMethod();
+            if (method === 'unknown') {
+                // Can't auto-upgrade if we don't know how it was installed.
+                // Print a hint to stderr so it doesn't pollute stdout.
+                process.stderr.write(`\nbkper ${latest} available (current: ${VERSION}). ` +
+                    `Upgrade manually: npm install -g bkper@${latest}\n`);
+                return;
+            }
+            executeUpgrade(method, latest);
+            process.stderr.write(`\nbkper upgraded: ${VERSION} \u2192 ${latest} (restart to use)\n`);
+        }
+        catch (_a) {
+            // Silent failure — never break the user's command
+        }
+    });
+}
+/**
+ * Runs an explicit foreground upgrade with user-facing output.
+ * Used by the `bkper upgrade` command.
+ */
+export function foregroundUpgrade(targetVersion, methodOverride) {
+    return __awaiter(this, void 0, void 0, function* () {
+        const latest = targetVersion !== null && targetVersion !== void 0 ? targetVersion : (yield fetchLatestVersion());
+        if (!latest) {
+            console.error('Could not determine the latest version. Check your network connection.');
+            process.exit(1);
+        }
+        if (!isNewerVersion(VERSION, latest) && !targetVersion) {
+            console.log(`Already on the latest version (${VERSION}).`);
+            return;
+        }
+        const method = methodOverride && isValidMethod(methodOverride) ? methodOverride : detectMethod();
+        if (method === 'unknown') {
+            console.error(`Could not detect how bkper was installed.\n` +
+                `Please upgrade manually: npm install -g bkper@${latest}\n` +
+                `Or specify the method: bkper upgrade --method npm`);
+            process.exit(1);
+        }
+        const command = getUpgradeCommand(method, latest);
+        console.log(`Upgrading bkper: ${VERSION} \u2192 ${latest}`);
+        console.log(`Running: ${command}`);
+        try {
+            executeUpgrade(method, latest);
+            console.log(`Successfully upgraded to bkper@${latest}. Restart your terminal to use the new version.`);
+        }
+        catch (err) {
+            console.error(`Upgrade failed:`, err);
+            console.error(`\nTry upgrading manually: ${command}`);
+            process.exit(1);
+        }
+    });
+}
+function isValidMethod(method) {
+    return ['npm', 'bun', 'yarn'].includes(method);
+}
+//# sourceMappingURL=upgrade.js.map

package/lib/upgrade/upgrade.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"upgrade.js","sourceRoot":"","sources":["../../src/upgrade/upgrade.ts"],"names":[],"mappings":";;;;;;;;;AAAA,OAAO,EACH,OAAO,EACP,kBAAkB,EAClB,YAAY,EACZ,cAAc,EACd,iBAAiB,GACpB,MAAM,mBAAmB,CAAC;AAG3B;;;GAGG;AACH,MAAM,UAAU,cAAc,CAAC,OAAe,EAAE,MAAc;IAC1D,MAAM,KAAK,GAAG,CAAC,CAAS,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IACtD,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,GAAG,KAAK,CAAC,OAAO,CAAC,CAAC;IAChD,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC;IAE/C,IAAI,MAAM,KAAK,MAAM;QAAE,OAAO,MAAM,GAAG,MAAM,CAAC;IAC9C,IAAI,MAAM,KAAK,MAAM;QAAE,OAAO,MAAM,GAAG,MAAM,CAAC;IAC9C,OAAO,MAAM,GAAG,MAAM,CAAC;AAC3B,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,UAAgB,WAAW;;QAC7B,IAAI,CAAC;YACD,MAAM,MAAM,GAAG,MAAM,kBAAkB,EAAE,CAAC;YAC1C,IAAI,CAAC,MAAM;gBAAE,OAAO;YACpB,IAAI,CAAC,cAAc,CAAC,OAAO,EAAE,MAAM,CAAC;gBAAE,OAAO;YAE7C,MAAM,MAAM,GAAG,YAAY,EAAE,CAAC;YAC9B,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;gBACvB,4DAA4D;gBAC5D,uDAAuD;gBACvD,OAAO,CAAC,MAAM,CAAC,KAAK,CAChB,WAAW,MAAM,wBAAwB,OAAO,KAAK;oBACjD,0CAA0C,MAAM,IAAI,CAC3D,CAAC;gBACF,OAAO;YACX,CAAC;YAED,cAAc,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;YAC/B,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,qBAAqB,OAAO,WAAW,MAAM,qBAAqB,CAAC,CAAC;QAC7F,CAAC;QAAC,WAAM,CAAC;YACL,kDAAkD;QACtD,CAAC;IACL,CAAC;CAAA;AAED;;;GAGG;AACH,MAAM,UAAgB,iBAAiB,CACnC,aAAsB,EACtB,cAAuB;;QAEvB,MAAM,MAAM,GAAG,aAAa,aAAb,aAAa,cAAb,aAAa,GAAI,CAAC,MAAM,kBAAkB,EAAE,CAAC,CAAC;QAC7D,IAAI,CAAC,MAAM,EAAE,CAAC;YACV,OAAO,CAAC,KAAK,CAAC,wEAAwE,CAAC,CAAC;YACxF,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QACpB,CAAC;QAED,IAAI,CAAC,cAAc,CAAC,OAAO,EAAE,MAAM,CAAC,IAAI,CAAC,aAAa,EAAE,CAAC;YACrD,OAAO,CAAC,GAAG,CAAC,kCAAkC,OAAO,IAAI,CAAC,CAAC;YAC3D,OAAO;QACX,CAAC;QAED,MAAM,MAAM,GACR,cAAc,IAAI,aAAa,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC,cAAc,CAAC,CAAC,CAAC,YAAY,EAAE,CAAC;QAEtF,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;YACvB,OAAO,CAAC,KAAK,CACT,6CAA6C;gBACzC,iDAAiD,MAAM,IAAI;gBAC3D,mDAAmD,CAC1D,CAAC;YACF,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QACpB,CAAC;QAED,MAAM,OAAO,GAAG,iBAAiB,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QAClD,OAAO,CAAC,GAAG,CAAC,oBAAoB,OAAO,WAAW,MAAM,EAAE,CAAC,CAAC;QAC5D,OAAO,CAAC,GAAG,CAAC,YAAY,OAAO,EAAE,CAAC,CAAC;QAEnC,IAAI,CAAC;YACD,cAAc,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;YAC/B,OAAO,CAAC,GAAG,CACP,kCAAkC,MAAM,iDAAiD,CAC5F,CAAC;QACN,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACX,OAAO,CAAC,KAAK,CAAC,iBAAiB,EAAE,GAAG,CAAC,CAAC;YACtC,OAAO,CAAC,KAAK,CAAC,6BAA6B,OAAO,EAAE,CAAC,CAAC;YACtD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QACpB,CAAC;IACL,CAAC;CAAA;AAED,SAAS,aAAa,CAAC,MAAc;IACjC,OAAO,CAAC,KAAK,EAAE,KAAK,EAAE,MAAM,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;AACnD,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "bkper",
-    "version": "4.3.0",
+    "version": "4.4.0",
     "description": "Command line client for Bkper",
     "bin": {
         "bkper": "./lib/cli.js"