stacks 0.51.0 → 0.52.0

package/core/analytics/package.json

@@ -0,0 +1,64 @@
+{
+  "name": "@stacksjs/analytics",
+  "type": "module",
+  "version": "0.52.0",
+  "packageManager": "pnpm@8.5.1",
+  "description": "Stacks Analytics. Privacy-friendly.",
+  "author": "Chris Breuer",
+  "license": "MIT",
+  "funding": "https://github.com/sponsors/chrisbbreuer",
+  "homepage": "https://github.com/stacksjs/stacks/tree/main/.stacks/core/analytics#readme",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/stacksjs/stacks.git",
+    "directory": "./.stacks/core/analytics"
+  },
+  "bugs": {
+    "url": "https://github.com/stacksjs/stacks/issues"
+  },
+  "keywords": [
+    "analytics",
+    "singlestore",
+    "gdpr compliant",
+    "zero cookies",
+    "privacy-first",
+    "api",
+    "functions",
+    "components",
+    "npm stats",
+    "fathom",
+    "stacks"
+  ],
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.mjs"
+    },
+    "./drivers/fathom": {
+      "types": "./dist/drivers/fathom.d.ts",
+      "import": "./dist/drivers/fathom.mjs"
+    }
+  },
+  "module": "dist/index.mjs",
+  "types": "dist/index.d.ts",
+  "contributors": [
+    "Chris Breuer <chris@ow3.org>"
+  ],
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "unbuild",
+    "dev": "unbuild --stub",
+    "prepublishOnly": "pnpm run build",
+    "typecheck": "tsc --noEmit"
+  },
+  "peerDependencies": {
+    "@stacksjs/cli": "workspace:*",
+    "@stacksjs/config": "workspace:*"
+  },
+  "devDependencies": {
+    "@stacksjs/development": "workspace:*"
+  }
+}

package/core/arrays/README.md

@@ -38,7 +38,7 @@ pnpm test
 
 Please see our [releases](https://github.com/stacksjs/stacks/releases) page for more information on what has changed recently.
 
-## 💪🏼 Contributing
+## 🚜 Contributing
 
 Please review the [Contributing Guide](https://github.com/stacksjs/contributing) for details.
 

package/core/arrays/build.config.ts

@@ -0,0 +1,13 @@
+import { defineBuildConfig } from 'unbuild'
+
+export default defineBuildConfig({
+  entries: [
+    {
+      builder: 'mkdist',
+      input: './src/',
+      outDir: './dist/',
+    },
+  ],
+
+  declaration: true,
+})

package/core/arrays/package.json

@@ -1,8 +1,8 @@
 {
   "name": "@stacksjs/arrays",
   "type": "module",
-  "version": "0.51.0",
-  "packageManager": "pnpm@7.26.3",
+  "version": "0.52.0",
+  "packageManager": "pnpm@8.5.1",
   "description": "The Stacks array utilities.",
   "author": "Chris Breuer",
   "license": "MIT",
@@ -24,7 +24,12 @@
     "functions",
     "stacks"
   ],
-  "main": "dist/index.mjs",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.mjs"
+    }
+  },
   "module": "dist/index.mjs",
   "types": "dist/index.d.ts",
   "contributors": [
@@ -34,22 +39,18 @@
     "dist",
     "README.md"
   ],
-  "engines": {
-    "node": ">=v18.14.0",
-    "pnpm": ">=7.26.3"
-  },
   "scripts": {
-    "build": "mkdist -d",
-    "dev": "mkdist -d",
+    "build": "unbuild",
+    "dev": "unbuild --stub",
     "prepublishOnly": "pnpm run build",
     "typecheck": "tsc --noEmit"
   },
   "peerDependencies": {
+    "@stacksjs/types": "workspace:*",
     "@stacksjs/utils": "workspace:*"
   },
   "devDependencies": {
-    "@stacksjs/testing": "workspace:*",
-    "mkdist": "^1.1.0",
-    "typescript": "^4.9.5"
+    "@stacksjs/development": "workspace:*",
+    "@stacksjs/types": "workspace:*"
   }
 }

package/core/arrays/src/index.ts

@@ -21,6 +21,10 @@ export function containsOnly(needles: string[], haystack: string[]) {
   return containsAll(haystack, needles)
 }
 
