stacks 0.44.10 → 0.44.12

package/core/dashboard/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@stacksjs/dashboard",
   "type": "module",
-  "version": "0.44.10",
+  "version": "0.44.12",
   "packageManager": "pnpm@7.18.2",
   "description": "The Stacks Dashboard.",
   "author": "Chris Breuer",

package/core/database/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@stacksjs/database",
   "type": "module",
-  "version": "0.44.10",
+  "version": "0.44.12",
   "packageManager": "pnpm@7.18.2",
   "description": "The Stacks database integration.",
   "author": "Chris Breuer",

package/core/datetime/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@stacksjs/datetime",
   "type": "module",
-  "version": "0.44.10",
+  "version": "0.44.12",
   "packageManager": "pnpm@7.18.2",
   "description": "The Stacks datetime helpers.",
   "author": "Chris Breuer",

package/core/desktop/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@stacksjs/desktop",
   "type": "module",
-  "version": "0.44.10",
+  "version": "0.44.12",
   "packageManager": "pnpm@7.18.2",
   "description": "The Stacks Desktop engine.",
   "author": "Chris Breuer",

package/core/docs/node_modules/.bin/vitepress

@@ -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/vitepress@1.0.0-alpha.31_tbpndr44ulefs3hehwpi2mkf2y/node_modules/vitepress/bin/vitepress.js" "$@"
+  exec "$basedir/node"  "$basedir/../../../../../node_modules/.pnpm/vitepress@1.0.0-alpha.32_tbpndr44ulefs3hehwpi2mkf2y/node_modules/vitepress/bin/vitepress.js" "$@"
 else
-  exec node  "$basedir/../../../../../node_modules/.pnpm/vitepress@1.0.0-alpha.31_tbpndr44ulefs3hehwpi2mkf2y/node_modules/vitepress/bin/vitepress.js" "$@"
+  exec node  "$basedir/../../../../../node_modules/.pnpm/vitepress@1.0.0-alpha.32_tbpndr44ulefs3hehwpi2mkf2y/node_modules/vitepress/bin/vitepress.js" "$@"
 fi

package/core/docs/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@stacksjs/docs",
   "type": "module",
-  "version": "0.44.10",
+  "version": "0.44.12",
   "packageManager": "pnpm@7.18.2",
   "description": "The Stacks way to document.",
   "author": "Chris Breuer",
