slipway-cli 0.0.0

package/README.md

@@ -0,0 +1,68 @@
+# slipway
+
+> The CLI for Slipway - the Sails-native deployment platform
+
+## Zero Dependencies
+
+This CLI has **no npm dependencies**. It uses only Node.js 22+ built-ins:
+
+- `node:util` → `parseArgs` for argument parsing
+- `node:readline` → interactive prompts
+- `node:fs` → config storage in `~/.slipway/`
+- Native `fetch` → HTTP requests
+- Native `WebSocket` → log streaming, Helm REPL
+
+This means instant startup, no supply chain risk, and zero maintenance overhead.
+
+## Commands
+
+```bash
+# Deploy (slide into production!)
+slipway slide                    # Primary command
+slipway launch                   # Alias
+slipway deploy                   # Alias
+
+# Apps
+slipway app:create myapp
+slipway app:list
+slipway app:info myapp
+slipway app:destroy myapp
+
+# Databases (unified)
+slipway db:create mydb --type=postgres
+slipway db:link mydb myapp       # Auto-sets DATABASE_URL
+slipway db:connect mydb          # Opens psql/mysql/redis-cli
+slipway db:list
+slipway db:backup mydb
+
+# Domains
+slipway domain:add myapp example.com
+slipway domain:list myapp
+slipway domain:remove myapp example.com
+
+# Environment
+slipway env:set myapp KEY=value
+slipway env:list myapp
+
+# Operations
+slipway helm myapp               # Sails REPL (like Tinkerwell)
+slipway logs myapp -t            # Tail logs
+slipway dev                      # Local dev mode
+```
+
+## Installation
+
+```bash
+npm install -g slipway
+# or
+npx slipway
+```
+
+## Part of the Slipway Suite
+
+- **Slipway Dashboard** - The web UI (root of this monorepo)
+- **sails-hook-slipway** - The Sails hook for Bridge, Helm, telemetry
+
+---
+
+*Where your apps slide into production.*

package/package.json

@@ -0,0 +1,29 @@
+{
+  "name": "slipway-cli",
+  "version": "0.0.0",
+  "description": "CLI for Slipway - Deploy Sails apps with ease",
+  "type": "module",
+  "bin": {
+    "slipway": "./src/index.js"
+  },
+  "keywords": [
+    "slipway",
+    "sails",
+    "deploy",
+    "docker",
+    "cli"
+  ],
+  "author": "Kelvin Omereshone <kelvin@sailscasts.com>",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/sailscastshq/slipway.git",
+    "directory": "packages/cli"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}

package/src/commands/db-create.js

@@ -0,0 +1,55 @@
+import { c } from '../lib/colors.js'
+import { api } from '../lib/api.js'
+import { isLoggedIn } from '../lib/config.js'
+import { error, requireProject, createSpinner } from '../lib/utils.js'
+
+export default async function dbCreate(options, positionals) {
+  if (!isLoggedIn()) {
+    error('Not logged in. Run `slipway login` first.')
+  }
+
+  const name = positionals[0]
+  if (!name) {
+    error('Please provide a database name. Usage: slipway db:create <name>')
+  }
+
+  const project = requireProject()
+  const environment = options.env || 'production'
+  const dbType = options.type || 'postgresql'
+  const version = options.version || 'latest'
+
+  console.log()
+  console.log(`  ${c.bold(c.highlight('Create Database'))}`)
+  console.log()
+
+  const spin = createSpinner(`Creating ${dbType} database "${name}"...`).start()
+
+  try {
+    const { service } = await api.services.create(project.project, environment, {
+      name,
+      type: dbType,
+      version
+    })
+
+    spin.succeed('Database created')
+    console.log()
+    console.log(`  ${c.dim('Name:')} ${service.name}`)
+    console.log(`  ${c.dim('Type:')} ${service.type}`)
+    console.log(`  ${c.dim('Version:')} ${service.version}`)
+    console.log(`  ${c.dim('Environment:')} ${environment}`)
+    console.log()
+
+    if (service.connectionUrl) {
+      console.log(`  ${c.dim('Connection URL:')}`)
+      console.log(`  ${c.highlight(service.connectionUrl)}`)
+      console.log()
+    }
+
+    console.log(`  ${c.dim('The connection URL has been added to your environment variables.')}`)
+    console.log(`  ${c.dim('Use')} ${c.highlight(`slipway db:url ${name}`)} ${c.dim('to retrieve it later.')}`)
+    console.log()
+  } catch (err) {
+    spin.fail('Failed to create database')
+    error(err.message)
+  }
+}

