stacks 0.41.1 → 0.44.9

package/core/actions/src/update.ts

@@ -0,0 +1,149 @@
+import { intro, log, outro, prompts, runCommand, spawn } from '@stacksjs/cli'
+import storage from '@stacksjs/storage'
+import { loop } from '@stacksjs/utils'
+import { determineDebugMode } from '@stacksjs/config'
+import { frameworkPath, projectPath } from '@stacksjs/path'
+import type { UpdateOptions } from '@stacksjs/types'
+import { ExitCode, NpmScript } from '@stacksjs/types'
+
+export async function invoke(options?: UpdateOptions) {
+  if (options?.framework || options?.all)
+    await updateFramework(options)
+
+  if (options?.dependencies || options?.all)
+    await updateDependencies(options)
+
+  if (options?.packageManager || options?.all)
+    await updatePackageManager(options)
+
+  if (options?.node || options?.all)
+    await updateNode(options)
+
+  else
+    process.exit(ExitCode.InvalidArgument)
+
+  // TODO: also update CI files & configurations, and other files, possibly
+  // we want this to be smart enough to update only if files that have been updated
+  // TODO: this script should trigger regeneration of auto-imports.d.ts & components.d.ts
+}
+
+/**
+ * An alias of the invoke method.
+ * @param options
+ * @returns
+ */
+export async function update(options: UpdateOptions) {
+  return await invoke(options)
+}
+
+export async function checkForUncommittedChanges(path = './.stacks', options: UpdateOptions) {
+  try {
+    const stdio = determineDebugMode(options) ? 'inherit' : 'ignore'
+
+    // check if the .stacks folder has any updates
+    // https://carlosbecker.com/posts/git-changed/
+    await spawn(`git diff --quiet HEAD -- ${path}`, { stdio, cwd: projectPath() })
+  }
+  catch (error: any) {
+    if (error.status === 1) {
+      // even though the ./.stacks folder should not be edited, instead config values should be adjusted,
+      // there is a chance that users may apply local core edits, as it's totally acceptable, as long as
+      // the user knows what they are doing. There is also a change that simply the deps within .stacks
+      // folder have been updated and that could produce a diff.
+      if (!options?.force) {
+        const answer = await prompts.confirm({
+          type: 'select',
+          name: 'framework-update',
+          message: 'We detected there are uncommitted in the ./stacks folder. Do you want to overwrite those?',
+        })
+
+        // @ts-expect-error the answer object type expects to return a void type but it returns boolean
+        if (!answer) {
+          log.info('Aborted. Stacks did not update itself.')
+          log.info('Note: if you commit your changes and replay the update, you can see what changed.')
+          process.exit(ExitCode.Success)
+        }
+      }
+    }
+  }
+}
+
+export async function updateFramework(options: UpdateOptions) {
+  const perf = intro('buddy update:framework')
+
+  await checkForUncommittedChanges('./.stacks', options)
+  await downloadFrameworkUpdate(options)
+
+  log.info('Updating framework...')
+
+  const exclude = ['functions/package.json', 'components/vue/package.json', 'components/web/package.json', 'auto-imports.d.ts', 'components.d.ts', 'dist']
+  await storage.deleteFiles(frameworkPath(), exclude)
+
+  // loop 5 times to make sure all "deep empty" folders are deleted
+  loop(5, async () => {
+    await storage.deleteEmptyFolders(frameworkPath())
+  })
+
+  await storage.copyFolder(frameworkPath(), projectPath('./updates/.stacks'), exclude)
+
+  if (determineDebugMode(options))
+    log.info('Cleanup...')
+
+  await storage.deleteFolder(projectPath('updates'))
+
+  outro('Framework updated', { startTime: perf, useSeconds: true })
+  process.exit()
+}
+
+export async function downloadFrameworkUpdate(options: UpdateOptions) {
+  const tempFolderName = 'updates'
+  const tempUpdatePath = projectPath(tempFolderName)
+
+  if (storage.doesFolderExist(tempUpdatePath))
+    await deleteFolder(tempUpdatePath)
+
+  log.info('Downloading framework updates...')
+  await runCommand(`giget stacks ${tempFolderName}`, options)
+  const version = (await storage.readJsonFile(projectPath(`${tempFolderName}/.stacks/version`))).data
+  log.success('Your framework updated correctly to version: ', version)
+}
+
+export async function updateDependencies(options: UpdateOptions) {
+  const perf = intro('buddy update:dependencies')
+  const result = await runCommand(NpmScript.UpdateDependencies, options)
+
+  if (result.isErr()) {
+    outro('While running the update:dependencies command, there was an issue', { startTime: perf, useSeconds: true, isError: true }, result.error)
+    process.exit()
+  }
+
+  outro('Freshly updated your dependencies.', { startTime: perf, useSeconds: true })
+  process.exit()
+}
+
+export async function updatePackageManager(options: UpdateOptions) {
+  const perf = intro('buddy update:package-manager')
+  const version = options?.version || 'latest'
+  const result = await runCommand(`corepack prepare pnpm@${version} --activate`, options)
+
+  if (result.isErr()) {
+    outro('While running the update:package-manager command, there was an issue', { startTime: perf, useSeconds: true, isError: true }, result.error)
+    process.exit()
+  }
+
+  outro(`Updated to version: ${version}`, { startTime: perf, useSeconds: true })
+  process.exit()
+}
+
+export async function updateNode(options: UpdateOptions) {
+  const perf = intro('buddy update:node')
+  const result = await runCommand(NpmScript.UpdateNode, options)
+
+  if (result.isErr()) {
+    outro('While running the update:node command, there was an issue', { startTime: perf, useSeconds: true, isError: true }, result.error)
+    process.exit()
+  }
+
+  outro(`Updated your project's Node.js version to: ${process.version}`, { startTime: perf, useSeconds: true })
+  process.exit()
+}

