deploy-bbc 0.0.1

package/cli/src/installers/queue.ts

@@ -0,0 +1,103 @@
+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);
+
+/**
+ * Queue installer - handles BullMQ and Inngest.
+ *
+ * @param options - Installer options with selected packages
+ */
+export async function queue_installer(
+  options: InstallerOptions
+): Promise<void> {
+  const { projectDir, packages } = options;
+
+  for (const pkg of packages) {
+    switch (pkg) {
+      case AvailablePackages.bullmq:
+        await install_bullmq(projectDir);
+        break;
+      case AvailablePackages.inngest:
+        await install_inngest(projectDir);
+        break;
+    }
+  }
+}
+
+async function install_bullmq(projectDir: string): Promise<void> {
+  const templateDir = path.resolve(
+    __dirname,
+    "../templates/extras/queue/bullmq"
+  );
+  await copy_template_files(templateDir, projectDir);
+
+  await add_package_dependency(projectDir, {
+    bullmq: DEPENDENCY_VERSION_MAP["bullmq"],
+  });
+
+  await append_env_example(
+    projectDir,
+    "\n# BullMQ Configuration\nREDIS_HOST=localhost\nREDIS_PORT=6379\nREDIS_PASSWORD=\n"
+  );
+}
+
+async function install_inngest(projectDir: string): Promise<void> {
+  const templateDir = path.resolve(
+    __dirname,
+    "../templates/extras/queue/inngest"
+  );
+  await copy_template_files(templateDir, projectDir);
+
+  await add_package_dependency(projectDir, {
+    inngest: DEPENDENCY_VERSION_MAP["inngest"],
+  });
+
+  await append_env_example(
+    projectDir,
+    "\n# Inngest Configuration\nINNGEST_EVENT_KEY=your-inngest-event-key\nINNGEST_SIGNING_KEY=your-inngest-signing-key\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);
+}

package/cli/src/installers/ratelimit.ts

@@ -0,0 +1,98 @@
+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);
+
+/**
+ * Rate limit installer - handles Upstash Rate Limit and custom rate limiting.
+ *
+ * @param options - Installer options with selected packages
+ */
+export async function ratelimit_installer(
+  options: InstallerOptions
+): Promise<void> {
+  const { projectDir, packages } = options;
+
+  for (const pkg of packages) {
+    switch (pkg) {
+      case AvailablePackages.upstashRateLimit:
+        await install_upstash_ratelimit(projectDir);
+        break;
+      case AvailablePackages.customRateLimit:
+        await install_custom_ratelimit(projectDir);
+        break;
+    }
+  }
+}
+
+async function install_upstash_ratelimit(projectDir: string): Promise<void> {
+  const templateDir = path.resolve(
+    __dirname,
+    "../templates/extras/ratelimit/upstash"
+  );
+  await copy_template_files(templateDir, projectDir);
+
+  await add_package_dependency(projectDir, {
+    "@upstash/ratelimit": DEPENDENCY_VERSION_MAP["@upstash/ratelimit"],
+    "@upstash/redis": DEPENDENCY_VERSION_MAP["@upstash/redis"],
+  });
+
+  await append_env_example(
+    projectDir,
+    "\n# Upstash Rate Limit Configuration\nUPSTASH_REDIS_REST_URL=your-upstash-redis-rest-url\nUPSTASH_REDIS_REST_TOKEN=your-upstash-redis-rest-token\n"
+  );
+}
+
+async function install_custom_ratelimit(projectDir: string): Promise<void> {
+  const templateDir = path.resolve(
+    __dirname,
+    "../templates/extras/ratelimit/custom"
+  );
+  await copy_template_files(templateDir, projectDir);
+
+  // Custom rate limit doesn't require external dependencies
+  // It uses built-in Hono middleware or custom implementation
+}
+
+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/realtime.ts

@@ -0,0 +1,79 @@
+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);
+
+/**
+ * Realtime installer - handles Socket.IO and Server-Sent Events (SSE).
+ *
+ * @param options - Installer options with selected packages
+ */
+export async function realtime_installer(
+  options: InstallerOptions
+): Promise<void> {
+  const { projectDir, packages } = options;
+
+  for (const pkg of packages) {
+    switch (pkg) {
+      case AvailablePackages.socketio:
+        await install_socketio(projectDir);
+        break;
+      case AvailablePackages.sse:
+        await install_sse(projectDir);
+        break;
+    }
+  }
+}
+
+async function install_socketio(projectDir: string): Promise<void> {
+  const templateDir = path.resolve(
+    __dirname,
+    "../templates/extras/realtime/socketio"
+  );
+  await copy_template_files(templateDir, projectDir);
+
+  await add_package_dependency(projectDir, {
+    "socket.io": DEPENDENCY_VERSION_MAP["socket.io"],
+  });
+
+  await add_package_dependency(
+    projectDir,
+    {},
+    {
+      "@types/socket.io": DEPENDENCY_VERSION_MAP["@types/socket.io"],
+    }
+  );
+}
+
+async function install_sse(projectDir: string): Promise<void> {
+  const templateDir = path.resolve(
+    __dirname,
+    "../templates/extras/realtime/sse"
+  );
+  await copy_template_files(templateDir, projectDir);
+
+  // SSE has no external dependencies, it's a native web standard
+}
+
+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,
+    });
+  }
+}

