deploy-bbc 1.2.0 → 1.2.2

package/cli/src/installers/database.ts

@@ -1,212 +0,0 @@
-import path from "path";
-import fs from "fs-extra";
-import { fileURLToPath } from "url";
-import { type InstallerOptions, AvailablePackages } from "../types/index.js";
-import { add_package_dependency } from "../utils/add-package-dependency.js";
-import { DEPENDENCY_VERSION_MAP } from "../utils/dependency-version-map.js";
-
-const __filename = fileURLToPath(import.meta.url);
-const __dirname = path.dirname(__filename);
-
-/**
- * Database installer - handles postgres, mysql, mongodb, and redis setup.
- * Copies template files and adds necessary dependencies.
- *
- * @param options - Installer options with selected packages
- */
-export async function database_installer(
-  options: InstallerOptions
-): Promise<void> {
-  const { projectDir, packages } = options;
-
-  // Handle each database type
-  for (const pkg of packages) {
-    switch (pkg) {
-      case AvailablePackages.postgres:
-        await install_postgres(projectDir);
-        break;
-      case AvailablePackages.mysql:
-        await install_mysql(projectDir);
-        break;
-      case AvailablePackages.mongodb:
-        await install_mongodb(projectDir);
-        break;
-      case AvailablePackages.redis:
-        await install_redis(projectDir);
-        break;
-    }
-  }
-}
-
-async function install_postgres(projectDir: string): Promise<void> {
-  // Copy template files
-  const templateDir = path.resolve(
-    __dirname,
-    "templates/extras/database/postgres"
-  );
-  await copy_template_files(templateDir, projectDir);
-
-  // Add dependencies
-  await add_package_dependency(projectDir, {
-    postgres: DEPENDENCY_VERSION_MAP["postgres"],
-    "drizzle-orm": DEPENDENCY_VERSION_MAP["drizzle-orm"],
-  });
-
-  await add_package_dependency(
-    projectDir,
-    {},
-    {
-      "drizzle-kit": DEPENDENCY_VERSION_MAP["drizzle-kit"],
-    }
-  );
-
-  // Append to .env.example
-  await append_env_example(
-    projectDir,
-    "\n# PostgreSQL Configuration\nDATABASE_URL=postgresql://user:password@localhost:5432/dbname\n"
-  );
-
-  // Add db scripts to package.json
-  await add_db_scripts(projectDir, "postgres");
-}
-
-async function install_mysql(projectDir: string): Promise<void> {
-  // Copy template files
-  const templateDir = path.resolve(
-    __dirname,
-    "templates/extras/database/mysql"
-  );
-  await copy_template_files(templateDir, projectDir);
-
-  // Add dependencies
-  await add_package_dependency(projectDir, {
-    mysql2: DEPENDENCY_VERSION_MAP["mysql2"],
-    "drizzle-orm": DEPENDENCY_VERSION_MAP["drizzle-orm"],
-  });
-
-  await add_package_dependency(
-    projectDir,
-    {},
-    {
-      "drizzle-kit": DEPENDENCY_VERSION_MAP["drizzle-kit"],
-    }
-  );
-
-  // Append to .env.example
-  await append_env_example(
-    projectDir,
-    "\n# MySQL Configuration\nDATABASE_URL=mysql://user:password@localhost:3306/dbname\n"
-  );
-
-  // Add db scripts to package.json
-  await add_db_scripts(projectDir, "mysql");
-}
-
-async function install_mongodb(projectDir: string): Promise<void> {
-  // Copy template files
-  const templateDir = path.resolve(
-    __dirname,
-    "templates/extras/database/mongodb"
-  );
-  await copy_template_files(templateDir, projectDir);
-
-  // Add dependencies
-  await add_package_dependency(projectDir, {
-    mongoose: DEPENDENCY_VERSION_MAP["mongoose"],
-  });
-
-  // Append to .env.example
-  await append_env_example(
-    projectDir,
-    "\n# MongoDB Configuration\nMONGODB_URI=mongodb://localhost:27017/dbname\n"
-  );
-}
-
-async function install_redis(projectDir: string): Promise<void> {
-  // Copy template files
-  const templateDir = path.resolve(
-    __dirname,
-    "templates/extras/database/redis"
-  );
-  await copy_template_files(templateDir, projectDir);
-
-  // Add dependencies
-  await add_package_dependency(projectDir, {
-    redis: DEPENDENCY_VERSION_MAP["redis"],
-  });
-
-  // Append to .env.example
-  await append_env_example(
-    projectDir,
-    "\n# Redis Configuration\nREDIS_URL=redis://localhost:6379\n"
-  );
-}
-
-/**
- * Copies template files from source to destination.
- * Copies both src/ directory and root config files.
- */
-async function copy_template_files(
-  templateDir: string,
-  projectDir: string
-): Promise<void> {
-  if (!(await fs.pathExists(templateDir))) {
-    console.warn(`Template directory not found: ${templateDir}`);
-    return;
-  }
-
-  // Copy src files
-  const srcDir = path.join(templateDir, "src");
-  if (await fs.pathExists(srcDir)) {
-    const targetSrcDir = path.join(projectDir, "src");
-    await fs.copy(srcDir, targetSrcDir, {
-      overwrite: false,
-      errorOnExist: false,
-    });
-  }
-
-  // Copy root config files (e.g., drizzle.config.ts)
-  const templateFiles = await fs.readdir(templateDir);
-  for (const file of templateFiles) {
-    if (file !== "src" && (file.endsWith(".ts") || file.endsWith(".json"))) {
-      const srcFile = path.join(templateDir, file);
-      const destFile = path.join(projectDir, file);
-
-      // Only copy if file doesn't exist
-      if (!(await fs.pathExists(destFile))) {
-        await fs.copy(srcFile, destFile);
-      }
-    }
-  }
-}
-
-/**
- * Appends environment variables to .env.example
- */
-async function append_env_example(
-  projectDir: string,
-  content: string
-): Promise<void> {
-  const envPath = path.join(projectDir, ".env.example");
-  await fs.appendFile(envPath, content);
-}
-
-/**
- * Adds database migration scripts to package.json
- */
-async function add_db_scripts(
-  projectDir: string,
-  dbType: "postgres" | "mysql"
-): Promise<void> {
-  const packageJsonPath = path.join(projectDir, "package.json");
-  const packageJson = await fs.readJson(packageJsonPath);
-
-  packageJson.scripts = {
-    ...packageJson.scripts,
-    "db:generate": "drizzle-kit generate",
-    "db:migrate": "drizzle-kit migrate",
-    "db:studio": "drizzle-kit studio",
-  };
-
-  await fs.writeJson(packageJsonPath, packageJson, { spaces: 2 });
-}

