feat: Add db init and db status commands

docs/commands/db.md

@@ -0,0 +1,86 @@
+---
+title: Netlify CLI db command
+description: Provision a production ready Postgres database with a single command
+sidebar:
+  label: db
+---
+
+# `db`
+
+
+<!-- AUTO-GENERATED-CONTENT:START (GENERATE_COMMANDS_DOCS) -->
+Provision a production ready Postgres database with a single command
+
+**Usage**
+
+```bash
+netlify db
+```
+
+**Flags**
+
+- `filter` (*string*) - For monorepos, specify the name of the application to run the command in
+- `debug` (*boolean*) - Print debugging information
+- `auth` (*string*) - Netlify auth token - can be used to run this command without logging in
+
+| Subcommand | description  |
+|:--------------------------- |:-----|
+| [`init`](/commands/db#init) | Initialize a new database for the current site  |
+| [`status`](/commands/db#status) | Check the status of the database  |
+
+
+**Examples**
+
+```bash
+netlify db status
+netlify db init
+netlify db init --help
+```
+
+---
+## `init`
+
+Initialize a new database for the current site
+
+**Usage**
+
+```bash
+netlify init
+```
+
+**Flags**
+
+- `drizzle` (*boolean*) - Initialize basic drizzle config and schema boilerplate
+- `filter` (*string*) - For monorepos, specify the name of the application to run the command in
+- `minimal` (*boolean*) - Minimal non-interactive setup. Does not initialize drizzle or any boilerplate. Ideal for CI or AI tools.
+- `no-drizzle` (*boolean*) - Does not initialize drizzle and skips any related prompts
+- `debug` (*boolean*) - Print debugging information
+- `auth` (*string*) - Netlify auth token - can be used to run this command without logging in
+- `overwrite` (*boolean*) - Overwrites existing files that would be created when setting up drizzle
+
+**Examples**
+
+```bash
+netlify db init --minimal
+netlify db init --drizzle --overwrite
+```
+
+---
+## `status`
+
+Check the status of the database
+
+**Usage**
+
+```bash
+netlify status
+```
+
+**Flags**
+
+- `debug` (*boolean*) - Print debugging information
+- `auth` (*string*) - Netlify auth token - can be used to run this command without logging in
+
+---
+
+<!-- AUTO-GENERATED-CONTENT:END -->

docs/index.md

@@ -51,6 +51,16 @@
 | [`completion:install`](/commands/completion#completioninstall) | Generates completion script for your preferred shell  |
 
 
+### [db](/commands/db)
+
+Provision a production ready Postgres database with a single command
+
+| Subcommand | description  |
+|:--------------------------- |:-----|
+| [`init`](/commands/db#init) | Initialize a new database for the current site  |
+| [`status`](/commands/db#status) | Check the status of the database  |
+
+
 ### [deploy](/commands/deploy)
 
 Create a new deploy from the contents of a folder

site/scripts/docs.js

@@ -100,7 +100,11 @@ const commandListSubCommandDisplay = function (commands) {
   let table = '| Subcommand | description  |\n'
   table += '|:--------------------------- |:-----|\n'
   commands.forEach((cmd) => {
-    const [commandBase] = cmd.name.split(':')
+    let commandBase
+    commandBase = cmd.name.split(':')[0]
+    if (cmd.parent) {
+      commandBase = cmd.parent
+    }
     const baseUrl = `/commands/${commandBase}`
     const slug = cmd.name.replace(/:/g, '')
     table += `| [\`${cmd.name}\`](${baseUrl}#${slug}) | ${cmd.description.split('\n')[0]}  |\n`

site/scripts/util/generate-command-data.js

@@ -35,12 +35,13 @@ const parseCommand = function (command) {
     }, {})
 
   return {
+    parent: command.parent?.name() !== "netlify" ? command.parent?.name() : undefined,
     name: command.name(),
     description: command.description(),
-    commands: commands
-
-      .filter((cmd) => cmd.name().startsWith(`${command.name()}:`) && !cmd._hidden)
-      .map((cmd) => parseCommand(cmd)),
+    commands: [
+      ...command.commands.filter(cmd => !cmd._hidden).map(cmd => parseCommand(cmd)),
+      ...commands.filter((cmd) => cmd.name().startsWith(`${command.name()}:`) && !cmd._hidden).map(cmd => parseCommand(cmd))
+    ],
     examples: command.examples.length !== 0 && command.examples,
     args: args.length !== 0 && args,
     flags: Object.keys(flags).length !== 0 && flags,

src/commands/database/constants.ts

@@ -0,0 +1,3 @@
+export const NEON_DATABASE_EXTENSION_SLUG = process.env.NEON_DATABASE_EXTENSION_SLUG ?? 'neon'
+export const JIGSAW_URL = process.env.JIGSAW_URL ?? 'https://api.netlifysdk.com'
+export const NETLIFY_NEON_PACKAGE_NAME = '@netlify/neon'

src/commands/database/database.ts

@@ -0,0 +1,43 @@
+import BaseCommand from '../base-command.js'
+import { status } from './status.js'
+import { init } from './init.js'
+
+export type Extension = {
+  id: string
+  name: string
+  slug: string
+  hostSiteUrl: string
+  installedOnTeam: boolean
+}
+
+export type SiteInfo = {
+  id: string
+  name: string
+  account_id: string
+  admin_url: string
+  url: string
+  ssl_url: string
+}
+
+export const createDatabaseCommand = (program: BaseCommand) => {
+  const dbCommand = program
+    .command('db')
+    .alias('database')
+    .description(`Provision a production ready Postgres database with a single command`)
+    .addExamples(['netlify db status', 'netlify db init', 'netlify db init --help'])
+
+  dbCommand
+    .command('init')
+    .description(`Initialize a new database for the current site`)
+    .option(`--drizzle`, 'Initialize basic drizzle config and schema boilerplate')
+    .option('--no-drizzle', 'Does not initialize drizzle and skips any related prompts')
+    .option(
+      '--minimal',
+      'Minimal non-interactive setup. Does not initialize drizzle or any boilerplate. Ideal for CI or AI tools.',
+    )
+    .option('-o, --overwrite', 'Overwrites existing files that would be created when setting up drizzle')
+    .action(init)
+    .addExamples([`netlify db init --minimal`, `netlify db init --drizzle --overwrite`])
+
+  dbCommand.command('status').description(`Check the status of the database`).action(status)
+}

src/commands/database/drizzle.ts

@@ -0,0 +1,111 @@
+import { carefullyWriteFile, getPackageJSON, spawnAsync } from './utils.js'
+import BaseCommand from '../base-command.js'
+import path from 'path'
+import fs from 'fs/promises'
+import inquirer from 'inquirer'
+import { NETLIFY_NEON_PACKAGE_NAME } from './constants.js'
+
+export const initDrizzle = async (command: BaseCommand) => {
+  if (!command.project.root) {
+    throw new Error('Failed to initialize Drizzle in project. Project root not found.')
+  }
+  const opts = command.opts<{
+    overwrite?: true | undefined
+  }>()
+
+  const drizzleConfigFilePath = path.resolve(command.project.root, 'drizzle.config.ts')
+  const schemaFilePath = path.resolve(command.project.root, 'db/schema.ts')
+  const dbIndexFilePath = path.resolve(command.project.root, 'db/index.ts')
+  if (opts.overwrite) {
+    await fs.writeFile(drizzleConfigFilePath, drizzleConfig)
+    await fs.mkdir(path.resolve(command.project.root, 'db'), { recursive: true })
+    await fs.writeFile(schemaFilePath, drizzleSchema)
+    await fs.writeFile(dbIndexFilePath, dbIndex)
+  } else {
+    await carefullyWriteFile(drizzleConfigFilePath, drizzleConfig, command.project.root)
+    await fs.mkdir(path.resolve(command.project.root, 'db'), { recursive: true })
+    await carefullyWriteFile(schemaFilePath, drizzleSchema, command.project.root)
+    await carefullyWriteFile(dbIndexFilePath, dbIndex, command.project.root)
+  }
+
+  const packageJsonPath = path.resolve(command.workingDir, 'package.json')
+  const packageJson = getPackageJSON(command.workingDir)
+
+  packageJson.scripts = {
+    ...(packageJson.scripts ?? {}),
+    ...packageJsonScripts,
+  }
+  if (opts.overwrite) {
+    await fs.writeFile(packageJsonPath, JSON.stringify(packageJson, null, 2))
+  }
+
+  type Answers = {
+    updatePackageJson: boolean
+  }
+
+  if (!opts.overwrite) {
+    const answers = await inquirer.prompt<Answers>([
+      {
+        type: 'confirm',
+        name: 'updatePackageJson',
+        message: `Add drizzle db commands to package.json?`,
+      },
+    ])
+    if (answers.updatePackageJson) {
+      await fs.writeFile(packageJsonPath, JSON.stringify(packageJson, null, 2))
+    }
+  }
+
+  if (!Object.keys(packageJson.devDependencies ?? {}).includes('drizzle-kit')) {
+    await spawnAsync(command.project.packageManager?.installCommand ?? 'npm install', ['drizzle-kit@latest', '-D'], {
+      stdio: 'inherit',
+      shell: true,
+    })
+  }
+
+  if (!Object.keys(packageJson.dependencies ?? {}).includes('drizzle-orm')) {
+    await spawnAsync(command.project.packageManager?.installCommand ?? 'npm install', ['drizzle-orm@latest'], {
+      stdio: 'inherit',
+      shell: true,
+    })
+  }
+}
+
+const drizzleConfig = `import { defineConfig } from 'drizzle-kit';
+
+export default defineConfig({
+    dialect: 'postgresql',
+    dbCredentials: {
+        url: process.env.NETLIFY_DATABASE_URL!
+    },
+    schema: './db/schema.ts',
+    /**
+     * Never edit the migrations directly, only use drizzle.
+     * There are scripts in the package.json "db:generate" and "db:migrate" to handle this.
+     */
+    out: './migrations'
+});`
+
+const drizzleSchema = `import { integer, pgTable, varchar, text } from 'drizzle-orm/pg-core';
+
+export const posts = pgTable('posts', {
+    id: integer().primaryKey().generatedAlwaysAsIdentity(),
+    title: varchar({ length: 255 }).notNull(),
+    content: text().notNull().default('')
+});`
+
+const dbIndex = `import { neon } from '${NETLIFY_NEON_PACKAGE_NAME}';
+import { drizzle } from 'drizzle-orm/neon-http';
+
+import * as schema from './schema';
+
+export const db = drizzle({
+    schema,
+    client: neon()
+});`
+
+const packageJsonScripts = {
+  'db:generate': 'drizzle-kit generate',
+  'db:migrate': 'netlify dev:exec drizzle-kit migrate',
+  'db:studio': 'netlify dev:exec drizzle-kit studio',
+}

src/commands/database/index.ts

@@ -0,0 +1 @@
+export { createDatabaseCommand } from './database.js'