stacks 0.50.0 → 0.52.0

package/README.md

@@ -1,4 +1,4 @@
-![Social Card of Stacks](./buddy/art/social.png)
+![Social Card of Stacks](./core/buddy/art/social.png)
 
 # Rapid App Development
 
@@ -8,7 +8,7 @@
 [![npm downloads][npm-downloads-src]][npm-downloads-href]
 <!-- [![Codecov][codecov-src]][codecov-href] -->
 
-_Pre-release until public beta released. Coming December._
+_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_
+- 🔤 **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.20 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/api/nitro.config.ts

@@ -0,0 +1,17 @@
+import { defineNitroConfig } from 'nitropack'
+
+// import { alias } from '@stacksjs/alias'
+// import { resolve } from '@stacksjs/path'
+// import { deploy } from '@stacksjs/config'
+
+export default defineNitroConfig({
+  // alias,
+  output: {
+    dir: '.output',
+    serverDir: '.output/server',
+    publicDir: '.output/public',
+  },
+  preset: 'aws-lambda',
+  // rootDir: resolve(__dirname, '.'),
+  // srcDir: resolve(__dirname, '.'),
+})

package/api/package.json

@@ -0,0 +1,42 @@
+{
+  "name": "api",
+  "type": "module",
+  "version": "0.51.0",
+  "packageManager": "pnpm@8.5.1",
+  "description": "The Stacks generated API server.",
+  "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/api"
+  },
+  "bugs": {
+    "url": "https://github.com/stacksjs/stacks/issues"
+  },
+  "keywords": [
+    "api",
+    "vite",
+    "composables",
+    "headless",
+    "modern",
+    "typescript"
+  ],
+  "contributors": [
+    "Chris Breuer <chris@ow3.org>"
+  ],
+  "scripts": {
+    "dev": "npx nitro dev",
+    "build": "npx nitro build",
+    "preview": "",
+    "deploy": "npx serverless deploy"
+  },
+  "dependencies": {
+    "@stacksjs/alias": "workspace:*",
+    "@stacksjs/config": "workspace:*",
+    "@stacksjs/path": "workspace:*",
+    "@stacksjs/server": "workspace:*"
+  }
+}

package/api/routes/index.ts

@@ -0,0 +1 @@
+export default defineEventHandler(() => '.stacks is amazing!')

package/api/serverless.yml

@@ -0,0 +1,11 @@
+service: stacks-service
+frameworkVersion: '3'
+useDotenv: true
+
+provider:
+  name: aws
+  runtime: nodejs18.x
+
+functions:
+  stacksFunction1:
+    handler: .output/server/index.handler