stacks 0.50.0 → 0.52.0

package/core/buddy/package.json

@@ -0,0 +1,127 @@
+{
+  "name": "@stacksjs/buddy",
+  "type": "module",
+  "version": "0.52.0",
+  "packageManager": "pnpm@8.5.1",
+  "description": "Meet Buddy. The Stacks runtime.",
+  "author": "Chris Breuer",
+  "license": "MIT",
+  "funding": "https://github.com/sponsors/chrisbbreuer",
+  "homepage": "https://github.com/stacksjs/stacks/tree/main/.stacks#readme",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/stacksjs/stacks.git",
+    "directory": "./.stacks/core/buddy"
+  },
+  "bugs": {
+    "url": "https://github.com/stacksjs/stacks/issues"
+  },
+  "keywords": [
+    "stacks",
+    "buddy",
+    "runtime",
+    "vite",
+    "component",
+    "composables",
+    "functions",
+    "headless",
+    "api",
+    "ssg",
+    "pwa",
+    "modern",
+    "library",
+    "vue",
+    "web components",
+    "typescript",
+    "javascript",
+    "starter kit"
+  ],
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.mjs"
+    },
+    "./cli": {
+      "types": "./dist/cli.d.ts",
+      "import": "./dist/cli.mjs"
+    }
+  },
+  "module": "dist/index.mjs",
+  "types": "dist/index.d.ts",
+  "contributors": [
+    "Chris Breuer <chris@ow3.org>"
+  ],
+  "bin": {
+    "stacks": "dist/cli.mjs",
+    "stx": "dist/cli.mjs",
+    "buddy": "dist/cli.mjs",
+    "bud": "dist/cli.mjs"
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "scripts": {
+    "buddy": "tsx ./src/cli.ts",
+    "preinstall": "npx only-allow pnpm",
+    "build": "unbuild",
+    "dev": "unbuild --stub",
+    "prepublishOnly": "pnpm buddy prepublish",
+    "typecheck": "tsc --noEmit"
+  },
+  "peerDependencies": {
+    "@stacksjs/actions": "workspace:*",
+    "@stacksjs/ai": "workspace:*",
+    "@stacksjs/alias": "workspace:*",
+    "@stacksjs/arrays": "workspace:*",
+    "@stacksjs/auth": "workspace:*",
+    "@stacksjs/build": "workspace:*",
+    "@stacksjs/cache": "workspace:*",
+    "@stacksjs/cli": "workspace:*",
+    "@stacksjs/cloud": "workspace:*",
+    "@stacksjs/collections": "workspace:*",
+    "@stacksjs/config": "workspace:*",
+    "@stacksjs/database": "workspace:*",
+    "@stacksjs/desktop": "workspace:*",
+    "@stacksjs/development": "workspace:*",
+    "@stacksjs/docs": "workspace:*",
+    "@stacksjs/domains": "workspace:*",
+    "@stacksjs/email": "workspace:*",
+    "@stacksjs/error-handling": "workspace:*",
+    "@stacksjs/events": "workspace:*",
+    "@stacksjs/faker": "workspace:*",
+    "@stacksjs/git": "workspace:*",
+    "@stacksjs/health": "workspace:*",
+    "@stacksjs/lint": "workspace:*",
+    "@stacksjs/logging": "workspace:*",
+    "@stacksjs/modules": "workspace:*",
+    "@stacksjs/notifications": "workspace:*",
+    "@stacksjs/objects": "workspace:*",
+    "@stacksjs/orm": "workspace:*",
+    "@stacksjs/pages": "workspace:*",
+    "@stacksjs/path": "workspace:*",
+    "@stacksjs/payments": "workspace:*",
+    "@stacksjs/realtime": "workspace:*",
+    "@stacksjs/router": "workspace:*",
+    "@stacksjs/search-engine": "workspace:*",
+    "@stacksjs/security": "workspace:*",
+    "@stacksjs/server": "workspace:*",
+    "@stacksjs/signals": "workspace:*",
+    "@stacksjs/storage": "workspace:*",
+    "@stacksjs/strings": "workspace:*",
+    "@stacksjs/testing": "workspace:*",
+    "@stacksjs/types": "workspace:*",
+    "@stacksjs/ui": "workspace:*",
+    "@stacksjs/utils": "workspace:*",
+    "@stacksjs/validation": "workspace:*"
+  },
+  "devDependencies": {
+    "@stacksjs/development": "workspace:*"
+  },
+  "config": {
+    "commitizen": {
+      "path": "node_modules/cz-git"
+    }
+  },
+  "web-types": "./web-types.json"
+}

