@stacksjs/buddy 0.72.9 → 0.72.11

package/dist/commands/db.d.ts

@@ -1,2 +1,32 @@
+import type { BackupTarget } from '../database-backup';
 import type { CLI } from '@stacksjs/types';
+/*.ts` asynchronously and only re-binds its
+ * exports once `overridesReady` resolves, so reading `config.database` before
+ * then answers with the FRAMEWORK DEFAULT rather than the project's config
+ * (stacksjs/stacks#2333). There is no barrier anywhere above this: the CLI
+ * does not await it, so this function has to.
+ *
+ * That matters most where it is least visible. `applyPreMigrationBackup`
+ * splices `db:backup --before-migrations` into a site's `preStart` ahead of
+ * `migrate`, so an early read means dumping one database while `migrate`
+ * changes another - and reporting success. A backup of the wrong database is
+ * worse than no backup, because it is one you would restore from.
+ *
+ * The rejection is swallowed on purpose. `overridesReady` rejects when boot
+ * validation finds ANY issue in ANY config file, but that check runs after
+ * every config module has already merged into `overrides` in place, so the
+ * values here are complete either way. Letting it propagate would mean a typo
+ * in an unrelated file - `ports.frontend`, say - aborts the pre-migration
+ * backup and therefore the deploy, which is a worse failure than the one it
+ * would be reporting. The validator has already printed the issues itself.
+ *
+ * Deliberately untested, which is worth stating rather than hiding. In this
+ * repo `database.default` comes from `DB_CONNECTION` in the environment,
+ * available synchronously, so early and late reads agree and no assertion can
+ * tell them apart - measured over three runs, and an ordering assertion also
+ * passed with the barrier removed. Reproducing the divergence needs a
+ * `config/database.ts` that is not env-derived or that carries a top-level
+ * await. A test that passes either way would only look like coverage.
+ */
+export declare function backupTarget(): Promise<BackupTarget | null>;
 export declare function db(buddy: CLI): void;

package/dist/commands/db.js