package/core/actions/test.ts

@@ -0,0 +1,10 @@
+import { runAction } from './src'
+
+const result = await runAction('generate-lib-entries')
+
+if (result.isErr()) {
+  console.error(result.error)
+  process.exit()
+}
+
+// console.log(result.value)

package/core/actions/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/ai/README.md

@@ -0,0 +1,62 @@
+# Stacks AI
+
+This package contains a pretty wrapper for the OpenAI API.
+
+## ☘️ Features
+
+- 🔎 Pretty API wrapper
+- 🤷🏼‍♂️ git Diff Interpreter
+- 🪐 GitHub integration
+- 💨 Zero-config
+- 🐶 Buddy CLI commands
+
+## TODO
+
+- [ ] Driver: OpenAI
+
+## 🤖 Usage
+
+```bash
+pnpm i -D @stacksjs/ai
+```
+
+You may now use:
+
+```ts
+import { useAI } from '@stacksjs/ai'
+
+const client = useAI()
+// client...
+```
+
+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/ai/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/ai/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/ai/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/ai/package.json

@@ -0,0 +1,55 @@
+{
+  "name": "@stacksjs/ai",
+  "type": "module",
+  "version": "0.44.9",
+  "packageManager": "pnpm@7.18.2",
+  "description": "Stacks Artificial Intelligence.",
+  "author": "Chris Breuer",
+  "license": "MIT",
+  "funding": "https://github.com/sponsors/chrisbbreuer",
+  "homepage": "https://github.com/stacksjs/stacks/tree/main/.stacks/core/ai#readme",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/stacksjs/stacks.git",
+    "directory": "./.stacks/core/ai"
+  },
+  "bugs": {
+    "url": "https://github.com/stacksjs/stacks/issues"
+  },
+  "keywords": [
+    "ai",
+    "openai",
+    "artificial intelligence",
+    "api",
+    "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": {
+    "@stacksjs/cli": "workspace:*",
+    "@stacksjs/config": "workspace:*"
+  },
+  "devDependencies": {
+    "@stacksjs/testing": "workspace:*",
+    "mkdist": "^1.0.0",
+    "typescript": "^4.9.4"
+  }
+}

