deploy-bbc 1.1.0 → 1.2.1

package/cli/src/templates/base/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/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/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/templates/base-bun-native/.env.example

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

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

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

package/cli/src/templates/base-bun-native/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-bun-native/src/controllers/user/create-user.controller.ts

@@ -0,0 +1,76 @@
+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): Promise<Response> {
+  try {
+    const body = await req.json();
+
+    // Validate request body
+    const validation = create_user_schema.safeParse(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 Response.json(errorResponse, { status: 400 });
+    }
+
+    // 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 Response.json(errorResponse, { status: 409 });
+    }
+
+    // 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",
+    };
+
+    return Response.json(response, { status: 201 });
+  } catch (error) {
+    const errorResponse: ApiError = {
+      success: false,
+      error: "Failed to create user",
+    };
+    return Response.json(errorResponse, { status: 500 });
+  }
+}

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

@@ -0,0 +1,53 @@
+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(id: string): Promise<Response> {
+  try {
+    // 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 Response.json(errorResponse, { status: 400 });
+    }
+
+    const deleted = await user_model.delete(id);
+
+    if (!deleted) {
+      const errorResponse: ApiError = {
+        success: false,
+        error: "User not found",
+      };
+      return Response.json(errorResponse, { status: 404 });
+    }
+
+    const response: ApiResponse = {
+      success: true,
+      message: "User deleted successfully",
+    };
+
+    return Response.json(response);
+  } catch (error) {
+    const errorResponse: ApiError = {
+      success: false,
+      error: "Failed to delete user",
+    };
+    return Response.json(errorResponse, { status: 500 });
+  }
+}

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

@@ -0,0 +1,67 @@
+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(id: string): Promise<Response> {
+  try {
+    // 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 Response.json(errorResponse, { status: 400 });
+    }
+
+    const user = await user_model.find_by_id(id);
+
+    if (!user) {
+      const errorResponse: ApiError = {
+        success: false,
+        error: "User not found",
+      };
+      return Response.json(errorResponse, { status: 404 });
+    }
+
+    const response: ApiResponse<UserResponse> = {
+      success: true,
+      data: format_user_response(user),
+    };
+
+    return Response.json(response);
+  } catch (error) {
+    const errorResponse: ApiError = {
+      success: false,
+      error: "Failed to fetch user",
+    };
+    return Response.json(errorResponse, { status: 500 });
+  }
+}

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

@@ -0,0 +1,40 @@
+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(): Promise<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,
+    };
+
+    return Response.json(response);
+  } catch (error) {
+    const errorResponse: ApiError = {
+      success: false,
+      error: "Failed to fetch users",
+    };
+    return Response.json(errorResponse, { status: 500 });
+  }
+}

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

@@ -0,0 +1,101 @@
+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(id: string, req: Request): Promise<Response> {
+  try {
+    const body = await req.json();
+
+    // 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 Response.json(errorResponse, { status: 400 });
+    }
+
+    // Validate request body
+    const body_validation = update_user_schema.safeParse(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 Response.json(errorResponse, { status: 400 });
+    }
+
+    // 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 Response.json(errorResponse, { status: 409 });
+      }
+    }
+
+    // Update user
+    const user = await user_model.update(id, body_validation.data);
+
+    if (!user) {
+      const errorResponse: ApiError = {
+        success: false,
+        error: "User not found",
+      };
+      return Response.json(errorResponse, { status: 404 });
+    }
+
+    const response: ApiResponse<UserResponse> = {
+      success: true,
+      data: format_user_response(user),
+      message: "User updated successfully",
+    };
+
+    return Response.json(response);
+  } catch (error) {
+    const errorResponse: ApiError = {
+      success: false,
+      error: "Failed to update user",
+    };
+    return Response.json(errorResponse, { status: 500 });
+  }
+}

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

@@ -6,8 +6,8 @@ import { router } from "./routes/index.js";
 /**
  * Simple router matcher for Bun native server
  */
-function match_route(pathname: string, method: string): Response | null {
-  return router(pathname, method);
+async function match_route(pathname: string, method: string, req: Request): Promise<Response | null> {
+  return await router(pathname, method, req);
 }
 
 const server = Bun.serve({
@@ -28,7 +28,7 @@ const server = Bun.serve({
       }
 
       // Match routes
-      const response = match_route(url.pathname, req.method);
+      const response = await match_route(url.pathname, req.method, req);
       if (response) {
         logger(req, response, Date.now() - start);
         return response;

package/cli/src/templates/base-bun-native/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-bun-native/src/routes/index.ts

@@ -1,8 +1,10 @@
+import { user_route } from "./user.route.js";
+
 /**
  * Simple router for Bun native server
  * Add your routes here
  */
-export function router(pathname: string, method: string): Response | null {
+export async function router(pathname: string, method: string, req: Request): Promise<Response | null> {
   // GET /
   if (pathname === "/" && method === "GET") {
     return Response.json({
@@ -11,11 +13,13 @@ export function router(pathname: string, method: string): Response | null {
     });
   }
 
-  // Add more routes here
-  // Example:
-  // if (pathname === "/users" && method === "GET") {
-  //   return Response.json({ users: [] });
-  // }
+  // User routes
+  if (pathname.startsWith("/users")) {
+    const response = await user_route(pathname, method, req);
+    if (response) {
+      return response;
+    }
+  }
 
   return null; // No route matched
 }

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

@@ -0,0 +1,50 @@
+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";
+
+/**
+ * Helper to extract ID from path
+ */
+function extract_id_from_path(pathname: string): string | null {
+  const match = pathname.match(/^\/users\/([^/]+)$/);
+  return match ? match[1] : null;
+}
+
+/**
+ * User route handler
+ * Handles all /users routes
+ */
+export async function user_route(pathname: string, method: string, req: Request): Promise<Response | null> {
+  // GET /users
+  if (pathname === "/users" && method === "GET") {
+    return await get_users();
+  }
+
+  // POST /users
+  if (pathname === "/users" && method === "POST") {
+    return await create_user(req);
+  }
+
+  // Routes with ID parameter
+  const id = extract_id_from_path(pathname);
+  if (id) {
+    // GET /users/:id
+    if (method === "GET") {
+      return await get_user(id);
+    }
+
+    // PATCH /users/:id
+    if (method === "PATCH") {
+      return await update_user(id, req);
+    }
+
+    // DELETE /users/:id
+    if (method === "DELETE") {
+      return await delete_user(id);
+    }
+  }
+
+  return null;
+}

package/cli/src/templates/base-bun-native/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-bun-native/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-bun-native/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/templates/base-express/.env.example

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