@stacksjs/buddy 0.58.48 → 0.58.49

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@stacksjs/buddy",
   "type": "module",
-  "version": "0.58.48",
+  "version": "0.58.49",
   "description": "Meet Buddy. The Stacks runtime.",
   "author": "Chris Breuer",
   "license": "MIT",
@@ -61,7 +61,8 @@
   },
   "files": [
     "README.md",
-    "dist"
+    "dist",
+    "src"
   ],
   "scripts": {
     "buddy": "bunx ./src/cli.ts",

package/src/cli.ts

@@ -0,0 +1,50 @@
+import process from 'node:process'
+import { handleError } from '@stacksjs/error-handling'
+import { cli } from '@stacksjs/cli'
+import { ensureProjectIsInitialized } from '@stacksjs/utils'
+import * as cmd from './commands'
+
+// setup global error handlers
+process.on('uncaughtException', handleError)
+process.on('unhandledRejection', handleError)
+
+async function main() {
+  const buddy = cli('buddy')
+
+  // the following commands are not dependent on the project being initialized
+  cmd.setup(buddy)
+  cmd.key(buddy)
+
+  // before running any commands, ensure the project is already initialized
+  await ensureProjectIsInitialized()
+
+  cmd.build(buddy)
+  cmd.changelog(buddy)
+  cmd.clean(buddy)
+  cmd.cloud(buddy)
+  // cmd.commit(buddy)
+  cmd.configure(buddy)
+  cmd.dev(buddy)
+  cmd.domains(buddy)
+  cmd.deploy(buddy)
+  cmd.dns(buddy)
+  cmd.fresh(buddy)
+  cmd.generate(buddy)
+  cmd.http(buddy)
+  cmd.install(buddy)
+  cmd.lint(buddy)
+  // cmd.make(buddy)
+  // cmd.migrate(buddy)
+  cmd.release(buddy)
+  // cmd.seed(buddy)
+  cmd.setup(buddy)
+  // cmd.example(buddy)
+  // cmd.test(buddy)
+  // cmd.version(buddy)
+  // cmd.prepublish(buddy)
+  cmd.upgrade(buddy)
+
+  buddy.parse()
+}
+
+await main()

package/src/commands/add.ts

@@ -0,0 +1,69 @@
+import process from 'node:process'
+import type { AddOptions, BuildOptions, CLI } from '@stacksjs/types'
+import { ExitCode } from '@stacksjs/types'
+import { runAdd } from '@stacksjs/actions'
+
+export function add(buddy: CLI) {
+  const descriptions = {
+    add: 'Add a stack to your project (coming soon)',
+    table: 'Add the Table Stack to your project',
+    calendar: 'Add the Calendar Stack to your project',
+    all: 'Add all stacks',
+    select: 'Which stack/s are you trying to add?',
+    project: 'Target a specific project',
+    verbose: 'Enable verbose output',
+  }
+
+  buddy
+    .command('add', descriptions.add)
+    .option('-t, --table', descriptions.table, { default: false })
+    .option('-c, --calendar', descriptions.calendar, { default: false })
+    .option('-a, --all', descriptions.all, { default: false })
+    .option('-p, --project', descriptions.project, { default: false })
+    .option('--verbose', descriptions.verbose, { default: false })
+    .action(async (options: BuildOptions) => {
+      if (hasNoOptions(options)) {
+        // const answers = await log.prompt(descriptions.select, {
+        //   type: 'multiselect',
+        //   options: [
+        //     { label: 'Calendar', value: 'calendar' },
+        //     { label: 'Table', value: 'table' },
+        //   ],
+        // })
+
+        // // creates an object out of array and sets answers to true
+        // options = answers.reduce((a: any, v: any) => ({ ...a, [v]: true }), {})
+      }
+
+      await runAdd(options)
+
+      process.exit(ExitCode.Success)
+    })
+
+  buddy
+    .command('add:table', descriptions.table)
+    .option('-t, --table', descriptions.table, { default: true })
+    .option('-p, --project', descriptions.project, { default: false })
+    .option('--verbose', descriptions.verbose, { default: false })
+    .action(async (options: BuildOptions) => {
+      await runAdd(options)
+    })
+
+  buddy
+    .command('add:calendar', descriptions.calendar)
+    .option('-t, --calendar', descriptions.calendar, { default: true })
+    .option('-p, --project', descriptions.project, { default: false })
+    .option('--verbose', descriptions.verbose, { default: false })
+    .action(async (options: BuildOptions) => {
+      await runAdd(options)
+    })
+
+  buddy.on('add:*', () => {
+    console.error('Invalid command: %s\nSee --help for a list of available commands.', buddy.args.join(' '))
+    process.exit(1)
+  })
+}
+
+function hasNoOptions(options: AddOptions) {
+  return !options.all && !options.table && !options.calendar
+}

package/src/commands/build.ts

@@ -0,0 +1,228 @@
+import process from 'node:process'
+import { runAction } from '@stacksjs/actions'
+import { intro, log, outro, prompt } from '@stacksjs/cli'
+import type { BuildOptions, CLI } from '@stacksjs/types'
+import { ExitCode } from '@stacksjs/types'
+import { Action } from '@stacksjs/enums'
+import { isString } from '@stacksjs/validation'
+
+export function build(buddy: CLI) {
+  const descriptions = {
+    build: 'Build any of your libraries (packages) for production use',
+    components: 'Build your component library',
+    vueComponents: 'Build your Vue component library',
+    webComponents: 'Build your framework agnostic web component library',
+    elements: 'An alias to the -w flag',
+    buddy: 'Build the Buddy binary',
+    functions: 'Build your function library',
+    desktop: 'Build the Desktop Application',
+    pages: 'Build your frontend',
+    docs: 'Build your documentation',
+    framework: 'Build Stacks framework',
+    select: 'What are you trying to build?',
+    project: 'Target a specific project',
+    verbose: 'Enable verbose output',
+  }
+
+  buddy
+    .command('build [type]', descriptions.build)
+    .option('-c, --components', descriptions.components)
+    .option('-v, --vue-components', descriptions.vueComponents) // these are automatically built with your -c option as well
+    .option('-w, --web-components', descriptions.webComponents) // these are automatically built with your -c option as well
+    .option('-e, --elements', descriptions.elements)
+    .option('-f, --functions', descriptions.functions)
+    .option('-p, --views', descriptions.pages)
+    .option('-d, --docs', descriptions.docs)
+    .option('-b, --buddy', descriptions.buddy, { default: false })
+    .option('-s, --stacks', descriptions.framework, { default: false })
+    .option('-p, --project', descriptions.project, { default: false })
+    .option('--verbose', descriptions.verbose, { default: false })
+    .action(async (server: string | undefined, options: BuildOptions) => {
+      switch (server) {
+        case 'components':
+          options.components = true
+          break
+        case 'vue':
+          options.vueComponents = true
+          break
+        case 'web-components':
+          options.webComponents = true
+          break
+        case 'functions':
+          options.functions = true
+          break
+        case 'views':
+          options.views = true
+          break
+        case 'docs':
+          options.docs = true
+          break
+        case 'buddy':
+          options.buddy = true
+          break
+        case 'cli':
+          options.buddy = true
+          break
+        case 'stacks':
+          options.stacks = true
+          break
+        default:
+          break
+      }
+
+      if (hasNoOptions(options)) {
+        let answers = await prompt.require()
+          .multiselect(descriptions.select, {
+            options: [
+              { label: 'Components', value: 'components' },
+              // { label: 'Vue Components', value: 'vue-components' },
+              { label: 'Web Components', value: 'web-components' },
+              { label: 'Functions', value: 'functions' },
+              { label: 'Views', value: 'views' },
+              { label: 'Documentation', value: 'docs' },
+            ],
+          })
+
+        if (answers !== null)
+          process.exit(ExitCode.InvalidArgument)
+
+        if (isString(answers))
+          answers = [answers]
+
+        // creates an object out of array and sets answers to true
+        options = answers.reduce((a: any, v: any) => ({ ...a, [v]: true }), {})
+      }
+
+      await runAction(Action.BuildStacks, options)
+
+      process.exit(ExitCode.Success)
+    })
+
+  buddy
+    .command('build:components', 'Automagically build component libraries for production use & npm/CDN distribution')
+    .alias('prod:components')
+    .option('-c, --components', descriptions.components, { default: true })
+    .option('-p, --project', descriptions.project, { default: false })
+    .option('--verbose', descriptions.verbose, { default: false })
+    .action(async (options: BuildOptions) => {
+      await runAction(Action.BuildComponentLibs, options)
+    })
+
+  buddy
+    .command('build:cli', 'Automagically build the CLI')
+    .alias('prod:cli')
+    .option('-b, --buddy', descriptions.buddy, { default: true })
+    .option('-p, --project', descriptions.project, { default: false })
+    .option('--verbose', descriptions.verbose, { default: false })
+    .action(async (options: BuildOptions) => {
+      await runAction(Action.BuildCli, options)
+    })
+
+  buddy
+    .command('build:functions', 'Automagically build function library for npm/CDN distribution')
+    .option('-f, --functions', descriptions.functions, { default: true })
+    .option('-p, --project', descriptions.project, { default: false })
+    .option('--verbose', descriptions.verbose, { default: false })
+    .action(async (options: BuildOptions) => {
+      await runAction(Action.BuildFunctionLib, options)
+    })
+
+  buddy
+    .command('build:vue-components', 'Automagically build Vue component library for npm/CDN distribution')
+    .alias('build:vue')
+    .alias('prod:vue-components')
+    .alias('prod:vue')
+    .option('-v, --vue-components', descriptions.vueComponents, { default: true })
+    .option('-p, --project', descriptions.project, { default: false })
+    .option('--verbose', descriptions.verbose, { default: false })
+    .alias('build:vue')
+    .action(async (options: BuildOptions) => {
+      await runAction(Action.BuildVueComponentLib, options)
+    })
+
+  buddy
+    .command('build:web-components', 'Automagically build Web Component library for npm/CDN distribution')
+    .alias('build:wc')
+    .alias('prod:web-components')
+    .alias('prod:wc')
+    .option('-w, --web-components', descriptions.webComponents, { default: true })
+    .option('-p, --project', descriptions.project, { default: false })
+    .option('--verbose', descriptions.verbose, { default: false })
+    .action(async (options: BuildOptions) => {
+      await runAction(Action.BuildWebComponentLib, options)
+    })
+
+  buddy
+    .command('build:docs', 'Automagically build your documentation site.')
+    .alias('prod:docs')
+    .alias('build:documentation')
+    .alias('prod:documentation')
+    .option('-d, --docs', descriptions.docs, { default: true })
+    .option('-p, --project', descriptions.project, { default: false })
+    .option('--verbose', descriptions.verbose, { default: false })
+    .action(async (options: BuildOptions) => {
+      await runAction(Action.BuildDocs, options)
+    })
+
+  buddy
+    .command('build:core', 'Automagically build the Stacks core.')
+    .option('-p, --project', descriptions.project, { default: false })
+    .option('--verbose', descriptions.verbose, { default: false })
+    .action(async (options: BuildOptions) => {
+      const startTime = await intro('buddy build:core')
+      const result = await runAction(Action.BuildCore, options)
+
+      if (result.isErr()) {
+        log.error('Failed to build the Stacks core.', result.error)
+        process.exit()
+      }
+
+      await outro('Core packages built successfully', { startTime, useSeconds: true })
+    })
+
+  buddy
+    .command('build:desktop', descriptions.desktop)
+    .alias('prod:desktop')
+    .option('-p, --project', descriptions.project, { default: false })
+    .option('--verbose', descriptions.verbose, { default: false })
+    .action(async (options: BuildOptions) => {
+      const perf = await intro('buddy build:desktop')
+      const result = await runAction(Action.BuildDesktop, options)
+
+      if (result.isErr()) {
+        await outro('While running the build:desktop command, there was an issue', { startTime: perf, useSeconds: true }, result.error)
+        process.exit()
+      }
+
+      // eslint-disable-next-line no-console
+      console.log('')
+      await outro('Exited', { startTime: perf, useSeconds: true })
+      process.exit(ExitCode.Success)
+    })
+
+  buddy
+    .command('build:stacks', 'Build the Stacks framework.')
+    .option('-s, --stacks', descriptions.framework, { default: true })
+    .option('-p, --project', descriptions.project, { default: false })
+    .option('--verbose', descriptions.verbose, { default: false })
+    .action(async (options: BuildOptions) => {
+      const startTime = await intro('buddy build:stacks')
+      const result = await runAction(Action.BuildStacks, options)
+
+      if (result.isErr()) {
+        log.error('Failed to build Stacks.', result.error)
+        process.exit()
+      }
+
+      await outro('Stacks built successfully', { startTime, useSeconds: true })
+    })
+
+  buddy.on('build:*', () => {
+    console.error('Invalid command: %s\nSee --help for a list of available commands.', buddy.args.join(' '))
+    process.exit(1)
+  })
+}
+
+function hasNoOptions(options: BuildOptions) {
+  return !options.components && !options.vueComponents && !options.webComponents && !options.elements && !options.functions && !options.views && !options.docs && !options.stacks && !options.buddy
+}

package/src/commands/changelog.ts

@@ -0,0 +1,38 @@
+import process from 'node:process'
+import type { CLI, FreshOptions } from '@stacksjs/types'
+import { ExitCode } from '@stacksjs/types'
+import { runAction } from '@stacksjs/actions'
+import { intro, outro } from '@stacksjs/cli'
+import { Action } from '@stacksjs/enums'
+
+export function changelog(buddy: CLI) {
+  const descriptions = {
+    changelog: 'Create a CHANGELOG.md file',
+    quiet: 'Minimal output',
+    project: 'Target a specific project',
+    verbose: 'Enable verbose output',
+  }
+
+  buddy
+    .command('changelog', descriptions.changelog)
+    .option('--quiet', descriptions.quiet, { default: false })
+    .option('-p, --project', descriptions.project, { default: false })
+    .option('--verbose', descriptions.verbose, { default: false })
+    .action(async (options: FreshOptions) => {
+      const perf = await intro('buddy changelog')
+      const result = await runAction(Action.Changelog, options)
+
+      if (result.isErr()) {
+        await outro('While running the changelog command, there was an issue', { ...options, startTime: perf, useSeconds: true }, result.error)
+        process.exit()
+      }
+
+      await outro('Generated the CHANGELOG.md file', { ...options, startTime: perf, useSeconds: true, type: 'info' })
+      process.exit(ExitCode.Success)
+    })
+
+  buddy.on('changelog:*', () => {
+    console.error('Invalid command: %s\nSee --help for a list of available commands.', buddy.args.join(' '))
+    process.exit(1)
+  })
+}

package/src/commands/clean.ts

@@ -0,0 +1,36 @@
+import process from 'node:process'
+import { ExitCode } from '@stacksjs/types'
+import type { CLI, CleanOptions } from '@stacksjs/types'
+import { runAction } from '@stacksjs/actions'
+import { intro, outro } from '@stacksjs/cli'
+import { Action } from '@stacksjs/enums'
+
+export function clean(buddy: CLI) {
+  const descriptions = {
+    clean: 'Removes all node_modules & lock files',
+    project: 'Target a specific project',
+    verbose: 'Enable verbose output',
+  }
+
+  buddy
+    .command('clean', descriptions.clean)
+    .option('-p, --project', descriptions.project, { default: false })
+    .option('--verbose', descriptions.verbose, { default: false })
+    .action(async (options: CleanOptions) => {
+      const perf = await intro('buddy clean')
+      const result = await runAction(Action.Clean, options)
+
+      if (result.isErr()) {
+        await outro('While running the clean command, there was an issue', { startTime: perf, useSeconds: true }, result.error)
+        process.exit(ExitCode.FatalError)
+      }
+
+      await outro('Cleaned up', { startTime: perf, useSeconds: true, message: 'Cleaned up' })
+      process.exit(ExitCode.Success)
+    })
+
+  buddy.on('clean:*', () => {
+    console.error('Invalid command: %s\nSee --help for a list of available commands.', buddy.args.join(' '))
+    process.exit(1)
+  })
+}