feat: add start option

Author: chrisbbreuer

CHANGELOG.md

@@ -326,27 +326,27 @@
 
 ## v0.0.1...main
 
-[compare changes](https://github.com/stacksjs/reverse-proxy/compare/v0.0.1...main)
+[compare changes](https://github.com/stacksjs/rpx/compare/v0.0.1...main)
 
 ### 🏡 Chore
 
-- Wip ([c5e31d5](https://github.com/stacksjs/reverse-proxy/commit/c5e31d5))
-- Wip ([6020df1](https://github.com/stacksjs/reverse-proxy/commit/6020df1))
-- Wip ([be3dde1](https://github.com/stacksjs/reverse-proxy/commit/be3dde1))
-- Wip ([e9e0feb](https://github.com/stacksjs/reverse-proxy/commit/e9e0feb))
-- Wip ([383854c](https://github.com/stacksjs/reverse-proxy/commit/383854c))
-- Wip ([363445b](https://github.com/stacksjs/reverse-proxy/commit/363445b))
-- Add `rp` ([beced3c](https://github.com/stacksjs/reverse-proxy/commit/beced3c))
-- Wip ([99cf0df](https://github.com/stacksjs/reverse-proxy/commit/99cf0df))
-- Wip ([c9341a4](https://github.com/stacksjs/reverse-proxy/commit/c9341a4))
-- Use `bun publish` ([6f6ae9d](https://github.com/stacksjs/reverse-proxy/commit/6f6ae9d))
-- Add tests ([da19c51](https://github.com/stacksjs/reverse-proxy/commit/da19c51))
-- Ignore docs cache ([81f2296](https://github.com/stacksjs/reverse-proxy/commit/81f2296))
-- Use bunx ([ec65717](https://github.com/stacksjs/reverse-proxy/commit/ec65717))
-- Adjust examples ([d4745fc](https://github.com/stacksjs/reverse-proxy/commit/d4745fc))
-- Adjust build process ([1e5c63c](https://github.com/stacksjs/reverse-proxy/commit/1e5c63c))
-- Remove postcompile ([52a9bc6](https://github.com/stacksjs/reverse-proxy/commit/52a9bc6))
-- Remove lint:fix-unsafe ([91ad947](https://github.com/stacksjs/reverse-proxy/commit/91ad947))
+- Wip ([c5e31d5](https://github.com/stacksjs/rpx/commit/c5e31d5))
+- Wip ([6020df1](https://github.com/stacksjs/rpx/commit/6020df1))
+- Wip ([be3dde1](https://github.com/stacksjs/rpx/commit/be3dde1))
+- Wip ([e9e0feb](https://github.com/stacksjs/rpx/commit/e9e0feb))
+- Wip ([383854c](https://github.com/stacksjs/rpx/commit/383854c))
+- Wip ([363445b](https://github.com/stacksjs/rpx/commit/363445b))
+- Add `rp` ([beced3c](https://github.com/stacksjs/rpx/commit/beced3c))
+- Wip ([99cf0df](https://github.com/stacksjs/rpx/commit/99cf0df))
+- Wip ([c9341a4](https://github.com/stacksjs/rpx/commit/c9341a4))
+- Use `bun publish` ([6f6ae9d](https://github.com/stacksjs/rpx/commit/6f6ae9d))
+- Add tests ([da19c51](https://github.com/stacksjs/rpx/commit/da19c51))
+- Ignore docs cache ([81f2296](https://github.com/stacksjs/rpx/commit/81f2296))
+- Use bunx ([ec65717](https://github.com/stacksjs/rpx/commit/ec65717))
+- Adjust examples ([d4745fc](https://github.com/stacksjs/rpx/commit/d4745fc))
+- Adjust build process ([1e5c63c](https://github.com/stacksjs/rpx/commit/1e5c63c))
+- Remove postcompile ([52a9bc6](https://github.com/stacksjs/rpx/commit/52a9bc6))
+- Remove lint:fix-unsafe ([91ad947](https://github.com/stacksjs/rpx/commit/91ad947))
 
 ### ❤️ Contributors
 
@@ -357,35 +357,34 @@
 
 ### 🏡 Chore
 
-- Initial commit ([beb4d96](https://github.com/stacksjs/reverse-proxy/commit/beb4d96))
-- Wip ([8e3fce6](https://github.com/stacksjs/reverse-proxy/commit/8e3fce6))
-- Wip ([bbb6783](https://github.com/stacksjs/reverse-proxy/commit/bbb6783))
-- Wip ([2cfb363](https://github.com/stacksjs/reverse-proxy/commit/2cfb363))
-- Wip ([6bb85ac](https://github.com/stacksjs/reverse-proxy/commit/6bb85ac))
-- Wip ([602c9e1](https://github.com/stacksjs/reverse-proxy/commit/602c9e1))
-- Wip ([5986105](https://github.com/stacksjs/reverse-proxy/commit/5986105))
-- Wip ([c2bfec6](https://github.com/stacksjs/reverse-proxy/commit/c2bfec6))
-- Wip ([454dd58](https://github.com/stacksjs/reverse-proxy/commit/454dd58))
-- Wip ([b55ae41](https://github.com/stacksjs/reverse-proxy/commit/b55ae41))
-- Wip ([e2f1350](https://github.com/stacksjs/reverse-proxy/commit/e2f1350))
-- Wip ([61b2aa5](https://github.com/stacksjs/reverse-proxy/commit/61b2aa5))
-- Wip ([a80283b](https://github.com/stacksjs/reverse-proxy/commit/a80283b))
-- Wip ([97b9b16](https://github.com/stacksjs/reverse-proxy/commit/97b9b16))
-- Wip ([fc8d633](https://github.com/stacksjs/reverse-proxy/commit/fc8d633))
-- Wip ([e924f9c](https://github.com/stacksjs/reverse-proxy/commit/e924f9c))
-- Wip ([249e8fa](https://github.com/stacksjs/reverse-proxy/commit/249e8fa))
-- Wip ([1045bb1](https://github.com/stacksjs/reverse-proxy/commit/1045bb1))
-- Wip ([c0a8bad](https://github.com/stacksjs/reverse-proxy/commit/c0a8bad))
-- Wip ([f28b118](https://github.com/stacksjs/reverse-proxy/commit/f28b118))
-- Wip ([712a5bf](https://github.com/stacksjs/reverse-proxy/commit/712a5bf))
-- Wip ([2786e8d](https://github.com/stacksjs/reverse-proxy/commit/2786e8d))
-- Wip ([1290366](https://github.com/stacksjs/reverse-proxy/commit/1290366))
-- Wip ([030a8b7](https://github.com/stacksjs/reverse-proxy/commit/030a8b7))
-- Wip ([2116f75](https://github.com/stacksjs/reverse-proxy/commit/2116f75))
-- Wip ([5352f7a](https://github.com/stacksjs/reverse-proxy/commit/5352f7a))
-- Wip ([1b99dd0](https://github.com/stacksjs/reverse-proxy/commit/1b99dd0))
+- Initial commit ([beb4d96](https://github.com/stacksjs/rpx/commit/beb4d96))
+- Wip ([8e3fce6](https://github.com/stacksjs/rpx/commit/8e3fce6))
+- Wip ([bbb6783](https://github.com/stacksjs/rpx/commit/bbb6783))
+- Wip ([2cfb363](https://github.com/stacksjs/rpx/commit/2cfb363))
+- Wip ([6bb85ac](https://github.com/stacksjs/rpx/commit/6bb85ac))
+- Wip ([602c9e1](https://github.com/stacksjs/rpx/commit/602c9e1))
+- Wip ([5986105](https://github.com/stacksjs/rpx/commit/5986105))
+- Wip ([c2bfec6](https://github.com/stacksjs/rpx/commit/c2bfec6))
+- Wip ([454dd58](https://github.com/stacksjs/rpx/commit/454dd58))
+- Wip ([b55ae41](https://github.com/stacksjs/rpx/commit/b55ae41))
+- Wip ([e2f1350](https://github.com/stacksjs/rpx/commit/e2f1350))
+- Wip ([61b2aa5](https://github.com/stacksjs/rpx/commit/61b2aa5))
+- Wip ([a80283b](https://github.com/stacksjs/rpx/commit/a80283b))
+- Wip ([97b9b16](https://github.com/stacksjs/rpx/commit/97b9b16))
+- Wip ([fc8d633](https://github.com/stacksjs/rpx/commit/fc8d633))
+- Wip ([e924f9c](https://github.com/stacksjs/rpx/commit/e924f9c))
+- Wip ([249e8fa](https://github.com/stacksjs/rpx/commit/249e8fa))
+- Wip ([1045bb1](https://github.com/stacksjs/rpx/commit/1045bb1))
+- Wip ([c0a8bad](https://github.com/stacksjs/rpx/commit/c0a8bad))
+- Wip ([f28b118](https://github.com/stacksjs/rpx/commit/f28b118))
+- Wip ([712a5bf](https://github.com/stacksjs/rpx/commit/712a5bf))
+- Wip ([2786e8d](https://github.com/stacksjs/rpx/commit/2786e8d))
+- Wip ([1290366](https://github.com/stacksjs/rpx/commit/1290366))
+- Wip ([030a8b7](https://github.com/stacksjs/rpx/commit/030a8b7))
+- Wip ([2116f75](https://github.com/stacksjs/rpx/commit/2116f75))
+- Wip ([5352f7a](https://github.com/stacksjs/rpx/commit/5352f7a))
+- Wip ([1b99dd0](https://github.com/stacksjs/rpx/commit/1b99dd0))
 
 ### ❤️ Contributors
 
 - Chris <chrisbreuer93@gmail.com>
-

README.md

@@ -51,21 +51,26 @@ export interface CleanupConfig {
   certs: boolean // clean up certificates, defaults to false
 }
 
-export interface ReverseProxyConfig {
-  from: string // domain to proxy from, defaults to localhost:3000
+export interface ProxyConfig {
+  from: string // domain to proxy from, defaults to localhost:5173
   to: string // domain to proxy to, defaults to stacks.localhost
   cleanUrls?: boolean // removes the .html extension from URLs, defaults to false
   https: boolean | TlsConfig // automatically uses https, defaults to true, also redirects http to https
   cleanup?: boolean | CleanupConfig // automatically cleans up /etc/hosts, defaults to false
+  start?: StartOptions
   verbose: boolean // log verbose output, defaults to false
 }
 
-const config: ReverseProxyOptions = {
-  from: 'localhost:3000',
+const config: ProxyOptions = {
+  from: 'localhost:5173',
   to: 'my-docs.localhost',
   cleanUrls: true,
   https: true,
   cleanup: false,
+  start: {
+    command: 'bun run dev:docs',
+    lazy: true,
+  }
 }
 
 startProxy(config)
@@ -74,12 +79,12 @@ startProxy(config)
 In case you are trying to start multiple proxies, you may use this configuration:
 
 ```ts
-// reverse-proxy.config.{ts,js}
-import type { ReverseProxyOptions } from '@stacksjs/rpx'
+// rpx.config.{ts,js}
+import type { ProxyOptions } from '@stacksjs/rpx'
 import os from 'node:os'
 import path from 'node:path'
 
-const config: ReverseProxyOptions = {
+const config: ProxyOptions = {
   https: { // https: true -> also works with sensible defaults
     caCertPath: path.join(os.homedir(), '.stacks', 'ssl', `stacks.localhost.ca.crt`),
     certPath: path.join(os.homedir(), '.stacks', 'ssl', `stacks.localhost.crt`),
@@ -96,6 +101,13 @@ const config: ReverseProxyOptions = {
       from: 'localhost:5173',
       to: 'my-app.localhost',
       cleanUrls: true,
+      start: {
+        command: 'bun run dev',
+        cwd: '/path/to/my-app',
+        env: {
+          NODE_ENV: 'development',
+        },
+      },
     },
     {
       from: 'localhost:5174',
@@ -120,15 +132,15 @@ rpx --version
 
 ## Configuration
 
-The Reverse Proxy can be configured using a `reverse-proxy.config.ts` _(or `reverse-proxy.config.js`)_ file and it will be automatically loaded when running the `reverse-proxy` command.
+The Reverse Proxy can be configured using a `rpx.config.ts` _(or `rpx.config.js`)_ file and it will be automatically loaded when running the `reverse-proxy` command.
 
 ```ts
-// reverse-proxy.config.{ts,js}
-import type { ReverseProxyOptions } from '@stacksjs/rpx'
+// rpx.config.{ts,js}
+import type { ProxyOptions } from '@stacksjs/rpx'
 import os from 'node:os'
 import path from 'node:path'
 
-const config: ReverseProxyOptions = {
+const config: ProxyOptions = {
   from: 'localhost:5173',
   to: 'stacks.localhost',
 

bin/cli.ts

@@ -1,22 +1,27 @@
+import type { ProxyOption, StartOptions } from '../src/types'
+import process from 'node:process'
 import { CAC } from 'cac'
 import { version } from '../package.json'
 import { config } from '../src/config'
-import { httpsConfig } from '../src/https'
+import { processManager } from '../src/process-manager'
 import { startProxies, startProxy } from '../src/start'
+import { isMultiProxyConfig } from '../src/utils'
 
-const cli = new CAC('reverse-proxy')
-
-interface ReverseProxyOption {
-  from: string
-  to: string
-  keyPath: string
-  certPath: string
-  caCertPath: string
-  cleanup: {
-    certs: boolean
-    hosts: boolean
-  }
-  verbose: boolean
+const cli = new CAC('rpx')
+
+// Define CLI options interface to match our core types
+interface CLIOptions {
+  from?: string
+  to?: string
+  keyPath?: string
+  certPath?: string
+  caCertPath?: string
+  hostsCleanup?: boolean
+  certsCleanup?: boolean
+  startCommand?: string
+  startCwd?: string
+  startEnv?: string
+  verbose?: boolean
 }
 
 cli
@@ -28,26 +33,107 @@ cli
   .option('--ca-cert-path <path>', 'Absolute path to the SSL CA certificate')
   .option('--hosts-cleanup', 'Cleanup /etc/hosts on exit')
   .option('--certs-cleanup', 'Cleanup SSL certificates on exit')
+  .option('--start-command <command>', 'Command to start the dev server')
+  .option('--start-cwd <path>', 'Current working directory for the dev server')
+  .option('--start-env <env>', 'Environment variables for the dev server')
   .option('--verbose', 'Enable verbose logging')
-  .example('reverse-proxy start --from localhost:5173 --to my-project.localhost')
-  .example('reverse-proxy start --from localhost:3000 --to my-project.localhost/api')
-  .example('reverse-proxy start --from localhost:3000 --to localhost:3001')
-  .example('reverse-proxy start --from localhost:5173 --to my-project.test --key-path /absolute/path/to/key --cert-path /absolute/path/to/cert')
-  .action(async (options?: ReverseProxyOption) => {
+  .example('rpx start --from localhost:5173 --to my-project.localhost')
+  .example('rpx start --from localhost:3000 --to my-project.localhost/api')
+  .example('rpx start --from localhost:3000 --to localhost:3001')
+  .example('rpx start --from localhost:5173 --to my-project.test --key-path /absolute/path/to/key --cert-path /absolute/path/to/cert')
+  .action(async (options?: CLIOptions) => {
     if (!options?.from || !options.to) {
       return startProxies(config)
     }
 
-    return startProxy({
-      from: options?.from,
-      to: options?.to,
-      https: httpsConfig(options),
+    // Convert CLI options to ProxyOption
+    const proxyOptions: ProxyOption = {
+      from: options.from,
+      to: options.to,
+      https: {
+        keyPath: options.keyPath,
+        certPath: options.certPath,
+        caCertPath: options.caCertPath,
+      },
       cleanup: {
-        certs: options?.cleanup.certs,
-        hosts: options?.cleanup.hosts,
+        certs: options.certsCleanup || false,
+        hosts: options.hostsCleanup || false,
       },
-      verbose: options?.verbose,
-    })
+      verbose: options.verbose || false,
+    }
+
+    // Add start options if provided
+    if (options.startCommand) {
+      const startOptions: StartOptions = {
+        command: options.startCommand,
+      }
+      if (options.startCwd)
+        startOptions.cwd = options.startCwd
+      if (options.startEnv) {
+        try {
+          startOptions.env = JSON.parse(options.startEnv)
+        }
+        catch (err) {
+          console.error('Failed to parse start-env JSON:', err)
+          process.exit(1)
+        }
+      }
+      proxyOptions.start = startOptions
+    }
+
+    return startProxy(proxyOptions)
+  })
+
+cli
+  .command('watch:start <proxy>', 'Start the dev server for a specific proxy')
+  .option('--verbose', 'Enable verbose logging')
+  .action(async (proxyId: string, options: { verbose?: boolean }) => {
+    // Find the proxy configuration
+    const proxyConfig = isMultiProxyConfig(config)
+      ? config.proxies.find(p => p.to === proxyId || `${p.from}-${p.to}` === proxyId)
+      : config.to === proxyId ? config : null
+
+    if (!proxyConfig?.start) {
+      console.error(`No watch configuration found for proxy: ${proxyId}`)
+      process.exit(1)
+    }
+
+    try {
+      await processManager.startProcess(proxyId, proxyConfig.start, options.verbose)
+      console.log(`Started dev server for ${proxyId}`)
+    }
+    catch (err) {
+      console.error(`Failed to start dev server for ${proxyId}:`, err)
+      process.exit(1)
+    }
+  })
+
+cli
+  .command('watch:stop <proxy>', 'Stop the dev server for a specific proxy')
+  .option('--verbose', 'Enable verbose logging')
+  .action(async (proxyId: string, options: { verbose?: boolean }) => {
+    try {
+      await processManager.stopProcess(proxyId, options.verbose)
+      console.log(`Stopped dev server for ${proxyId}`)
+    }
+    catch (err) {
+      console.error(`Failed to stop dev server for ${proxyId}:`, err)
+      process.exit(1)
+    }
+  })
+
+cli
+  .command('watch:stopall', 'Stop all running dev servers')
+  .option('--verbose', 'Enable verbose logging')
+  .action(async (options: { verbose?: boolean }) => {
+    try {
+      await processManager.stopAll(options.verbose)
+      console.log('Stopped all dev servers')
+    }
+    catch (err) {
+      console.error('Failed to stop all dev servers:', err)
+      process.exit(1)
+    }
   })
 
 cli.command('version', 'Show the version of the Reverse Proxy CLI').action(() => {