package/src/commands/db-url.js

@@ -0,0 +1,44 @@
+import { c } from '../lib/colors.js'
+import { api } from '../lib/api.js'
+import { isLoggedIn } from '../lib/config.js'
+import { error, requireProject, createSpinner } from '../lib/utils.js'
+
+export default async function dbUrl(options, positionals) {
+  if (!isLoggedIn()) {
+    error('Not logged in. Run `slipway login` first.')
+  }
+
+  const name = positionals[0]
+  if (!name) {
+    error('Please provide a database name. Usage: slipway db:url <name>')
+  }
+
+  const project = requireProject()
+  const environment = options.env || 'production'
+
+  const spin = createSpinner('Fetching database URL...').start()
+
+  try {
+    const { services } = await api.services.list(project.project, environment)
+
+    const database = services.find(s => s.name === name)
+
+    if (!database) {
+      spin.fail('Database not found')
+      error(`No database named "${name}" found in ${environment} environment.`)
+    }
+
+    spin.stop()
+
+    console.log()
+    if (database.connectionUrl) {
+      console.log(database.connectionUrl)
+    } else {
+      console.log(`  ${c.dim('No connection URL available for this database.')}`)
+    }
+    console.log()
+  } catch (err) {
+    spin.fail('Failed to fetch database URL')
+    error(err.message)
+  }
+}

package/src/commands/deployments.js

@@ -0,0 +1,72 @@
+import { c } from '../lib/colors.js'
+import { api } from '../lib/api.js'
+import { isLoggedIn } from '../lib/config.js'
+import { error, requireProject, table, statusColor, formatDate } from '../lib/utils.js'
+
+export default async function deployments(options) {
+  if (!isLoggedIn()) {
+    error('Not logged in. Run `slipway login` first.')
+  }
+
+  const project = requireProject()
+
+  console.log()
+  console.log(`  ${c.bold(c.highlight('Recent Deployments'))}`)
+  console.log()
+
+  try {
+    // Get environments first
+    const { environments } = await api.environments.list(project.project)
+
+    // Filter by environment if specified
+    const targetEnvs = options.env
+      ? environments.filter(e => e.slug === options.env)
+      : environments
+
+    if (targetEnvs.length === 0) {
+      console.log(`  ${c.dim('No environments found.')}`)
+      return
+    }
+
+    // Collect deployments from each environment
+    const allDeployments = []
+    for (const env of targetEnvs) {
+      const { environment } = await api.environments.get(project.project, env.slug)
+      if (environment.deployments) {
+        environment.deployments.forEach(d => {
+          allDeployments.push({
+            ...d,
+            environment: env.slug
+          })
+        })
+      }
+    }
+
+    // Sort by date and limit
+    allDeployments.sort((a, b) => (b.createdAt || 0) - (a.createdAt || 0))
+    const limited = allDeployments.slice(0, parseInt(options.limit) || 10)
+
+    if (limited.length === 0) {
+      console.log(`  ${c.dim('No deployments yet. Run `slipway deploy` to create one.')}`)
+      return
+    }
+
+    const rows = limited.map(d => [
+      d.id.substring(0, 8),
+      statusColor(d.status),
+      d.environment,
+      d.gitBranch || '-',
+      d.gitCommit ? d.gitCommit.substring(0, 7) : '-',
+      formatDate(d.createdAt)
+    ])
+
+    table(
+      ['ID', 'Status', 'Env', 'Branch', 'Commit', 'Date'],
+      rows
+    )
+
+    console.log()
+  } catch (err) {
+    error(err.message)
+  }
+}

package/src/commands/env-list.js

