@stacksjs/actions 0.58.72 → 0.59.1

package/src/generate/symlink-core.ts

@@ -0,0 +1,3 @@
+import { generateCoreSymlink } from '@stacksjs/actions'
+
+await generateCoreSymlink()

package/src/helpers/lib-entries.ts

@@ -30,7 +30,7 @@ export async function createLibraryEntryPoint(type: LibraryType) {
 }
 
 export async function createVueLibraryEntryPoint(type: LibraryType = 'vue-components') {
-  log.info('Creating Vue Component Library Entry Point...')
+  log.info('Ensuring Component Library Entry Point...')
 
   await writeTextFile({
     path: libraryEntryPath(type),
@@ -44,7 +44,7 @@ export async function createVueLibraryEntryPoint(type: LibraryType = 'vue-compon
 }
 
 export async function createWebComponentLibraryEntryPoint(type: LibraryType = 'web-components') {
-  log.info('Creating Web Component Library Entry Point...')
+  log.info('Ensuring Web Component Library Entry Point...')
 
   await writeTextFile({
     path: libraryEntryPath(type),
@@ -58,7 +58,7 @@ export async function createWebComponentLibraryEntryPoint(type: LibraryType = 'w
 }
 
 export async function createFunctionLibraryEntryPoint(type: LibraryType = 'functions') {
-  log.info('Creating Function Library Entry Point...')
+  log.info('Ensuring Function Library Entry Point...')
 
   await writeTextFile({
     path: libraryEntryPath(type),

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/binary.ts

@@ -0,0 +1,43 @@
+import process from 'node:process'
+import { path } from '@stacksjs/path'
+import { runCommand } from '@stacksjs/cli'
+import { log } from '@stacksjs/logging'
+import { fs, storage } from '@stacksjs/storage'
+
+/**
+ * Move the `stacks` binary to the user's home directory.
+ */
+
+const source = path.buddyPath('dist/stacks')
+const destination = path.homeDir('.stacks/bin/stacks')
+const destinationDir = path.homeDir('.stacks/bin/')
+
+log.info('Upgrading `stacks`...')
+
+// ensure the latest binary is generated
+const result = await runCommand('bun compile.ts', { cwd: path.buddyPath() })
+
+if (result.isErr()) {
+  log.error('There was an error compiling the binary', result.error)
+  process.exit()
+}
+
+// Check if the source exists (it should be, because bun compile.ts was successful)
+if (await storage.exists(source)) {
+  try {
+    log.info('Updating Binary...')
+    log.info(`Source: ${source}`) // TODO: should be debug
+    log.info(`Destination: ${destination}`) // TODO: should be debug
+
+    await fs.ensureDir(destinationDir) // Ensure the destination directory exists
+    await fs.move(source, destination, { overwrite: true })
+
+    log.success('Binary Latest Version Is Used')
+  }
+  catch (err: any) {
+    log.error(err)
+  }
+}
+else {
+  log.error(`Binary source not found: ${source}`)
+}

package/src/upgrade/index.ts

@@ -16,6 +16,12 @@ if (options?.dependencies || options?.all)
 if (options?.bun || options?.all)
   await runAction(Action.UpgradeBun, options)
 
+if (options?.shell || options?.all)
+  await runAction(Action.UpgradeShell, options)
+
+if (options?.binary || options?.all)
+  await runAction(Action.UpgradeBinary, options)
+
 process.exit(ExitCode.InvalidArgument)
 
 // TODO: also update CI files & configurations, and other files, possibly (taze?)

package/src/upgrade/shell.ts

@@ -0,0 +1,64 @@
+import process from 'node:process'
+import { $ } from 'bun'
+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')
+const pluginPath = p.shellPath('src/buddy.plugin.zsh')
+const customPath = p.join(homePath, '.oh-my-zsh/custom/plugins/buddy/')
+
+log.info(`Setting up Oh My Zsh via ${zshrcPath}...`)
+$.cwd(p.dirname(zshrcPath))
+let data = await $`cat ${p.basename(zshrcPath)}`.text()
+
+// Manipulate the data
+const pluginLineRegex = /^(?!#).*plugins=\(([^)]+)\)/m // ensure it's not a comment
+const match = data.match(pluginLineRegex)
+
+if (match) {
+  // Split the captured group by any whitespace and filter out empty strings
+  const plugins = match[1]?.split(/\s+/).filter(Boolean)
+  if (!plugins) {
+    log.error('Maybe the plugins line in your .zshrc file could not be found? If this continues being an issue, please reach out to us on Discord.')
+    process.exit(ExitCode.FatalError)
+  }
+
+  // 2. Add buddy to the list of plugins if it's not already there
+  if (!plugins.includes('buddy')) {
+    plugins.push('buddy')
+    // Trim each plugin name and ensure it's formatted correctly
+    const formattedPlugins = plugins.map(plugin => plugin.trim()).join('\n    ')
+    const newPluginLine = `plugins=(\n    ${formattedPlugins}\n)`
+    // Replace the old plugin line with the new one
+    data = data.replace(pluginLineRegex, newPluginLine)
+    // Write the data back to the file
+    await writeFile(zshrcPath, data)
+
+    // need to copy plugin to ~/.oh-my-zsh/custom/plugins
+    log.info(`Copying buddy zsh plugin ${pluginPath} to ${customPath}...`)
+
+    // create customPath if it doesn't exist
+    await runCommand(`mkdir -p ${customPath}`)
+    await runCommand(`cp -rf ${pluginPath} ${customPath}`)
+    // await runCommand(`source ${customPath}/src/buddy.plugin.zsh`)
+
+    log.success('Copied buddy zsh plugin')
+  }
+  else {
+    log.info('Buddy is already set up') // in other words, it is integrated in their shell
+    log.info('Ensuring `buddy` is updated...')
+    await runCommand(`cp -rf ${pluginPath} ${customPath}`)
+    log.success('Updated buddy zsh plugin to latest version')
+  }
+}
+
+log.success('Oh My Zsh Setup Complete')
+log.info(italic('To see changes reflect, you may need to open a new terminal window'))
+
+// if using the vscode terminal, show the message
+if (process.env.TERM_PROGRAM === 'vscode')
+  log.info('⌘⇧P terminal.create.new.terminal')

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 });

package/dist/src/build/core.js

@@ -1,21 +0,0 @@
-// @bun
-// src/build/core.ts
-import process from "process";
-import {glob} from "@stacksjs/storage";
-import {dim, italic, log} from "@stacksjs/cli";
-import {corePath} from "@stacksjs/path";
-import {ExitCode} from "@stacksjs/types";
-var {$ } = globalThis.Bun;
-log.info("Building core packages");
-var dirs = (await glob([corePath("*")], { onlyDirectories: true })).sort();
-if (dirs.length === 0) {
-  log.info("No core packages found");
-  process.exit(ExitCode.FatalError);
-}
-for (const folder of dirs) {
-  log.info(`\uD83C\uDFD7\uFE0F  Building ${italic(dim(folder))}`);
-  $.cwd(folder);
-  await $`bun run build`;
-  log.success(`${italic(dim(folder))} built`);
-  console.log(``);
-}

package/dist/src/build/stacks.js

@@ -1,8 +0,0 @@
-// @bun
-// src/build/stacks.ts
-import {frameworkPath} from "@stacksjs/path";
-import {runCommands} from "@stacksjs/cli";
-await runCommands([
-  "bun build:cli",
-  "bun build:core"
-], { verbose: true, cwd: frameworkPath() });

package/dist/src/build.js

@@ -1,213 +0,0 @@
-// @bun
-// src/helpers/utils.ts
-import * as storage from "@stacksjs/storage";
-import {buddyOptions, runCommand, runCommands} from "@stacksjs/cli";
-import {log} from "@stacksjs/logging";
-import * as p from "@stacksjs/path";
-import {err, handleError} from "@stacksjs/error-handling";
-async function runAction(action, options) {
-  const opts = buddyOptions();
-  const path = p.relativeActionsPath(`${action}.ts`);
-  const cmd = `bun --bun ${path} ${opts}`.trimEnd();
-  const optionsWithCwd = {
-    cwd: options?.cwd || p.projectPath(),
-    ...options
-  };
-  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);
-}
-async function runActions(actions, options) {
-  log.debug("runActions:", actions);
-  log.debug("actions options:", options);
-  if (!actions.length)
-    return err("No actions were specified");
-  for (const action of actions) {
-    if (!hasAction(action))
-      return err(`The specified action "${action}" does not exist`);
-  }
-  const opts = buddyOptions();
-  const o = {
-    cwd: options?.cwd || p.projectPath(),
-    ...options
-  };
-  const commands = actions.map((action) => `bun --bun ${p.relativeActionsPath(`${action}.ts`)} ${opts}`);
-  return await runCommands(commands, o);
-}
-function hasAction(action) {
-  if (storage.isFile(p.functionsPath(`actions/${action}.ts`)))
-    return true;
-  return storage.isFile(p.actionsPath(`${action}.ts`));
-}
-// src/generate/index.ts
-import process from "process";
-import {log as log2} from "@stacksjs/logging";
-import {Action, NpmScript} from "@stacksjs/enums";
-import {runNpmScript} from "@stacksjs/utils";
-import {frameworkPath, projectPath as projectPath2} from "@stacksjs/path";
-async function invoke(options) {
-  if (options?.types)
-    await generateTypes(options);
-  else if (options?.entries)
-    await generateLibEntries(options);
-  else if (options?.webTypes)
-    await generateWebTypes(options);
-  else if (options?.customData)
-    await generateVsCodeCustomData(options);
-  else if (options?.ideHelpers)
-    await generateIdeHelpers(options);
-  else if (options?.componentMeta)
-    await generateComponentMeta(options);
-}
-function generate(options) {
-  return invoke(options);
-}
-async function generateLibEntries(options) {
-  const result = await runAction(Action.GenerateLibraryEntries, {
-    ...options,
-    cwd: projectPath2()
-  });
-  if (result.isErr()) {
-    log2.error("There was an error generating your library entry points", result.error);
-    process.exit();
-  }
-  log2.success("Library entry points generated successfully");
-}
-async function generateWebTypes(options) {
-  const result = await runNpmScript(NpmScript.GenerateWebTypes, options);
-  if (result.isErr()) {
-    log2.error("There was an error generating the web-types.json file.", result.error);
-    process.exit();
-  }
-  log2.success("Successfully generated the web-types.json file");
-}
-async function generateVsCodeCustomData(options) {
-  const result = await runNpmScript(NpmScript.GenerateVsCodeCustomData, {
-    cwd: frameworkPath(),
-    ...options
-  });
-  if (result.isErr()) {
-    log2.error("There was an error generating the custom-elements.json file.", result.error);
-    process.exit();
-  }
-  await runAction(Action.LintFix, { verbose: true });
-  log2.success("Successfully generated the custom-elements.json file");
-}
-async function generateIdeHelpers(options) {
-  const result = await runNpmScript(NpmScript.GenerateIdeHelpers, options);
-  if (result.isErr()) {
-    log2.error("There was an error generating IDE helpers.", result.error);
-    process.exit();
-  }
-  await runAction(Action.LintFix, { verbose: true });
-  log2.success("Successfully generated IDE helpers");
-}
-async function generateComponentMeta(options) {
-  const result = await runNpmScript(NpmScript.GenerateComponentMeta, options);
-  if (result.isErr()) {
-    log2.error("There was an error generating your component meta information.", result.error);
-    process.exit();
-  }
-  await runAction(Action.LintFix, { verbose: true });
-  log2.success("Successfully generated component meta information");
-}
-async function generateTypes(options) {
-  const result = await runNpmScript(NpmScript.GenerateTypes, {
-    cwd: frameworkPath(),
-    ...options
-  });
-  if (result.isErr()) {
-    log2.error("There was an error generating your types.", result.error);
-    process.exit();
-  }
-  log2.success("Types were generated successfully");
-}
-function generateMigrations() {
-  log2.success("Successfully updated migrations");
-}
-function generatePkgxConfig() {
-  log2.success("Successfully generated `./pkgx.yaml` based on your configs");
-}
-async function generateSeeder() {
-}
-
-// src/build.ts
-import {log as log3} from "@stacksjs/logging";
-import {hasComponents, hasFunctions} from "@stacksjs/storage";
-import {runNpmScript as runNpmScript2} from "@stacksjs/utils";
-import {NpmScript as NpmScript2} from "@stacksjs/enums";
-async function invoke2(options) {
-  if (options.components)
-    await componentLibraries(options);
-  else if (options.vueComponents)
-    await vueComponentLibrary(options);
-  else if (options.webComponents || options.elements)
-    await webComponentLibrary(options);
-  else if (options.functions)
-    await functionsLibrary(options);
-  else if (options.docs)
-    await docs(options);
-  else if (options.stacks)
-    await stacks(options);
-  await generateTypes();
-}
-async function build(options) {
-  return invoke2(options);
-}
-async function componentLibraries(options) {
-  await runNpmScript2(NpmScript2.GenerateEntries, options);
-  await vueComponentLibrary(options);
-  await webComponentLibrary(options);
-}
-async function vueComponentLibrary(options) {
-  if (hasComponents()) {
-    log3.info("Building your component library...");
-    await runNpmScript2(NpmScript2.BuildComponents, options);
-    log3.success("Your component library was built successfully");
-  } else {
-    log3.warn("No components found.");
-    log3.info("Before you can build components,");
-    log3.info("you need to have created some in the ./components folder.");
-  }
-}
-async function webComponentLibrary(options) {
-  log3.info("Building your component library for production use & npm/CDN distribution...");
-  if (hasComponents()) {
-    await runNpmScript2(NpmScript2.BuildWebComponents, options);
-    log3.success("Your Web Component library was built successfully");
-  } else {
-    log3.info("No components found.");
-  }
-}
-async function docs(options) {
-  log3.info("Building the documentation site...");
-  await runNpmScript2(NpmScript2.BuildDocs, options);
-  log3.success("Docs built successfully");
-}
-async function stacks(options) {
-  log3.info("Building the Stacks Framework...");
-  await runNpmScript2(NpmScript2.BuildStacks, options);
-  log3.success("Stacks built successfully");
-}
-async function functionsLibrary(options) {
-  if (hasFunctions()) {
-    log3.info("Building your functions library for production usages...");
-    log3.info("Production usages include: manual npm distribution and/or CDN distribution");
-    await runNpmScript2(NpmScript2.BuildFunctions, options);
-    log3.success("Functions library built successfully");
-  } else {
-    log3.info("No functions found");
-  }
-}
-export {
-  webComponentLibrary,
-  vueComponentLibrary,
-  stacks,
-  invoke2 as invoke,
-  functionsLibrary,
-  docs,
-  componentLibraries,
-  build
-};

package/dist/src/bump.js

@@ -1,14 +0,0 @@
-// @bun
-// src/bump.ts
-import {parseOptions, runCommand} from "@stacksjs/cli";
-import {path as p} from "@stacksjs/path";
-var options = parseOptions();
-var changelogCommand = options?.dryRun ? "buddy changelog --quiet --dry-run" : "buddy changelog --quiet";
-await runCommand(changelogCommand, {
-  cwd: p.projectPath()
-});
-var 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";
-await runCommand(bumpCommand, {
-  cwd: p.frameworkPath(),
-  stdin: "inherit"
-});

package/dist/src/changelog.js

@@ -1,17 +0,0 @@
-// @bun
-// src/changelog.ts
-import {execSync, log, parseOptions, runCommand} from "@stacksjs/cli";
-import {projectPath} from "@stacksjs/path";
-log.debug("Generating changelog");
-var fromRevision = await execSync("git describe --abbrev=0 --tags HEAD^");
-log.debug("FromRevision", fromRevision);
-var toRevision = await execSync("git describe");
-log.debug("ToRevision", toRevision);
-var options = parseOptions();
-log.debug("Changelog Options", options);
-var command = options?.dryRun ? `bunx changelogen --no-output --from ${fromRevision} --to ${toRevision}` : `bunx changelogen --output CHANGELOG.md --from ${fromRevision} --to ${toRevision}`;
-await runCommand(command, {
-  cwd: projectPath(),
-  quiet: options?.quiet,
-  verbose: options?.verbose
-});

package/dist/src/clean.js

@@ -1,6 +0,0 @@
-// @bun
-// src/clean.ts
-import {log} from "@stacksjs/logging";
-import {cleanProject} from "@stacksjs/utils";
-log.info("Running clean command...");
-await cleanProject();

package/dist/src/commit.js

@@ -1,17 +0,0 @@
-// @bun
-// src/commit.ts
-import {log} from "@stacksjs/logging";
-import {runNpmScript} from "@stacksjs/utils";
-import {NpmScript} from "@stacksjs/enums";
-async function invoke(options) {
-  log.info("Committing...");
-  await runNpmScript(NpmScript.Commit, options);
-  log.success("Committed");
-}
-async function commit(options) {
-  return invoke(options);
-}
-export {
-  invoke,
-  commit
-};

package/dist/src/copy-types.js

@@ -1,14 +0,0 @@
-#!/usr/bin/env bun
-// @bun
-
-// src/copy-types.ts
-import {frameworkPath} from "@stacksjs/path";
-import {copyFolder} from "@stacksjs/storage";
-var destinations = [
-  [frameworkPath("dist/types/components"), frameworkPath("components/vue/dist/types")],
-  [frameworkPath("dist/types/components"), frameworkPath("components/web/dist/types")],
-  [frameworkPath("dist/types/functions"), frameworkPath("functions/dist/types")]
-];
-destinations.forEach(([src, dest]) => {
-  copyFolder(src, dest);
-});

package/dist/src/database/seed.js

@@ -1 +0,0 @@
-// @bun

package/dist/src/deploy/index.js

@@ -1,31 +0,0 @@
-// @bun
-// src/deploy/index.ts
-import process from "process";
-import {log, runCommand} from "@stacksjs/cli";
-import {config as config2} from "@stacksjs/config";
-import {path as p} from "@stacksjs/path";
-import {storage as storage2} from "@stacksjs/storage";
-await runCommand("bun run build", {
-  cwd: p.frameworkPath()
-});
-if (storage2.hasFiles(p.projectPath("docs"))) {
-  await runCommand("bun run build", {
-    cwd: p.frameworkPath("docs")
-  });
-}
-if (config2.app.docMode !== true) {
-  await runCommand("bun run build", {
-    cwd: p.frameworkPath("views")
-  });
-}
-await runCommand("bun build.ts", {
-  cwd: p.frameworkPath("server")
-});
-await runCommand("bun zip.ts", {
-  cwd: p.cloudPath()
-});
-log.info("Preparing Deployment...");
-var profile = process.env.AWS_PROFILE || "stacks";
-await runCommand(`bunx cdk deploy --require-approval never --profile="${profile}"`, {
-  cwd: p.frameworkCloudPath()
-});

package/dist/src/dev/components.js

@@ -1,11 +0,0 @@
-// @bun
-// src/dev/components.ts
-import {frameworkPath, vitePath} from "@stacksjs/path";
-import {parseOptions, runCommand} from "@stacksjs/cli";
-var options = parseOptions();
-if (options.verbose)
-  console.log("dev components options", options);
-await runCommand(`bunx vite --config ${vitePath("src/components.ts")}`, {
-  ...options,
-  cwd: frameworkPath()
-});

package/dist/src/dev/docs.js

@@ -1,7 +0,0 @@
-// @bun
-// src/dev/docs.ts
-import {runCommand} from "@stacksjs/cli";
-import {frameworkPath} from "@stacksjs/path";
-await runCommand("bun run dev", {
-  cwd: frameworkPath("docs")
-});