chore: wip

Author: chrisbbreuer

.github/CONTRIBUTING.md

@@ -5,7 +5,7 @@ WIP: Updates to here are in progress.
 First off, thank you for taking the time to contribute to the Stacks ecosystem ❤️
 
 > **Note**
-> The likelihood is high that the repo you are working on is either a Stack or Stacks itself. In both cases, you will be exposed to a meshup of technologies, like [Vue][vue], [Vite][vite], [Tauri][tauri], [Nitro][nitro], and [Bun][bun].
+> The likelihood is high that the repo you are working on is either a Stack or Stacks itself. In both cases, you will be exposed to a meshup of technologies, like [Vite][vite], [Tauri][tauri], [Nitro][nitro], [Vue][vue], and [Bun][bun].
 
 ## 💭 Knowledge
 

config/app.ts

@@ -9,17 +9,17 @@ import type { AppConfig } from '@stacksjs/types'
  * you have any questions, feel free to reach out via Discord or GitHub Discussions.
  */
 export default {
-  name: env.APP_NAME || 'Stacks',
+  name: env.APP_NAME ?? 'Stacks',
   description: 'Stacks is a full-stack framework for building modern web applications.',
-  env: env.APP_ENV || 'local',
-  url: env.APP_URL || 'stacks.localhost',
+  env: env.APP_ENV ?? 'local',
+  url: env.APP_URL ?? 'stacks.localhost',
   redirectUrls: ['stacksjs.com'],
-  debug: env.DEBUG || false,
+  debug: env.DEBUG ?? false,
   key: env.APP_KEY,
 
-  maintenanceMode: env.APP_MAINTENANCE || false,
-  // docMode: true, // instead of example.com/docs, deploys example.com as main entry point for docs
-  docMode: false,
+  maintenanceMode: env.APP_MAINTENANCE ?? false,
+  docMode: true, // instead of example.com/docs, deploys example.com as main entry point for docs
+  // docMode: false,
 
   timezone: 'America/Los_Angeles',
   locale: 'en',

storage/framework/core/buddy/src/commands/cloud.ts

@@ -23,10 +23,11 @@ export function cloud(buddy: CLI) {
     cloud: 'Interact with the Stacks Cloud',
     ssh: 'SSH into the Stacks Cloud',
     add: 'Add a resource to the Stacks Cloud',
-    remove: 'Removes the Stacks Cloud. In case it fails, try again',
-    optimizeCost: 'Removes certain resources that may be re-applied at a later time',
-    cleanUp: 'Removes all resources that were retained during the cloud deletion',
-    invalidateCache: 'Invalidates the CloudFront cache',
+    remove: 'Remove the Stacks Cloud. In case it fails, try again',
+    optimizeCost: 'Remove certain resources that may be re-applied at a later time',
+    cleanUp: 'Remove all resources that were retained during the cloud deletion',
+    invalidateCache: 'Invalidate the CloudFront cache',
+    diff: 'Show the diff of the current, undeployed cloud changes ',
     paths: 'The paths to invalidate',
     project: 'Target a specific project',
     verbose: 'Enable verbose output',
@@ -38,6 +39,7 @@ export function cloud(buddy: CLI) {
     .option('--connect', descriptions.ssh, { default: false })
     .option('--invalidate-cache', descriptions.invalidateCache, { default: false })
     .option('--paths [paths]', descriptions.paths)
+    .option('--diff', descriptions.diff, { default: false })
     .option('-p, --project [project]', descriptions.project, { default: false })
     .option('--verbose', descriptions.verbose, { default: false })
     .action(async (options: CloudCliOptions) => {
@@ -107,6 +109,22 @@ export function cloud(buddy: CLI) {
         process.exit(ExitCode.Success)
       }
 
+      if (options.diff) {
+        const result = await runCommand('bunx cdk diff', {
+          cwd: p.frameworkCloudPath(),
+          stdin: 'pipe'
+        })
+
+        if (result.isErr()) {
+          await outro('While running the cloud diff command, there was an issue', { startTime, useSeconds: true }, result.error)
+          process.exit(ExitCode.FatalError)
+        }
+
+        await outro('Showing diff of the current, undeployed cloud changes', { startTime, useSeconds: true })
+        console.log(result.value)
+        process.exit(ExitCode.Success)
+      }
+
       log.info('Not implemented yet. Read more about `buddy cloud` here: https://stacksjs.org/docs/cloud')
       process.exit(ExitCode.Success)
     })
@@ -476,6 +494,30 @@ export function cloud(buddy: CLI) {
       process.exit(ExitCode.Success)
     })
 
+  buddy
+    .command('cloud:diff', descriptions.diff)
+    .option('-p, --project [project]', descriptions.project, { default: false })
+    .option('--verbose', descriptions.verbose, { default: false })
+    .action(async (options: CloudCliOptions) => {
+      log.debug('Running `buddy cloud:diff` ...', options)
+
+      const startTime = await intro('buddy cloud:diff')
+
+      const result = await runCommand('bunx cdk diff', {
+        cwd: p.frameworkCloudPath(),
+        stdin: 'pipe'
+      })
+
+      if (result.isErr()) {
+        await outro('While running the cloud diff command, there was an issue', { startTime, useSeconds: true }, result.error)
+        process.exit(ExitCode.FatalError)
+      }
+
+      await outro('Showing diff of the current, undeployed cloud changes', { startTime, useSeconds: true })
+      console.log(result.value)
+      process.exit(ExitCode.Success)
+    })
+
   buddy.on('cloud:*', () => {
     console.error('Invalid command: %s\nSee --help for a list of available commands.', buddy.args.join(' '))
     process.exit(1)

storage/framework/core/buddy/src/commands/deploy.ts

@@ -11,17 +11,18 @@ import { $ } from 'bun'
 
 export function deploy(buddy: CLI) {
   const descriptions = {
-    deploy: 'Re-installs your npm dependencies',
+    deploy: 'Deploy your project',
     project: 'Target a specific project',
     production: 'Deploy to production',
     development: 'Deploy to development',
     staging: 'Deploy to staging',
+    domain: 'Specify a domain to deploy to',
     verbose: 'Enable verbose output',
   }
 
   buddy
     .command('deploy [env]', descriptions.deploy)
-    .option('--domain', 'Specify a domain to deploy to', { default: undefined })
+    .option('--domain', descriptions.domain, { default: undefined })
     .option('-p, --project [project]', descriptions.project, { default: false })
     .option('--prod', descriptions.production, { default: true })
     .option('--dev', descriptions.development, { default: false })

storage/framework/core/buddy/src/commands/dev.ts

@@ -17,8 +17,8 @@ import type { CLI, DevOptions } from '@stacksjs/types'
 
 export function dev(buddy: CLI) {
   const descriptions = {
-    dev: 'Starts development server',
-    frontend: 'Starts the frontend development server',
+    dev: 'Start development server',
+    frontend: 'Start the frontend development server',
     components: 'Start the Components development server',
     desktop: 'Start the Desktop App development server',
     dashboard: 'Start the Dashboard development server',

storage/framework/core/cloud/src/cloud/compute.ts

@@ -11,7 +11,6 @@ import {
   aws_route53_targets as route53Targets,
   aws_secretsmanager as secretsmanager,
 } from 'aws-cdk-lib'
-import * as ecr_assets from 'aws-cdk-lib/aws-ecr-assets'
 import * as elbv2 from 'aws-cdk-lib/aws-elasticloadbalancingv2'
 import { LogGroup } from 'aws-cdk-lib/aws-logs'
 import type { Construct } from 'constructs'
@@ -223,8 +222,12 @@ export class ComputeStack {
       },
     })
 
-    secrets.grantRead(service.taskDefinition.executionRole)
-    container.addEnvironment('SECRETS_ARN', secrets.secretArn)
+    if (service.taskDefinition.executionRole) {
+      secrets.grantRead(service.taskDefinition.executionRole)
+      container.addEnvironment('SECRETS_ARN', secrets.secretArn)
+    } else {
+      throw new Error('Service task execution role is undefined.')
+    }
 
     const apiPrefix = 'api'
     new Output(scope, 'ApiUrl', {

storage/framework/core/types/src/cli.ts

@@ -353,6 +353,7 @@ export interface CloudCliOptions extends CliOptions {
   jumpBox?: boolean
   invalidateCache?: boolean
   paths?: string
+  diff?: boolean
 }
 export interface CommitOptions extends CliOptions {}
 export interface KeyOptions extends CliOptions {}

storage/framework/ide/dictionary.txt

@@ -301,6 +301,7 @@ typecheck
 typegen
 typesense
 unconfig
+undeployed
 undeploys
 unhead
 unimport