@@ -0,0 +1,53 @@
+import { c } from '../lib/colors.js'
+import { api } from '../lib/api.js'
+import { isLoggedIn } from '../lib/config.js'
+import { error, requireProject } from '../lib/utils.js'
+
+export default async function envList(options) {
+  if (!isLoggedIn()) {
+    error('Not logged in. Run `slipway login` first.')
+  }
+
+  const project = requireProject()
+  const environment = options.env || 'production'
+
+  console.log()
+  console.log(`  ${c.bold(c.highlight('Environment Variables'))}`)
+  console.log(`  ${c.dim(`${project.project} / ${environment}`)}`)
+  console.log()
+
+  try {
+    const { environment: env } = await api.environments.get(project.project, environment)
+
+    const vars = env.envVars || {}
+    const keys = Object.keys(vars).sort()
+
+    if (keys.length === 0) {
+      console.log(`  ${c.dim('No environment variables set.')}`)
+      console.log(`  ${c.dim('Use')} ${c.highlight('slipway env:set KEY=value')} ${c.dim('to add variables.')}`)
+      console.log()
+      return
+    }
+
+    for (const key of keys) {
+      const value = vars[key]
+      // Mask sensitive values
+      const masked = shouldMask(key) ? '••••••••' : value
+      console.log(`  ${c.dim(key + '=')}${masked}`)
+    }
+
+    console.log()
+  } catch (err) {
+    error(err.message)
+  }
+}
+
+// Keys that should have their values masked
+function shouldMask(key) {
+  const sensitivePatterns = [
+    'PASSWORD', 'SECRET', 'KEY', 'TOKEN', 'PRIVATE',
+    'CREDENTIAL', 'AUTH', 'API_KEY', 'APIKEY'
+  ]
+  const upper = key.toUpperCase()
+  return sensitivePatterns.some(p => upper.includes(p))
+}

package/src/commands/env-set.js

@@ -0,0 +1,63 @@
+import { c } from '../lib/colors.js'
+import { api } from '../lib/api.js'
+import { isLoggedIn } from '../lib/config.js'
+import { error, requireProject, success, createSpinner } from '../lib/utils.js'
+
+export default async function envSet(options, positionals) {
+  if (!isLoggedIn()) {
+    error('Not logged in. Run `slipway login` first.')
+  }
+
+  if (positionals.length === 0) {
+    error('Please provide at least one KEY=value pair. Usage: slipway env:set KEY=value')
+  }
+
+  const project = requireProject()
+  const environment = options.env || 'production'
+
+  // Parse KEY=value pairs
+  const vars = {}
+  for (const pair of positionals) {
+    const eqIndex = pair.indexOf('=')
+    if (eqIndex === -1) {
+      error(`Invalid format: "${pair}". Use KEY=value format.`)
+    }
+    const key = pair.substring(0, eqIndex)
+    const value = pair.substring(eqIndex + 1)
+
+    if (!key) {
+      error(`Invalid key in "${pair}". Key cannot be empty.`)
+    }
+
+    vars[key] = value
+  }
+
+  const spin = createSpinner('Setting environment variables...').start()
+
+  try {
+    // Get current environment
+    const { environment: env } = await api.environments.get(project.project, environment)
+
+    // Merge with existing vars
+    const updatedVars = { ...env.envVars, ...vars }
+
+    // Update environment
+    await api.environments.update(project.project, environment, {
+      envVars: updatedVars
+    })
+
+    spin.succeed('Environment variables updated')
+    console.log()
+
+    for (const key of Object.keys(vars)) {
+      console.log(`  ${c.success('+')} ${key}`)
+    }
+
+    console.log()
+    console.log(`  ${c.dim('Run')} ${c.highlight('slipway deploy')} ${c.dim('to apply changes.')}`)
+    console.log()
+  } catch (err) {
+    spin.fail('Failed to set environment variables')
+    error(err.message)
+  }
+}

package/src/commands/env-unset.js

@@ -0,0 +1,62 @@
+import { c } from '../lib/colors.js'
+import { api } from '../lib/api.js'
+import { isLoggedIn } from '../lib/config.js'
+import { error, requireProject, createSpinner } from '../lib/utils.js'
+
+export default async function envUnset(options, positionals) {
+  if (!isLoggedIn()) {
+    error('Not logged in. Run `slipway login` first.')
+  }
+
+  if (positionals.length === 0) {
+    error('Please provide at least one key to remove. Usage: slipway env:unset KEY1 KEY2')
+  }
+
+  const project = requireProject()
+  const environment = options.env || 'production'
+
+  const spin = createSpinner('Removing environment variables...').start()
+
+  try {
+    // Get current environment
+    const { environment: env } = await api.environments.get(project.project, environment)
+
+    // Remove specified keys
+    const updatedVars = { ...env.envVars }
+    const removed = []
+
+    for (const key of positionals) {
+      if (key in updatedVars) {
+        delete updatedVars[key]
+        removed.push(key)
+      }
+    }
+
+    if (removed.length === 0) {
+      spin.stop()
+      console.log()
+      console.log(`  ${c.dim('No matching variables found to remove.')}`)
+      console.log()
+      return
+    }
+
+    // Update environment
+    await api.environments.update(project.project, environment, {
+      envVars: updatedVars
+    })
+
+    spin.succeed('Environment variables removed')
+    console.log()
+
+    for (const key of removed) {
+      console.log(`  ${c.error('-')} ${key}`)
+    }
+
+    console.log()
+    console.log(`  ${c.dim('Run')} ${c.highlight('slipway deploy')} ${c.dim('to apply changes.')}`)
+    console.log()
+  } catch (err) {
+    spin.fail('Failed to remove environment variables')
+    error(err.message)
+  }
+}

