@stacksjs/actions 0.58.72 → 0.59.1

package/dist/action.d.ts

@@ -0,0 +1,36 @@
+import type { JobOptions, Nullable } from '@stacksjs/types';
+import type { ValidationBoolean, ValidationNumber, ValidationString } from '@stacksjs/validation';
+type FieldKey = string;
+interface FieldValue {
+    rule: ValidationString | ValidationNumber | ValidationBoolean | Date | Nullable<any>;
+    message: string;
+    factory?: any;
+    unique?: boolean;
+}
+interface Request {
+    message: string;
+    level: 'info' | 'warn' | 'error';
+}
+interface ActionOptions {
+    name?: string;
+    description?: string;
+    fields?: Record<FieldKey, FieldValue>;
+    path?: string;
+    rate?: JobOptions['rate'];
+    tries?: JobOptions['tries'];
+    backoff?: JobOptions['backoff'];
+    enabled?: JobOptions['enabled'];
+    handle: (request?: Request) => Promise<any> | object | string;
+}
+export declare class Action {
+    name?: string;
+    description?: string;
+    fields?: Record<FieldKey, FieldValue>;
+    rate?: JobOptions['rate'];
+    tries?: JobOptions['tries'];
+    backoff?: JobOptions['backoff'];
+    enabled?: boolean;
+    handle: (request?: Request) => Promise<any> | object | string;
+    constructor({ name, description, fields, handle, rate, tries, backoff, enabled }: ActionOptions);
+}
+export {};

package/dist/add.d.ts

@@ -0,0 +1,6 @@
+import type { AddOptions } from '@stacksjs/types';
+export declare function invoke(options: AddOptions): Promise<void>;
+export declare function add(options: AddOptions): Promise<void>;
+export declare function addTable(): Promise<void>;
+export declare function addCalendar(): Promise<void>;
+export declare function installPackages(names: string[]): Promise<void>;

package/dist/build/component-libs.d.ts

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

package/dist/build/core.d.ts

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

package/dist/build/stacks.d.ts

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

package/dist/build.d.ts

@@ -0,0 +1,9 @@
+import type { BuildOptions } from '@stacksjs/types';
+export declare function invoke(options: BuildOptions): Promise<void>;
+export declare function build(options: BuildOptions): Promise<void>;
+export declare function componentLibraries(options: BuildOptions): Promise<void>;
+export declare function vueComponentLibrary(options: BuildOptions): Promise<void>;
+export declare function webComponentLibrary(options: BuildOptions): Promise<void>;
+export declare function docs(options: BuildOptions): Promise<void>;
+export declare function stacks(options: BuildOptions): Promise<void>;
+export declare function functionsLibrary(options: BuildOptions): Promise<void>;

package/dist/bump.d.ts

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

package/dist/changelog.d.ts

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

package/dist/clean.d.ts

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

package/dist/commit.d.ts

@@ -0,0 +1,3 @@
+import type { CleanOptions } from '@stacksjs/types';
+export declare function invoke(options: CleanOptions): Promise<void>;
+export declare function commit(options: CleanOptions): Promise<void>;

package/dist/copy-types.d.ts

@@ -0,0 +1,5 @@
+#!/usr/bin/env bun
+/**
+ * This action copies all the generated types.
+ */
+export {};

package/dist/database/seed.d.ts

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

package/dist/deploy/index.d.ts

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

package/dist/dev/components.d.ts

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

package/dist/dev/docs.d.ts

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

package/dist/dev/index.d.ts

@@ -0,0 +1,10 @@
+import type { DevOptions } from '@stacksjs/types';
+export declare function runDevServer(options: DevOptions): Promise<void>;
+export declare function runFrontendDevServer(options: DevOptions): Promise<void>;
+export declare function runBackendDevServer(options: DevOptions): Promise<void>;
+export declare function runApiDevServer(options: DevOptions): Promise<void>;
+export declare function runComponentsDevServer(options: DevOptions): Promise<void>;
+export declare function runDashboardDevServer(options: DevOptions): Promise<void>;
+export declare function runSystemTrayDevServer(options: DevOptions): Promise<void>;
+export declare function runDesktopDevServer(options: DevOptions): Promise<void>;
+export declare function runDocsDevServer(options: DevOptions): Promise<void>;