package/cli/src/installers/testing.ts

@@ -0,0 +1,88 @@
+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);
+
+/**
+ * Testing installer - handles Vitest testing framework.
+ *
+ * @param options - Installer options with selected packages
+ */
+export async function testing_installer(
+  options: InstallerOptions
+): Promise<void> {
+  const { projectDir, packages } = options;
+
+  for (const pkg of packages) {
+    switch (pkg) {
+      case AvailablePackages.vitest:
+        await install_vitest(projectDir);
+        break;
+    }
+  }
+}
+
+async function install_vitest(projectDir: string): Promise<void> {
+  const templateDir = path.resolve(
+    __dirname,
+    "../templates/extras/testing/vitest"
+  );
+  await copy_template_files(templateDir, projectDir);
+
+  await add_package_dependency(projectDir, {
+    vitest: DEPENDENCY_VERSION_MAP["vitest"],
+    "@vitest/ui": DEPENDENCY_VERSION_MAP["@vitest/ui"],
+    supertest: DEPENDENCY_VERSION_MAP["supertest"],
+  });
+
+  await add_package_dependency(
+    projectDir,
+    {},
+    {
+      "@types/supertest": DEPENDENCY_VERSION_MAP["@types/supertest"],
+    }
+  );
+}
+
+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/validation.ts

@@ -0,0 +1,85 @@
+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);
+
+/**
+ * Validation installer - handles Zod and Yup validation libraries.
+ *
+ * @param options - Installer options with selected packages
+ */
+export async function validation_installer(
+  options: InstallerOptions
+): Promise<void> {
+  const { projectDir, packages } = options;
+
+  for (const pkg of packages) {
+    switch (pkg) {
+      case AvailablePackages.zod:
+        await install_zod(projectDir);
+        break;
+      case AvailablePackages.yup:
+        await install_yup(projectDir);
+        break;
+    }
+  }
+}
+
+async function install_zod(projectDir: string): Promise<void> {
+  const templateDir = path.resolve(
+    __dirname,
+    "../templates/extras/validation/zod"
+  );
+  await copy_template_files(templateDir, projectDir);
+
+  await add_package_dependency(projectDir, {
+    zod: DEPENDENCY_VERSION_MAP["zod"],
+  });
+}
+
+async function install_yup(projectDir: string): Promise<void> {
+  const templateDir = path.resolve(
+    __dirname,
+    "../templates/extras/validation/yup"
+  );
+  await copy_template_files(templateDir, projectDir);
+
+  await add_package_dependency(projectDir, {
+    yup: DEPENDENCY_VERSION_MAP["yup"],
+  });
+}
+
+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);
+      }
+    }
+  }
+}

package/cli/src/templates/base/.env.example

@@ -0,0 +1,3 @@
+# Server Configuration
+PORT=3000
+NODE_ENV=development

package/cli/src/templates/base/README.md

@@ -0,0 +1,31 @@
+# My Backend App
+
+Production-ready Bun backend with TypeScript and Hono.
+
+## Getting Started
+
+```bash
+# Install dependencies
+bun install
+
+# Copy environment variables
+cp .env.example .env
+
+# Run development server
+bun run dev
+
+# Build for production
+bun run build
+
+# Run production server
+bun run start
+```
+
+## API Endpoints
+
+- `GET /` - Welcome message
+- `GET /health` - Health check
+
+## Documentation
+
+Visit `/docs` for API documentation (if Swagger/Scalar is installed).

package/cli/src/templates/base/package.json

@@ -0,0 +1,20 @@
+{
+  "name": "my-backend-app",
+  "version": "1.0.0",
+  "description": "Production-ready Bun backend with TypeScript",
+  "type": "module",
+  "scripts": {
+    "dev": "bun --watch src/index.ts",
+    "start": "bun src/index.ts",
+    "build": "bun build src/index.ts --outdir dist --target bun",
+    "type-check": "tsc --noEmit"
+  },
+  "dependencies": {
+    "hono": "^4.0.0",
+    "dotenv": "^16.3.1"
+  },
+  "devDependencies": {
+    "@types/bun": "latest",
+    "typescript": "^5.3.3"
+  }
+}

package/cli/src/templates/base/src/config/index.ts

@@ -0,0 +1,8 @@
+import { load_env } from "../utils/env.js";
+
+load_env();
+
+export const config = {
+  port: parseInt(process.env.PORT || "3000", 10),
+  nodeEnv: process.env.NODE_ENV || "development",
+} as const;