package/src/commands/env.js

@@ -0,0 +1,2 @@
+// env command maps to env-list
+export { default } from './env-list.js'

package/src/commands/environment-create.js

@@ -0,0 +1,38 @@
+import { c } from '../lib/colors.js'
+import { api } from '../lib/api.js'
+import { isLoggedIn } from '../lib/config.js'
+import { error, requireProject } from '../lib/utils.js'
+
+export default async function environmentCreate(options, positionals) {
+  if (!isLoggedIn()) {
+    error('Not logged in. Run `slipway login` first.')
+  }
+
+  const project = requireProject()
+
+  const name = positionals[0]
+  if (!name) {
+    error('Please provide an environment name. Usage: slipway environment:create <name>')
+  }
+
+  try {
+    const data = { name }
+    if (options.production) data.isProduction = true
+    if (options.domain) data.domain = options.domain
+
+    const { environment } = await api.environments.create(project.project, data)
+
+    console.log()
+    console.log(`${c.success('✓')} Environment created`)
+    console.log()
+    console.log(`  ${c.dim('Name:')} ${environment.name}`)
+    console.log(`  ${c.dim('Slug:')} ${environment.slug}`)
+    console.log(`  ${c.dim('Type:')} ${environment.isProduction ? 'production' : 'staging'}`)
+    if (environment.domain) {
+      console.log(`  ${c.dim('Domain:')} ${environment.domain}`)
+    }
+    console.log()
+  } catch (err) {
+    error(err.message)
+  }
+}

package/src/commands/environment-update.js

@@ -0,0 +1,43 @@
+import { c } from '../lib/colors.js'
+import { api } from '../lib/api.js'
+import { isLoggedIn } from '../lib/config.js'
+import { error, requireProject } from '../lib/utils.js'
+
+export default async function environmentUpdate(options, positionals) {
+  if (!isLoggedIn()) {
+    error('Not logged in. Run `slipway login` first.')
+  }
+
+  const project = requireProject()
+
+  const slug = positionals[0]
+  if (!slug) {
+    error('Please provide an environment slug. Usage: slipway environment:update <slug> [options]')
+  }
+
+  const updates = {}
+  if (options.name !== undefined) updates.name = options.name
+  if (options.domain !== undefined) updates.domain = options.domain
+  if (options.production !== undefined) updates.isProduction = options.production
+
+  if (Object.keys(updates).length === 0) {
+    error('No updates provided. Use --name, --domain, or --production.')
+  }
+
+  try {
+    const { environment } = await api.environments.update(project.project, slug, updates)
+
+    console.log()
+    console.log(`${c.success('✓')} Environment updated`)
+    console.log()
+    console.log(`  ${c.dim('Name:')} ${environment.name}`)
+    console.log(`  ${c.dim('Slug:')} ${environment.slug}`)
+    console.log(`  ${c.dim('Type:')} ${environment.isProduction ? 'production' : 'staging'}`)
+    if (environment.domain) {
+      console.log(`  ${c.dim('Domain:')} ${environment.domain}`)
+    }
+    console.log()
+  } catch (err) {
+    error(err.message)
+  }
+}

package/src/commands/environments.js