package/cli/src/installers/docs.ts

@@ -1,93 +0,0 @@
-import path from "path";
-import fs from "fs-extra";
-import { fileURLToPath } from "url";
-import { type InstallerOptions, AvailablePackages } from "../types/index.js";
-import { add_package_dependency } from "../utils/add-package-dependency.js";
-import { DEPENDENCY_VERSION_MAP } from "../utils/dependency-version-map.js";
-
-const __filename = fileURLToPath(import.meta.url);
-const __dirname = path.dirname(__filename);
-
-/**
- * Docs installer - handles Swagger and Scalar API documentation.
- *
- * @param options - Installer options with selected packages
- */
-export async function docs_installer(
-  options: InstallerOptions
-): Promise<void> {
-  const { projectDir, packages } = options;
-
-  for (const pkg of packages) {
-    switch (pkg) {
-      case AvailablePackages.swagger:
-        await install_swagger(projectDir);
-        break;
-      case AvailablePackages.scalar:
-        await install_scalar(projectDir);
-        break;
-    }
-  }
-}
-
-async function install_swagger(projectDir: string): Promise<void> {
-  const templateDir = path.resolve(
-    __dirname,
-    "templates/extras/docs/swagger"
-  );
-  await copy_template_files(templateDir, projectDir);
-
-  await add_package_dependency(projectDir, {
-    "@hono/swagger": DEPENDENCY_VERSION_MAP["@hono/swagger"],
-  });
-}
-
-async function install_scalar(projectDir: string): Promise<void> {
-  const templateDir = path.resolve(
-    __dirname,
-    "templates/extras/docs/scalar"
-  );
-  await copy_template_files(templateDir, projectDir);
-
-  await add_package_dependency(projectDir, {
-    "@scalar/hono-api-reference": DEPENDENCY_VERSION_MAP["@scalar/hono-api-reference"],
-  });
-}
-
-async function copy_template_files(
-  templateDir: string,
-  projectDir: string
-): Promise<void> {
-  if (!(await fs.pathExists(templateDir))) {
-    return;
-  }
-
-  const srcDir = path.join(templateDir, "src");
-  if (await fs.pathExists(srcDir)) {
-    const targetSrcDir = path.join(projectDir, "src");
-    await fs.copy(srcDir, targetSrcDir, {
-      overwrite: false,
-      errorOnExist: false,
-    });
-  }
-
-  const templateFiles = await fs.readdir(templateDir);
-  for (const file of templateFiles) {
-    if (file !== "src" && (file.endsWith(".ts") || file.endsWith(".json"))) {
-      const srcFile = path.join(templateDir, file);
-      const destFile = path.join(projectDir, file);
-
-      if (!(await fs.pathExists(destFile))) {
-        await fs.copy(srcFile, destFile);
-      }
-    }
-  }
-}
-
-async function append_env_example(
-  projectDir: string,
-  content: string
-): Promise<void> {
-  const envPath = path.join(projectDir, ".env.example");
-  await fs.appendFile(envPath, content);
-}