+export function doesNotContain(needle: string, haystack: string[]) {
+  return !contains(needle, haystack)
+}
+
 /**
  * Convert `Arrayable<T>` to `Array<T>`
  *

package/core/auth/README.md

@@ -38,7 +38,7 @@ pnpm test
 
 Please see our [releases](https://github.com/stacksjs/stacks/releases) page for more information on what has changed recently.
 
-## 💪🏼 Contributing
+## 🚜 Contributing
 
 Please review the [Contributing Guide](https://github.com/stacksjs/contributing) for details.
 

package/core/auth/build.config.ts

@@ -0,0 +1,13 @@
+import { defineBuildConfig } from 'unbuild'
+
+export default defineBuildConfig({
+  entries: [
+    {
+      builder: 'mkdist',
+      input: './src/',
+      outDir: './dist/',
+    },
+  ],
+
+  declaration: true,
+})

package/core/auth/package.json

@@ -1,8 +1,8 @@
 {
   "name": "@stacksjs/auth",
   "type": "module",
-  "version": "0.51.0",
-  "packageManager": "pnpm@7.26.3",
+  "version": "0.52.0",
+  "packageManager": "pnpm@8.5.1",
   "description": "A more simplistic way to authenticate.",
   "author": "Chris Breuer",
   "license": "MIT",
@@ -21,7 +21,12 @@
     "authenticate",
     "stacks"
   ],
-  "main": "dist/index.mjs",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.mjs"
+    }
+  },
   "module": "dist/index.mjs",
   "types": "dist/index.d.ts",
   "contributors": [
@@ -31,19 +36,13 @@
     "dist",
     "README.md"
   ],
-  "engines": {
-    "node": ">=v18.14.0",
-    "pnpm": ">=7.26.3"
-  },
   "scripts": {
-    "build": "mkdist -d",
-    "dev": "mkdist -d",
+    "build": "unbuild",
+    "dev": "unbuild --stub",
     "prepublishOnly": "pnpm run build",
     "typecheck": "tsc --noEmit"
   },
   "devDependencies": {
-    "@stacksjs/testing": "workspace:*",
-    "mkdist": "^1.1.0",
-    "typescript": "^4.9.5"
+    "@stacksjs/development": "workspace:*"
   }
 }

package/{buddy → core/buddy}/README.md

@@ -8,7 +8,7 @@
 [![npm downloads][npm-downloads-src]][npm-downloads-href]
 <!-- [![Codecov][codecov-src]][codecov-href] -->
 
-_Pre-release until public beta released. Coming March._
+_Pre-release until public beta released. Coming May/June._
 
 The goal of the framework is to _help you_ create & maintain frontends, backends, and clouds—without having to worry about the boilerplate. Stacks is a rapid application development framework, meeting all your full stack needs.
 
@@ -23,7 +23,7 @@ Stacks helps you every step along the way—in beginner & expert-friendly ways,
 
 > “Convention over configuration” is the Stacks mantra. _- Chris_
 
-<!-- ![Atomic UI & FX Design](./apps/docs/images/diagram.png) -->
+<!-- ![Atomic UI & FX Design](./docs/images/diagram.png) -->
 
 ## Features
 
@@ -52,26 +52,29 @@ _Develop serverless (or server) functions with countless helpers to build scalab
 - 👾 **Errors** _native type-safe error handling_
 - 🗓️ **Events** _functional event (front & backend) communication_
 - 📢 **Notifications** _emails, SMSs, direct, and push notifications & webhooks_
+- 🗺️ **ORM** _supercharged, fully-typed models & relations (including automated migrations)_
 - 💳 **Payments** _unified API for one-off & subscription billing methods for Stripe_
-- ⚙️ **Queues** _run your heavy workload in the background_
-- 💬 **Realtime** _"everything you need to build dynamic real-time apps"_
+- ⚙️ **Queues** _run any heavy workload in the background_
+- 🛠️ **Query Builder** _powerful, type-safe SQL query builder_
+- 💬 **Realtime** _“everything you need to build dynamic real-time apps”_
 - 🧭 **Router** _smart routing, file-based or Laravel-like_
 - 🔎 **Search Engine** _smart searching, advanced filtering & sorting, pagination, headless UI_
 - 💾 **Storage** _easily create & make use of local & remote storages/file systems_
-- 🌪️ **Validation** _e2e type-safety (frontend knows what the backend knows)_
+- 🧪 **Tinker** _a powerful TypeScript REPL_
+- 🌪️ **Validation** _e2e type-safety (true frontend & backend harmony)_
 - 🎯 **X-Ray** _all you need to debug, log & analyze_
 
 ### Stacks Cloud
 
-_Create your personal or professional Vercel-like cloud._
+_Create your personal or professional Vercel-like cloud, based on MIT-licensed OSS._
 
 - ☁️ **Server** _local development server & production-ready servers_
 - ⛅️ **Serverless** _on-demand, auto-scaling, zero maintenance_
-- 🚏 **CDN** _zero-config low-latency CDN, including request life-cycle hooks_
-- 🤌🏼 **Brotli & gzip** _optimized request compressions to speed up page load times_
+- 🚏 **CDN** _zero-config low-latency CDN, including request life-cycle hooks & optimized request compressions (Brotli & gzip)_
+- 🔀 **Domain** _version-controlled & zero-config domain management (e.g. DNS)_
 - 📧 **Email** _secure & simplistic easy-peasy@custom-domains.com mail_
 - 🔐 **Firewall** _native web application firewall support_
-- 🏗️ **Maintenance** _handles your cloud infrastructure via the Stacks & Serverless framework_
+- 🚜 **Maintenance** _handles your cloud infrastructure via the Stacks & Serverless framework_
 - 🤖 **Infrastructure as Code** _create & maintain your cloud infrastructure with ease_
 
 ### Stacks CI/CD
@@ -91,8 +94,8 @@ _Enhanced productivity for developers. No more creating boilerplate._
 - 💪🏼 **Type Strong** _built-in e2e type-safety_
 - ✨ **Git Workflows** _committing with ease_
 - 🚗 **Auto Imports** _your components & functions, including date, string, array, & object helpers_
-- ⏩ **Code Snippets** _say goodbye to the boilerplate_
-- 🔤 **Spell Checker** _be notified once when there are typos_
+- ⏩ **Code Snippets** _say goodbye to the boilerplate—thank you [Sarah Drasner](https://github.com/sdras/vue-vscode-snippets)_
+- 🔤 **Spell Checker** _be notified once there are typos_
 - 🛠️ **Utilities** _Collections, VueUse, and more_
 - 🧪 **Testing** _unit & e2e tests powered by Vitest & Playwright_
 
@@ -115,7 +118,7 @@ npx stacks new my-project
 ```
 
 > **Note**
-> pnpm 7.26 or higher required. _Run the setup script & 🐶 Buddy will set you up. He barks otherwise._
+> pnpm 8 required. _Run the setup script & 🐶 Buddy will set you up. He barks otherwise._
 
 ## 🤖 Usage
 
@@ -131,7 +134,7 @@ buddy upgrade # auto-update deps & the Stacks framework
 
 buddy make:component HelloWorld # scaffolds a component
 buddy make:function HelloWorld # scaffolds a function
-buddy make:page hello-world # scaffolds a page (https://127.0.0.1/hello-world)
+buddy make:page hello-world # scaffolds a page (https://my-project.test/hello-world)
 
 buddy --help
 ```
@@ -338,9 +341,9 @@ console.log('increased count is', count)
 
 </details>
 
-You may view this framework as an incredibly "useful set of frames" to assist in efficiently bootstrapping, designing, and managing component & function libraries—using industry best practices, to reach one of the broadest user bases possible.
+You may view this framework as an incredibly “useful set of frames” to assist in efficiently bootstrapping, designing, and managing component & function libraries—using industry best practices, to reach one of the broadest user bases possible.
 
-## 🚙 Roadmap
+## 🎯 Roadmap
 
 Part of the Stacks ecosystem are the following first-party supported stacks:
 
@@ -370,7 +373,7 @@ pnpm test
 
 Please see our [releases](https://github.com/stacksjs/stacks/releases) page for more information on what has changed recently.
 
-## 💪🏼 Contributing
+## 🚜 Contributing
 
 Please see the [Contributing Guide](https://github.com/stacksjs/contributing) for details.
 

package/core/buddy/build.config.ts

@@ -0,0 +1,16 @@
+import { defineBuildConfig } from 'unbuild'
+import { alias } from '@stacksjs/alias'
+
+export default defineBuildConfig({
+  alias,
+  entries: [
+    './src/index',
+    './src/cli',
+  ],
+  declaration: true,
+  clean: true,
+  rollup: {
+    emitCJS: false,
+    inlineDependencies: true,
+  },
+})

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,8 +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',
+    select: 'Which stack/s are you trying to add?',
     verbose: 'Enable verbose output',
-    debug: 'Enable debug mode',
   }
 
   buddy
@@ -19,16 +19,13 @@ async function add(buddy: CLI) {
     .option('-c, --calendar', descriptions.calendar, { default: false })
     .option('-a, --all', descriptions.all, { default: false })
     .option('--verbose', descriptions.verbose, { default: false })
-    .option('--debug', descriptions.debug, { 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' },
           ],
         })
 
@@ -45,7 +42,6 @@ async function add(buddy: CLI) {
     .command('add:table', descriptions.table)
     .option('-t, --table', descriptions.table, { default: true })
     .option('--verbose', descriptions.verbose, { default: false })
-    .option('--debug', descriptions.debug, { default: false })
     .action(async (options: BuildOptions) => {
       await invoke(options)
     })
@@ -54,7 +50,6 @@ async function add(buddy: CLI) {
     .command('add:calendar', descriptions.calendar)
     .option('-t, --calendar', descriptions.calendar, { default: true })
     .option('--verbose', descriptions.verbose, { default: false })
-    .option('--debug', descriptions.debug, { default: false })
     .action(async (options: BuildOptions) => {
       await invoke(options)
     })