package/core/ai/src/drivers/openai.ts

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

package/core/ai/src/index.ts

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

package/core/ai/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/alias/README.md

@@ -0,0 +1,62 @@
+# Stacks AI
+
+This package contains a pretty wrapper for the OpenAI API.
+
+## ☘️ Features
+
+- 🔎 Pretty API wrapper
+- 🤷🏼‍♂️ git Diff Interpreter
+- 🪐 GitHub integration
+- 💨 Zero-config
+- 🐶 Buddy CLI commands
+
+## TODO
+
+- [ ] Driver: OpenAI
+
+## 🤖 Usage
+
+```bash
+pnpm i -D @stacksjs/ai
+```
+
+You may now use:
+
+```ts
+import { useAI } from '@stacksjs/ai'
+
+const client = useAI()
+// client...
+```
+
+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/alias/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/alias/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/alias/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/alias/package.json

@@ -0,0 +1,51 @@
+{
+  "name": "@stacksjs/alias",
+  "type": "module",
+  "version": "0.44.9",
+  "packageManager": "pnpm@7.18.2",
+  "description": "The Stacks aliases.",
+  "author": "Chris Breuer",
+  "license": "MIT",
+  "funding": "https://github.com/sponsors/chrisbbreuer",
+  "homepage": "https://github.com/stacksjs/stacks/tree/main/.stacks/core/alias#readme",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/stacksjs/stacks.git",
+    "directory": "./.stacks/core/alias"
+  },
+  "bugs": {
+    "url": "https://github.com/stacksjs/stacks/issues"
+  },
+  "keywords": [
+    "alias",
+    "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": {
+    "@stacksjs/path": "workspace:*"
+  },
+  "devDependencies": {
+    "@stacksjs/testing": "workspace:*",
+    "mkdist": "^1.0.0",
+    "typescript": "^4.9.4"
+  }
+}

package/core/alias/src/index.ts