package/cli/src/installers/email.ts

@@ -1,119 +0,0 @@
-import path from "path";
-import fs from "fs-extra";
-import { fileURLToPath } from "url";
-import { type InstallerOptions, AvailablePackages } from "../types/index.js";
-import { add_package_dependency } from "../utils/add-package-dependency.js";
-import { DEPENDENCY_VERSION_MAP } from "../utils/dependency-version-map.js";
-
-const __filename = fileURLToPath(import.meta.url);
-const __dirname = path.dirname(__filename);
-
-/**
- * Email installer - handles Resend, SendGrid, and Nodemailer.
- *
- * @param options - Installer options with selected packages
- */
-export async function email_installer(
-  options: InstallerOptions
-): Promise<void> {
-  const { projectDir, packages } = options;
-
-  for (const pkg of packages) {
-    switch (pkg) {
-      case AvailablePackages.resend:
-        await install_resend(projectDir);
-        break;
-      case AvailablePackages.sendgrid:
-        await install_sendgrid(projectDir);
-        break;
-      case AvailablePackages.nodemailer:
-        await install_nodemailer(projectDir);
-        break;
-    }
-  }
-}
-
-async function install_resend(projectDir: string): Promise<void> {
-  const templateDir = path.resolve(
-    __dirname,
-    "templates/extras/email/resend"
-  );
-  await copy_template_files(templateDir, projectDir);
-
-  await add_package_dependency(projectDir, {
-    resend: DEPENDENCY_VERSION_MAP["resend"],
-  });
-
-  await append_env_example(
-    projectDir,
-    "\n# Resend Configuration\nRESEND_API_KEY=your-resend-api-key\n"
-  );
-}
-
-async function install_sendgrid(projectDir: string): Promise<void> {
-  const templateDir = path.resolve(
-    __dirname,
-    "templates/extras/email/sendgrid"
-  );
-  await copy_template_files(templateDir, projectDir);
-
-  await add_package_dependency(projectDir, {
-    "@sendgrid/mail": DEPENDENCY_VERSION_MAP["@sendgrid/mail"],
-  });
-
-  await append_env_example(
-    projectDir,
-    "\n# SendGrid Configuration\nSENDGRID_API_KEY=your-sendgrid-api-key\nSENDGRID_FROM_EMAIL=noreply@yourdomain.com\n"
-  );
-}
-
-async function install_nodemailer(projectDir: string): Promise<void> {
-  const templateDir = path.resolve(
-    __dirname,
-    "templates/extras/email/nodemailer"
-  );
-  await copy_template_files(templateDir, projectDir);
-
-  await add_package_dependency(projectDir, {
-    nodemailer: DEPENDENCY_VERSION_MAP["nodemailer"],
-  });
-
-  await add_package_dependency(
-    projectDir,
-    {},
-    {
-      "@types/nodemailer": DEPENDENCY_VERSION_MAP["@types/nodemailer"],
-    }
-  );
-
-  await append_env_example(
-    projectDir,
-    "\n# Nodemailer Configuration\nSMTP_HOST=smtp.example.com\nSMTP_PORT=587\nSMTP_USER=your-smtp-username\nSMTP_PASS=your-smtp-password\nSMTP_FROM=noreply@yourdomain.com\n"
-  );
-}
-
-async function copy_template_files(
-  templateDir: string,
-  projectDir: string
-): Promise<void> {
-  if (!(await fs.pathExists(templateDir))) {
-    return;
-  }
-
-  const srcDir = path.join(templateDir, "src");
-  if (await fs.pathExists(srcDir)) {
-    const targetSrcDir = path.join(projectDir, "src");
-    await fs.copy(srcDir, targetSrcDir, {
-      overwrite: false,
-      errorOnExist: false,
-    });
-  }
-}
-
-async function append_env_example(
-  projectDir: string,
-  content: string
-): Promise<void> {
-  const envPath = path.join(projectDir, ".env.example");
-  await fs.appendFile(envPath, content);
-}