@@ -43,7 +43,7 @@
     "typecheck": "tsc --noEmit"
   },
   "peerDependencies": {
-    "vitepress": "1.0.0-alpha.31"
+    "vitepress": "1.0.0-alpha.32"
   },
   "devDependencies": {
     "@stacksjs/testing": "workspace:*",

package/core/domains/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@stacksjs/domains",
   "type": "module",
-  "version": "0.44.10",
+  "version": "0.44.12",
   "packageManager": "pnpm@7.18.2",
   "description": "Easily manage your domains.",
   "author": "Chris Breuer",

package/core/drivers/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@stacksjs/drivers",
   "type": "module",
-  "version": "0.44.10",
+  "version": "0.44.12",
   "packageManager": "pnpm@7.18.2",
   "description": "Easily create a driver-based system.",
   "author": "Chris Breuer",

package/core/email/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@stacksjs/email",
   "type": "module",
-  "version": "0.44.10",
+  "version": "0.44.12",
   "packageManager": "pnpm@7.18.2",
   "description": "The Stacks Email integration. Painlessly create & manage your inboxes, templates, and send emails.",
   "author": "Chris Breuer",

package/core/error-handling/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@stacksjs/error-handling",
   "type": "module",
-  "version": "0.44.10",
+  "version": "0.44.12",
   "packageManager": "pnpm@7.18.2",
   "description": "Type safe error handling.",
   "author": "Chris Breuer",

package/core/git/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@stacksjs/git",
   "type": "module",
-  "version": "0.44.10",
+  "version": "0.44.12",
   "packageManager": "pnpm@7.18.2",
   "description": "The Stacks git utilities & conventions.",
   "author": "Chris Breuer",

package/core/health/README.md

@@ -0,0 +1,56 @@
+# Stacks Health Engine
+
+The Health Engine is a unified driver system to easily manage health checks for your application.
+
+## ☘️ Features
+
+- 🚘 Driver based
+- ⚡️ Oh Dear support
+- 💀 Headless functions & components
+
+## 🤖 Usage
+
+```bash
+pnpm i -D @stacksjs/health
+```
+
+You may now use:
+
+```ts
+import { useHealth } from '@stacksjs/health'
+
+const health = useHealth()
+// ...
+```
+
+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/health/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/core/health/node_modules/.bin/tsc

@@ -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/tsc" "$@"
+else
+  exec node  "$basedir/../../../../../node_modules/.pnpm/typescript@4.9.4/node_modules/typescript/bin/tsc" "$@"
+fi

package/core/health/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

package/core/health/package.json

@@ -0,0 +1,54 @@
+{
+  "name": "@stacksjs/health",
+  "type": "module",
+  "version": "0.44.12",
+  "packageManager": "pnpm@7.18.2",
+  "description": "The Stacks Health services.",
+  "author": "Chris Breuer",
+  "license": "MIT",
+  "funding": "https://github.com/sponsors/chrisbbreuer",
+  "homepage": "https://github.com/stacksjs/stacks/tree/main/.stacks/core/health#readme",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/stacksjs/stacks.git",
+    "directory": "./.stacks/core/health"
+  },
+  "bugs": {
+    "url": "https://github.com/stacksjs/stacks/issues"
+  },
+  "keywords": [
+    "health",
+    "oh dear",
+    "stacks",
+    "api",
+    "headless"
+  ],
+  "main": "dist/index.mjs",
+  "module": "dist/index.mjs",
+  "types": "dist/index.d.ts",
+  "contributors": [
+    "Chris Breuer <chris@ow3.org>"
+  ],
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "engines": {
+    "node": ">=v18.12.1",
+    "pnpm": ">=7.18.2"
+  },
+  "scripts": {
+    "build": "mkdist -d",
+    "dev": "mkdist -d",
+    "prepublishOnly": "pnpm run build",
+    "typecheck": "tsc --noEmit"
+  },
+  "peerDependencies": {
+    "@stacksjs/notifications": "workspace:*"
+  },
+  "devDependencies": {
+    "@stacksjs/testing": "workspace:*",
+    "mkdist": "^1.0.0",
+    "typescript": "^4.9.4"
+  }
+}

package/core/health/src/drivers/ohdear.ts

@@ -0,0 +1 @@
+export {}

package/core/health/src/index.ts

@@ -0,0 +1 @@
+export {}

package/core/health/src/notifications/index.ts

@@ -0,0 +1 @@
+export {}

package/core/health/tests/example.test.ts

@@ -0,0 +1,7 @@
+import { assert, describe, test } from 'vitest'
+
+describe('example test', () => {
+  test('assert', () => {
+    assert.equal(1, 1)
+  })
+})

package/core/lint/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@stacksjs/lint",
   "type": "module",
-  "version": "0.44.10",
+  "version": "0.44.12",
   "packageManager": "pnpm@7.18.2",
   "description": "The Stacks way to lint.",
   "author": "Chris Breuer",

package/core/logging/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@stacksjs/logging",
   "type": "module",
-  "version": "0.44.10",
+  "version": "0.44.12",
   "packageManager": "pnpm@7.18.2",
   "description": "The Stacks logging system.",
   "author": "Chris Breuer",

package/core/modules/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@stacksjs/modules",
   "type": "module",
-  "version": "0.44.10",
+  "version": "0.44.12",
   "packageManager": "pnpm@7.18.2",
   "description": "The Stacks framework modules.",
   "author": "Chris Breuer",

package/core/notifications/README.md

@@ -1,60 +1,227 @@
 # Stacks Notifications
 