@@ -0,0 +1,84 @@
+/**
+ * The following configuration references local aliases.
+ */
+
+import p from '@stacksjs/path'
+
+const alias: Record<string, string> = {
+  '~/*': p.projectPath('*'),
+  '@stacksjs/ai': p.aiPath('src/index.ts'),
+  '@stacksjs/ai/*': p.aiPath('src/*'),
+  '@stacksjs/actions': p.actionsPath('src/index.ts'),
+  '@stacksjs/actions/*': p.actionsPath('src/*'),
+  '@stacksjs/alias': p.aliasPath(),
+  '@stacksjs/arrays': p.arraysPath('src/index.ts'),
+  '@stacksjs/arrays/*': p.arraysPath('src/*'),
+  '@stacksjs/auth': p.authPath('src/index.ts'),
+  '@stacksjs/auth/*': p.authPath('src/*'),
+  '@stacksjs/build': p.buildPath('src/index.ts'),
+  '@stacksjs/build/*': p.buildPath('src/*'),
+  '@stacksjs/cache': p.cachePath('src/index.ts'),
+  '@stacksjs/cache/*': p.cachePath('src/*'),
+  '@stacksjs/cli': p.cliPath('src/index.ts'),
+  '@stacksjs/cli/*': p.cliPath('src/*'),
+  '@stacksjs/collections': p.collectionsPath('src/index.ts'),
+  '@stacksjs/collections/*': p.collectionsPath('src/*'),
+  '@stacksjs/config': p.configPath(),
+  '@stacksjs/config/*': p.projectPath('config/*'),
+  '@stacksjs/dashboard': p.dashboardPath('src/index.ts'),
+  '@stacksjs/dashboard/*': p.dashboardPath('src/*'),
+  // '@stacksjs/desktop': p.desktopPath('src/index.ts'),
+  // '@stacksjs/desktop/*': p.desktopPath('src/*'),
+  '@stacksjs/docs': p.docsPath('src/index.ts'),
+  '@stacksjs/docs/*': p.docsPath('src/*'),
+  '@stacksjs/domains': p.domainsPath('src/index.ts'),
+  '@stacksjs/domains/*': p.domainsPath('src/*'),
+  '@stacksjs/drivers': p.driversPath('src/index.ts'),
+  '@stacksjs/drivers/*': p.driversPath('src/*'),
+  '@stacksjs/error-handling': p.errorHandlingPath('src/index.ts'),
+  '@stacksjs/error-handling/*': p.errorHandlingPath('src/*'),
+  '@stacksjs/storage': p.fsPath('src/index.ts'),
+  '@stacksjs/storage/*': p.fsPath('src/*'),
+  '@stacksjs/git': p.gitPath('src/index.ts'),
+  '@stacksjs/git/*': p.gitPath('src/*'),
+  '@stacksjs/lint': p.lintPath('src/index.ts'),
+  '@stacksjs/lint/*': p.lintPath('src/*'),
+  '@stacksjs/logging': p.loggingPath('src/index.ts'),
+  '@stacksjs/logging/*': p.loggingPath('src/*'),
+  '@stacksjs/x-ray': p.xRayPath('src/index.ts'),
+  '@stacksjs/x-ray/*': p.xRayPath('src/*'),
+  '@stacksjs/modules/*': p.modulesPath('src/*'),
+  '@stacksjs/notifications': p.notificationsPath('src/index.ts'),
+  '@stacksjs/notifications/*': p.notificationsPath('src/*'),
+  '@stacksjs/objects': p.objectsPath('src/index.ts'),
+  '@stacksjs/objects/*': p.objectsPath('src/*'),
+  '@stacksjs/path': p.pathPath('src/index.ts'), // 🤦🏼‍♂️
+  '@stacksjs/path/*': p.pathPath('src/*'),
+  '@stacksjs/router': p.routerPath('src/index.ts'),
+  '@stacksjs/router/*': p.routerPath('src/*'),
+  '@stacksjs/search-engine': p.searchEnginePath('src/index.ts'),
+  '@stacksjs/search-engine/*': p.searchEnginePath('src/*'),
+  '@stacksjs/security': p.securityPath('src/index.ts'),
+  '@stacksjs/security/*': p.securityPath('src/*'),
+  '@stacksjs/server': p.serverPath('src/index.ts'),
+  '@stacksjs/server/*': p.serverPath('src/*'),
+  '@stacksjs/serverless': p.serverlessPath('src/index.ts'),
+  '@stacksjs/serverless/*': p.serverlessPath('src/*'),
+  '@stacksjs/strings': p.stringsPath('src/index.ts'),
+  '@stacksjs/strings/*': p.stringsPath('src/*'),
+  '@stacksjs/testing/*': p.testingPath('*'),
+  '@stacksjs/types': p.typesPath('src/index.ts'),
+  '@stacksjs/types/*': p.typesPath('src/*'),
+  '@stacksjs/ui': p.uiPath('src/index.ts'),
+  '@stacksjs/ui/*': p.uiPath('src/*'),
+  '@stacksjs/utils': p.utilsPath('src/index.ts'),
+  '@stacksjs/utils/*': p.utilsPath('src/*'),
+  'framework/*': p.frameworkPath('*'),
+  'stacks': p.frameworkPath('src/index.ts'),
+  'config/*': p.projectPath('config/*'),
+  'components/*': p.componentsPath('*'),
+  'functions/*': p.functionsPath('*'),
+  'pages/*': p.pagesPath('*'),
+}
+
+export { alias }

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

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