@stacksjs/buddy 0.59.11 → 0.61.0

package/src/commands/http.ts

@@ -1,7 +1,7 @@
 import process from 'node:process'
+import { config } from '@stacksjs/config'
 import { ExitCode } from '@stacksjs/types'
 import type { CLI } from '@stacksjs/types'
-import { config } from '@stacksjs/config'
 
 // import { path } from '@stacksjs/path'
 import { log, runCommandSync } from '@stacksjs/cli'
@@ -36,7 +36,7 @@ export function http(buddy: CLI) {
 
   buddy
     .command('http [domain]', descriptions.http)
-    .option('-p, --project', descriptions.project, { default: false })
+    .option('-p, --project [project]', descriptions.project, { default: false })
     // .option('--verbose', descriptions.verbose, { default: false })
     .action(async (domain: string | undefined, options: HttpOptions) => {
       log.debug('Running `buddy http [domain]` ...', options)

package/src/commands/install.ts

@@ -1,7 +1,7 @@
 import process from 'node:process'
-import type { CLI, InstallOptions } from '@stacksjs/types'
 import { log, runCommand } from '@stacksjs/cli'
 import { path as p } from '@stacksjs/path'
+import type { CLI, InstallOptions } from '@stacksjs/types'
 
 export function install(buddy: CLI) {
   const descriptions = {
@@ -12,7 +12,7 @@ export function install(buddy: CLI) {
 
   buddy
     .command('install', descriptions.install)
-    .option('-p, --project', descriptions.project, { default: false })
+    .option('-p, --project [project]', descriptions.project, { default: false })
     .option('-v, --verbose', descriptions.verbose, { default: false })
     .action(async (options: InstallOptions) => {
       log.debug('Running `buddy install` ...', options)

package/src/commands/key.ts

@@ -1,8 +1,8 @@
 import process from 'node:process'
-import type { CLI, KeyOptions } from '@stacksjs/types'
-import { intro, log, outro } from '@stacksjs/cli'
 import { runAction } from '@stacksjs/actions'
+import { intro, log, outro } from '@stacksjs/cli'
 import { Action } from '@stacksjs/enums'
+import type { CLI, KeyOptions } from '@stacksjs/types'
 
 export function key(buddy: CLI) {
   const descriptions = {
@@ -13,7 +13,7 @@ export function key(buddy: CLI) {
 
   buddy
     .command('key:generate', descriptions.command)
-    .option('-p, --project', descriptions.project, { default: false })
+    .option('-p, --project [project]', descriptions.project, { default: false })
     .option('--verbose', descriptions.verbose, { default: false })
     .action(async (options: KeyOptions) => {
       log.debug('Running `buddy key:generate` ...', options)

package/src/commands/lint.ts

@@ -1,8 +1,8 @@
 import process from 'node:process'
-import type { CLI, LintOptions } from '@stacksjs/types'
+import { runAction } from '@stacksjs/actions'
 import { intro, log, outro } from '@stacksjs/cli'
 import { Action } from '@stacksjs/enums'
-import { runAction } from '@stacksjs/actions'
+import type { CLI, LintOptions } from '@stacksjs/types'
 
 export function lint(buddy: CLI) {
   const descriptions = {
@@ -15,7 +15,7 @@ export function lint(buddy: CLI) {
   buddy
     .command('lint', descriptions.lint)
     .option('-f, --fix', descriptions.lintFix, { default: false })
-    .option('-p, --project', descriptions.project, { default: false })
+    .option('-p, --project [project]', descriptions.project, { default: false })
     .option('--verbose', descriptions.verbose, { default: false })
     .action(async (options: LintOptions) => {
       log.debug('Running `buddy lint` ...', options)
@@ -34,7 +34,7 @@ export function lint(buddy: CLI) {
 
   buddy
     .command('lint:fix', descriptions.lintFix)
-    .option('-p, --project', descriptions.project, { default: false })
+    .option('-p, --project [project]', descriptions.project, { default: false })
     .option('--verbose', descriptions.verbose, { default: false })
     .action(async (options: LintOptions) => {
       log.debug('Running `buddy lint:fix` ...', options)

package/src/commands/list.ts

@@ -1,8 +1,8 @@
 import process from 'node:process'
+import { log } from '@stacksjs/logging'
+import { projectPath } from '@stacksjs/path'
 import type { CLI, CliOptions } from '@stacksjs/types'
 import { $ } from 'bun'
-import { projectPath } from '@stacksjs/path'
-import { log } from '@stacksjs/logging'
 
 export function list(buddy: CLI) {
   const descriptions = {
@@ -13,7 +13,7 @@ export function list(buddy: CLI) {
 
   buddy
     .command('list', descriptions.list)
-    .option('-p, --project', descriptions.project, { default: false })
+    .option('-p, --project [project]', descriptions.project, { default: false })
     .option('--verbose', descriptions.verbose, { default: false })
     .action(async (options: CliOptions) => {
       log.debug('Running `buddy list` ...', options)
@@ -28,7 +28,6 @@ export function list(buddy: CLI) {
           .replace('Commands:', '') // Remove "Commands:"
           .replace(/^\s+/gm, '') // Trim leading whitespace from the start of each line
 
-        // eslint-disable-next-line no-console
         console.log(cleanedCommands)
         return
       }

package/src/commands/make.ts

@@ -3,6 +3,7 @@ import {
   createModel,
   createNotification,
   invoke,
+  makeAction,
   makeComponent,
   makeDatabase,
   makeFunction,
@@ -12,13 +13,14 @@ import {
 } from '@stacksjs/actions'
 import { intro, italic, outro, runCommand } from '@stacksjs/cli'
 import { localUrl } from '@stacksjs/config'
-import { path as p } from '@stacksjs/path'
 import { log } from '@stacksjs/logging'
+import { path as p } from '@stacksjs/path'
 import type { CLI, MakeOptions } from '@stacksjs/types'
 import { ExitCode } from '@stacksjs/types'
 
 export function make(buddy: CLI) {
   const descriptions = {
+    action: 'Create a new action',
     model: 'Create a new model',
     component: 'Create a new component',
     page: 'Create a new page',
@@ -28,6 +30,7 @@ export function make(buddy: CLI) {
     migration: 'Create a new migration',
     factory: 'Create a new factory',
     notification: 'Create a new notification',
+    name: 'The name of the action',
     stack: 'Create a new stack',
     certificate: 'Create a new SSL Certificate',
     select: 'What are you trying to make?',
@@ -37,16 +40,17 @@ export function make(buddy: CLI) {
 
   buddy
     .command('make', 'The make command')
-    .option('-c, --component', descriptions.component, { default: false })
-    .option('-p, --page', descriptions.page, { default: false })
-    .option('-f, --function', descriptions.function, { default: false })
-    .option('-l, --language', descriptions.language, { default: false })
-    .option('-d, --database', descriptions.database, { default: false })
-    .option('-m, --migration', descriptions.migration, { default: false })
-    .option('-f, --factory', descriptions.factory, { default: false })
-    .option('-n, --notification', descriptions.notification, { default: false })
-    .option('-s, --stack', descriptions.stack, { default: false })
-    .option('-p, --project', descriptions.project, { default: false })
+    .option('-a, --action [action]', descriptions.action, { default: false })
+    .option('-m, --model [model]', descriptions.model, { default: false })
+    .option('-c, --component [component]', descriptions.component, { default: false })
+    .option('-p, --page [page]', descriptions.page, { default: false })
+    .option('-f, --function [function]', descriptions.function, { default: false })
+    .option('-l, --language [language]', descriptions.language, { default: false })
+    .option('-d, --database [database]', descriptions.database, { default: false })
+    .option('-m, --migration [migration]', descriptions.migration, { default: false })
+    .option('-f, --factory [factory]', descriptions.factory, { default: false })
+    .option('-n, --notification [notification]', descriptions.notification, { default: false })
+    .option('-s, --stack [stack]', descriptions.stack, { default: false })
     .option('--verbose', descriptions.verbose, { default: false })
     .action(async (options: MakeOptions) => {
       log.debug('Running `buddy make` ...', options)
@@ -91,14 +95,14 @@ export function make(buddy: CLI) {
     })
 
   buddy
-    .command('make:component', descriptions.component)
-    .option('-n, --name', 'The name of the component')
-    .option('-p, --project', descriptions.project, { default: false })
+    .command('make:component [name]', descriptions.component)
+    .option('-n, --name [name]', descriptions.name, { default: false })
+    .option('-p, --project [project]', descriptions.project, { default: false })
     .option('--verbose', descriptions.verbose, { default: false })
-    .action(async (options: MakeOptions) => {
+    .action(async (name, options: MakeOptions) => {
       log.debug('Running `buddy make:component` ...', options)
 
-      const name = buddy.args[0] || options.name
+      name = name ?? options.name
       options.name = name
 
       if (!name) {
@@ -110,18 +114,21 @@ export function make(buddy: CLI) {
     })
 
   buddy
-    .command('make:database', descriptions.database)
-    .option('-n, --name', 'The name of the database')
-    .option('-p, --project', descriptions.project, { default: false })
+    .command('make:database [name]', descriptions.database)
+    .option('-n, --name [name]', descriptions.name, { default: false })
+    .option('-p, --project [project]', descriptions.project, { default: false })
     .option('--verbose', descriptions.verbose, { default: false })
-    .action((options: MakeOptions) => {
+    .action((name, options: MakeOptions) => {
       log.debug('Running `buddy make:database` ...', options)
 
-      const name = buddy.args[0] || options.name
+      name = name ?? options.name
       options.name = name
 
       if (!name) {
-        log.error('You need to specify a name. Read more about the documentation here.')
+        log.error('You need to specify a database name via the `--name` option, or as the command’s argument.')
+        log.info('Example: `buddy make:database my-cool-database`')
+        log.info('Or: `buddy make:database --name=my-cool-database`')
+        log.info('Read more about the documentation here: https://stacksjs.org/docs/make/database')
         process.exit()
       }
 
@@ -129,14 +136,14 @@ export function make(buddy: CLI) {
     })
 
   buddy
-    .command('make:factory', descriptions.factory)
-    .option('-n, --name', 'The name of the factory')
-    .option('-p, --project', descriptions.project, { default: false })
+    .command('make:factory [name]', descriptions.factory)
+    .option('-n, --name [name]', descriptions.name, { default: false })
+    .option('-p, --project [project]', descriptions.project, { default: false })
     .option('--verbose', descriptions.verbose, { default: false })
-    .action((options: MakeOptions) => {
+    .action((name, options: MakeOptions) => {
       log.debug('Running `buddy make:factory` ...', options)
 
-      const name = buddy.args[0] || options.name
+      name = name ?? options.name
       options.name = name
 
       if (!name) {
@@ -148,15 +155,15 @@ export function make(buddy: CLI) {
     })
 
   buddy
-    .command('make:view', descriptions.page)
-    .alias('make:page')
-    .option('-n, --name', 'The name of the page')
-    .option('-p, --project', descriptions.project, { default: false })
+    .command('make:view [name]', descriptions.page)
+    .alias('make:page [name]')
+    .option('-n, --name [name]', descriptions.name, { default: false })
+    .option('-p, --project [project]', descriptions.project, { default: false })
     .option('--verbose', descriptions.verbose, { default: false })
-    .action(async (options: MakeOptions) => {
+    .action(async (name, options: MakeOptions) => {
       log.debug('Running `buddy make:view` ...', options)
 
-      const name = buddy.args[0] || options.name
+      name = name ?? options.name
       options.name = name
 
       if (!name) {
@@ -168,9 +175,9 @@ export function make(buddy: CLI) {
     })
 
   buddy
-    .command('make:function', descriptions.function)
-    .option('-n, --name', 'The name of the function')
-    .option('-p, --project', descriptions.project, { default: false })
+    .command('make:function [name]', descriptions.function)
+    .option('-n, --name [name]', descriptions.name, { default: false })
+    .option('-p, --project [project]', descriptions.project, { default: false })
     .option('--verbose', descriptions.verbose, { default: false })
     .action(async (options: MakeOptions) => {
       log.debug('Running `buddy make:function` ...', options)
@@ -179,14 +186,14 @@ export function make(buddy: CLI) {
     })
 
   buddy
-    .command('make:lang', descriptions.language)
-    .option('-n, --name', 'The name of the language')
-    .option('-p, --project', descriptions.project, { default: false })
+    .command('make:lang [name]', descriptions.language)
+    .option('-n, --name [name]', descriptions.name, { default: false })
+    .option('-p, --project [project]', descriptions.project, { default: false })
     .option('--verbose', descriptions.verbose, { default: false })
-    .action(async (options: MakeOptions) => {
+    .action(async (name, options: MakeOptions) => {
       log.debug('Running `buddy make:lang` ...', options)
 
-      const name = buddy.args[0] || options.name
+      name = name ?? options.name
       options.name = name
 
       if (!name) {
@@ -198,19 +205,19 @@ export function make(buddy: CLI) {
     })
 
   buddy
-    .command('make:notification', descriptions.notification)
-    .option('-n, --name', 'The name of the notification')
+    .command('make:notification [name]', descriptions.notification)
+    .option('-n, --name [name]', descriptions.name, { default: false })
     .option('-e, --email', 'Is it an email notification?', { default: true })
     .option('-c, --chat', 'Is it a chat notification?', { default: false })
     .option('-s, --sms', 'Is it a SMS notification?', { default: false })
-    .option('-p, --project', descriptions.project, { default: false })
+    .option('-p, --project [project]', descriptions.project, { default: false })
     .option('--verbose', descriptions.verbose, { default: false })
-    .action(async (options: MakeOptions) => {
+    .action(async (name, options: MakeOptions) => {
       log.debug('Running `buddy make:notification` ...', options)
 
       const perf = await intro('buddy make:notification')
 
-      const name = buddy.args[0] || options.name
+      name = name ?? options.name
       options.name = name
 
       if (!name) {
@@ -221,23 +228,29 @@ export function make(buddy: CLI) {
       const result = await createNotification(options)
 
       if (!result) {
-        await outro('While running the make:notification command, there was an issue', { startTime: perf, useSeconds: true })
+        await outro('While running the make:notification command, there was an issue', {
+          startTime: perf,
+          useSeconds: true,
+        })
         process.exit()
       }
 
-      await outro(`Created your ${italic(name)} notification.`, { startTime: perf, useSeconds: true })
+      await outro(`Created your ${italic(name)} notification.`, {
+        startTime: perf,
+        useSeconds: true,
+      })
       process.exit(ExitCode.Success)
     })
 
   buddy
-    .command('make:stack', descriptions.stack)
-    .option('-n, --name', 'The name of the stack')
-    .option('-p, --project', descriptions.project, { default: false })
+    .command('make:stack [name]', descriptions.stack)
+    .option('-n, --name [name]', descriptions.name, { default: false })
+    .option('-p, --project [project]', descriptions.project, { default: false })
     .option('--verbose', descriptions.verbose, { default: false })
-    .action((options: MakeOptions) => {
+    .action((name, options: MakeOptions) => {
       log.debug('Running `buddy make:stack` ...', options)
 
-      const name = buddy.args[0] || options.name
+      name = name ?? options.name
       options.name = name
 
       if (!name) {
@@ -249,12 +262,34 @@ export function make(buddy: CLI) {
     })
 
   buddy
-    .command('make:model', descriptions.model)
-    .option('-n, --name', 'The name of the model')
-    .action(async (options: MakeOptions) => {
+    .command('make:action [name]', descriptions.action)
+    .option('-n, --name [name]', descriptions.name, { default: false })
+    .option('-p, --project [project]', descriptions.project, { default: false })
+    .option('--verbose', descriptions.verbose, { default: false })
+    .action(async (name, options: MakeOptions) => {
+      log.info('Running `buddy make:action` ...')
+      log.debug('Running `buddy make:action` ...', name, options)
+
+      name = name ?? options.name
+      options.name = name
+
+      if (!name) {
+        log.error('You need to specify a name. Read more about the documentation here.')
+        process.exit()
+      }
+
+      await makeAction(options)
+    })
+
+  buddy
+    .command('make:model [name]', descriptions.model)
+    .option('-n, --name [name]', descriptions.name, { default: false })
+    .option('-p, --project [project]', descriptions.project, { default: false })
+    .option('--verbose', descriptions.verbose, { default: false })
+    .action(async (name, options: MakeOptions) => {
       log.debug('Running `buddy make:model` ...', options)
 
-      const name = buddy.args[0] || options.name
+      name = name ?? options.name
       options.name = name
 
       if (!name) {
@@ -266,13 +301,14 @@ export function make(buddy: CLI) {
     })
 
   buddy
-    .command('make:migration', descriptions.migration)
-    .option('-n, --name', 'The name of the migration')
-    .option('-e, --env', 'The environment to run the migration in', { default: 'dev' })
-    .action((options: MakeOptions) => {
+    .command('make:migration [name]', descriptions.migration)
+    .option('-n, --name [name]', descriptions.name, { default: false })
+    .option('-p, --project [project]', descriptions.project, { default: false })
+    .option('--verbose', descriptions.verbose, { default: false })
+    .action((name, options: MakeOptions) => {
       log.debug('Running `buddy make:migration` ...', options)
 
-      const name = buddy.args[0] || options.name
+      name = name ?? options.name
       options.name = name
 
       if (!name) {
@@ -280,7 +316,7 @@ export function make(buddy: CLI) {
         process.exit()
       }
 
-      log.info(path, name)
+      // log.info(path)
     })
 
   buddy
@@ -293,14 +329,14 @@ export function make(buddy: CLI) {
       const domain = await localUrl()
       log.info(`Creating SSL certificate...`)
 
-      await runCommand(`mkcert ${domain}`, {
+      await runCommand(`tlsx ${domain}`, {
         cwd: p.projectStoragePath('keys'),
       })
 
       log.success('Certificate created')
 
       log.info(`Installing SSL certificate...`)
-      await runCommand(`mkcert -install`, {
+      await runCommand(`tlsx -install`, {
         cwd: p.projectStoragePath('keys'),
       })
       log.success('Certificate installed')

package/src/commands/migrate.ts

@@ -1,9 +1,9 @@
 import process from 'node:process'
-import { ExitCode } from '@stacksjs/types'
-import type { CLI, MigrateOptions } from '@stacksjs/types'
 import { runAction } from '@stacksjs/actions'
 import { intro, log, outro } from '@stacksjs/cli'
 import { Action } from '@stacksjs/enums'
+import { ExitCode } from '@stacksjs/types'
+import type { CLI, MigrateOptions } from '@stacksjs/types'
 
 export function migrate(buddy: CLI) {
   const descriptions = {
@@ -15,28 +15,64 @@ export function migrate(buddy: CLI) {
 
   buddy
     .command('migrate', descriptions.migrate)
-    .option('-p, --project', descriptions.project, { default: false })
+    .option('-d, --diff', 'Show the SQL that would be run', { default: false })
+    .option('-p, --project [project]', descriptions.project, { default: false })
     .option('--verbose', descriptions.verbose, { default: false })
     .action(async (options: MigrateOptions) => {
       log.debug('Running `buddy migrate` ...', options)
 
       const perf = await intro('buddy migrate')
-      const result = await runAction(Action.Migrate, { ...options })
+      const result = await runAction(Action.Migrate, options)
 
       if (result.isErr()) {
-        await outro('While running the migrate command, there was an issue', { startTime: perf, useSeconds: true }, result.error)
+        await outro(
+          'While running the migrate command, there was an issue',
+          { startTime: perf, useSeconds: true },
+          result.error,
+        )
         process.exit()
       }
 
       const APP_ENV = process.env.APP_ENV || 'local'
 
-      await outro(`Migrated your ${APP_ENV} database.`, { startTime: perf, useSeconds: true })
+      await outro(`Migrated your ${APP_ENV} database.`, {
+        startTime: perf,
+        useSeconds: true,
+      })
+      process.exit(ExitCode.Success)
+    })
+
+  buddy
+    .command('migrate:fresh', descriptions.migrate)
+    .option('-d, --diff', 'Show the SQL that would be run', { default: false })
+    .option('-p, --project [project]', descriptions.project, { default: false })
+    .option('--verbose', descriptions.verbose, { default: false })
+    .action(async (options: MigrateOptions) => {
+      log.debug('Running `buddy migrate:fresh` ...', options)
+
+      const perf = await intro('buddy migrate:fresh')
+      const result = await runAction(Action.MigrateFresh, options)
+
+      if (result.isErr()) {
+        await outro(
+          'While running the migrate:fresh command, there was an issue',
+          { startTime: perf, useSeconds: true },
+          result.error,
+        )
+        process.exit()
+      }
+
+      await outro(`All tables dropped successfully`, {
+        startTime: perf,
+        useSeconds: true,
+      })
+
       process.exit(ExitCode.Success)
     })
 
   buddy
     .command('migrate:dns', descriptions.migrate)
-    .option('-p, --project', descriptions.project, { default: false })
+    .option('-p, --project [project]', descriptions.project, { default: false })
     .option('--verbose', descriptions.verbose, { default: false })
     .action(async (options: MigrateOptions) => {
       log.debug('Running `buddy migrate:dns` ...', options)
@@ -45,13 +81,20 @@ export function migrate(buddy: CLI) {
       const result = await runAction(Action.MigrateDns, { ...options })
 
       if (result.isErr()) {
-        await outro('While running the migrate:dns command, there was an issue', { startTime: perf, useSeconds: true }, result.error)
+        await outro(
+          'While running the migrate:dns command, there was an issue',
+          { startTime: perf, useSeconds: true },
+          result.error,
+        )
         process.exit()
       }
 
       const APP_URL = process.env.APP_URL || 'undefined'
 
-      await outro(`Migrated your ${APP_URL} DNS.`, { startTime: perf, useSeconds: true })
+      await outro(`Migrated your ${APP_URL} DNS.`, {
+        startTime: perf,
+        useSeconds: true,
+      })
       process.exit(ExitCode.Success)
     })