stacks 0.46.4 → 0.47.0

package/.gitignore

@@ -10,3 +10,7 @@ core/build/entries/*.ts
 **/dist/**/*.d.ts
 **/dist/**/*.d.cts
 **/dist/**/*.d.mts
+node_modules/
+/test-results/
+/playwright-report/
+/playwright/.cache/

package/README.md

@@ -50,6 +50,7 @@ _Develop serverless (or server) functions with countless helpers to build scalab
 - ⚙️ **CLIs** _create beautiful CLIs for Linux, Windows, and Mac—without requirements_
 - 📀 **Database** _MySQL, Postgres, PlanetScale, Supabase, Prisma, ..._
 - 👾 **Errors** _native type-safe error handling_
+- 🗓️ **Events** _functional event (front & backend) communication_
 - 📢 **Notifications** _emails, SMSs, direct, and push notifications & webhooks_
 - 💳 **Payments** _unified API for one-off & subscription billing methods for Stripe_
 - ⚙️ **Queues** _run your heavy workload in the background_
@@ -114,7 +115,7 @@ npx stacks new my-project
 ```
 
 > **Note**
-> pnpm 7.18 or higher required. _Run the setup script & 🐶 Buddy will set you up. He barks otherwise._
+> pnpm 7.20 or higher required. _Run the setup script & 🐶 Buddy will set you up. He barks otherwise._
 
 ## 🤖 Usage
 

package/buddy/README.md

@@ -50,6 +50,7 @@ _Develop serverless (or server) functions with countless helpers to build scalab
 - ⚙️ **CLIs** _create beautiful CLIs for Linux, Windows, and Mac—without requirements_
 - 📀 **Database** _MySQL, Postgres, PlanetScale, Supabase, Prisma, ..._
 - 👾 **Errors** _native type-safe error handling_
+- 🗓️ **Events** _functional event (front & backend) communication_
 - 📢 **Notifications** _emails, SMSs, direct, and push notifications & webhooks_
 - 💳 **Payments** _unified API for one-off & subscription billing methods for Stripe_
 - ⚙️ **Queues** _run your heavy workload in the background_
@@ -114,7 +115,7 @@ npx stacks new my-project
 ```
 
 > **Note**
-> pnpm 7.18 or higher required. _Run the setup script & 🐶 Buddy will set you up. He barks otherwise._
+> pnpm 7.20 or higher required. _Run the setup script & 🐶 Buddy will set you up. He barks otherwise._
 
 ## 🤖 Usage
 

package/buddy/package.json

@@ -1,8 +1,8 @@
 {
   "name": "@stacksjs/buddy",
   "type": "module",
-  "version": "0.46.4",
-  "packageManager": "pnpm@7.19.0",
+  "version": "0.47.0",
+  "packageManager": "pnpm@7.20.0",
   "description": "Meet Buddy. The Stacks runtime.",
   "author": "Chris Breuer",
   "license": "MIT",
@@ -51,7 +51,7 @@
   ],
   "engines": {
     "node": ">=v18.12.1",
-    "pnpm": ">=7.19.0"
+    "pnpm": ">=7.20.0"
   },
   "scripts": {
     "buddy": "esno ./src/cli.ts",
@@ -144,23 +144,33 @@
   },
   "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/docs": "workspace:*",
     "@stacksjs/domains": "workspace:*",
+    "@stacksjs/email": "workspace:*",
     "@stacksjs/error-handling": "workspace:*",
+    "@stacksjs/events": "workspace:*",
     "@stacksjs/git": "workspace:*",
+    "@stacksjs/health": "workspace:*",
     "@stacksjs/lint": "workspace:*",
     "@stacksjs/logging": "workspace:*",
     "@stacksjs/modules": "workspace:*",
+    "@stacksjs/notifications": "workspace:*",
     "@stacksjs/objects": "workspace:*",
     "@stacksjs/path": "workspace:*",