@@ -1 +1 @@
-import{existsSync,mkdirSync,readdirSync,rmSync,statSync}from"node:fs";import{isAbsolute,join,resolve}from"node:path";import process from"node:process";import{confirmOrNull,intro,log,outro}from"@stacksjs/cli";import{ExitCode}from"@stacksjs/types";import{backupFileName,describeCommand,dumpCommand,dumpSqlite,isBackupFileName,prunableBackups,resolveBackupTarget,restoreCommand,restoreSqlite,toolFailureDetail,withoutPassword}from"../database-backup";const DEFAULT_BACKUP_DIR="storage/backups/database",DEFAULT_RETAIN=7;async function backupTarget(){const{config}=await import("@stacksjs/config");return resolveBackupTarget(config?.database)}function backupDir(out){const dir=out?.trim()||DEFAULT_BACKUP_DIR;return isAbsolute(dir)?dir:resolve(process.cwd(),dir)}function existingBackups(dir){if(!existsSync(dir))return[];return readdirSync(dir).filter(isBackupFileName).sort()}function sqliteDatabaseExists(target){const path=sqliteFile(target);return existsSync(path)&&statSync(path).size>0}function sqliteFile(target){return isAbsolute(target.database)?target.database:resolve(process.cwd(),target.database)}async function runTool(command,password){const proc=Bun.spawn([command.bin,...command.args],{env:{...process.env,...command.env},stdout:"pipe",stderr:"pipe"}),[code,stderr]=await Promise.all([proc.exited,new Response(proc.stderr).text()]);if(code===0)return;const detail=toolFailureDetail(stderr,command.bin)||`exit code ${code}`;throw Error(withoutPassword(`${command.bin}: ${detail}`,password))}function prune(dir,retain){const removed=prunableBackups(existingBackups(dir),retain);for(const name of removed)rmSync(join(dir,name),{force:!0});return removed}export function db(buddy){buddy.command("db:backup","Dump the application database to a file").option("--out [dir]",`Where to write the dump (default: ${DEFAULT_BACKUP_DIR})`).option("--retain [count]","How many dumps to keep",{default:String(DEFAULT_RETAIN)}).option("--before-migrations","Deploy mode: succeed quietly when there is no database yet",{default:!1}).option("--verbose","Enable verbose output",{default:!1}).example("buddy db:backup").example("buddy db:backup --out /var/backups/app --retain 30").action(async(options)=>{const perf=await intro("buddy db:backup");try{const target=await backupTarget();if(!target){await outro("No dumpable database is configured; nothing to back up.",{startTime:perf,useSeconds:!0});process.exit(ExitCode.Success)}if(target.engine==="sqlite"&&!sqliteDatabaseExists(target)){const message=`No database at ${target.database} yet; nothing to back up.`;if(options.beforeMigrations){await outro(message,{startTime:perf,useSeconds:!0});process.exit(ExitCode.Success)}log.warn(message);await outro("Nothing backed up.",{startTime:perf,useSeconds:!0});process.exit(ExitCode.Success)}const dir=backupDir(options.out);mkdirSync(dir,{recursive:!0});const name=backupFileName(target,new Date),destination=join(dir,name),command=dumpCommand(target,destination);if(command){if(options.verbose)log.info(describeCommand(command));await runTool(command,target.password)}else await dumpSqlite(sqliteFile(target),destination);const size=existsSync(destination)?statSync(destination).size:0;log.success(`Wrote ${destination} (${(size/1024).toFixed(1)} KB)`);const retain=Number.parseInt(String(options.retain??DEFAULT_RETAIN),10),removed=prune(dir,retain);if(removed.length)log.info(`Pruned ${removed.length} older dump(s), keeping ${retain}.`);log.info("This dump is on the same disk as the database. Copy it off the box for a real backup.");await outro("Database backed up",{startTime:perf,useSeconds:!0})}catch(error){await log.error("Database backup failed:",error);process.exit(ExitCode.FatalError)}process.exit(ExitCode.Success)});buddy.command("db:backups","List the database dumps that have been taken").option("--out [dir]",`Where dumps are kept (default: ${DEFAULT_BACKUP_DIR})`).example("buddy db:backups").action(async(options)=>{const dir=backupDir(options.out),backups=existingBackups(dir);if(!backups.length){log.info(`No dumps in ${dir}.`);process.exit(ExitCode.Success)}log.info(`${backups.length} dump(s) in ${dir}, oldest first:`);for(const name of backups){const size=statSync(join(dir,name)).size;log.info(`  ${name}  ${(size/1024).toFixed(1)} KB`)}process.exit(ExitCode.Success)});buddy.command("db:restore [file]","Restore the application database from a dump").option("--out [dir]",`Where dumps are kept (default: ${DEFAULT_BACKUP_DIR})`).option("--force","Skip the confirmation prompt",{default:!1}).option("--verbose","Enable verbose output",{default:!1}).example("buddy db:restore").example("buddy db:restore 2026-08-13T09-00-00-000.sqlite.sqlite --force").action(async(file,options)=>{const perf=await intro("buddy db:restore");try{const target=await backupTarget();if(!target){await log.error("No restorable database is configured.");process.exit(ExitCode.FatalError)}const dir=backupDir(options.out),backups=existingBackups(dir),name=file??backups[backups.length-1];if(!name){await log.error(`No dumps found in ${dir}.`);process.exit(ExitCode.FatalError)}const source=isAbsolute(name)?name:join(dir,name);if(!existsSync(source)){await log.error(`No such dump: ${source}`);process.exit(ExitCode.FatalError)}if(!options.force){if(await confirmOrNull({message:`Replace ${target.engine} database "${target.database}" with ${name}? The current contents are lost.`,initial:!1})!==!0){await outro("Restore cancelled.",{startTime:perf,useSeconds:!0});process.exit(ExitCode.Success)}}const command=restoreCommand(target,source);if(command){if(options.verbose)log.info(describeCommand(command));await runTool(command,target.password)}else{const displaced=await restoreSqlite(source,sqliteFile(target),Date.now());if(displaced)log.info(`The database that was there is kept at ${displaced}`)}log.success(`Restored ${target.database} from ${name}`);await outro("Database restored",{startTime:perf,useSeconds:!0})}catch(error){await log.error("Database restore failed:",error);process.exit(ExitCode.FatalError)}process.exit(ExitCode.Success)})}
+import{existsSync,mkdirSync,readdirSync,rmSync,statSync}from"node:fs";import{isAbsolute,join,resolve}from"node:path";import process from"node:process";import{confirmOrNull,intro,log,outro}from"@stacksjs/cli";import{ExitCode}from"@stacksjs/types";import{backupFileName,describeCommand,dumpCommand,dumpSqlite,isBackupFileName,prunableBackups,resolveBackupTarget,restoreCommand,restoreSqlite,toolFailureDetail,withoutPassword}from"../database-backup";const DEFAULT_BACKUP_DIR="storage/backups/database",DEFAULT_RETAIN=7;export async function backupTarget(){const{config,overridesReady}=await import("@stacksjs/config");await overridesReady.catch(()=>{});return resolveBackupTarget(config?.database)}function backupDir(out){const dir=out?.trim()||DEFAULT_BACKUP_DIR;return isAbsolute(dir)?dir:resolve(process.cwd(),dir)}function existingBackups(dir){if(!existsSync(dir))return[];return readdirSync(dir).filter(isBackupFileName).sort()}function sqliteDatabaseExists(target){const path=sqliteFile(target);return existsSync(path)&&statSync(path).size>0}function sqliteFile(target){return isAbsolute(target.database)?target.database:resolve(process.cwd(),target.database)}async function runTool(command,password){const proc=Bun.spawn([command.bin,...command.args],{env:{...process.env,...command.env},stdout:"pipe",stderr:"pipe"}),[code,stderr]=await Promise.all([proc.exited,new Response(proc.stderr).text()]);if(code===0)return;const detail=toolFailureDetail(stderr,command.bin)||`exit code ${code}`;throw Error(withoutPassword(`${command.bin}: ${detail}`,password))}function prune(dir,retain){const removed=prunableBackups(existingBackups(dir),retain);for(const name of removed)rmSync(join(dir,name),{force:!0});return removed}export function db(buddy){buddy.command("db:backup","Dump the application database to a file").option("--out [dir]",`Where to write the dump (default: ${DEFAULT_BACKUP_DIR})`).option("--retain [count]","How many dumps to keep",{default:String(DEFAULT_RETAIN)}).option("--before-migrations","Deploy mode: succeed quietly when there is no database yet",{default:!1}).option("--verbose","Enable verbose output",{default:!1}).example("buddy db:backup").example("buddy db:backup --out /var/backups/app --retain 30").action(async(options)=>{const perf=await intro("buddy db:backup");try{const target=await backupTarget();if(!target){await outro("No dumpable database is configured; nothing to back up.",{startTime:perf,useSeconds:!0});process.exit(ExitCode.Success)}if(target.engine==="sqlite"&&!sqliteDatabaseExists(target)){const message=`No database at ${target.database} yet; nothing to back up.`;if(options.beforeMigrations){await outro(message,{startTime:perf,useSeconds:!0});process.exit(ExitCode.Success)}log.warn(message);await outro("Nothing backed up.",{startTime:perf,useSeconds:!0});process.exit(ExitCode.Success)}const dir=backupDir(options.out);mkdirSync(dir,{recursive:!0});const name=backupFileName(target,new Date),destination=join(dir,name),command=dumpCommand(target,destination);if(command){if(options.verbose)log.info(describeCommand(command));await runTool(command,target.password)}else await dumpSqlite(sqliteFile(target),destination);const size=existsSync(destination)?statSync(destination).size:0;log.success(`Wrote ${destination} (${(size/1024).toFixed(1)} KB)`);const retain=Number.parseInt(String(options.retain??DEFAULT_RETAIN),10),removed=prune(dir,retain);if(removed.length)log.info(`Pruned ${removed.length} older dump(s), keeping ${retain}.`);log.info("This dump is on the same disk as the database. Copy it off the box for a real backup.");await outro("Database backed up",{startTime:perf,useSeconds:!0})}catch(error){await log.error("Database backup failed:",error);process.exit(ExitCode.FatalError)}process.exit(ExitCode.Success)});buddy.command("db:backups","List the database dumps that have been taken").option("--out [dir]",`Where dumps are kept (default: ${DEFAULT_BACKUP_DIR})`).example("buddy db:backups").action(async(options)=>{const dir=backupDir(options.out),backups=existingBackups(dir);if(!backups.length){log.info(`No dumps in ${dir}.`);process.exit(ExitCode.Success)}log.info(`${backups.length} dump(s) in ${dir}, oldest first:`);for(const name of backups){const size=statSync(join(dir,name)).size;log.info(`  ${name}  ${(size/1024).toFixed(1)} KB`)}process.exit(ExitCode.Success)});buddy.command("db:restore [file]","Restore the application database from a dump").option("--out [dir]",`Where dumps are kept (default: ${DEFAULT_BACKUP_DIR})`).option("--force","Skip the confirmation prompt",{default:!1}).option("--verbose","Enable verbose output",{default:!1}).example("buddy db:restore").example("buddy db:restore 2026-08-13T09-00-00-000.sqlite.sqlite --force").action(async(file,options)=>{const perf=await intro("buddy db:restore");try{const target=await backupTarget();if(!target){await log.error("No restorable database is configured.");process.exit(ExitCode.FatalError)}const dir=backupDir(options.out),backups=existingBackups(dir),name=file??backups[backups.length-1];if(!name){await log.error(`No dumps found in ${dir}.`);process.exit(ExitCode.FatalError)}const source=isAbsolute(name)?name:join(dir,name);if(!existsSync(source)){await log.error(`No such dump: ${source}`);process.exit(ExitCode.FatalError)}if(!options.force){if(await confirmOrNull({message:`Replace ${target.engine} database "${target.database}" with ${name}? The current contents are lost.`,initial:!1})!==!0){await outro("Restore cancelled.",{startTime:perf,useSeconds:!0});process.exit(ExitCode.Success)}}const command=restoreCommand(target,source);if(command){if(options.verbose)log.info(describeCommand(command));await runTool(command,target.password)}else{const displaced=await restoreSqlite(source,sqliteFile(target),Date.now());if(displaced)log.info(`The database that was there is kept at ${displaced}`)}log.success(`Restored ${target.database} from ${name}`);await outro("Database restored",{startTime:perf,useSeconds:!0})}catch(error){await log.error("Database restore failed:",error);process.exit(ExitCode.FatalError)}process.exit(ExitCode.Success)})}