package/cli/src/installers/env-variables.ts

@@ -1,27 +0,0 @@
-import path from "path";
-import fs from "fs-extra";
-import { type InstallerOptions } from "../types/index.js";
-
-/**
- * Environment variables installer - creates an empty .env file.
- * The .env.example file is populated by individual installers as they run.
- * This installer ensures a .env file exists for local development.
- *
- * @param options - Installer options
- */
-export async function env_variables_installer(
-  options: InstallerOptions
-): Promise<void> {
-  const { projectDir } = options;
-
-  // Create empty .env file (will be git-ignored)
-  const envPath = path.join(projectDir, ".env");
-
-  // Only create if it doesn't exist
-  if (!(await fs.pathExists(envPath))) {
-    await fs.writeFile(
-      envPath,
-      "# Copy values from .env.example and fill in your actual credentials\n"
-    );
-  }
-}

package/cli/src/installers/index.ts

@@ -1,145 +0,0 @@
-import {
-  type InstallerOptions,
-  type PkgInstallerMap,
-  type Installer,
-  AvailablePackages,
-} from "../types/index.js";
-import { base_installer } from "./base.js";
-import { database_installer } from "./database.js";
-import { auth_installer } from "./auth.js";
-import { ai_installer } from "./ai.js";
-import { email_installer } from "./email.js";
-import { cloud_installer } from "./cloud.js";
-import { realtime_installer } from "./realtime.js";
-import { queue_installer } from "./queue.js";
-import { ratelimit_installer } from "./ratelimit.js";
-import { observability_installer } from "./observability.js";
-import { docs_installer } from "./docs.js";
-import { testing_installer } from "./testing.js";
-import { validation_installer } from "./validation.js";
-import { env_variables_installer } from "./env-variables.js";
-
-/**
- * Builds a map of installers based on selected packages.
- * Each installer is marked as inUse if any of its related packages are selected.
- *
- * @param options - Installer options with selected packages
- * @returns Map of installers with usage flags
- */
-export function build_installer_map(
-  options: InstallerOptions
-): PkgInstallerMap {
-  const { packages } = options;
-
-  // Helper to check if any package in a category is selected
-  const has_package = (...pkgs: AvailablePackages[]): boolean => {
-    return pkgs.some((pkg) => packages.includes(pkg));
-  };
-
-  return {
-    base: {
-      inUse: true, // Always run base installer
-      installer: base_installer,
-    },
-    database: {
-      inUse: has_package(
-        AvailablePackages.postgres,
-        AvailablePackages.mysql,
-        AvailablePackages.mongodb,
-        AvailablePackages.redis
-      ),
-      installer: database_installer,
-    },
-    auth: {
-      inUse: has_package(
-        AvailablePackages.jwt,
-        AvailablePackages.oauth,
-        AvailablePackages.session
-      ),
-      installer: auth_installer,
-    },
-    ai: {
-      inUse: has_package(
-        AvailablePackages.openai,
-        AvailablePackages.anthropic,
-        AvailablePackages.gemini,
-        AvailablePackages.vercelAI
-      ),
-      installer: ai_installer,
-    },
-    email: {
-      inUse: has_package(
-        AvailablePackages.resend,
-        AvailablePackages.sendgrid,
-        AvailablePackages.nodemailer
-      ),
-      installer: email_installer,
-    },
-    cloud: {
-      inUse: has_package(
-        AvailablePackages.aws,
-        AvailablePackages.gcp,
-        AvailablePackages.azure,
-        AvailablePackages.cloudflareR2
-      ),
-      installer: cloud_installer,
-    },
-    realtime: {
-      inUse: has_package(AvailablePackages.socketio, AvailablePackages.sse),
-      installer: realtime_installer,
-    },
-    queue: {
-      inUse: has_package(AvailablePackages.bullmq, AvailablePackages.inngest),
-      installer: queue_installer,
-    },
-    ratelimit: {
-      inUse: has_package(
-        AvailablePackages.upstashRateLimit,
-        AvailablePackages.customRateLimit
-      ),
-      installer: ratelimit_installer,
-    },
-    observability: {
-      inUse: has_package(AvailablePackages.sentry, AvailablePackages.logtail),
-      installer: observability_installer,
-    },
-    docs: {
-      inUse: has_package(AvailablePackages.swagger, AvailablePackages.scalar),
-      installer: docs_installer,
-    },
-    testing: {
-      inUse: has_package(AvailablePackages.vitest),
-      installer: testing_installer,
-    },
-    validation: {
-      inUse: has_package(AvailablePackages.zod, AvailablePackages.yup),
-      installer: validation_installer,
-    },
-    envVariables: {
-      inUse: true, // Always run to create .env files
-      installer: env_variables_installer,
-    },
-  };
-}
-
-/**
- * Executes all installers marked as inUse sequentially.
- * Each installer is responsible for copying templates and adding dependencies.
- *
- * @param installerMap - Map of installers with usage flags
- * @param options - Installer options
- */
-export async function run_installers(
-  installerMap: PkgInstallerMap,
-  options: InstallerOptions
-): Promise<void> {
-  // Get list of active installers
-  const installers = Object.entries(installerMap)
-    .filter(([_, config]) => config.inUse)
-    .map(([_, config]) => config.installer);
-
-  // Run each installer sequentially
-  for (const installer of installers) {
-    await installer(options);
-  }
-}