+    "@stacksjs/payments": "workspace:*",
+    "@stacksjs/realtime": "workspace:*",
     "@stacksjs/router": "workspace:*",
+    "@stacksjs/search-engine": "workspace:*",
     "@stacksjs/security": "workspace:*",
     "@stacksjs/server": "workspace:*",
     "@stacksjs/storage": "workspace:*",
@@ -172,7 +182,6 @@
   },
   "devDependencies": {
     "only-allow": "^1.1.1",
-    "pnpm": ">=7.19.0",
     "typescript": "^4.9.4",
     "unbuild": "^1.0.2"
   },

package/buddy/src/cli.ts

@@ -1,7 +1,10 @@
 #!/usr/bin/env node
+import { runAction } from '@stacksjs/actions'
 import { command, log } from '@stacksjs/cli'
-import { isProjectCreated } from '@stacksjs/utils'
-import { version } from '../package.json' assert { type: 'json' }
+import { env, isProjectCreated } from '@stacksjs/utils'
+import { projectPath } from '@stacksjs/path'
+import { Action } from '@stacksjs/types'
+import { version } from '../package.json'
 import { build, changelog, clean, commit, create, dev, example, fresh, generate, key, lint, make, preinstall, prepublish, release, setup, test, update } from './commands'
 
 const cli = command('stacks')
@@ -11,30 +14,44 @@ process.on('uncaughtException', errorHandler)
 process.on('unhandledRejection', errorHandler)
 
 async function main() {
-  // before running any commands, check if the project is already initialized
+  // the following commands are not dependent on the project being initialized
   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 initialized, generating application key...')
+      const result = await runAction(Action.KeyGenerate, { cwd: projectPath(), debug: true })
+      if (result.isErr()) {
+        log.error(result.error)
+        process.exit()
+      }
+      log.info('Application key generated.')
+    }
+    else {
+      log.error('Please run `buddy key:generate` to generate an application key.')
+      process.exit()
+    }
+
     await create(cli)
   }