package/dist/examples.d.ts

@@ -0,0 +1,5 @@
+import type { ExamplesOptions } from '@stacksjs/types';
+export declare function invoke(options: ExamplesOptions): Promise<void>;
+export declare function examples(options: ExamplesOptions): Promise<void>;
+export declare function componentExample(options: ExamplesOptions): Promise<void>;
+export declare function webComponentExample(options: ExamplesOptions): Promise<void>;

package/dist/fresh.d.ts

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

package/dist/generate/component-meta.d.ts

@@ -0,0 +1,5 @@
+#!/usr/bin/env bun
+/**
+ * This action generates the component meta.
+ */
+export {};

package/dist/generate/ide-helpers.d.ts

@@ -0,0 +1,6 @@
+#!/usr/bin/env bun
+/**
+ * This action generates the web-types.json & custom-elements.json
+ * files for the components.
+ */
+export {};

package/dist/generate/index.d.ts

@@ -0,0 +1,13 @@
+import type { GeneratorOptions } from '@stacksjs/types';
+export declare function invoke(options?: GeneratorOptions): Promise<void>;
+export declare function generate(options: GeneratorOptions): Promise<void>;
+export declare function generateLibEntries(options: GeneratorOptions): Promise<void>;
+export declare function generateWebTypes(options?: GeneratorOptions): Promise<void>;
+export declare function generateVsCodeCustomData(options?: GeneratorOptions): Promise<void>;
+export declare function generateIdeHelpers(options?: GeneratorOptions): Promise<void>;
+export declare function generateComponentMeta(options?: GeneratorOptions): Promise<void>;
+export declare function generateTypes(options?: GeneratorOptions): Promise<void>;
+export declare function generateMigrations(): void;
+export declare function generatePkgxConfig(): void;
+export declare function generateSeeder(): Promise<void>;
+export declare function generateCoreSymlink(): Promise<void>;

package/dist/generate/lib-entries.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env bun
+export {};

package/dist/generate/vscode-custom-data.d.ts

@@ -0,0 +1,6 @@
+#!/usr/bin/env bun
+/**
+ * This action generates the web-types.json & custom-elements.json
+ * files for the components.
+ */
+export {};

package/dist/helpers/component-meta.d.ts

@@ -0,0 +1,22 @@
+import { type ComponentMeta } from 'vue-component-meta';
+/**
+ * ℹ️ Useful Links
+ *
+ * vue-component-meta tests: https://github.com/johnsoncodehk/volar/blob/master/vue-language-tools/vue-component-meta/tests/index.spec.ts
+ * Discord thread about improving vue-component-meta: https://discord.com/channels/793943652350427136/1027819645677350912
+ * GitHub issue for improving vue-component-meta based on runtime/dynamic props: https://github.com/johnsoncodehk/volar/issues/1854
+ * Discord chat: https://discord.com/channels/793943652350427136/1027819645677350912
+ * original script: https://raw.githubusercontent.com/jd-solanki/anu/main/scripts/gen-component-meta.ts
+ */
+export declare function generateComponentMeta(): void;
+export interface ComponentApiProps {
+    name: ComponentMeta['props'][number]['name'];
+    description: ComponentMeta['props'][number]['description'];
+    type: ComponentMeta['props'][number]['type'];
+    default: ComponentMeta['props'][number]['default'];
+}
+export interface ComponentApi {
+    props: ComponentApiProps[];
+    events: ComponentMeta['events'];
+    slots: ComponentMeta['slots'];
+}

package/dist/helpers/lib-entries.d.ts