package/cli/src/installers/observability.ts

@@ -1,103 +0,0 @@
-import path from "path";
-import fs from "fs-extra";
-import { fileURLToPath } from "url";
-import { type InstallerOptions, AvailablePackages } from "../types/index.js";
-import { add_package_dependency } from "../utils/add-package-dependency.js";
-import { DEPENDENCY_VERSION_MAP } from "../utils/dependency-version-map.js";
-
-const __filename = fileURLToPath(import.meta.url);
-const __dirname = path.dirname(__filename);
-
-/**
- * Observability installer - handles Sentry and Logtail.
- *
- * @param options - Installer options with selected packages
- */
-export async function observability_installer(
-  options: InstallerOptions
-): Promise<void> {
-  const { projectDir, packages } = options;
-
-  for (const pkg of packages) {
-    switch (pkg) {
-      case AvailablePackages.sentry:
-        await install_sentry(projectDir);
-        break;
-      case AvailablePackages.logtail:
-        await install_logtail(projectDir);
-        break;
-    }
-  }
-}
-
-async function install_sentry(projectDir: string): Promise<void> {
-  const templateDir = path.resolve(
-    __dirname,
-    "templates/extras/observability/sentry"
-  );
-  await copy_template_files(templateDir, projectDir);
-
-  await add_package_dependency(projectDir, {
-    "@sentry/node": DEPENDENCY_VERSION_MAP["@sentry/node"],
-  });
-
-  await append_env_example(
-    projectDir,
-    "\n# Sentry Configuration\nSENTRY_DSN=your-sentry-dsn-here\nSENTRY_ENVIRONMENT=production\n"
-  );
-}
-
-async function install_logtail(projectDir: string): Promise<void> {
-  const templateDir = path.resolve(
-    __dirname,
-    "templates/extras/observability/logtail"
-  );
-  await copy_template_files(templateDir, projectDir);
-
-  await add_package_dependency(projectDir, {
-    "@logtail/node": DEPENDENCY_VERSION_MAP["@logtail/node"],
-  });
-
-  await append_env_example(
-    projectDir,
-    "\n# Logtail Configuration\nLOGTAIL_SOURCE_TOKEN=your-logtail-source-token-here\n"
-  );
-}
-
-async function copy_template_files(
-  templateDir: string,
-  projectDir: string
-): Promise<void> {
-  if (!(await fs.pathExists(templateDir))) {
-    return;
-  }
-
-  const srcDir = path.join(templateDir, "src");
-  if (await fs.pathExists(srcDir)) {
-    const targetSrcDir = path.join(projectDir, "src");
-    await fs.copy(srcDir, targetSrcDir, {
-      overwrite: false,
-      errorOnExist: false,
-    });
-  }
-
-  const templateFiles = await fs.readdir(templateDir);
-  for (const file of templateFiles) {
-    if (file !== "src" && (file.endsWith(".ts") || file.endsWith(".json"))) {
-      const srcFile = path.join(templateDir, file);
-      const destFile = path.join(projectDir, file);
-
-      if (!(await fs.pathExists(destFile))) {
-        await fs.copy(srcFile, destFile);
-      }
-    }
-  }
-}
-
-async function append_env_example(
-  projectDir: string,
-  content: string
-): Promise<void> {
-  const envPath = path.join(projectDir, ".env.example");
-  await fs.appendFile(envPath, content);
-}