package/package.json

@@ -2,7 +2,7 @@
   "name": "@stacksjs/buddy",
   "type": "module",
   "sideEffects": false,
-  "version": "0.72.9",
+  "version": "0.72.11",
   "description": "Meet Buddy. The Stacks runtime.",
   "author": "Chris Breuer",
   "contributors": [
@@ -95,55 +95,55 @@
     "prepublishOnly": "bun run build"
   },
   "dependencies": {
-    "@stacksjs/actions": "^0.72.9",
-    "@stacksjs/ai": "^0.72.9",
-    "@stacksjs/alias": "^0.72.9",
-    "@stacksjs/arrays": "^0.72.9",
-    "@stacksjs/auth": "^0.72.9",
-    "@stacksjs/build": "^0.72.9",
-    "@stacksjs/cache": "^0.72.9",
-    "@stacksjs/cli": "^0.72.9",
+    "@stacksjs/actions": "^0.72.11",
+    "@stacksjs/ai": "^0.72.11",
+    "@stacksjs/alias": "^0.72.11",
+    "@stacksjs/arrays": "^0.72.11",
+    "@stacksjs/auth": "^0.72.11",
+    "@stacksjs/build": "^0.72.11",
+    "@stacksjs/cache": "^0.72.11",
+    "@stacksjs/cli": "^0.72.11",
     "@stacksjs/clapp": "^0.2.12",
-    "@stacksjs/cloud": "^0.72.9",
-    "@stacksjs/collections": "^0.72.9",
-    "@stacksjs/config": "^0.72.9",
-    "@stacksjs/database": "^0.72.9",
-    "@stacksjs/desktop-build": "^0.72.9",
-    "@stacksjs/dns": "^0.72.9",
-    "@stacksjs/email": "^0.72.9",
-    "@stacksjs/enums": "^0.72.9",
-    "@stacksjs/error-handling": "^0.72.9",
-    "@stacksjs/events": "^0.72.9",
-    "@stacksjs/git": "^0.72.9",
+    "@stacksjs/cloud": "^0.72.11",
+    "@stacksjs/collections": "^0.72.11",
+    "@stacksjs/config": "^0.72.11",
+    "@stacksjs/database": "^0.72.11",
+    "@stacksjs/desktop-build": "^0.72.11",
+    "@stacksjs/dns": "^0.72.11",
+    "@stacksjs/email": "^0.72.11",
+    "@stacksjs/enums": "^0.72.11",
+    "@stacksjs/error-handling": "^0.72.11",
+    "@stacksjs/events": "^0.72.11",
+    "@stacksjs/git": "^0.72.11",
     "@stacksjs/gitit": "^0.2.5",
-    "@stacksjs/health": "^0.72.9",
+    "@stacksjs/health": "^0.72.11",
     "@stacksjs/dnsx": "^0.2.3",
     "@stacksjs/httx": "^0.1.10",
-    "@stacksjs/image": "^0.72.9",
-    "@stacksjs/lint": "^0.72.9",
-    "@stacksjs/logging": "^0.72.9",
-    "@stacksjs/notifications": "^0.72.9",
-    "@stacksjs/objects": "^0.72.9",
-    "@stacksjs/orm": "^0.72.9",
-    "@stacksjs/path": "^0.72.9",
-    "@stacksjs/skills": "^0.72.9",
-    "@stacksjs/payments": "^0.72.9",
-    "@stacksjs/realtime": "^0.72.9",
-    "@stacksjs/router": "^0.72.9",
+    "@stacksjs/image": "^0.72.11",
+    "@stacksjs/lint": "^0.72.11",
+    "@stacksjs/logging": "^0.72.11",
+    "@stacksjs/notifications": "^0.72.11",
+    "@stacksjs/objects": "^0.72.11",
+    "@stacksjs/orm": "^0.72.11",
+    "@stacksjs/path": "^0.72.11",
+    "@stacksjs/skills": "^0.72.11",
+    "@stacksjs/payments": "^0.72.11",
+    "@stacksjs/realtime": "^0.72.11",
+    "@stacksjs/router": "^0.72.11",
     "@stacksjs/rpx": "^0.11.42",
-    "@stacksjs/search-engine": "^0.72.9",
-    "@stacksjs/security": "^0.72.9",
-    "@stacksjs/server": "^0.72.9",
-    "@stacksjs/cms": "^0.72.9",
-    "@stacksjs/sites": "^0.72.9",
-    "@stacksjs/storage": "^0.72.9",
-    "@stacksjs/strings": "^0.72.9",
-    "@stacksjs/testing": "^0.72.9",
-    "@stacksjs/tunnel": "^0.72.9",
-    "@stacksjs/types": "^0.72.9",
-    "@stacksjs/ui": "^0.72.9",
-    "@stacksjs/utils": "^0.72.9",
-    "@stacksjs/validation": "^0.72.9",
+    "@stacksjs/search-engine": "^0.72.11",
+    "@stacksjs/security": "^0.72.11",
+    "@stacksjs/server": "^0.72.11",
+    "@stacksjs/cms": "^0.72.11",
+    "@stacksjs/sites": "^0.72.11",
+    "@stacksjs/storage": "^0.72.11",
+    "@stacksjs/strings": "^0.72.11",
+    "@stacksjs/testing": "^0.72.11",
+    "@stacksjs/tunnel": "^0.72.11",
+    "@stacksjs/types": "^0.72.11",
+    "@stacksjs/ui": "^0.72.11",
+    "@stacksjs/utils": "^0.72.11",
+    "@stacksjs/validation": "^0.72.11",
     "@stacksjs/ts-cloud": "^0.8.3",
     "ajv": "^8.20.0",
     "ajv-formats": "^3.0.1",