@@ -0,0 +1,13 @@
+import type { LibraryType } from '@stacksjs/path';
+/**
+ * Based on the config values, this method
+ * will generate the library entry points.
+ *
+ * @param type LibraryType
+ */
+export declare function generateLibEntry(type: LibraryType): Promise<void>;
+export declare function createLibraryEntryPoint(type: LibraryType): Promise<void>;
+export declare function createVueLibraryEntryPoint(type?: LibraryType): Promise<void>;
+export declare function createWebComponentLibraryEntryPoint(type?: LibraryType): Promise<void>;
+export declare function createFunctionLibraryEntryPoint(type?: LibraryType): Promise<void>;
+export declare function generateEntryPointData(type: LibraryType): string;

package/dist/helpers/package-json.d.ts

@@ -0,0 +1,3 @@
+type PackageJsonType = 'vue-components' | 'web-components' | 'functions';
+export declare function generatePackageJson(type: PackageJsonType): Promise<void>;
+export {};

package/dist/helpers/utils.d.ts

@@ -0,0 +1,18 @@
+import type { ActionOptions } from '@stacksjs/types';
+/**
+ * Run an Action the Stacks way.
+ *
+ * @param action The action to invoke.
+ * @param options The options to pass to the command.
+ * @returns The result of the command.
+ */
+export declare function runAction(action: string, options?: ActionOptions): Promise<any>;
+/**
+ * Run Actions the Stacks way.
+ *
+ * @param actions The actions to invoke.
+ * @param options The options to pass to the command.
+ * @returns The result of the command.
+ */
+export declare function runActions(actions: string[], options?: ActionOptions): Promise<any>;
+export declare function hasAction(action: string): any;

package/dist/helpers/vscode-custom-data.d.ts

@@ -0,0 +1,2 @@
+export declare function generateVsCodeCustomData(): Promise<void>;
+export declare function generateWebTypes(): Promise<void>;

package/dist/index.d.ts

@@ -0,0 +1,7 @@
+export * from './action';
+export * from './dev';
+export * from './generate';
+export * from './helpers/utils';
+export { commit as runCommit } from './commit';
+export { add as runAdd } from './add';
+export { make as runMake, makeComponent, makeDatabase, makeFunction, makeLanguage, makeNotification, makePage, makeStack, createComponent, createDatabase, createFactory, createFunction, createLanguage, createMigration, createModel, createNotification, createPage, } from './make';

package/dist/key-generate.d.ts

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

package/dist/lint/fix.d.ts

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

package/dist/lint/index.d.ts

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

package/dist/make.d.ts

@@ -0,0 +1,20 @@
+import type { MakeOptions } from '@stacksjs/types';
+export declare function invoke(options: MakeOptions): Promise<void>;
+export declare function make(options: MakeOptions): Promise<void>;
+export declare function makeComponent(options: MakeOptions): Promise<void>;
+export declare function createComponent(options: MakeOptions): Promise<void>;
+export declare function makeDatabase(options: MakeOptions): void;
+export declare function createDatabase(options: MakeOptions): void;
+export declare function factory(options: MakeOptions): void;
+export declare function createFactory(options: MakeOptions): void;
+export declare function makeNotification(options: MakeOptions): Promise<void>;
+export declare function makePage(options: MakeOptions): Promise<void>;
+export declare function createPage(options: MakeOptions): Promise<void>;
+export declare function makeFunction(options: MakeOptions): Promise<void>;
+export declare function createFunction(options: MakeOptions): Promise<void>;
+export declare function makeLanguage(options: MakeOptions): Promise<void>;
+export declare function createLanguage(options: MakeOptions): Promise<void>;
+export declare function makeStack(options: MakeOptions): void;
+export declare function createNotification(options: MakeOptions): Promise<boolean>;
+export declare function createMigration(options: MakeOptions): Promise<void>;
+export declare function createModel(options: MakeOptions): Promise<void>;

package/dist/prepublish.d.ts

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

package/dist/release.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env bun
+export {};

package/dist/test/coverage.d.ts

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

package/dist/test/feature.d.ts

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

package/dist/test/ui.d.ts

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

package/dist/test/unit.d.ts

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

