@stacksjs/actions 0.58.73 → 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.73",
+  "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

@@ -1,20 +1,23 @@
 import process from 'node:process'
-import { runCommand } from '@stacksjs/cli'
+import { $ } from 'bun'
 import { findStacksProjects } from '@stacksjs/utils'
+import { log } from '@stacksjs/logging'
 
 const projects = await findStacksProjects(undefined, { quiet: true })
 
-// eslint-disable-next-line no-console
-console.log('projects', projects)
+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) {
-  // eslint-disable-next-line no-console
-  console.log('project', project)
+  log.debug('Running `buddy ports`')
+  log.debug('Project:', project)
+
   // this right now causes a loop of the same project
-  const ports = await runCommand(`buddy ports --project ${project}`)
-  // eslint-disable-next-line no-console
-  console.log('proj', project)
+  $.cwd(project)
+  const ports = await $`./buddy ports --project ${project} --quiet`.text()
+
   // eslint-disable-next-line no-console
   console.log('ports', ports)
 }

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/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

@@ -1,7 +1,7 @@
 import process from 'node:process'
 import { findStacksProjects } from '@stacksjs/utils'
 import { log } from '@stacksjs/logging'
-import { parseOptions } from 'stacks/cli'
+import { parseOptions } from '@stacksjs/cli'
 
 try {
   const options = parseOptions()

package/src/generate/index.ts

@@ -5,7 +5,7 @@ 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'
 

package/src/helpers/utils.ts

@@ -1,10 +1,9 @@
-import * as storage from '@stacksjs/storage'
 import { buddyOptions, runCommand, runCommands } from '@stacksjs/cli'
+import { storage } from '@stacksjs/storage'
 import { log } from '@stacksjs/logging'
+import { err } from '@stacksjs/error-handling'
 import * as p from '@stacksjs/path'
-import type { ActionOptions, Subprocess } from '@stacksjs/types'
-import type { Result } from '@stacksjs/error-handling'
-import { err, handleError } from '@stacksjs/error-handling'
+import type { ActionOptions } from '@stacksjs/types'
 
 /**
  * Run an Action the Stacks way.
@@ -13,9 +12,9 @@ import { err, handleError } from '@stacksjs/error-handling'
  * @param options The options to pass to the command.
  * @returns The result of the command.
  */
-export async function runAction(action: string, options?: ActionOptions): Promise<Result<Subprocess, Error>> {
+export async function runAction(action: string, options?: ActionOptions) {
   const opts = buddyOptions()
-  const path = p.relativeActionsPath(`${action}.ts`)
+  const path = p.relativeActionsPath(`src/${action}.ts`)
   const cmd = `bun --bun ${path} ${opts}`.trimEnd()
   const optionsWithCwd = {
     cwd: options?.cwd || p.projectPath(),
@@ -25,9 +24,6 @@ export async function runAction(action: string, options?: ActionOptions): Promis
   log.debug('runAction:', cmd)
   log.debug('action options:', optionsWithCwd)
 
-  if (!hasAction(action))
-    return err(handleError(`The specified action "${action}" does not exist`))
-
   return await runCommand(cmd, optionsWithCwd)
 }
 
@@ -46,6 +42,7 @@ export async function runActions(actions: string[], options?: ActionOptions) {
     return err('No actions were specified')
 
   for (const action of actions) {
+    log.debug(`running action "${action}"`)
     if (!hasAction(action))
       return err(`The specified action "${action}" does not exist`)
   }
@@ -57,14 +54,13 @@ export async function runActions(actions: string[], options?: ActionOptions) {
     ...options,
   }
 
-  const commands = actions.map(action => `bun --bun ${p.relativeActionsPath(`${action}.ts`)} ${opts}`)
+  const commands = actions.map(action => `bun --bun ${p.relativeActionsPath(`src/${action}.ts`)} ${opts}`)
+
+  log.debug('commands:', commands)
 
   return await runCommands(commands, o)
 }
 
 export function hasAction(action: string) {
-  if (storage.isFile(p.functionsPath(`actions/${action}.ts`)))
-    return true
-
-  return storage.isFile(p.actionsPath(`${action}.ts`))
+  return storage.isFile(p.actionsPath(`src/${action}.ts`))
 }

package/src/index.ts

@@ -1,9 +1,8 @@
 export * from './action'
 export * from './dev'
 export * from './generate'
-export * from './helpers'
+export * from './helpers/utils'
 
-export { examples as runExample } from './examples'
 export { commit as runCommit } from './commit'
 export { add as runAdd } from './add'
 

package/src/lint/fix.ts

@@ -2,6 +2,7 @@ import { log, parseOptions, runCommand } from '@stacksjs/cli'
 import { projectPath } from '@stacksjs/path'
 import { NpmScript } from '@stacksjs/enums'
 
+// TODO: this should be a loader
 log.info('Ensuring Code Style...')
 
 const options = parseOptions()

package/src/upgrade/shell.ts

@@ -1,10 +1,10 @@
 import process from 'node:process'
 import { $ } from 'bun'
-import { path as p } from 'stacks/path'
-import { log } from 'stacks/logging'
-import { ExitCode } from 'stacks/types'
-import { writeFile } from 'stacks/storage'
-import { italic, runCommand } from 'stacks/cli'
+import { path as p } from '@stacksjs/path'
+import { log } from '@stacksjs/logging'
+import { ExitCode } from '@stacksjs/types'
+import { writeFile } from '@stacksjs/storage'
+import { italic, runCommand } from '@stacksjs/cli'
 
 const homePath = (await $`echo $HOME`.text()).trim()
 const zshrcPath = p.join(homePath, '.zshrc')

package/dist/src/add.js

@@ -1,29 +0,0 @@
-// @bun
-// src/add.ts
-import {installPackage} from "@stacksjs/cli";
-async function invoke(options) {
-  if (options?.table)
-    await addTable();
-  if (options?.calendar)
-    await addCalendar();
-}
-async function add(options) {
-  return invoke(options);
-}
-async function addTable() {
-  await installPackage("@stacksjs/table");
-}
-async function addCalendar() {
-  await installPackage("@stacksjs/calendar");
-}
-async function installPackages(names) {
-  for (const name of names)
-    await installPackage(name);
-}
-export {
-  invoke,
-  installPackages,
-  addTable,
-  addCalendar,
-  add
-};

package/dist/src/build/component-libs.js

@@ -1,6 +0,0 @@
-// @bun
-// src/build/component-libs.ts
-import {frameworkPath} from "@stacksjs/path";
-import {runCommand} from "@stacksjs/cli";
-import {NpmScript} from "@stacksjs/enums";
-await runCommand(NpmScript.BuildComponents, { cwd: frameworkPath(), verbose: true });