@@ -0,0 +1,47 @@
+import { c } from '../lib/colors.js'
+import { api } from '../lib/api.js'
+import { isLoggedIn } from '../lib/config.js'
+import { error, table, requireProject, formatDate } from '../lib/utils.js'
+
+export default async function environments() {
+  if (!isLoggedIn()) {
+    error('Not logged in. Run `slipway login` first.')
+  }
+
+  const project = requireProject()
+
+  console.log()
+  console.log(`  ${c.bold(c.highlight('Environments'))}`)
+  console.log(`  ${c.dim(project.project)}`)
+  console.log()
+
+  try {
+    const { environments } = await api.environments.list(project.project)
+
+    if (environments.length === 0) {
+      console.log(`  ${c.dim('No environments yet. Run `slipway environment:create` to create one.')}`)
+      console.log()
+      return
+    }
+
+    const rows = environments.map(env => [
+      env.name,
+      c.dim(env.slug),
+      env.isProduction ? c.warn('production') : c.info('staging'),
+      env.domain || c.dim('—'),
+      env.app ? c.success('running') : c.dim('no app'),
+      formatDate(env.createdAt)
+    ])
+
+    table(
+      ['Name', 'Slug', 'Type', 'Domain', 'Status', 'Created'],
+      rows
+    )
+
+    console.log()
+    console.log(`  ${c.dim(`${environments.length} environment${environments.length !== 1 ? 's' : ''}`)}`)
+    console.log()
+  } catch (err) {
+    error(err.message)
+  }
+}

package/src/commands/init.js

@@ -0,0 +1,94 @@
+import { join, basename } from 'node:path'
+import { existsSync, readFileSync, appendFileSync } from 'node:fs'
+import { c } from '../lib/colors.js'
+import { api } from '../lib/api.js'
+import { saveProjectConfig, getProjectConfig, isLoggedIn } from '../lib/config.js'
+import { error, createSpinner, warn } from '../lib/utils.js'
+import { prompt, confirm } from '../lib/prompt.js'
+
+export default async function init(options) {
+  if (!isLoggedIn()) {
+    error('Not logged in. Run `slipway login` first.')
+  }
+
+  // Check if already initialized
+  const existing = getProjectConfig()
+  if (existing) {
+    error(`Already linked to project "${existing.project}". Use \`slipway link\` to switch projects.`)
+  }
+
+  // Check for package.json to determine project name
+  const packageJsonPath = join(process.cwd(), 'package.json')
+  let suggestedName = basename(process.cwd())
+
+  if (existsSync(packageJsonPath)) {
+    try {
+      const pkg = JSON.parse(readFileSync(packageJsonPath, 'utf8'))
+      suggestedName = pkg.name || suggestedName
+    } catch {
+      // Ignore parsing errors
+    }
+  }
+
+  console.log()
+  console.log(`  ${c.bold(c.highlight('Initialize Slipway Project'))}`)
+  console.log()
+
+  // Get project details
+  const projectName = options.name || await prompt('  Project name', suggestedName)
+
+  // Check for Dockerfile
+  const dockerfilePath = join(process.cwd(), 'Dockerfile')
+  const hasDockerfile = existsSync(dockerfilePath)
+
+  if (!hasDockerfile) {
+    console.log()
+    warn('No Dockerfile found in current directory.')
+    console.log(`  ${c.dim('Slipway requires a Dockerfile to build and deploy your app.')}`)
+    console.log()
+
+    const proceed = await confirm('  Continue anyway?', true)
+
+    if (!proceed) {
+      console.log(`  ${c.dim('Run `slipway init` again after adding a Dockerfile.')}`)
+      return
+    }
+  }
+
+  const spin = createSpinner('Creating project...').start()
+
+  try {
+    // Create project via API
+    const { project } = await api.projects.create({
+      name: projectName,
+      dockerfilePath: 'Dockerfile'
+    })
+
+    // Save project config
+    saveProjectConfig({
+      project: project.slug,
+      projectId: project.id
+    })
+
+    spin.succeed('Project created')
+    console.log()
+    console.log(`  ${c.dim('Project:')} ${project.name}`)
+    console.log(`  ${c.dim('Slug:')} ${project.slug}`)
+    console.log(`  ${c.dim('Environment:')} production`)
+    console.log()
+    console.log(`  ${c.dim('Run')} ${c.highlight('slipway slide')} ${c.dim('to deploy your app.')}`)
+    console.log()
+
+    // Add .slipway.json to .gitignore if it exists
+    const gitignorePath = join(process.cwd(), '.gitignore')
+    if (existsSync(gitignorePath)) {
+      const gitignore = readFileSync(gitignorePath, 'utf8')
+      if (!gitignore.includes('.slipway.json')) {
+        appendFileSync(gitignorePath, '\n# Slipway\n.slipway.json\n')
+      }
+    }
+  } catch (err) {
+    spin.fail('Failed to create project')
+    error(err.message)
+  }
+}