stacks 0.40.0 → 0.44.9

package/core/cache/tests/Redis.test.ts

@@ -0,0 +1,82 @@
+import { describe, expect, it } from 'vitest'
+import { createClient } from 'redis' // TODO: needs to be imported from cache package
+
+const client: any = createClient({
+  socket: {
+    host: '127.0.0.1',
+    port: 6379,
+  },
+  password: '',
+})
+
+// TODO: needs to be moved to cache package
+await client.connect()
+
+// TODO: needs to be imported to cache package
+async function set(key: any, value: any): Promise<void> {
+  await client.set(key, value)
+}
+
+// TODO: needs to be imported to cache package
+async function get(key: string): Promise<any> {
+  const value = await client.get(key)
+
+  return value
+}
+
+// TODO: needs to be imported to cache package
+async function remove(key: string): Promise<void> {
+  await client.del(key)
+}
+
+// TODO: needs to be imported to cache package
+async function del(key: string): Promise<void> {
+  await client.del(key)
+}
+
+// TODO: needs to be imported to cache package
+async function flushAll(): Promise<void> {
+  await client.sendCommand(['FLUSHALL', 'ASYNC'])
+}
+
+// TODO: needs to be imported to cache package
+async function flushDB(): Promise<void> {
+  await client.sendCommand(['FLUSHDB', 'ASYNC'])
+}
+
+describe('RedisTest', () => {
+  it('it should set redis cache', async () => {
+    await set('test', 'test')
+    expect(await get('test')).toBe('test')
+  })
+
+  it('it should get redis cache', async () => {
+    await set('test', 'test')
+    expect(await get('test')).toBe('test')
+  })
+
+  it('it should remove cache', async () => {
+    await set('test', 'test')
+    await remove('test')
+    expect(await get('test')).toBe(null)
+  })
+
+  it('it should del cache', async () => {
+    await set('test', 'test')
+    await del('test')
+    expect(await get('test')).toBe(null)
+  })
+
+  it('it should flush all cache', async () => {
+    await set('test', 'test')
+    await flushAll()
+    expect(await get('test')).toBe(null)
+  })
+
+  it('it should flush all DB', async () => {
+    await set('test', 'test')
+    await flushDB()
+    expect(await get('test')).toBe(null)
+  })
+})
+

package/core/cache/vite.config.ts

@@ -0,0 +1,7 @@
+import { defineConfig } from 'vitest/config'
+
+export default defineConfig({
+  test: {
+    // ...
+  },
+})

package/core/cli/README.md