-  else {
-    await preinstall(cli)
-    await prepublish(cli)
-    await update(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 example(cli)
-    await test(cli)
-  }
+
+  await preinstall(cli)
+  await prepublish(cli)
+  await update(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 example(cli)
+  await test(cli)
 
   cli.help()
   cli.version(version)

package/buddy/src/commands/create.ts

@@ -3,8 +3,8 @@ import { bold, cyan, green, intro, link, log, runCommand } from '@stacksjs/cli'
 import { useOnline } from '@stacksjs/utils'
 import { isFolder } from '@stacksjs/storage'
 import { resolve } from '@stacksjs/path'
-import { ExitCode } from '@stacksjs/types'
-import { generate as generateAppKey } from '@stacksjs/actions/key'
+import { Action, ExitCode } from '@stacksjs/types'
+import { runAction } from '@stacksjs/actions'
 
 async function create(buddy: CLI) {
   const descriptions = {
@@ -100,26 +100,26 @@ async function ensureEnv(path: string, options: CreateOptions) {
 
 async function install(path: string, options: CreateOptions) {
   log.info('Installing & setting up Stacks')
-  const res1 = await runCommand('pnpm install', { ...options, cwd: path })
+  let result = await runCommand('pnpm install', { ...options, cwd: path })
 
-  if (res1.isErr()) {
-    log.error(res1.error)
-    process.exit(ExitCode.FatalError)
+  if (result.isErr()) {
+    log.error(result.error)
+    process.exit()
   }
 
-  const res2 = await runCommand('cp .env.example .env', { ...options, cwd: path })
+  result = await runCommand('cp .env.example .env', { ...options, cwd: path })
 
-  if (res2.isErr()) {
-    log.error(res2.error)
+  if (result.isErr()) {
+    log.error(result.error)
     process.exit(ExitCode.FatalError)
   }
 
-  await generateAppKey(options)
+  await runAction(Action.KeyGenerate, { ...options, cwd: path })
 
-  const res3 = await runCommand('git init', { ...options, cwd: path })
+  result = await runCommand('git init', { ...options, cwd: path })
 
-  if (res3.isErr()) {
-    log.error(res3.error)
+  if (result.isErr()) {
+    log.error(result.error)
     process.exit(ExitCode.FatalError)
   }
 

package/buddy/src/commands/key.ts

@@ -1,5 +1,7 @@
 import type { CLI, KeyOptions } from '@stacksjs/types'
-import { generate as generateAppKey } from '@stacksjs/actions/key'
+import { intro, log, outro } from '@stacksjs/cli'
+import { Action } from '@stacksjs/types'
+import { runAction } from '@stacksjs/actions'
 
 async function key(buddy: CLI) {
   const descriptions = {
@@ -11,7 +13,15 @@ async function key(buddy: CLI) {
     .command('key:generate', descriptions.command)
     .option('--debug', descriptions.debug, { default: false })
     .action(async (options: KeyOptions) => {
-      await generateAppKey(options)
+      const startTime = intro('buddy key:generate')
+      const result = await runAction(Action.KeyGenerate, options)
+
+      if (result.isErr()) {
+        log.error('Failed to set random application key.', result.error)
+        process.exit()
+      }
+
+      outro('Set random application key.', { startTime })
     })
 }
 

package/buddy/src/index.ts

@@ -1,11 +1,13 @@
 export * from './commands'
 export * from '@stacksjs/alias'
+export * from '@stacksjs/ai'
 export * from '@stacksjs/arrays'
 export * from '@stacksjs/build'
 export * from '@stacksjs/cli'
 export * from '@stacksjs/cloud'
 export * from '@stacksjs/collections'
 export * from '@stacksjs/config'
+export * from '@stacksjs/events'
 // export * from '@stacksjs/desktop'
 // export * from '@stacksjs/notifications'
 export * from '@stacksjs/storage'
@@ -16,3 +18,4 @@ export * from '@stacksjs/types'
 export * from '@stacksjs/objects'
 export * from '@stacksjs/path'
 export * from '@stacksjs/ui'
+// export * from '@stacksjs/utils'

package/components/vue/package.json

@@ -2,7 +2,7 @@
   "name": "hello-world-vue",
   "type": "module",
   "version": "",
-  "packageManager": "pnpm@7.19.0",
+  "packageManager": "pnpm@7.20.0",
   "description": "Your Vue component library description",
   "author": "Chris Breuer",
   "license": "MIT",

package/components/web/package.json

@@ -2,7 +2,7 @@
   "name": "hello-world-elements",
   "type": "module",
   "version": "",
-  "packageManager": "pnpm@7.19.0",
+  "packageManager": "pnpm@7.20.0",
   "description": "Your framework agnostic web component library description.",
   "author": "Chris Breuer",
   "license": "MIT",

package/core/actions/package.json

@@ -1,8 +1,8 @@
 {
   "name": "@stacksjs/actions",
   "type": "module",
-  "version": "0.46.4",
-  "packageManager": "pnpm@7.19.0",
+  "version": "0.47.0",
+  "packageManager": "pnpm@7.20.0",
   "description": "The Stacks actions.",
   "author": "Chris Breuer",
   "license": "MIT",
@@ -37,7 +37,7 @@
   ],
   "engines": {
     "node": ">=v18.12.1",
-    "pnpm": ">=7.19.0"
+    "pnpm": ">=7.20.0"
   },
   "scripts": {
     "build": "mkdist -d",
@@ -50,11 +50,12 @@
     "@stacksjs/config": "workspace:*",
     "@stacksjs/logging": "workspace:*",
     "@stacksjs/path": "workspace:*",
+    "@stacksjs/security": "workspace:*",
     "@stacksjs/storage": "workspace:*",
     "@stacksjs/types": "workspace:*",
     "@stacksjs/utils": "workspace:*",
     "markdown-it": "^13.0.1",
-    "vue-component-meta": "^1.0.16"
+    "vue-component-meta": "^1.0.18"
   },
   "dependencies": {
     "@stacksjs/strings": "workspace:*",

package/core/actions/src/helpers/package-json.ts

@@ -2,7 +2,7 @@ import { log } from '@stacksjs/logging'
 import { writeTextFile } from '@stacksjs/storage'
 import { packageJsonPath } from '@stacksjs/path'
 import { library } from '@stacksjs/config'
-import { packageManager } from '../../package.json' assert { type: 'json' }
+import { packageManager } from '../../package.json'
 
 export async function generatePackageJson(type: 'vue-components' | 'web-components' | 'functions') {
   let name, description, directory, keywords, config, prettyName

package/core/actions/src/key-generate.ts

@@ -0,0 +1,10 @@
+import { runCommand } from '@stacksjs/cli'
+import { isFile } from '@stacksjs/storage'
+import { setEnvValue } from '@stacksjs/utils'
+import { options } from 'kolorist'
+import { generateAppKey } from '@stacksjs/security'
+
+if (!isFile('.env'))
+  await runCommand('cp .env.example .env', { ...options, cwd: projectPath() })
+
+await setEnvValue('APP_KEY', await generateAppKey())

package/core/ai/package.json

@@ -1,8 +1,8 @@
 {
   "name": "@stacksjs/ai",
   "type": "module",
-  "version": "0.46.4",
-  "packageManager": "pnpm@7.19.0",
+  "version": "0.47.0",
+  "packageManager": "pnpm@7.20.0",
   "description": "Stacks Artificial Intelligence.",
   "author": "Chris Breuer",
   "license": "MIT",
@@ -35,7 +35,7 @@
   ],
   "engines": {
     "node": ">=v18.12.1",
-    "pnpm": ">=7.19.0"
+    "pnpm": ">=7.20.0"
   },
   "scripts": {
     "build": "mkdist -d",

package/core/alias/package.json

@@ -1,8 +1,8 @@
 {
   "name": "@stacksjs/alias",
   "type": "module",
-  "version": "0.46.4",
-  "packageManager": "pnpm@7.19.0",
+  "version": "0.47.0",
+  "packageManager": "pnpm@7.20.0",
   "description": "The Stacks aliases.",
   "author": "Chris Breuer",
   "license": "MIT",
@@ -32,7 +32,7 @@
   ],
   "engines": {
     "node": ">=v18.12.1",
-    "pnpm": ">=7.19.0"
+    "pnpm": ">=7.20.0"
   },
   "scripts": {
     "build": "mkdist -d",

package/core/arrays/package.json

@@ -1,8 +1,8 @@
 {
   "name": "@stacksjs/arrays",
   "type": "module",
-  "version": "0.46.4",
-  "packageManager": "pnpm@7.19.0",
+  "version": "0.47.0",
+  "packageManager": "pnpm@7.20.0",
   "description": "The Stacks array utilities.",
   "author": "Chris Breuer",
   "license": "MIT",
@@ -36,7 +36,7 @@
   ],
   "engines": {
     "node": ">=v18.12.1",
-    "pnpm": ">=7.19.0"
+    "pnpm": ">=7.20.0"
   },
   "scripts": {
     "build": "mkdist -d",

package/core/auth/package.json

@@ -1,8 +1,8 @@
 {
   "name": "@stacksjs/auth",
   "type": "module",
-  "version": "0.46.4",
-  "packageManager": "pnpm@7.19.0",
+  "version": "0.47.0",
+  "packageManager": "pnpm@7.20.0",
   "description": "A more simplistic way to authenticate.",
   "author": "Chris Breuer",
   "license": "MIT",
@@ -33,7 +33,7 @@
   ],
   "engines": {
     "node": ">=v18.12.1",
-    "pnpm": ">=7.19.0"
+    "pnpm": ">=7.20.0"
   },
   "scripts": {
     "build": "mkdist -d",

package/core/build/package.json

@@ -1,8 +1,8 @@
 {
   "name": "@stacksjs/build",
   "type": "module",
-  "version": "0.46.4",
-  "packageManager": "pnpm@7.19.0",
+  "version": "0.47.0",
+  "packageManager": "pnpm@7.20.0",
   "description": "The Stacks framework build tools and configurations.",
   "author": "Chris Breuer",
   "license": "MIT",
@@ -35,7 +35,7 @@
   ],
   "engines": {
     "node": ">=v18.12.1",
-    "pnpm": ">=7.19.0"
+    "pnpm": ">=7.20.0"
   },
   "scripts": {
     "build": "mkdist -d",

package/core/cache/package.json

@@ -1,8 +1,8 @@
 {
   "name": "@stacksjs/cache",
   "type": "module",
-  "version": "0.46.4",
-  "packageManager": "pnpm@7.19.0",
+  "version": "0.47.0",
+  "packageManager": "pnpm@7.20.0",
   "description": "The Stacks way to test.",
   "author": "Chris Breuer",
   "license": "MIT",
@@ -36,7 +36,7 @@
   ],
   "engines": {
     "node": ">=v18.12.1",
-    "pnpm": ">=7.19.0"
+    "pnpm": ">=7.20.0"
   },
   "scripts": {
     "build": "mkdist -d",
@@ -45,7 +45,7 @@
     "typecheck": "tsc --noEmit"
   },
   "peerDependencies": {
-    "@aws-sdk/client-dynamodb": "^3.236.0",
+    "@aws-sdk/client-dynamodb": "^3.238.0",
     "@stacksjs/config": "workspace:*",
     "@types/memjs": "^1.2.4",
     "memcached": "^2.2.2",

package/core/chat/README.md

@@ -0,0 +1,89 @@
+# Stacks Notifications
+
+wip
+
+## ☘️ Features
+
+wip
+
+- ⚡️
+
+wip
+
+## 🤖 Usage
+
+wip
+
+```bash
+pnpm i -D @stacksjs/notifications
+```
+
+Now, you can use it in your project:
+
+```js
+import notifications from '@stacksjs/notifications'
+
+// wip
+```
+
+## 🤖 Drivers
+
+### Email
+
+- Sendgrid
+- Mailgun
+- Mailjet
+- Netcore
+- Nodemailer
+- Post Mark
+- Ses
+- Mandrill
+- EmailJS
+
+### SMS
+
+- Twilio
+- Nexmo
+- Gupshup
+- Plivo
+- SMS77
+- SNS
+- Telnyx
+- Termii
+
+### Chat
+
+- Discord
+- Slack
+
+Learn more in the docs.
+
+## 🧪 Testing
+
+```bash
+pnpm test
+```
+
+## 📈 Changelog
+
+Please see our [releases](https://github.com/stacksjs/stacks/releases) page for more information on what has changed recently.
+
+## 💪🏼 Contributing
+
+Please review the [Contributing Guide](https://github.com/stacksjs/contributing) for details.
+
+## 🏝 Community
+
+For help, discussion about best practices, or any other conversation that would benefit from being searchable:
+
+[Discussions on GitHub](https://github.com/stacksjs/stacks/discussions)
+
+For casual chit-chat with others using this package:
+
+[Join the Stacks Discord Server](https://discord.ow3.org)
+
+## 📄 License
+
+The MIT License (MIT). Please see [LICENSE](https://github.com/stacksjs/stacks/tree/main/LICENSE.md) for more information.
+
+Made with ❤️

package/core/chat/node_modules/.bin/maizzle

@@ -0,0 +1,17 @@
+#!/bin/sh
+basedir=$(dirname "$(echo "$0" | sed -e 's,\\,/,g')")
+
+case `uname` in
+    *CYGWIN*) basedir=`cygpath -w "$basedir"`;;
+esac
+
+if [ -z "$NODE_PATH" ]; then
+  export NODE_PATH="/home/runner/work/stacks/stacks/node_modules/.pnpm/node_modules"
+else
+  export NODE_PATH="$NODE_PATH:/home/runner/work/stacks/stacks/node_modules/.pnpm/node_modules"
+fi
+if [ -x "$basedir/node" ]; then
+  exec "$basedir/node"  "$basedir/../../../../../node_modules/.pnpm/@maizzle+framework@4.3.1_glob@7.2.3/node_modules/@maizzle/framework/bin/maizzle" "$@"
+else
+  exec node  "$basedir/../../../../../node_modules/.pnpm/@maizzle+framework@4.3.1_glob@7.2.3/node_modules/@maizzle/framework/bin/maizzle" "$@"
+fi

package/core/chat/node_modules/.bin/mkdist

@@ -0,0 +1,17 @@
+#!/bin/sh
+basedir=$(dirname "$(echo "$0" | sed -e 's,\\,/,g')")
+
+case `uname` in
+    *CYGWIN*) basedir=`cygpath -w "$basedir"`;;
+esac
+
+if [ -z "$NODE_PATH" ]; then
+  export NODE_PATH="/home/runner/work/stacks/stacks/node_modules/.pnpm/node_modules"
+else
+  export NODE_PATH="$NODE_PATH:/home/runner/work/stacks/stacks/node_modules/.pnpm/node_modules"
+fi
+if [ -x "$basedir/node" ]; then
+  exec "$basedir/node"  "$basedir/../../../../../node_modules/.pnpm/mkdist@1.0.0_typescript@4.9.4/node_modules/mkdist/dist/cli.cjs" "$@"
+else
+  exec node  "$basedir/../../../../../node_modules/.pnpm/mkdist@1.0.0_typescript@4.9.4/node_modules/mkdist/dist/cli.cjs" "$@"
+fi

package/{buddy/node_modules/.bin/pnpm → core/chat/node_modules/.bin/tsc}

@@ -11,7 +11,7 @@ else
   export NODE_PATH="$NODE_PATH:/home/runner/work/stacks/stacks/node_modules/.pnpm/node_modules"
 fi
 if [ -x "$basedir/node" ]; then
-  exec "$basedir/node"  "$basedir/../../../../node_modules/.pnpm/pnpm@7.19.0/node_modules/pnpm/bin/pnpm.cjs" "$@"
+  exec "$basedir/node"  "$basedir/../../../../../node_modules/.pnpm/typescript@4.9.4/node_modules/typescript/bin/tsc" "$@"
 else
-  exec node  "$basedir/../../../../node_modules/.pnpm/pnpm@7.19.0/node_modules/pnpm/bin/pnpm.cjs" "$@"
+  exec node  "$basedir/../../../../../node_modules/.pnpm/typescript@4.9.4/node_modules/typescript/bin/tsc" "$@"
 fi

package/core/chat/node_modules/.bin/tsserver

@@ -0,0 +1,17 @@
+#!/bin/sh
+basedir=$(dirname "$(echo "$0" | sed -e 's,\\,/,g')")
+
+case `uname` in
+    *CYGWIN*) basedir=`cygpath -w "$basedir"`;;
+esac
+
+if [ -z "$NODE_PATH" ]; then
+  export NODE_PATH="/home/runner/work/stacks/stacks/node_modules/.pnpm/node_modules"
+else
+  export NODE_PATH="$NODE_PATH:/home/runner/work/stacks/stacks/node_modules/.pnpm/node_modules"
+fi
+if [ -x "$basedir/node" ]; then
+  exec "$basedir/node"  "$basedir/../../../../../node_modules/.pnpm/typescript@4.9.4/node_modules/typescript/bin/tsserver" "$@"
+else
+  exec node  "$basedir/../../../../../node_modules/.pnpm/typescript@4.9.4/node_modules/typescript/bin/tsserver" "$@"
+fi