deploy-bbc 1.1.0 → 1.2.1

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

@@ -10,8 +10,9 @@
     "type-check": "tsc --noEmit"
   },
   "dependencies": {
+    "dotenv": "^16.3.1",
     "express": "^4.18.2",
-    "dotenv": "^16.3.1"
+    "zod": "^3.22.4"
   },
   "devDependencies": {
     "@types/bun": "latest",

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

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

package/cli/src/templates/base-express/src/controllers/user/create-user.controller.ts

@@ -0,0 +1,75 @@
+import type { Request, Response } from "express";
+import { z } from "zod";
+import { user_model } from "../../models/user.model.js";
+import type { ApiResponse, ApiError } from "../../types/common/api-response.types.js";
+import type { UserResponse } from "../../types/models/user.types.js";
+
+/**
+ * Validation schema
+ */
+const create_user_schema = z.object({
+  email: z.string().email("Invalid email address"),
+  name: z.string().min(2, "Name must be at least 2 characters").max(100, "Name must not exceed 100 characters"),
+});
+
+/**
+ * Helper to format user response
+ */
+function format_user_response(user: any): UserResponse {
+  return {
+    id: user.id,
+    email: user.email,
+    name: user.name,
+    createdAt: user.createdAt.toISOString(),
+    updatedAt: user.updatedAt.toISOString(),
+  };
+}
+
+/**
+ * Create a new user
+ * POST /users
+ */
+export async function create_user(req: Request, res: Response) {
+  try {
+    // Validate request body
+    const validation = create_user_schema.safeParse(req.body);
+    if (!validation.success) {
+      const errorResponse: ApiError = {
+        success: false,
+        error: "Validation failed",
+        details: validation.error.errors.map((err) => ({
+          field: err.path.join("."),
+          message: err.message,
+        })),
+      };
+      return res.status(400).json(errorResponse);
+    }
+
+    // Check if email already exists
+    const existing_user = await user_model.find_by_email(validation.data.email);
+    if (existing_user) {
+      const errorResponse: ApiError = {
+        success: false,
+        error: "User with this email already exists",
+      };
+      return res.status(409).json(errorResponse);
+    }
+
+    // Create user
+    const user = await user_model.create(validation.data);
+
+    const response: ApiResponse<UserResponse> = {
+      success: true,
+      data: format_user_response(user),
+      message: "User created successfully",
+    };
+
+    res.status(201).json(response);
+  } catch (error) {
+    const errorResponse: ApiError = {
+      success: false,
+      error: "Failed to create user",
+    };
+    res.status(500).json(errorResponse);
+  }
+}

package/cli/src/templates/base-express/src/controllers/user/delete-user.controller.ts

@@ -0,0 +1,56 @@
+import type { Request, Response } from "express";
+import { z } from "zod";
+import { user_model } from "../../models/user.model.js";
+import type { ApiResponse, ApiError } from "../../types/common/api-response.types.js";
+
+/**
+ * Validation schema
+ */
+const user_id_schema = z.string().uuid("Invalid user ID format");
+
+/**
+ * Delete user by ID
+ * DELETE /users/:id
+ */
+export async function delete_user(req: Request, res: Response) {
+  try {
+    const { id } = req.params;
+
+    // Validate ID format
+    const validation = user_id_schema.safeParse(id);
+    if (!validation.success) {
+      const errorResponse: ApiError = {
+        success: false,
+        error: "Invalid user ID",
+        details: validation.error.errors.map((err) => ({
+          field: err.path.join("."),
+          message: err.message,
+        })),
+      };
+      return res.status(400).json(errorResponse);
+    }
+
+    const deleted = await user_model.delete(id);
+
+    if (!deleted) {
+      const errorResponse: ApiError = {
+        success: false,
+        error: "User not found",
+      };
+      return res.status(404).json(errorResponse);
+    }
+
+    const response: ApiResponse = {
+      success: true,
+      message: "User deleted successfully",
+    };
+
+    res.json(response);
+  } catch (error) {
+    const errorResponse: ApiError = {
+      success: false,
+      error: "Failed to delete user",
+    };
+    res.status(500).json(errorResponse);
+  }
+}

package/cli/src/templates/base-express/src/controllers/user/get-user.controller.ts

@@ -0,0 +1,70 @@
+import type { Request, Response } from "express";
+import { z } from "zod";
+import { user_model } from "../../models/user.model.js";
+import type { ApiResponse, ApiError } from "../../types/common/api-response.types.js";
+import type { UserResponse } from "../../types/models/user.types.js";
+
+/**
+ * Validation schema
+ */
+const user_id_schema = z.string().uuid("Invalid user ID format");
+
+/**
+ * Helper to format user response
+ */
+function format_user_response(user: any): UserResponse {
+  return {
+    id: user.id,
+    email: user.email,
+    name: user.name,
+    createdAt: user.createdAt.toISOString(),
+    updatedAt: user.updatedAt.toISOString(),
+  };
+}
+
+/**
+ * Get user by ID
+ * GET /users/:id
+ */
+export async function get_user(req: Request, res: Response) {
+  try {
+    const { id } = req.params;
+
+    // Validate ID format
+    const validation = user_id_schema.safeParse(id);
+    if (!validation.success) {
+      const errorResponse: ApiError = {
+        success: false,
+        error: "Invalid user ID",
+        details: validation.error.errors.map((err) => ({
+          field: err.path.join("."),
+          message: err.message,
+        })),
+      };
+      return res.status(400).json(errorResponse);
+    }
+
+    const user = await user_model.find_by_id(id);
+
+    if (!user) {
+      const errorResponse: ApiError = {
+        success: false,
+        error: "User not found",
+      };
+      return res.status(404).json(errorResponse);
+    }
+
+    const response: ApiResponse<UserResponse> = {
+      success: true,
+      data: format_user_response(user),
+    };
+
+    res.json(response);
+  } catch (error) {
+    const errorResponse: ApiError = {
+      success: false,
+      error: "Failed to fetch user",
+    };
+    res.status(500).json(errorResponse);
+  }
+}

package/cli/src/templates/base-express/src/controllers/user/get-users.controller.ts

@@ -0,0 +1,41 @@
+import type { Request, Response } from "express";
+import { user_model } from "../../models/user.model.js";
+import type { ApiResponse, ApiError } from "../../types/common/api-response.types.js";
+import type { UserResponse } from "../../types/models/user.types.js";
+
+/**
+ * Helper to format user response
+ */
+function format_user_response(user: any): UserResponse {
+  return {
+    id: user.id,
+    email: user.email,
+    name: user.name,
+    createdAt: user.createdAt.toISOString(),
+    updatedAt: user.updatedAt.toISOString(),
+  };
+}
+
+/**
+ * Get all users
+ * GET /users
+ */
+export async function get_users(req: Request, res: Response) {
+  try {
+    const users = await user_model.find_all();
+    const formatted_users = users.map(format_user_response);
+
+    const response: ApiResponse<UserResponse[]> = {
+      success: true,
+      data: formatted_users,
+    };
+
+    res.json(response);
+  } catch (error) {
+    const errorResponse: ApiError = {
+      success: false,
+      error: "Failed to fetch users",
+    };
+    res.status(500).json(errorResponse);
+  }
+}

package/cli/src/templates/base-express/src/controllers/user/update-user.controller.ts

@@ -0,0 +1,102 @@
+import type { Request, Response } from "express";
+import { z } from "zod";
+import { user_model } from "../../models/user.model.js";
+import type { ApiResponse, ApiError } from "../../types/common/api-response.types.js";
+import type { UserResponse } from "../../types/models/user.types.js";
+
+/**
+ * Validation schemas
+ */
+const user_id_schema = z.string().uuid("Invalid user ID format");
+const update_user_schema = z.object({
+  email: z.string().email("Invalid email address").optional(),
+  name: z.string().min(2, "Name must be at least 2 characters").max(100, "Name must not exceed 100 characters").optional(),
+});
+
+/**
+ * Helper to format user response
+ */
+function format_user_response(user: any): UserResponse {
+  return {
+    id: user.id,
+    email: user.email,
+    name: user.name,
+    createdAt: user.createdAt.toISOString(),
+    updatedAt: user.updatedAt.toISOString(),
+  };
+}
+
+/**
+ * Update user by ID
+ * PATCH /users/:id
+ */
+export async function update_user(req: Request, res: Response) {
+  try {
+    const { id } = req.params;
+
+    // Validate ID format
+    const id_validation = user_id_schema.safeParse(id);
+    if (!id_validation.success) {
+      const errorResponse: ApiError = {
+        success: false,
+        error: "Invalid user ID",
+        details: id_validation.error.errors.map((err) => ({
+          field: err.path.join("."),
+          message: err.message,
+        })),
+      };
+      return res.status(400).json(errorResponse);
+    }
+
+    // Validate request body
+    const body_validation = update_user_schema.safeParse(req.body);
+    if (!body_validation.success) {
+      const errorResponse: ApiError = {
+        success: false,
+        error: "Validation failed",
+        details: body_validation.error.errors.map((err) => ({
+          field: err.path.join("."),
+          message: err.message,
+        })),
+      };
+      return res.status(400).json(errorResponse);
+    }
+
+    // Check if email is being updated and if it already exists
+    if (body_validation.data.email) {
+      const existing_user = await user_model.find_by_email(body_validation.data.email);
+      if (existing_user && existing_user.id !== id) {
+        const errorResponse: ApiError = {
+          success: false,
+          error: "User with this email already exists",
+        };
+        return res.status(409).json(errorResponse);
+      }
+    }
+
+    // Update user
+    const user = await user_model.update(id, body_validation.data);
+
+    if (!user) {
+      const errorResponse: ApiError = {
+        success: false,
+        error: "User not found",
+      };
+      return res.status(404).json(errorResponse);
+    }
+
+    const response: ApiResponse<UserResponse> = {
+      success: true,
+      data: format_user_response(user),
+      message: "User updated successfully",
+    };
+
+    res.json(response);
+  } catch (error) {
+    const errorResponse: ApiError = {
+      success: false,
+      error: "Failed to update user",
+    };
+    res.status(500).json(errorResponse);
+  }
+}

package/cli/src/templates/base-express/src/models/user.model.ts

@@ -0,0 +1,83 @@
+import type { User, CreateUserInput, UpdateUserInput } from "../types/models/user.types.js";
+
+/**
+ * User model
+ *
+ * This is a simple in-memory implementation.
+ * Replace with your database ORM (Drizzle, Prisma, etc.) in production.
+ */
+
+// In-memory storage (for demonstration)
+const users: User[] = [];
+
+export const user_model = {
+  /**
+   * Find all users
+   */
+  find_all: async (): Promise<User[]> => {
+    return users;
+  },
+
+  /**
+   * Find user by ID
+   */
+  find_by_id: async (id: string): Promise<User | undefined> => {
+    return users.find((user) => user.id === id);
+  },
+
+  /**
+   * Find user by email
+   */
+  find_by_email: async (email: string): Promise<User | undefined> => {
+    return users.find((user) => user.email === email);
+  },
+
+  /**
+   * Create a new user
+   */
+  create: async (input: CreateUserInput): Promise<User> => {
+    const user: User = {
+      id: crypto.randomUUID(),
+      email: input.email,
+      name: input.name,
+      createdAt: new Date(),
+      updatedAt: new Date(),
+    };
+
+    users.push(user);
+    return user;
+  },
+
+  /**
+   * Update user by ID
+   */
+  update: async (id: string, input: UpdateUserInput): Promise<User | undefined> => {
+    const index = users.findIndex((user) => user.id === id);
+
+    if (index === -1) {
+      return undefined;
+    }
+
+    users[index] = {
+      ...users[index],
+      ...input,
+      updatedAt: new Date(),
+    };
+
+    return users[index];
+  },
+
+  /**
+   * Delete user by ID
+   */
+  delete: async (id: string): Promise<boolean> => {
+    const index = users.findIndex((user) => user.id === id);
+
+    if (index === -1) {
+      return false;
+    }
+
+    users.splice(index, 1);
+    return true;
+  },
+};

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

@@ -1,7 +1,9 @@
 import express from "express";
+import user_route from "./user.route.js";
 
 const router = express.Router();
 
+// Root route
 router.get("/", (req, res) => {
   res.json({
     message: "Welcome to your Bun backend!",
@@ -9,4 +11,7 @@ router.get("/", (req, res) => {
   });
 });
 
+// User routes
+router.use("/users", user_route);
+
 export default router;

package/cli/src/templates/base-express/src/routes/user.route.ts

@@ -0,0 +1,17 @@
+import express from "express";
+import { get_users } from "../controllers/user/get-users.controller.js";
+import { get_user } from "../controllers/user/get-user.controller.js";
+import { create_user } from "../controllers/user/create-user.controller.js";
+import { update_user } from "../controllers/user/update-user.controller.js";
+import { delete_user } from "../controllers/user/delete-user.controller.js";
+
+const user_route = express.Router();
+
+// User CRUD routes
+user_route.get("/", get_users);
+user_route.get("/:id", get_user);
+user_route.post("/", create_user);
+user_route.patch("/:id", update_user);
+user_route.delete("/:id", delete_user);
+
+export default user_route;

package/cli/src/templates/base-express/src/types/common/api-response.types.ts

@@ -0,0 +1,30 @@
+/**
+ * Common API response types
+ */
+
+export interface ApiResponse<T = unknown> {
+  success: boolean;
+  data?: T;
+  error?: string;
+  message?: string;
+}
+
+export interface PaginatedResponse<T> extends ApiResponse<T[]> {
+  pagination: {
+    page: number;
+    limit: number;
+    total: number;
+    totalPages: number;
+  };
+}
+
+export interface ValidationError {
+  field: string;
+  message: string;
+}
+
+export interface ApiError {
+  success: false;
+  error: string;
+  details?: ValidationError[];
+}

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

@@ -1,2 +1,5 @@
-// Add your TypeScript types and interfaces here
-export {};
+// Export common types
+export * from "./common/api-response.types.js";
+
+// Export model types
+export * from "./models/user.types.js";

package/cli/src/templates/base-express/src/types/models/user.types.ts

@@ -0,0 +1,26 @@
+/**
+ * User model types
+ */
+
+export interface User {
+  id: string;
+  email: string;
+  name: string;
+  createdAt: Date;
+  updatedAt: Date;
+}
+
+export interface CreateUserInput {
+  email: string;
+  name: string;
+}
+
+export interface UpdateUserInput {
+  email?: string;
+  name?: string;
+}
+
+export type UserResponse = Omit<User, "createdAt" | "updatedAt"> & {
+  createdAt: string;
+  updatedAt: string;
+};

package/cli/src/utils/parse-name-and-path.ts

@@ -1,19 +1,35 @@
 import path from "path";
 
-export interface ParsedNameAndPath {
+export type ParsedNameAndPath = {
   projectName: string;
   projectDir: string;
 }
 
 /**
  * Parses the app name input to extract project name and directory path.
- * Handles relative paths (./my-app), absolute paths, and simple names.
+ * Handles:
+ * - Current directory: "." (sets up in current directory)
+ * - Relative paths: "./my-app", "../my-app"
+ * - Home paths: "~/my-app"
+ * - Absolute paths: "/path/to/my-app"
+ * - Simple names: "my-app" (creates subdirectory in current directory)
  *
  * @param appName - The app name or path provided by the user
  * @returns Object containing projectName (kebab-case) and projectDir (absolute path)
  * @throws Error if the name contains invalid characters (spaces, special chars except - and _)
  */
 export function parse_name_and_path(appName: string): ParsedNameAndPath {
+  // Handle special case: current directory
+  if (appName === ".") {
+    const currentDir = process.cwd();
+    const currentDirName = path.basename(currentDir);
+
+    return {
+      projectName: currentDirName.replace(/_/g, "-").toLowerCase(),
+      projectDir: currentDir,
+    };
+  }
+
   // Validate app name - no spaces or invalid characters
   // Allow only alphanumeric, hyphens, underscores, slashes, and dots (for paths)
   const pathRegex = /^[a-zA-Z0-9\-_/.]+$/;

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "deploy-bbc",
-    "version": "1.1.0",
+    "version": "1.2.1",
     "description": "CLI to bootstrap production-ready backends with Bun (Best Backend Code)",
     "workspaces": [
         "cli"
@@ -14,7 +14,7 @@
     "devDependencies": {
         "@types/bun": "latest",
         "bun-types": "^1.3.7",
-        "prettier": "^3.1.1",
-        "typescript": "^5.3.3"
+        "prettier": "^3.8.1",
+        "typescript": "^5.9.3"
     }
 }