@@ -0,0 +1,129 @@
+# Stacks CLI
+
+The simple way to build beautiful CLIs.
+
+## ☘️ Features
+
+- 🎨 Easily create beautiful CLI apps
+- ⚡️ Lightweight, user-friendly, interactive prompts
+- 🚦 Elegant terminal spinners
+- ⛑️ Helper methods to run commands
+
+## 🤖 Usage
+
+```bash
+pnpm i -D @stacksjs/cli
+```
+
+Now, you can use it in your project:
+
+```js
+// command.ts
+// you may create create a relatively complex CLI UI/UX via the following:
+import { command, log, prompts, spawn, spinner, ExitCode, italic } from '@stacksjs/cli'
+
+const stacks = command('stacks')
+
+stacks
+  .command('example', 'A dummy command') // pnpm buddy example
+  .option('-i, --install', 'The install option', { default: true })
+  .action(async (options) => {
+    if (options.install)
+      await install()
+
+    const answer = await prompts.select({
+      type: 'select',
+      message: 'Are you trying to run this command?',
+      choices: [
+        { title: 'Run the command', value: 'run' },
+        { title: 'Do not run the command', value: 'do-not-run' },
+      ],
+    })
+
+    if (answer === 'run')
+      install()
+    else if (answer === 'do-not-run')
+      log.info('Not running the command')
+    else process.exit(ExitCode.InvalidArgument)
+  })
+
+async function install() {
+  try {
+    const spin = spinner('Running...').start()
+    setTimeout(() => {
+      spin.text = italic('This may take a little while...')
+    }, 5000)
+    await spawn('pnpm install')
+    spin.stop()
+  } catch (error) {
+    log.error(error)
+  }
+}
+
+command.help() // automatically expose a -h and --help flag
+command.version(version) // automatically expose a -v and --version flag
+command.parse() // parse the command
+```
+
+You may now run the command via:
+
+```bash
+esno command.ts
+```
+
+To view a more detailed example, check out [Buddy](../../buddy/).
+
+_You may also use any of the following CLI utilities:_
+
+```js
+import {
+  log,
+  ansi256Bg, bold, dim, hidden, inverse, italic, link, reset, strikethrough, underline,
+  bgBlack, bgBlue, bgCyan, bgGray, bgGreen, bgLightBlue, bgLightCyan, bgLightGray, bgLightGreen, bgLightMagenta, bgLightRed, bgLightYellow, bgMagenta, bgRed, bgWhite, bgYellow,
+  black, blue, cyan, gray, green, lightBlue, lightCyan, lightGray, lightGreen, lightMagenta, lightRed, lightYellow, magenta, red, white, yellow,
+} from '@stacksjs/cli'
+
+log.info(`hello ${bold(italic('world'))`)
+```
+
+To view the full documentation, please visit [https://stacksjs.dev/cli](https://stacksjs.dev/cli).
+
+## 🧪 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)
+
+## 🙏🏼 Credits
+
+Many thanks to the following core technologies & people who have contributed to this package:
+
+- [CAC](https://github.com/cacjs/cac)
+- [Ora](https://github.com/sindresorhus/ora)
+- [Consola](https://github.com/unjs/consola)
+- [Chris Breuer](https://github.com/chrisbbreuer)
+- [All Contributors](../../contributors)
+
+## 📄 License
+
+The MIT License (MIT). Please see [LICENSE](https://github.com/stacksjs/stacks/tree/main/LICENSE.md) for more information.
+
+Made with ❤️

package/core/cli/node_modules/.bin/esno

@@ -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/esno@0.16.3/node_modules/esno/esno.js" "$@"
+else
+  exec node  "$basedir/../../../../../node_modules/.pnpm/esno@0.16.3/node_modules/esno/esno.js" "$@"
+fi

package/core/cli/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/node_modules/mkdist/dist/cli.cjs" "$@"
+else
+  exec node  "$basedir/../../../../../node_modules/.pnpm/mkdist@1.0.0/node_modules/mkdist/dist/cli.cjs" "$@"
+fi

package/core/cli/package.json

@@ -0,0 +1,69 @@
+{
+  "name": "@stacksjs/cli",
+  "type": "module",
+  "version": "0.44.9",
+  "packageManager": "pnpm@7.18.2",
+  "description": "The simple way to create beautiful CLIs.",
+  "author": "Chris Breuer",
+  "license": "MIT",
+  "funding": "https://github.com/sponsors/chrisbbreuer",
+  "homepage": "https://github.com/stacksjs/stacks/tree/main/.stacks/core/cli#readme",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/stacksjs/stacks.git",
+    "directory": "./.stacks/core/cli"
+  },
+  "bugs": {
+    "url": "https://github.com/stacksjs/stacks/issues"
+  },
+  "keywords": [
+    "cli",
+    "commands",
+    "command line interface",
+    "spinners",
+    "utilities",
+    "helpers",
+    "cac",
+    "ora",
+    "consola",
+    "ez-spawn",
+    "stacks"
+  ],
+  "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": {
+    "@antfu/install-pkg": "^0.1.1",
+    "@stacksjs/config": "workspace:*",
+    "@stacksjs/error-handling": "workspace:*",
+    "@stacksjs/logging": "workspace:*",
+    "@stacksjs/path": "workspace:*",
+    "@stacksjs/types": "workspace:*",
+    "cac": "^6.7.14",
+    "execa": "^6.1.0",
+    "ora": "^6.1.2",
+    "prompts": "^2.4.2"
+  },
+  "devDependencies": {
+    "@stacksjs/testing": "workspace:*",
+    "esno": "^0.16.3",
+    "mkdist": "^1.0.0"
+  }
+}

package/core/cli/src/actions/index.ts

@@ -0,0 +1,2 @@
+export * from './install'
+export * from './run'

package/core/cli/src/actions/install.ts

@@ -0,0 +1,22 @@
+import { installPackage as installPkg } from '@antfu/install-pkg'
+import type { CommandResult } from '@stacksjs/types'
+
+/**
+ * Install an npm package.
+ *
+ * @param pkg - The package name to install.
+ * @returns The result of the install.
+ */
+export async function installPackage(pkg: string): Promise<CommandResult<string>> {
+  return await installPkg(pkg, { silent: true })
+}
+
+/**
+ * Install a Stack into your project.
+ *
+ * @param pkg - The Stack name to install.
+ * @returns The result of the install.
+ */
+export async function installStack(name: string): Promise<CommandResult<string>> {
+  return await installPkg(`@stacksjs/${name}`, { silent: true })
+}

package/core/cli/src/actions/run.ts

@@ -0,0 +1,72 @@
+import type { CliOptions, CommandResult, Result, SpinnerOptions as Spinner } from '@stacksjs/types'
+import { determineDebugMode } from '@stacksjs/config'
+import { ResultAsync } from '@stacksjs/error-handling'
+import { projectPath } from '@stacksjs/path'
+import { italic } from '../'
+import { spawn } from '../command'
+import { startAnimation } from '../helpers'
+
+/**
+ * Execute a command.
+ *
+ * @param command The command to execute.
+ * @param options The options to pass to the command.
+ * @param errorMsg The name of the error to throw if the command fails.
+ * @returns The result of the command.
+ */
+export function exec(command: string, options?: CliOptions) {
+  const cwd = options?.cwd || projectPath()
+  const stdio = determineDebugMode(options) ? 'inherit' : 'ignore'
+
+  return ResultAsync.fromPromise(
+    spawn(command, { stdio, cwd }),
+    () => new Error(`Failed to execute command: ${italic(command)}`),
+  )
+}
+
+/**
+ * Run a command the Stacks way.
+ *
+ * @param command The command to run.
+ * @param options The options to pass to the command.
+ * @returns The result of the command.
+ */
+export async function runCommand(command: string, options?: CliOptions) {
+  return await exec(command, options)
+}
+
+/**
+ * Run many commands—the Stacks way.
+ *
+ * @param commands The command to run.
+ * @param options The options to pass to the command.
+ * @returns The result of the command.
+ */
+export async function runCommands(commands: string[], options?: CliOptions): Promise<Result<CommandResult<string>, Error>[]> {
+  let spinner: Spinner | undefined
+
+  if (!determineDebugMode(options))
+    spinner = startAnimation()
+
+  const results: Result<CommandResult<string>, Error>[] = []
+
+  for (const command of commands) {
+    const result = await runCommand(command, options)
+
+    if (result.isOk())
+      results.push(result)
+
+    if (result.isErr()) {
+      if (spinner)
+        spinner.fail('Failed to run command.')
+
+      results.push(result)
+      break
+    }
+  }
+
+  if (spinner)
+    spinner.stop()
+
+  return results
+}

package/core/cli/src/command.ts

@@ -0,0 +1,7 @@
+import cac from 'cac'
+import { execaCommand } from 'execa'
+
+const spawn = execaCommand
+const command = cac
+
+export { spawn, command }

package/core/cli/src/console.ts

@@ -0,0 +1,6 @@
+import { log } from '@stacksjs/logging'
+import Prompts from 'prompts'
+
+const { prompts } = Prompts
+
+export { log, prompts }

package/core/cli/src/helpers.ts

@@ -0,0 +1,58 @@
+import type { IntroOptions, OutroOptions } from '@stacksjs/types'
+import { version } from '../package.json'
+import { log } from './console'
+import { spinner } from './spinner'
+import { bgCyan, bold, cyan, dim, green, italic, red } from './utilities'
+
+/**
+ * Prints the intro message.
+ */
+export function intro(command: string, options?: IntroOptions) {
+  console.log()
+
+  console.log(cyan(bold('Stacks CLI')) + dim(` v${version}`))
+  console.log()
+
+  log.info(`Preparing to run the  ${bgCyan(italic(bold(` ${command} `)))}  command.`)
+
+  if (options?.showPerformance === false)
+    return
+
+  return performance.now()
+}
+
+/**
+ * Prints the outro message.
+ */
+export function outro(text: string, options: OutroOptions, error?: Error) {
+  if (options.isError) {
+    if (error)
+      log.error(error)
+  }
+  else { log.success(text) }
+
+  if (options.startTime) {
+    let time = performance.now() - options.startTime
+
+    if (options.useSeconds) {
+      time = time / 1000
+      time = Math.round(time * 100) / 100 // https://stackoverflow.com/a/11832950/7811162
+    }
+
+    if (options.isError)
+      log.error(red(`in ${time}${options.useSeconds ? 's' : 'ms'}`))
+    else
+      log.success(green(`Done in ${time}${options.useSeconds ? 's' : 'ms'}`))
+  }
+}
+
+export function startAnimation() {
+  const spin = spinner('Running...').start()
+  const pleaseWait = 'This may take a little while...'
+
+  setTimeout(() => {
+    spin.text = italic(pleaseWait)
+  }, 5000)
+
+  return spin
+}

package/core/cli/src/index.ts

@@ -0,0 +1,8 @@
+export * from './actions'
+export * from './command'
+export * from './console'
+export * from './helpers'
+export * from './spinner'
+export * from './utilities'
+
+export { ExitCode } from '@stacksjs/types'

package/core/cli/src/spinner.ts

@@ -0,0 +1,3 @@
+import ora from 'ora'
+
+export const spinner = ora

package/core/cli/src/utilities.ts

@@ -0,0 +1 @@
+export { ansi256Bg, bgBlack, bgBlue, bgCyan, bgGray, bgGreen, bgLightBlue, bgLightCyan, bgLightGray, bgLightGreen, bgLightMagenta, bgLightRed, bgLightYellow, bgMagenta, bgRed, bgWhite, bgYellow, black, blue, bold, cyan, dim, gray, green, hidden, inverse, italic, lightBlue, lightCyan, lightGray, lightGreen, lightMagenta, lightRed, lightYellow, link, magenta, red, reset, strikethrough, underline, white, yellow } from 'kolorist'

package/core/cli/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/cloud/README.md

@@ -0,0 +1,59 @@
+# Stacks Cloud
+
+This package assists you in setting up & maintaining your application's cloud infrastructure.
+
+## ☘️ Features
+
+- Cloud Creation & Management
+- Domain Management
+- Stacks Buddy Commands
+
+### TODO
+
+- [ ] Driver: AWS
+
+## 🤖 Usage
+
+```bash
+pnpm i -D @stacksjs/cloud
+```
+
+Now, you can use it in your project:
+
+```ts
+import cloud from '@stacksjs/cloud'
+
+// wip
+```
+
+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/cloud/dist/actions/README.md

@@ -0,0 +1,53 @@
+# Actions
+
+Placeholder for the "On-The-Fly API."
+
+## ☘️ Features
+
+- ⚡️
+
+## 🤖 Usage
+
+```bash
+pnpm i -D @stacksjs/cloud
+```
+
+Now, you can use it in your project:
+
+```js
+import { actions } from '@stacksjs/cloud'
+
+// wip
+```
+
+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/cloud/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/cloud/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