bkper 4.31.3 → 5.1.0

package/lib/upgrade/update-check.js

@@ -0,0 +1,253 @@
+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 { spawn } from 'child_process';
+import { createHash } from 'crypto';
+import { closeSync, mkdirSync, openSync, readFileSync, renameSync, statSync, unlinkSync, writeFileSync, } from 'fs';
+import path from 'path';
+import { fileURLToPath } from 'url';
+import { BKPER_CONFIG_DIR } from '../dev/cloudflared/constants.js';
+import { PACKAGE_DIR, VERSION, fetchLatestVersion, getSelfUpdatePlan, readInstalledVersion, runInstallCommand, } from './installation.js';
+import { isNewerVersion } from './upgrade.js';
+/** At most one npm check (and install attempt) per installed copy per day. */
+export const CHECK_INTERVAL_MS = 24 * 60 * 60 * 1000;
+const REGISTRY_TIMEOUT_MS = 3000;
+const STALE_LOCK_MS = 5000;
+/**
+ * Cache file for one installed copy. Copies (e.g. npm and bun) keep separate
+ * state so each one only ever updates itself.
+ */
+export function getUpdateCachePath(packageDir = PACKAGE_DIR, configDir = BKPER_CONFIG_DIR) {
+    const key = createHash('sha256').update(packageDir).digest('hex').slice(0, 16);
+    return path.join(configDir, 'update-check', `${key}.json`);
+}
+export function isUpdateCheckDisabled(env = process.env) {
+    var _a;
+    if (env.BKPER_DISABLE_AUTOUPDATE) {
+        return true;
+    }
+    const ci = (_a = env.CI) === null || _a === void 0 ? void 0 : _a.trim().toLowerCase();
+    return !!ci && ci !== '0' && ci !== 'false';
+}
+export function readUpdateState(cachePath = getUpdateCachePath()) {
+    try {
+        const data = JSON.parse(readFileSync(cachePath, 'utf8'));
+        if (typeof data !== 'object' || data === null || Array.isArray(data)) {
+            return {};
+        }
+        const record = data;
+        const state = {};
+        if (typeof record.lastAttemptedAt === 'number') {
+            state.lastAttemptedAt = record.lastAttemptedAt;
+        }
+        if (typeof record.latestVersion === 'string') {
+            state.latestVersion = record.latestVersion;
+        }
+        const install = record.install;
+        if (install &&
+            typeof install.version === 'string' &&
+            (install.status === 'installed' ||
+                install.status === 'manual' ||
+                install.status === 'failed')) {
+            state.install = { version: install.version, status: install.status };
+            if (typeof install.instruction === 'string') {
+                state.install.instruction = install.instruction;
+            }
+        }
+        return state;
+    }
+    catch (_a) {
+        return {};
+    }
+}
+/** Writes the state atomically (temp file + rename). */
+export function writeUpdateState(state, cachePath = getUpdateCachePath()) {
+    const tempPath = `${cachePath}.${process.pid}.tmp`;
+    try {
+        mkdirSync(path.dirname(cachePath), { recursive: true });
+        writeFileSync(tempPath, `${JSON.stringify(state)}\n`, { encoding: 'utf8', mode: 0o600 });
+        renameSync(tempPath, cachePath);
+        return true;
+    }
+    catch (_a) {
+        try {
+            unlinkSync(tempPath);
+        }
+        catch (_b) {
+            // Nothing to clean up
+        }
+        return false;
+    }
+}
+function withLock(cachePath, fn) {
+    const lockPath = `${cachePath}.lock`;
+    let fd;
+    try {
+        mkdirSync(path.dirname(cachePath), { recursive: true });
+        try {
+            fd = openSync(lockPath, 'wx', 0o600);
+        }
+        catch (_a) {
+            if (Date.now() - statSync(lockPath).mtimeMs <= STALE_LOCK_MS) {
+                return undefined;
+            }
+            unlinkSync(lockPath);
+            fd = openSync(lockPath, 'wx', 0o600);
+        }
+        return fn();
+    }
+    catch (_b) {
+        return undefined;
+    }
+    finally {
+        if (fd !== undefined) {
+            try {
+                closeSync(fd);
+                unlinkSync(lockPath);
+            }
+            catch (_c) {
+                // Lock goes stale on its own
+            }
+        }
+    }
+}
+function spawnUpdateWorker() {
+    const isTypeScript = import.meta.url.endsWith('.ts');
+    const workerPath = fileURLToPath(new URL(isTypeScript ? './update-worker.ts' : './update-worker.js', import.meta.url));
+    const args = isTypeScript ? [...process.execArgv, workerPath] : [workerPath];
+    spawn(process.execPath, args, { detached: true, stdio: 'ignore', windowsHide: true }).unref();
+}
+/**
+ * Starts the detached update worker when the last attempt is older than a day.
+ * Never blocks the running command and never installs in this process.
+ */
+export function maybeStartUpdateCheck(options = {}) {
+    var _a, _b, _c, _d;
+    const cachePath = (_a = options.cachePath) !== null && _a !== void 0 ? _a : getUpdateCachePath();
+    const now = (_b = options.now) !== null && _b !== void 0 ? _b : Date.now();
+    if (isUpdateCheckDisabled((_c = options.env) !== null && _c !== void 0 ? _c : process.env)) {
+        return false;
+    }
+    const claimed = withLock(cachePath, () => {
+        const state = readUpdateState(cachePath);
+        if (state.lastAttemptedAt !== undefined && now - state.lastAttemptedAt < CHECK_INTERVAL_MS) {
+            return false;
+        }
+        return writeUpdateState(Object.assign(Object.assign({}, state), { lastAttemptedAt: now }), cachePath);
+    });
+    if (!claimed) {
+        return false;
+    }
+    try {
+        ((_d = options.spawnWorker) !== null && _d !== void 0 ? _d : spawnUpdateWorker)();
+        return true;
+    }
+    catch (_e) {
+        return false;
+    }
+}
+function createDefaultWorkerDependencies() {
+    return {
+        cachePath: getUpdateCachePath(),
+        version: VERSION,
+        fetchLatestVersion,
+        getSelfUpdatePlan: version => getSelfUpdatePlan(version),
+        runInstall: runInstallCommand,
+        readInstalledVersion,
+    };
+}
+function decideInstall(latest, deps) {
+    const plan = deps.getSelfUpdatePlan(latest);
+    if (plan.kind === 'manual') {
+        return { version: latest, status: 'manual', instruction: plan.instruction };
+    }
+    if (deps.readInstalledVersion(plan.packageJsonPath) === latest) {
+        return { version: latest, status: 'installed' };
+    }
+    try {
+        deps.runInstall(plan.command);
+    }
+    catch (_a) {
+        return { version: latest, status: 'failed' };
+    }
+    const installed = deps.readInstalledVersion(plan.packageJsonPath);
+    return { version: latest, status: installed === latest ? 'installed' : 'failed' };
+}
+/**
+ * Detached worker: checks npm and installs a newer version into the running
+ * copy only when that copy is a verified, writable global install.
+ */
+export function runUpdateWorker() {
+    return __awaiter(this, arguments, void 0, function* (deps = createDefaultWorkerDependencies()) {
+        try {
+            const latest = yield deps.fetchLatestVersion(REGISTRY_TIMEOUT_MS);
+            if (!latest) {
+                return;
+            }
+            writeUpdateState(Object.assign(Object.assign({}, readUpdateState(deps.cachePath)), { latestVersion: latest }), deps.cachePath);
+            if (!isNewerVersion(deps.version, latest)) {
+                return;
+            }
+            const install = decideInstall(latest, deps);
+            writeUpdateState(Object.assign(Object.assign({}, readUpdateState(deps.cachePath)), { install }), deps.cachePath);
+        }
+        catch (_a) {
+            // Never surface worker errors
+        }
+    });
+}
+/**
+ * Reads what the running copy should tell the user, based on the cache only.
+ */
+export function getUpdateNotice(state, currentVersion = VERSION) {
+    var _a;
+    const latest = state.latestVersion;
+    if (!latest || !isNewerVersion(currentVersion, latest)) {
+        return undefined;
+    }
+    const install = state.install;
+    if (!install || install.version !== latest) {
+        return undefined;
+    }
+    if (install.status === 'installed') {
+        return { kind: 'installed', current: currentVersion, latest };
+    }
+    return {
+        kind: 'manual',
+        current: currentVersion,
+        latest,
+        instruction: (_a = install.instruction) !== null && _a !== void 0 ? _a : 'Run: bkper upgrade',
+    };
+}
+export function formatUpdateNotice(notice) {
+    if (notice.kind === 'installed') {
+        return `bkper ${notice.latest} installed (current ${notice.current}). Restart to use it.`;
+    }
+    return `bkper ${notice.latest} available (current ${notice.current}). ${notice.instruction}`;
+}
+/**
+ * Plain-command hook: prints the fallback warning when the copy cannot
+ * update itself, then starts the daily background check.
+ */
+export function runCommandUpdateCheck(writeStderr = message => process.stderr.write(message)) {
+    try {
+        if (isUpdateCheckDisabled()) {
+            return;
+        }
+        const notice = getUpdateNotice(readUpdateState());
+        if ((notice === null || notice === void 0 ? void 0 : notice.kind) === 'manual') {
+            writeStderr(`${formatUpdateNotice(notice)}\n`);
+        }
+        maybeStartUpdateCheck();
+    }
+    catch (_a) {
+        // Never break the user's command
+    }
+}
+//# sourceMappingURL=update-check.js.map