package/dist/test.d.ts

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

package/dist/tinker.d.ts

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

package/dist/typecheck.d.ts

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

package/dist/types.d.ts

@@ -0,0 +1,3 @@
+import type { TypesOptions } from '@stacksjs/types';
+export declare function invoke(options?: TypesOptions): Promise<void>;
+export declare function types(options: TypesOptions): Promise<void>;

package/dist/upgrade/dependencies.d.ts

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

package/dist/upgrade/framework.d.ts

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

package/dist/upgrade/index.d.ts

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

package/dist/upgrade.d.ts

@@ -0,0 +1,4 @@
+import type { UpgradeOptions } from '@stacksjs/types';
+export declare function checkForUncommittedChanges(options: UpgradeOptions): void;
+export declare function downloadFrameworkUpdate(options: UpgradeOptions): Promise<void>;
+export declare function updateDependencies(): Promise<void>;

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@stacksjs/actions",
   "type": "module",
-  "version": "0.58.72",
+  "version": "0.59.1",
   "description": "The Stacks actions.",
   "author": "Chris Breuer",
   "license": "MIT",
@@ -27,10 +27,12 @@
   "exports": {
     ".": {
       "bun": "./src/index.ts",
+      "types": "./dist/index.d.ts",
       "import": "./dist/index.js"
     },
     "./*": {
       "bun": "./src/*",
+      "types": "./dist/*.d.ts",
       "import": "./dist/*"
     }
   },
@@ -66,7 +68,7 @@
     "@stacksjs/utils": "latest",
     "@stacksjs/validation": "latest",
     "markdown-it": "^14.0.0",
-    "vue-component-meta": "^1.8.27"
+    "vue-component-meta": "^2.0.5"
   },
   "dependencies": {
     "@stacksjs/cli": "latest",
@@ -84,7 +86,7 @@
     "@stacksjs/utils": "latest",
     "@stacksjs/validation": "latest",
     "markdown-it": "^14.0.0",
-    "vue-component-meta": "^1.8.27"
+    "vue-component-meta": "^2.0.5"
   },
   "devDependencies": {
     "@stacksjs/development": "latest"

package/src/bump.ts

@@ -9,10 +9,15 @@ await runCommand(changelogCommand, {
 })
 
 const bumpCommand = options?.dryRun
-  ? 'bunx bumpp ./package.json ./core/**/package.json ./ide/vscode/package.json --no-push'
-  : 'bunx bumpp ./package.json ./core/**/package.json ./ide/vscode/package.json --all'
+  ? 'bunx bumpp ./package.json ./**/package.json ../ide/vscode/package.json --no-push'
+  : 'bunx bumpp ./package.json ./**/package.json ../ide/vscode/package.json --all'
+
+// eslint-disable-next-line no-console
+console.log(`Running: ${bumpCommand}`)
+// eslint-disable-next-line no-console
+console.log(`In frameworkPath: ${p.frameworkPath()}`)
 
 await runCommand(bumpCommand, {
-  cwd: p.frameworkPath(),
+  cwd: p.frameworkPath('core'),
   stdin: 'inherit',
 })

package/src/check/ports.ts

@@ -0,0 +1,27 @@
+import process from 'node:process'
+import { $ } from 'bun'
+import { findStacksProjects } from '@stacksjs/utils'
+import { log } from '@stacksjs/logging'
+
+const projects = await findStacksProjects(undefined, { quiet: true })
+
+log.debug('Running `buddy ports`')
+log.debug(`Found ${projects.length} projects`)
+log.debug('Projects:', projects)
+
+// need to loop over the projects and then trigger `buddy ports` for each project (which returns a list of ports)
+for (const project of projects) {
+  log.debug('Running `buddy ports`')
+  log.debug('Project:', project)
+
+  // this right now causes a loop of the same project
+  $.cwd(project)
+  const ports = await $`./buddy ports --project ${project} --quiet`.text()
+
+  // eslint-disable-next-line no-console
+  console.log('ports', ports)
+}
+
+process.exit(0)
+// then we can check if the port is in use and if it is, we can prompt the user to kill the process or to auto assign a new port
+// if the port is not in use, we can start the project

package/src/deploy/index.ts

@@ -5,7 +5,7 @@ import { path as p } from '@stacksjs/path'
 import { storage } from '@stacksjs/storage'
 
 await runCommand('bun run build', {
-  cwd: p.frameworkPath(),
+  cwd: p.corePath(),
 })
 
 if (storage.hasFiles(p.projectPath('docs'))) {
@@ -14,16 +14,12 @@ if (storage.hasFiles(p.projectPath('docs'))) {
   })
 }
 