package/core/buddy/src/cli.ts

@@ -0,0 +1,96 @@
+#!/usr/bin/env node
+import { runAction } from '@stacksjs/actions'
+import { command, execSync, log, runCommand } from '@stacksjs/cli'
+import { env, frameworkVersion, isProjectCreated, parseYaml, semver } from '@stacksjs/utils'
+import { projectPath } from '@stacksjs/path'
+import { Action } from '@stacksjs/types'
+import { filesystem } from '@stacksjs/storage'
+import { build, changelog, clean, commit, create, dev, example, fresh, generate, key, lint, make, migrate, preinstall, prepublish, release, seed, setup, test, upgrade, version } from './commands'
+
+const cli = command('buddy')
+const { fs } = filesystem
+
+// setup global error handlers
+process.on('uncaughtException', errorHandler)
+process.on('unhandledRejection', errorHandler)
+
+async function main() {
+  // the following commands are not dependent on the project being initialized
+  installIfVersionMismatch()
+  await setup(cli)
+  await key(cli)
+
+  // before running any commands, check if the project is already initialized
+  if (!await isProjectCreated()) {
+    if (env('APP_ENV') !== 'production') {
+      log.info('Project not yet initialized, generating application key...')
+    }
+    else {
+      log.error('Please run `buddy key:generate` to generate an application key.')
+      process.exit()
+    }
+
+    const result = await runAction(Action.KeyGenerate, { cwd: projectPath() })
+
+    if (result.isErr()) {
+      log.error(result.error)
+      process.exit()
+    }
+
+    log.info('Application key generated.')
+
+    await create(cli)
+  }
+
+  await preinstall(cli)
+  await prepublish(cli)
+  await upgrade(cli)
+  await generate(cli)
+  await dev(cli)
+  await build(cli)
+  await changelog(cli)
+  await clean(cli)
+  await commit(cli)
+  await fresh(cli)
+  await lint(cli)
+  await release(cli)
+  await make(cli)
+  await migrate(cli)
+  await seed(cli)
+  await example(cli)
+  await test(cli)
+  await version(cli)
+
+  cli.help()
+  cli.version(await frameworkVersion())
+
+  cli.parse()
+}
+
+main()
+
+async function installIfVersionMismatch() {
+  const dependenciesYaml = fs.readFileSync(projectPath('tea.yaml'), 'utf8')
+  const dependencies = parseYaml(dependenciesYaml).dependencies
+
+  const requiredNodeVersion = dependencies['nodejs.org']
+  const requiredPnpmVersion = dependencies['pnpm.io']
+
+  const installedNodeVersion = process.version
+  const installedPnpmVersion = execSync('pnpm -v').trim()
+
+  if (!semver.satisfies(installedNodeVersion, requiredNodeVersion)) {
+    log.error(`Installed Node.js version (${installedNodeVersion}) does not satisfy required version (${requiredNodeVersion}). Installing...`)
+    await runCommand(`tea +nodejs.org${requiredNodeVersion} >/dev/null 2>&1`)
+  }
+
+  if (!semver.satisfies(installedPnpmVersion, requiredPnpmVersion)) {
+    log.error(`Installed pnpm version (${installedPnpmVersion}) does not satisfy required version (${requiredPnpmVersion}). Installing...`)
+    await runCommand(`tea +pnpm.io${requiredPnpmVersion} >/dev/null 2>&1`)
+  }
+}
+
+function errorHandler(error: Error): void {
+  log.error(error)
+  process.exit(1)
+}

package/{buddy → core/buddy}/src/commands/add.ts

@@ -1,6 +1,6 @@
 import type { AddOptions, BuildOptions, CLI } from '@stacksjs/types'
 import { ExitCode } from '@stacksjs/types'