package/lib/upgrade/update-check.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"update-check.js","sourceRoot":"","sources":["../../src/upgrade/update-check.ts"],"names":[],"mappings":"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"}

package/lib/upgrade/update-worker.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=update-worker.d.ts.map

package/lib/upgrade/update-worker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"update-worker.d.ts","sourceRoot":"","sources":["../../src/upgrade/update-worker.ts"],"names":[],"mappings":""}

package/lib/upgrade/update-worker.js

@@ -0,0 +1,6 @@
+import { runUpdateWorker } from './update-check.js';
+// Detached entry point started by maybeStartUpdateCheck().
+runUpdateWorker().catch(() => {
+    // Never surface worker errors
+});
+//# sourceMappingURL=update-worker.js.map

package/lib/upgrade/update-worker.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"update-worker.js","sourceRoot":"","sources":["../../src/upgrade/update-worker.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAEpD,2DAA2D;AAC3D,eAAe,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE;IACzB,8BAA8B;AAClC,CAAC,CAAC,CAAC"}

package/lib/upgrade/upgrade.d.ts

@@ -1,43 +1,26 @@
-import type { InstallMethod } from './installation.js';
+import type { SelfUpdatePlan } from './installation.js';
 /**
  * Compares two semver version strings.
  * Returns true if `latest` is newer than `current`.
  */
 export declare function isNewerVersion(current: string, latest: string): boolean;