-if (config.app.docMode !== true) { // when in docs mode, we disregard building views
+if (config.app.docMode !== true) { // when in docMode, we can disregard building views
   await runCommand('bun run build', {
     cwd: p.frameworkPath('views'),
   })
 }
 
-// await runCommand('bun run build-layer', {
-//   cwd: p.corePath('cloud'),
-// })
-
 // await runCommand('bun run build-edge', {
 //   cwd: p.corePath('cloud'),
 // })

package/src/dev/api.ts

@@ -8,7 +8,7 @@ const options = parseOptions()
 log.debug('Running API dev server via', `bunx vite --config ${p.vitePath('src/api.ts')}`, options)
 
 serve({
-  port: config.app.ports?.api, // defaults to 3999
+  port: config.ports?.api, // defaults to 3008
 })
 
 // the reason we start a Vite dev server next is because we need the Bun server proxied by vite

package/src/dev/index.ts

@@ -1,7 +1,7 @@
 import { log } from '@stacksjs/logging'
 import type { DevOptions } from '@stacksjs/types'
 import { Action } from '@stacksjs/enums'
-import { runAction } from '../helpers'
+import { runAction } from '../helpers/utils'
 
 export async function runDevServer(options: DevOptions) {
   log.info('Starting your Frontend Engine...')

package/src/find-projects.ts

@@ -0,0 +1,21 @@
+import process from 'node:process'
+import { findStacksProjects } from '@stacksjs/utils'
+import { log } from '@stacksjs/logging'
+import { parseOptions } from '@stacksjs/cli'
+
+try {
+  const options = parseOptions()
+  const projects = await findStacksProjects(undefined, options)
+
+  if (projects.length > 0) {
+    log.info('Found Projects:')
+    // eslint-disable-next-line no-console
+    projects.forEach(project => console.log(`   - ${project}`))
+    process.exit()
+  }
+
+  log.info('No Stacks Projects found.')
+}
+catch (error: any) {
+  log.error('Error searching for Stacks projects:', error)
+}

package/src/generate/action-types.ts

@@ -1,89 +1,25 @@
+import { readdir } from 'node:fs/promises'
 import { path as p } from '@stacksjs/path'
-import { storage } from '@stacksjs/storage'
-import { env as e, enums } from '@stacksjs/env'
 import { logger } from '@stacksjs/logging'
-import { envKeys } from '../../../../env'
-
-log.debug('Generating type Action types...')
-
-// generate ./storage/framework/types/env.d.ts file from .env
-const envTypes = `
-// This file is auto-generated by Stacks. Do not edit this file manually.
-// If you want to edit Action types, please edit the app/Actions/* validations
-//
-// For more information, please visit: https://stacksjs.org/docs
-
-declare module 'bun' {
-  namespace env {
-    ${envKeys.map((key) => {
-      let type: string | undefined = typeof e[key]
-      let value: string | boolean | number | undefined = e[key]
-
-      if (!value) {
-        if (enums[key]) {
-          type = enums[key]?.map(item => `'${item}'`).join(' | ')
-          value = enums[key]?.[0] // default to the first enum value
-        }
- else {
-          switch (type) {
-            case 'number':
-              value = '0'
-              break
-            case 'boolean':
-              value = false
-              break
-            default:
-              value = ''
-          }
-        }
-      }
-
-      type = 'string'
-      if (typeof value === 'string') {
-        if (value.toLowerCase() === 'true' || value.toLowerCase() === 'false') {
-          type = 'boolean'
-        }
-        else if (!Number.isNaN(Number.parseFloat(value)) && Number.isFinite(Number(value))) {
-          type = 'number'
-        }
-        else if (enums[key]) {
-          // @ts-expect-error enums[key] is defined
-          type = enums[key].map(item => `'${item}'`).join(' | ')
-        }
-      }
-
-      else if (typeof value === 'number') {
-        type = 'number'
-      }
-
-      else if (typeof value === 'boolean') {
-        type = 'boolean'
-      }
+import { storage } from '@stacksjs/storage'
 
-      return `const ${key}: ${type}`
-    }).join('\n    ')}
-  }
-}
-`
+logger.log('Generating action types...')
 
-await storage.writeFile(p.frameworkPath('types/env.d.ts'), envTypes)
+const domain = 'Actions'
 
-logger.log('  - ./storage/framework/env.ts')
+const files = await readdir(p.appPath(domain), { recursive: true })
 
-// generate ./storage/framework/env.ts file based on Bun.env
-const env = `
-// This file is auto-generated by Stacks. Do not edit this file manually.
-// If you want to change the environment variables, please edit the .env file.
+const validActions = `// This file is auto-generated by Stacks. Do not edit this file manually.
+// If you wish to rename an action, please do so by editing the file name.
 //
 // For more information, please visit: https://stacksjs.org/docs
 
-export const envKeys = [
-  ${envKeys.map(key => `'${key}'`).join(',\n  ')}
-] as const
-
-export type EnvKey = typeof envKeys[number]
+export type ActionPath = ${
+  files
+    .filter(file => file.endsWith('.ts'))
+    .map(value => `'${domain}/${value.replace('.ts', '')}'`)
+    .join(' | ')
+}
 `
 
-await storage.writeFile(p.frameworkPath('env.ts'), env)
-
-logger.log('  - ./storage/framework/env.d.ts')
+await storage.writeFile(p.frameworkPath('types/actions.d.ts'), validActions)

package/src/generate/custom-cli-file.ts

@@ -4,7 +4,7 @@ import { writeTextFile } from '@stacksjs/storage'
 import { projectPath } from '@stacksjs/path'
 import { cli } from '@stacksjs/config'
 
-log.info('Creating Vue Component Library Entry Point...')
+log.info('Ensuring Component Library Entry Point...')
 
 if (!cli.command) {
   log.error('No command defined in the CLI configuration')

package/src/generate/index.ts

@@ -2,9 +2,10 @@ import process from 'node:process'
 import { log } from '@stacksjs/logging'
 import { Action, NpmScript } from '@stacksjs/enums'
 import type { GeneratorOptions } from '@stacksjs/types'
+import { runCommand } from '@stacksjs/cli'
 import { runNpmScript } from '@stacksjs/utils'
 import { frameworkPath, projectPath } from '@stacksjs/path'
-import { runAction } from '../helpers'
+import { runAction } from '../helpers/utils'
 
 // import { files } from '@stacksjs/storage'
 
@@ -26,6 +27,9 @@ export async function invoke(options?: GeneratorOptions) {
 
   else if (options?.componentMeta)
     await generateComponentMeta(options)
+
+  else if (options?.coreSymlink)
+    await generateCoreSymlink()
 }
 
 export function generate(options: GeneratorOptions) {
@@ -124,9 +128,13 @@ export function generatePkgxConfig() {
   // write the yaml string to a file in your project root
   // files.put(projectPath('./pkgx.yaml'), yamlStr)
 
-  log.success('Successfully generated `./pkgx.yaml` based on your configs')
+  log.success('Successfully generated `./pkgx.yaml` based on your config')
 }
 
 export async function generateSeeder() {
   // await seed()
 }
+
+export async function generateCoreSymlink() {
+  await runCommand(`ln -s ${frameworkPath()} ${projectPath('.stacks')}`)
+}