-import { prompts } from '@stacksjs/cli'
+import { prompt } from '@stacksjs/cli'
 import { invoke } from '@stacksjs/actions/add'
 
 async function add(buddy: CLI) {
@@ -9,7 +9,8 @@ async function add(buddy: CLI) {
     table: 'Add the Table Stack to your project',
     calendar: 'Add the Calendar Stack to your project',
     all: 'Add all stacks',
-    debug: 'Enable debug mode',
+    select: 'Which stack/s are you trying to add?',
+    verbose: 'Enable verbose output',
   }
 
   buddy
@@ -17,16 +18,14 @@ async function add(buddy: CLI) {
     .option('-t, --table', descriptions.table, { default: false })
     .option('-c, --calendar', descriptions.calendar, { default: false })
     .option('-a, --all', descriptions.all, { default: false })
-    .option('--debug', descriptions.debug, { default: false })
+    .option('--verbose', descriptions.verbose, { default: false })
     .action(async (options: BuildOptions) => {
       if (hasNoOptions(options)) {
-        const answers = await prompts.multiselect({
+        const answers = await prompt(descriptions.select, {
           type: 'multiselect',
-          name: 'add',
-          message: 'Which stack/s are you trying to add?',
-          choices: [
-            { title: 'Calendar', value: 'calendar' },
-            { title: 'Table', value: 'table' },
+          options: [
+            { label: 'Calendar', value: 'calendar' },
+            { label: 'Table', value: 'table' },
           ],
         })
 
@@ -42,7 +41,7 @@ async function add(buddy: CLI) {
   buddy
     .command('add:table', descriptions.table)
     .option('-t, --table', descriptions.table, { default: true })
-    .option('--debug', descriptions.debug, { default: false })
+    .option('--verbose', descriptions.verbose, { default: false })
     .action(async (options: BuildOptions) => {
       await invoke(options)
     })
@@ -50,7 +49,7 @@ async function add(buddy: CLI) {
   buddy
     .command('add:calendar', descriptions.calendar)
     .option('-t, --calendar', descriptions.calendar, { default: true })
-    .option('--debug', descriptions.debug, { default: false })
+    .option('--verbose', descriptions.verbose, { default: false })
     .action(async (options: BuildOptions) => {
       await invoke(options)
     })

package/{buddy → core/buddy}/src/commands/build.ts

@@ -1,6 +1,6 @@
 import type { BuildOptions, CLI } from '@stacksjs/types'
 import { Action, ExitCode } from '@stacksjs/types'
-import { intro, log, outro, prompts } from '@stacksjs/cli'
+import { intro, outro, prompt } from '@stacksjs/cli'
 import { runAction } from '@stacksjs/actions'
 
 async function build(buddy: CLI) {
@@ -13,7 +13,8 @@ async function build(buddy: CLI) {
     pages: 'Build your SSG pages',
     docs: 'Build your documentation site',
     stacks: 'Build Stacks framework',
-    debug: 'Enable debug mode',
+    select: 'What are you trying to build?',
+    verbose: 'Enable verbose output',
   }
 
   buddy
@@ -26,20 +27,19 @@ async function build(buddy: CLI) {
     .option('-p, --pages', descriptions.pages)
     .option('-d, --docs', descriptions.docs)
     .option('-s, --stacks', descriptions.stacks, { default: false })
-    .option('--debug', descriptions.debug, { default: false })
+    .option('--verbose', descriptions.verbose, { default: false })
     .action(async (options: BuildOptions) => {
       if (hasNoOptions(options)) {
-        const answers = await prompts.multiselect({
+        const answers = await prompt(descriptions.select, {
           type: 'multiselect',
-          name: 'update',
-          message: 'What are you trying to build?',
-          choices: [
-            { title: 'Components', value: 'components' },
-            { title: 'Vue Components', value: 'vue-components' },
-            { title: 'Web Components', value: 'web-components' },
-            { title: 'Functions', value: 'functions' },
-            { title: 'Pages', value: 'pages' },
-            { title: 'Documentation', value: 'docs' },
+          required: true,
+          options: [
+            { label: 'Components', value: 'components' },
+            // { label: 'Vue Components', value: 'vue-components' },
+            // { label: 'Web Components', value: 'web-components' },
+            { label: 'Functions', value: 'functions' },
+            { label: 'Pages', value: 'pages' },
+            { label: 'Documentation', value: 'docs' },
           ],
         })
 
@@ -55,7 +55,7 @@ async function build(buddy: CLI) {
   buddy
     .command('build:components', 'Automagically build component libraries for production use & npm/CDN distribution')
     .option('-c, --components', descriptions.components, { default: true })
-    .option('--debug', descriptions.debug, { default: false })
+    .option('--verbose', descriptions.verbose, { default: false })
     .action(async (options: BuildOptions) => {
       await runAction(Action.BuildComponentLibs, options)
     })
@@ -63,7 +63,7 @@ async function build(buddy: CLI) {
   buddy
     .command('build:cli', 'Automagically build the CLI')
     .option('-c, --components', descriptions.components, { default: true })
-    .option('--debug', descriptions.debug, { default: false })
+    .option('--verbose', descriptions.verbose, { default: false })
     .action(async (options: BuildOptions) => {
       await runAction(Action.BuildCli, options)
     })
@@ -71,7 +71,7 @@ async function build(buddy: CLI) {
   buddy
     .command('build:functions', 'Automagically build function library for npm/CDN distribution')
     .option('-f, --functions', descriptions.functions, { default: true })
-    .option('--debug', descriptions.debug, { default: false })
+    .option('--verbose', descriptions.verbose, { default: false })
     .action(async (options: BuildOptions) => {
       await runAction(Action.BuildFunctionLib, options)
     })
@@ -79,7 +79,7 @@ async function build(buddy: CLI) {
   buddy
     .command('build:vue-components', 'Automagically build Vue component library for npm/CDN distribution')
     .option('-v, --vue-components', descriptions.vueComponents, { default: true })
-    .option('--debug', descriptions.debug, { default: false })
+    .option('--verbose', descriptions.verbose, { default: false })
     .alias('build:vue')
     .action(async (options: BuildOptions) => {
       await runAction(Action.BuildVueComponentLib, options)
@@ -88,7 +88,7 @@ async function build(buddy: CLI) {
   buddy
     .command('build:web-components', 'Automagically build Web Component library for npm/CDN distribution')
     .option('-w, --web-components', descriptions.webComponents, { default: true })
-    .option('--debug', descriptions.debug, { default: false })
+    .option('--verbose', descriptions.verbose, { default: false })
     .alias('build:elements')
     .alias('build:wc')
     .action(async (options: BuildOptions) => {
@@ -98,22 +98,24 @@ async function build(buddy: CLI) {
   buddy
     .command('build:docs', 'Automagically build your documentation site.')
     .option('-d, --docs', descriptions.docs, { default: true })
-    .option('--debug', descriptions.debug, { 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('--debug', descriptions.debug, { default: true })
+    .option('--verbose', descriptions.verbose, { default: true })
     .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()
-      }
+      console.log('result', result)
+
+      // if (result.isErr()) {
+      //   log.error('Failed to build the Stacks core.', result.error)
+      //   process.exit()
+      // }
 
       outro('Stacks core built successfully', { startTime, useSeconds: true })
     })
@@ -121,15 +123,16 @@ async function build(buddy: CLI) {
   buddy
     .command('build:stacks', 'Build the Stacks framework.')
     .option('-s, --stacks', descriptions.stacks, { default: true })
-    .option('--debug', descriptions.debug, { 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)
+      console.log('result', result)
 
-      if (result.isErr()) {
-        log.error('Failed to build Stacks.', result.error)
-        process.exit()
-      }
+      // if (result.isErr()) {
+      //   log.error('Failed to build Stacks.', result.error)
+      //   process.exit()
+      // }
 
       outro('Stacks built successfully', { startTime, useSeconds: true })
     })

package/{buddy → core/buddy}/src/commands/changelog.ts

@@ -6,20 +6,21 @@ import { Action, ExitCode } from '@stacksjs/types'
 async function changelog(buddy: CLI) {
   const descriptions = {
     changelog: 'Create a CHANGELOG.md file',
-    debug: 'Enable debug mode',
+    verbose: 'Enable verbose output',
   }
 
   buddy
     .command('changelog', descriptions.changelog)
-    .option('--debug', descriptions.debug, { 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)
+      console.log('result', result)
 
-      if (result.isErr()) {
-        outro('While running the changelog command, there was an issue', { startTime: perf, useSeconds: true, isError: true }, result.error)
-        process.exit()
-      }
+      // if (result.isErr()) {
+      //   outro('While running the changelog command, there was an issue', { startTime: perf, useSeconds: true, isError: true }, result.error)
+      //   process.exit()
+      // }
 
       outro('Generated the CHANGELOG.md file.', { startTime: perf, useSeconds: true })
       process.exit(ExitCode.Success)

package/core/buddy/src/commands/clean.ts

@@ -0,0 +1,30 @@
+import type { CLI, CleanOptions } from '@stacksjs/types'
+import { runAction } from '@stacksjs/actions'
+import { intro, outro } from '@stacksjs/cli'
+import { Action, ExitCode } from '@stacksjs/types'
+
+async function clean(buddy: CLI) {
+  const descriptions = {
+    clean: 'Removes all node_modules & lock files',
+    verbose: 'Enable verbose output',
+  }
+
+  buddy
+    .command('clean', descriptions.clean)
+    .option('--verbose', descriptions.verbose, { default: false })
+    .action(async (options: CleanOptions) => {
+      //  { shell: true, verbose: true }
+      const perf = await intro('buddy clean')
+      const result = await runAction(Action.Fresh, { verbose: true })
+
+      if (result.isErr()) {
+        outro('While running the clean command, there was an issue', { startTime: perf, useSeconds: true, isError: true }, result.error as Error)
+        process.exit(ExitCode.FatalError)
+      }
+
+      outro('Cleaned project.', { startTime: perf, useSeconds: true })
+      process.exit(ExitCode.Success)
+    })
+}
+
+export { clean }

package/{buddy → core/buddy}/src/commands/commit.ts

@@ -4,12 +4,12 @@ import { invoke } from '@stacksjs/actions/commit'
 async function commit(buddy: CLI) {
   const descriptions = {
     commit: 'Commit your stashed changes',
-    debug: 'Enable debug mode',
+    verbose: 'Enable verbose output',
   }
 
   buddy
     .command('commit', descriptions.commit)
-    .option('--debug', descriptions.debug, { default: false })
+    .option('--verbose', descriptions.verbose, { default: false })
     .action(async (options: FreshOptions) => {
       await invoke(options)
     })

package/{buddy → core/buddy}/src/commands/create.ts

@@ -1,5 +1,5 @@
 import type { CLI, CreateOptions } from '@stacksjs/types'
-import { bold, cyan, green, intro, link, log, runCommand } from '@stacksjs/cli'
+import { bold, cyan, green, intro, log, runCommand } from '@stacksjs/cli'
 import { useOnline } from '@stacksjs/utils'
 import { isFolder } from '@stacksjs/storage'
 import { resolve } from '@stacksjs/path'
@@ -17,7 +17,7 @@ async function create(buddy: CLI) {
     functions: 'Are you developing functions/composables?',
     api: 'Are you building an API?',
     database: 'Do you need a database?',
-    debug: 'Enable debug mode',
+    verbose: 'Enable verbose output',
   }
 
   buddy
@@ -30,7 +30,7 @@ async function create(buddy: CLI) {
     .option('-f, --functions', descriptions.functions, { default: true }) // if no, API would be false
     .option('-a, --api', descriptions.api, { default: true }) // APIs need an HTTP server & assumes functions is true
     .option('-d, --database', descriptions.database, { default: true })
-    .option('--debug', descriptions.debug, { default: false })
+    .option('--verbose', descriptions.verbose, { default: false })
     // .option('--auth', 'Scaffold an authentication?', { default: true })
     .action(async (options: CreateOptions) => {
       const startTime = await intro('stacks new')
@@ -50,7 +50,7 @@ async function create(buddy: CLI) {
       await install(path, options)
 
       // a custom outro
-      console.log()
+      // console.log()
 
       if (startTime) {
         const time = performance.now() - startTime
@@ -58,8 +58,8 @@ async function create(buddy: CLI) {
       }
 
       log.info(bold('Welcome to the Stacks Framework! ⚛️'))
-      console.log(`cd ${link(path, `vscode://file/${path}:1`)} && code .`)
-      console.log()
+      // console.log(`cd ${link(path, `vscode://file/${path}:1`)} && code .`)
+      // console.log()
       log.info('To learn more, visit https://stacksjs.dev')
 
       process.exit(ExitCode.Success)

package/core/buddy/src/commands/deploy.ts

@@ -0,0 +1,30 @@
+import type { CLI, DeployOptions } from '@stacksjs/types'
+import { runAction } from '@stacksjs/actions'
+import { intro, outro } from '@stacksjs/cli'
+import { Action, ExitCode } from '@stacksjs/types'
+
+async function deploy(buddy: CLI) {
+  const descriptions = {
+    deploy: 'Reinstalls your npm dependencies',
+    verbose: 'Enable verbose output',
+  }
+
+  buddy
+    .command('deploy', descriptions.deploy)
+    .option('--verbose', descriptions.verbose, { default: false })
+    .action(async (options: DeployOptions) => {
+      const perf = await intro('buddy deploy')
+      const result = await runAction(Action.Deploy, options)
+      console.log('result', result)
+
+      // if (result.isErr()) {
+      //   outro('While running the `buddy deploy`, there was an issue', { startTime: perf, useSeconds: true, isError: true }, result.error)
+      //   process.exit()
+      // }
+
+      outro('Deployment succeeded.', { startTime: perf, useSeconds: true })
+      process.exit(ExitCode.Success)
+    })
+}
+
+export { deploy }