-export interface AvailableUpgrade {
-    current: string;
-    latest: string;
-    method: InstallMethod;
-}
-export interface AvailableUpgradeDependencies {
+export interface UpgradeDependencies {
     version: string;
     fetchLatestVersion: () => Promise<string | null>;
-    detectMethod: () => Promise<InstallMethod>;
-}
-export interface AutoUpgradeDependencies extends AvailableUpgradeDependencies {
-    startUpgrade: (method: InstallMethod, version: string) => void;
-    writeStderr: (message: string) => void;
+    getSelfUpdatePlan: (version: string) => SelfUpdatePlan;
+    runInstall: (command: string) => void;
+    readInstalledVersion: (packageJsonPath: string) => string | undefined;
+    log: (message: string) => void;
+    error: (message: string) => void;
 }
 /**
- * Checks whether a newer version is available and returns the target version
- * plus the detected install method.
- */
-export declare function getAvailableUpgrade(dependencies?: AvailableUpgradeDependencies): Promise<AvailableUpgrade | null>;
-/**
- * Runs the silent auto-upgrade check in the background.
- *
- * This function:
- * 1. Fetches the latest version from npm
- * 2. Compares with the current installed version
- * 3. If newer, starts a detached background upgrade using the detected install method
- * 4. Prints a brief message to stderr on fallback or when running non-interactively
- *
- * All errors are swallowed silently to never disrupt the user's command.
+ * Upgrades the running copy of bkper and returns the process exit code.
+ * Refuses to touch anything that is not a verified, writable global install.
  */
-export declare function autoUpgrade(dependencies?: AutoUpgradeDependencies): Promise<void>;
+export declare function runUpgrade(targetVersion: string | undefined, deps?: UpgradeDependencies): Promise<number>;
 /**
  * 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>;
+export declare function foregroundUpgrade(targetVersion?: string): Promise<void>;
 //# sourceMappingURL=upgrade.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"upgrade.d.ts","sourceRoot":"","sources":["../../src/upgrade/upgrade.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAEvD;;;GAGG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAQvE;AAED,MAAM,WAAW,gBAAgB;IAC7B,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,aAAa,CAAC;CACzB;AAED,MAAM,WAAW,4BAA4B;IACzC,OAAO,EAAE,MAAM,CAAC;IAChB,kBAAkB,EAAE,MAAM,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IACjD,YAAY,EAAE,MAAM,OAAO,CAAC,aAAa,CAAC,CAAC;CAC9C;AAED,MAAM,WAAW,uBAAwB,SAAQ,4BAA4B;IACzE,YAAY,EAAE,CAAC,MAAM,EAAE,aAAa,EAAE,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;IAC/D,WAAW,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;CAC1C;AAgCD;;;GAGG;AACH,wBAAsB,mBAAmB,CACrC,YAAY,GAAE,4BAA0E,GACzF,OAAO,CAAC,gBAAgB,GAAG,IAAI,CAAC,CAWlC;AAED;;;;;;;;;;GAUG;AACH,wBAAsB,WAAW,CAC7B,YAAY,GAAE,uBAAgE,GAC/E,OAAO,CAAC,IAAI,CAAC,CA2Bf;AAED;;;GAGG;AACH,wBAAsB,iBAAiB,CACnC,aAAa,CAAC,EAAE,MAAM,EACtB,cAAc,CAAC,EAAE,MAAM,GACxB,OAAO,CAAC,IAAI,CAAC,CAsCf"}
+{"version":3,"file":"upgrade.d.ts","sourceRoot":"","sources":["../../src/upgrade/upgrade.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAExD;;;GAGG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAQvE;AAED,MAAM,WAAW,mBAAmB;IAChC,OAAO,EAAE,MAAM,CAAC;IAChB,kBAAkB,EAAE,MAAM,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IACjD,iBAAiB,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,cAAc,CAAC;IACvD,UAAU,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;IACtC,oBAAoB,EAAE,CAAC,eAAe,EAAE,MAAM,KAAK,MAAM,GAAG,SAAS,CAAC;IACtE,GAAG,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;IAC/B,KAAK,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;CACpC;AAcD;;;GAGG;AACH,wBAAsB,UAAU,CAC5B,aAAa,EAAE,MAAM,GAAG,SAAS,EACjC,IAAI,GAAE,mBAAwD,GAC/D,OAAO,CAAC,MAAM,CAAC,CA8CjB;AAED;;;GAGG;AACH,wBAAsB,iBAAiB,CAAC,aAAa,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAK7E"}

package/lib/upgrade/upgrade.js

@@ -7,7 +7,7 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
         step((generator = generator.apply(thisArg, _arguments || [])).next());
     });
 };
-import { VERSION, fetchLatestVersion, detectMethod, detectMethodAsync, executeUpgrade, getUpgradeCommand, startDetachedUpgrade, } from './installation.js';
+import { VERSION, fetchLatestVersion, getSelfUpdatePlan, readInstalledVersion, runInstallCommand, } from './installation.js';
 /**
  * Compares two semver version strings.
  * Returns true if `latest` is newer than `current`.
@@ -22,118 +22,71 @@ export function isNewerVersion(current, latest) {
         return lMinor > cMinor;
     return lPatch > cPatch;
 }
-function writeAutoUpgradeMessage(message) {
-    if (process.stdout.isTTY === true && process.stderr.isTTY === true) {
-        return;
-    }
-    process.stderr.write(message);
-}
-function createDefaultAvailableUpgradeDependencies() {
+function createDefaultUpgradeDependencies() {
     return {
         version: VERSION,
-        fetchLatestVersion,
-        detectMethod: detectMethodAsync,
+        fetchLatestVersion: () => fetchLatestVersion(),
+        getSelfUpdatePlan: version => getSelfUpdatePlan(version),
+        runInstall: runInstallCommand,
+        readInstalledVersion,
+        log: message => console.log(message),
+        error: message => console.error(message),
     };
 }
-function createDefaultAutoUpgradeDependencies() {
-    return Object.assign(Object.assign({}, createDefaultAvailableUpgradeDependencies()), { startUpgrade: startDetachedUpgrade, writeStderr: writeAutoUpgradeMessage });
-}
-function getManualUpgradeMessage(current, latest) {
-    return (`\nbkper ${latest} available (current: ${current}). ` +
-        `Upgrade manually: npm install -g bkper@${latest}\n`);
-}
 /**
- * Checks whether a newer version is available and returns the target version
- * plus the detected install method.
+ * Upgrades the running copy of bkper and returns the process exit code.
+ * Refuses to touch anything that is not a verified, writable global install.
  */
-export function getAvailableUpgrade() {
-    return __awaiter(this, arguments, void 0, function* (dependencies = createDefaultAvailableUpgradeDependencies()) {
-        const latest = yield dependencies.fetchLatestVersion();
-        if (!latest)
-            return null;
-        if (!isNewerVersion(dependencies.version, latest))
-            return null;
-        const method = yield dependencies.detectMethod();
-        return {
-            current: dependencies.version,
-            latest,
-            method,
-        };
-    });
-}
-/**
- * Runs the silent auto-upgrade check in the background.
- *
- * This function:
- * 1. Fetches the latest version from npm
- * 2. Compares with the current installed version
- * 3. If newer, starts a detached background upgrade using the detected install method
- * 4. Prints a brief message to stderr on fallback or when running non-interactively
- *
- * All errors are swallowed silently to never disrupt the user's command.
- */
-export function autoUpgrade() {
-    return __awaiter(this, arguments, void 0, function* (dependencies = createDefaultAutoUpgradeDependencies()) {
+export function runUpgrade(targetVersion_1) {
+    return __awaiter(this, arguments, void 0, function* (targetVersion, deps = createDefaultUpgradeDependencies()) {
+        const latest = targetVersion !== null && targetVersion !== void 0 ? targetVersion : (yield deps.fetchLatestVersion());
+        if (!latest) {
+            deps.error('Could not determine the latest version. Check your network connection.');
+            return 1;
+        }
+        if (!targetVersion && !isNewerVersion(deps.version, latest)) {
+            deps.log(`Already on the latest version (${deps.version}).`);
+            return 0;
+        }
+        const plan = deps.getSelfUpdatePlan(latest);
+        if (plan.kind === 'manual') {
+            deps.error(`Cannot upgrade this bkper automatically.\n` +
+                `Running bkper: ${plan.packageDir}\n` +
+                `Detected method: ${plan.method}\n` +
+                plan.instruction);
+            return 1;
+        }
+        deps.log(`Upgrading bkper: ${deps.version} \u2192 ${latest}`);
+        deps.log(`Running: ${plan.command}`);
         try {
-            const availableUpgrade = yield getAvailableUpgrade(dependencies);
-            if (!availableUpgrade)
-                return;
-            if (availableUpgrade.method === 'unknown') {
-                dependencies.writeStderr(getManualUpgradeMessage(availableUpgrade.current, availableUpgrade.latest));
-                return;
-            }
-            try {
-                dependencies.startUpgrade(availableUpgrade.method, availableUpgrade.latest);
-                dependencies.writeStderr(`\nbkper update started in background: ` +
-                    `${availableUpgrade.current} \u2192 ${availableUpgrade.latest} ` +
-                    `(restart later to use)\n`);
-            }
-            catch (_a) {
-                dependencies.writeStderr(getManualUpgradeMessage(availableUpgrade.current, availableUpgrade.latest));
-            }
+            deps.runInstall(plan.command);
         }
-        catch (_b) {
-            // Silent failure — never break the user's command
+        catch (err) {
+            deps.error(`Upgrade failed: ${err instanceof Error ? err.message : String(err)}`);
+            deps.error(`Try upgrading manually: ${plan.command}`);
+            return 1;
+        }
+        const installed = deps.readInstalledVersion(plan.packageJsonPath);
+        if (installed !== latest) {
+            deps.error(`bkper@${latest} was installed elsewhere; the running bkper at ${plan.packageDir} ` +
+                `is still ${installed !== null && installed !== void 0 ? installed : 'unknown'}.\n` +
+                `Update it with the package manager that provides it.`);
+            return 1;
         }
+        deps.log(`Successfully upgraded to bkper@${latest}. Restart your terminal to use the new version.`);
+        return 0;
     });
 }
 /**
  * Runs an explicit foreground upgrade with user-facing output.
  * Used by the `bkper upgrade` command.
  */
-export function foregroundUpgrade(targetVersion, methodOverride) {
+export function foregroundUpgrade(targetVersion) {
     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);
+        const exitCode = yield runUpgrade(targetVersion);
+        if (exitCode !== 0) {
+            process.exit(exitCode);
         }
     });
 }
-function isValidMethod(method) {
-    return ['npm', 'bun', 'yarn'].includes(method);
-}
 //# sourceMappingURL=upgrade.js.map

package/lib/upgrade/upgrade.js.map

@@ -1 +1 @@
-{"version":3,"file":"upgrade.js","sourceRoot":"","sources":["../../src/upgrade/upgrade.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"upgrade.js","sourceRoot":"","sources":["../../src/upgrade/upgrade.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "bkper",
-    "version": "4.31.3",
+    "version": "5.1.0",
     "description": "Official Bkper CLI for accounting data, automation, apps, and AI agents",
     "bin": {
         "bkper": "./lib/cli.js"

package/lib/render/csv-formatter.d.ts

@@ -1,15 +0,0 @@
-/**
- * Formats a 2D matrix into an RFC 4180 compliant CSV string.
- *
- * - Row 0 is treated as headers, rows 1+ as data (all rendered identically)
- * - Uses CRLF line endings per RFC 4180
- * - Fields containing commas, double quotes, or newlines are quoted
- * - Double quotes are escaped by doubling them ("")
- * - null/undefined cells are rendered as empty strings
- * - No truncation is applied to any field
- *
- * @param matrix - 2D array where row 0 is headers and rows 1+ are data
- * @returns RFC 4180 CSV string
- */
-export declare function formatCsv(matrix: unknown[][]): string;
-//# sourceMappingURL=csv-formatter.d.ts.map

package/lib/render/csv-formatter.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"csv-formatter.d.ts","sourceRoot":"","sources":["../../src/render/csv-formatter.ts"],"names":[],"mappings":"AAqBA;;;;;;;;;;;;GAYG;AACH,wBAAgB,SAAS,CAAC,MAAM,EAAE,OAAO,EAAE,EAAE,GAAG,MAAM,CAMrD"}

package/lib/render/csv-formatter.js

@@ -1,37 +0,0 @@
-/**
- * Formats a field value according to RFC 4180 rules.
- *
- * - null/undefined become empty string
- * - Fields containing commas, double quotes, or newlines are wrapped in double quotes
- * - Double quotes within a field are escaped by doubling them ("")
- */
-function formatField(value) {
-    if (value == null) {
-        return '';
-    }
-    const str = String(value);
-    if (str.includes('"') || str.includes(',') || str.includes('\n') || str.includes('\r')) {
-        return '"' + str.replace(/"/g, '""') + '"';
-    }
-    return str;
-}
-/**
- * Formats a 2D matrix into an RFC 4180 compliant CSV string.
- *
- * - Row 0 is treated as headers, rows 1+ as data (all rendered identically)
- * - Uses CRLF line endings per RFC 4180
- * - Fields containing commas, double quotes, or newlines are quoted
- * - Double quotes are escaped by doubling them ("")
- * - null/undefined cells are rendered as empty strings
- * - No truncation is applied to any field
- *
- * @param matrix - 2D array where row 0 is headers and rows 1+ are data
- * @returns RFC 4180 CSV string
- */
-export function formatCsv(matrix) {
-    if (!matrix || matrix.length === 0) {
-        return '';
-    }
-    return matrix.map(row => row.map(formatField).join(',')).join('\r\n');
-}
-//# sourceMappingURL=csv-formatter.js.map

package/lib/render/csv-formatter.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"csv-formatter.js","sourceRoot":"","sources":["../../src/render/csv-formatter.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,SAAS,WAAW,CAAC,KAAc;IAC/B,IAAI,KAAK,IAAI,IAAI,EAAE,CAAC;QAChB,OAAO,EAAE,CAAC;IACd,CAAC;IAED,MAAM,GAAG,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;IAE1B,IAAI,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,GAAG,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,GAAG,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;QACrF,OAAO,GAAG,GAAG,GAAG,CAAC,OAAO,CAAC,IAAI,EAAE,IAAI,CAAC,GAAG,GAAG,CAAC;IAC/C,CAAC;IAED,OAAO,GAAG,CAAC;AACf,CAAC;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,SAAS,CAAC,MAAmB;IACzC,IAAI,CAAC,MAAM,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACjC,OAAO,EAAE,CAAC;IACd,CAAC;IAED,OAAO,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;AAC1E,CAAC"}