package/cli/src/templates/base/src/index.ts

@@ -0,0 +1,26 @@
+import { Hono } from "hono";
+import { logger as loggerMiddleware } from "./middleware/logger.js";
+import { errorHandler } from "./middleware/error.js";
+import routes from "./routes/index.js";
+import { config } from "./config/index.js";
+
+const app = new Hono();
+
+// Middleware
+app.use("*", loggerMiddleware);
+app.onError(errorHandler);
+
+// Routes
+app.route("/", routes);
+
+// Health check
+app.get("/health", (c) => {
+  return c.json({ status: "ok", timestamp: new Date().toISOString() });
+});
+
+console.log(`🚀 Server running on http://localhost:${config.port}`);
+
+export default {
+  port: config.port,
+  fetch: app.fetch,
+};

package/cli/src/templates/base/src/middleware/error.ts

@@ -0,0 +1,13 @@
+import type { ErrorHandler } from "hono";
+
+export const errorHandler: ErrorHandler = (err, c) => {
+  console.error(`Error: ${err.message}`, err);
+  
+  return c.json(
+    {
+      error: err.message || "Internal Server Error",
+      status: err.status || 500,
+    },
+    err.status || 500
+  );
+};

package/cli/src/templates/base/src/middleware/logger.ts

@@ -0,0 +1,8 @@
+import type { MiddlewareHandler } from "hono";
+
+export const logger: MiddlewareHandler = async (c, next) => {
+  const start = Date.now();
+  await next();
+  const ms = Date.now() - start;
+  console.log(`${c.req.method} ${c.req.url} - ${c.res.status} (${ms}ms)`);
+};

package/cli/src/templates/base/src/routes/index.ts

@@ -0,0 +1,12 @@
+import { Hono } from "hono";
+
+const routes = new Hono();
+
+routes.get("/", (c) => {
+  return c.json({
+    message: "Welcome to your Bun backend!",
+    docs: "/docs",
+  });
+});
+
+export default routes;

package/cli/src/templates/base/src/types/index.ts

@@ -0,0 +1,2 @@
+// Add your TypeScript types and interfaces here
+export {};

package/cli/src/templates/base/src/utils/env.ts

@@ -0,0 +1,5 @@
+import { config as dotenvConfig } from "dotenv";
+
+export function load_env(): void {
+  dotenvConfig();
+}

package/cli/src/templates/base/tsconfig.json

@@ -0,0 +1,20 @@
+{
+  "compilerOptions": {
+    "target": "ESNext",
+    "module": "ESNext",
+    "moduleResolution": "bundler",
+    "lib": ["ESNext"],
+    "types": ["bun-types"],
+    "strict": true,
+    "esModuleInterop": true,
+    "skipLibCheck": true,
+    "forceConsistentCasingInFileNames": true,
+    "resolveJsonModule": true,
+    "isolatedModules": true,
+    "noEmit": true,
+    "outDir": "./dist",
+    "rootDir": "./src"
+  },
+  "include": ["src/**/*"],
+  "exclude": ["node_modules", "dist"]
+}

package/cli/src/templates/base-bun-native/.env.example

@@ -0,0 +1,3 @@
+# Server Configuration
+PORT=3000
+NODE_ENV=development

package/cli/src/templates/base-bun-native/README.md

@@ -0,0 +1,31 @@
+# My Backend App
+
+Production-ready Bun backend with TypeScript and Hono.
+
+## Getting Started
+
+```bash
+# Install dependencies
+bun install
+
+# Copy environment variables
+cp .env.example .env
+
+# Run development server
+bun run dev
+
+# Build for production
+bun run build
+
+# Run production server
+bun run start
+```
+
+## API Endpoints
+
+- `GET /` - Welcome message
+- `GET /health` - Health check
+
+## Documentation
+
+Visit `/docs` for API documentation (if Swagger/Scalar is installed).

package/cli/src/templates/base-bun-native/package.json

@@ -0,0 +1,19 @@
+{
+  "name": "my-backend-app",
+  "version": "1.0.0",
+  "description": "Production-ready backend with Bun native HTTP server",
+  "type": "module",
+  "scripts": {
+    "dev": "bun --watch src/index.ts",
+    "start": "bun src/index.ts",
+    "build": "bun build src/index.ts --outdir dist --target bun",
+    "type-check": "tsc --noEmit"
+  },
+  "dependencies": {
+    "dotenv": "^16.3.1"
+  },
+  "devDependencies": {
+    "@types/bun": "latest",
+    "typescript": "^5.3.3"
+  }
+}

package/cli/src/templates/base-bun-native/src/config/index.ts

@@ -0,0 +1,8 @@
+import { load_env } from "../utils/env.js";
+
+load_env();
+
+export const config = {
+  port: parseInt(process.env.PORT || "3000", 10),
+  nodeEnv: process.env.NODE_ENV || "development",
+} as const;