-wip
+Stacks Notifications is a unified driver system for sending messages/notifications. It supports sending emails, SMS messages, and chat messages.
 
 ## ☘️ Features
 
-wip
+- 📦 Send Emails
+- 🎨 Email Styling
+- 📱 Send SMS messages
+- 💬 Send Chat messages
 
-- ⚡️
+## TODO
 
-wip
+- [ ] Driver: FCM
+- [ ] Driver: Expo
+- [ ] Driver: SNS (Push)
+- [ ] Driver: Pushwoosh
 
 ## 🤖 Usage
 
-wip
-
 ```bash
 pnpm i -D @stacksjs/notifications
 ```
 
-Now, you can use it in your project:
+You may now use it in your project:
+
+```ts
+import { notification } from '@stacksjs/notifications'
 
-```js
-import notifications from '@stacksjs/notifications'
+notification.send(options)
+```
 
-// wip
+## 🏎️ Drivers
+
+There are different option types for Chat, Email, and SMS drivers. To use any driver, simply configure the notification `options` object.
+
+```ts
+interface ChatOptions {
+  webhookUrl: string
+  content: string
+}
+
+interface EmailOptions {
+  to: string | string[]
+  subject: string
+  html: string
+  from?: string
+  text?: string
+  attachments?: IAttachmentOptions[]
+  id?: string
+}
+
+interface SMSOptions {
+  to: string
+  content: string
+  from?: string
+  attachments?: IAttachmentOptions[]
+  id?: string
+}
 ```
 
-## 🤖 Drivers
+Available drivers are listed below, with the proper variables needed to get started.
 
 ### Email
 
-- Sendgrid
-- Mailgun
-- Mailjet
-- Netcore
-- Nodemailer
-- Post Mark
-- Ses
-- Mandrill
-- EmailJS
+Email drivers are configured with the following environment variables:
+
+#### Sendgrid
+
+```bash
+SENDGRID_API_KEY=SG123
+SENDGRID_FROM=from@example.com
+SENDGRID_SENDER_NAME=Sender
+```
+
+#### Mailgun
+
+```bash
+MAILGUN_API_KEY=MG123
+MAILGUN_DOMAIN=example.com
+MAILGUN_USERNAME=username
+MAILGUN_FROM=from@example.com
+```
+
+#### Mailjet
+
+```bash
+MAILJET_API_KEY=MJ123
+MAILJET_API_SECRET=MJTESTSECRET
+MAILJET_FROM_EMAIL=from@example.com
+```
+
+#### Netcore
+
+```bash
+NETCORE_API_KEY=NC123
+NETCORE_FROM=from@example.com
+```
+
+#### Nodemailer
+
+```bash
+NODEMAILER_FROM_EMAIL=from@example.com
+NODEMAILER_HOST=example.com
+NODEMAILER_USERNAME=username
+NODEMAILER_PASSWORD=password
+NODEMAILER_PORT=25
+NODEMAILER_SECURE=true
+```
+
+#### Postmark
+
+```bash
+POSTMARK_API_KEY=PM123
+POSTMARK_FROM=from@example.com
+```
+
+#### AWS SES
+
+```bash
+SES_REGION=US
+SES_ACCESS_KEY_ID=testkey123
+SES_SECRET_ACCESS_KEY=testaccesskey123
+SES_FROM=from@example.com
+```
+
+#### Mandrill
+
+```bash
+MANDRILL_API_KEY=Ma123
+MANDRILL_EMAIL=from@example.com
+```
+
+#### EmailJS
+
+```bash
+EMAILJS_FROM_EMAIL=from@example.com
+EMAILJS_HOST=example.com
+EMAILJS_USERNAME=username
+EMAILJS_PASSWORD=password
+EMAILJS_PORT=25
+EMAILJS_SECURE=true
+```
 
 ### SMS
 
-- Twilio
-- Nexmo
-- Gupshup
-- Plivo
-- SMS77
-- SNS
-- Telnyx
-- Termii
+SMS drivers are configured with the following environment variables:
+
+#### Twilio
+
+```bash
+TWILIO_ACCOUNT_SID=ACtest
+TWILIO_AUTH_TOKEN=testtoken
+TWILIO_FROM_NUMBER=+112345
+TWILIO_TO_NUMBER=+145678
+```
+
+#### Nexmo
+
+```bash
+VONAGE_API_KEY=VN123
+VONAGE_API_SECRET=testkey
+VONAGE_FROM_NUMBER=+112345
+```
+
+#### Gupshup
+
+```bash
+GUPSHUP_USER_ID=GU123
+GUPSHUP_PASSWORD=password
+```
+
+#### Plivo
+
+```bash
+PLIVO_ACCOUNT_ID=PA123
+PLIVO_AUTH_TOKEN=testtoken
+PLIVO_FROM_NUMBER=+112345
+```
+
+#### SMS77
+
+```bash
+SMS77_API_KEY=SA123
+SMS77_FROM=from@example.com
+```
+
+#### SNS
+
+```bash
+SMS77_API_KEY=SA123
+SMS77_FROM=from@example.com
+```
+
+#### Telnyx
+
+```bash
+TELNYX_API_KEY=TA123
+TELNYX_MESSAGE_PROFILE_ID=testprofileid
+TELNYX_FROM=from@example.com
+```
+
+#### Termii
+
+```bash
+TERMII_API_KEY=TermA123
+TERMII_SENDER=from@example.com
+```
 
 ### Chat
 
-- Discord
-- Slack
+Chat drivers are configured with the following environment variables:
+
+#### Discord
+
+- None
+
+#### Slack
+
+```
+SLACK_APPLICATION_ID=SAID123
+SLACK_CLIENT_ID=SCID123
+SLACK_SECRET_KEY=SSK123
+```
 
 Learn more in the docs.
 
@@ -82,6 +249,14 @@ For casual chit-chat with others using this package:
 
 [Join the Stacks Discord Server](https://discord.ow3.org)
 
+## 🙏🏼 Credits
+
+Many thanks to the following core technologies & people who have contributed to this package:
+
+- [Chris Breuer](https://github.com/chrisbbreuer)
+- [Novu](https://novu.co/)
+- [All Contributors](../../contributors)
+
 ## 📄 License
 
 The MIT License (MIT). Please see [LICENSE](https://github.com/stacksjs/stacks/tree/main/LICENSE.md) for more information.

package/core/notifications/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@stacksjs/notifications",
   "type": "module",
-  "version": "0.44.10",
+  "version": "0.44.12",
   "packageManager": "pnpm@7.18.2",
   "description": "The Stacks notifications integration.",
   "author": "Chris Breuer",

package/core/objects/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@stacksjs/objects",
   "type": "module",
-  "version": "0.44.10",
+  "version": "0.44.12",
   "packageManager": "pnpm@7.18.2",
   "description": "The Stacks objects.",
   "author": "Chris Breuer",

package/core/path/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@stacksjs/path",
   "type": "module",
-  "version": "0.44.10",
+  "version": "0.44.12",
   "packageManager": "pnpm@7.18.2",
   "description": "The Stacks path.",
   "author": "Chris Breuer",

package/core/payments/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@stacksjs/payments",
   "type": "module",
-  "version": "0.44.10",
+  "version": "0.44.12",
   "packageManager": "pnpm@7.18.2",
   "description": "The Stacks payments package. Currently supporting Stripe.",
   "author": "Chris Breuer",

package/core/realtime/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@stacksjs/realtime",
   "type": "module",
-  "version": "0.44.10",
+  "version": "0.44.12",
   "packageManager": "pnpm@7.18.2",
   "description": "The Stacks realtime integration.",
   "author": "Chris Breuer",

package/core/router/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@stacksjs/router",
   "type": "module",
-  "version": "0.44.10",
+  "version": "0.44.12",
   "packageManager": "pnpm@7.18.2",
   "description": "The Stacks framework router.",
   "author": "Chris Breuer",