create-charcole 1.0.0

package/template/src/utils/logger.js

@@ -0,0 +1,73 @@
+import { env } from "../config/env.js";
+
+const COLORS = {
+  reset: "\x1b[0m",
+  red: "\x1b[31m",
+  yellow: "\x1b[33m",
+  green: "\x1b[32m",
+  blue: "\x1b[36m",
+  gray: "\x1b[90m",
+  magenta: "\x1b[35m",
+};
+
+const LOG_LEVELS = {
+  debug: 0,
+  info: 1,
+  warn: 2,
+  error: 3,
+};
+
+const getCurrentLogLevel = () => LOG_LEVELS[env.LOG_LEVEL] || LOG_LEVELS.info;
+
+const formatLog = (level, message, data) => {
+  const timestamp = new Date().toISOString();
+  const dataStr = data ? ` ${JSON.stringify(data)}` : "";
+  return `[${timestamp}] ${level}:${dataStr ? " " + message + dataStr : " " + message}`;
+};
+
+const formatStack = (stack) => {
+  if (!stack) return "";
+  return `\n${stack}`;
+};
+
+export const logger = {
+  debug: (message, data) => {
+    if (getCurrentLogLevel() <= LOG_LEVELS.debug) {
+      console.log(
+        `${COLORS.gray}${formatLog("DEBUG", message, data)}${COLORS.reset}`,
+      );
+    }
+  },
+
+  info: (message, data) => {
+    if (getCurrentLogLevel() <= LOG_LEVELS.info) {
+      console.log(
+        `${COLORS.blue}${formatLog("INFO", message, data)}${COLORS.reset}`,
+      );
+    }
+  },
+
+  warn: (message, data) => {
+    if (getCurrentLogLevel() <= LOG_LEVELS.warn) {
+      console.warn(
+        `${COLORS.yellow}${formatLog("WARN", message, data)}${COLORS.reset}`,
+      );
+    }
+  },
+
+  error: (message, data, stack) => {
+    if (getCurrentLogLevel() <= LOG_LEVELS.error) {
+      const stackTrace = formatStack(stack);
+      console.error(
+        `${COLORS.red}${formatLog("ERROR", message, data)}${stackTrace}${COLORS.reset}`,
+      );
+    }
+  },
+
+  fatal: (message, data, stack) => {
+    const stackTrace = formatStack(stack);
+    console.error(
+      `${COLORS.red}${COLORS.magenta}${formatLog("FATAL", message, data)}${stackTrace}${COLORS.reset}`,
+    );
+  },
+};

package/template/src/utils/response.js

@@ -0,0 +1,51 @@
+/**
+ * Send success response
+ *
+ * @param {Response} res - Express response object
+ * @param {*} data - Response data
+ * @param {number} statusCode - HTTP status code (default: 200)
+ * @param {string} message - Success message (default: 'Success')
+ */
+export const sendSuccess = (
+  res,
+  data,
+  statusCode = 200,
+  message = "Success",
+) => {
+  return res.status(statusCode).json({
+    success: true,
+    message,
+    data,
+    timestamp: new Date().toISOString(),
+  });
+};
+
+/**
+ * Send error response (DEPRECATED - use AppError instead)
+ * This is kept for backward compatibility
+ */
+export const sendError = (res, message, statusCode = 500, errors = null) => {
+  return res.status(statusCode).json({
+    success: false,
+    message,
+    ...(errors && { errors }),
+    timestamp: new Date().toISOString(),
+  });
+};
+
+/**
+ * Send validation error response (DEPRECATED - use ValidationError instead)
+ * This is kept for backward compatibility
+ */
+export const sendValidationError = (res, errors, statusCode = 422) => {
+  return res.status(statusCode).json({
+    success: false,
+    message: "Validation failed",
+    errors: errors.map((err) => ({
+      field: err.path.join("."),
+      message: err.message,
+      code: err.code,
+    })),
+    timestamp: new Date().toISOString(),
+  });
+};

package/template/test-api.js

@@ -0,0 +1,100 @@
+#!/usr/bin/env node
+
+import http from "http";
+
+const tests = [
+  {
+    name: "Test 1: GET / (root)",
+    method: "GET",
+    path: "/",
+    body: null,
+  },
+  {
+    name: "Test 2: GET /api/health",
+    method: "GET",
+    path: "/api/health",
+    body: null,
+  },
+  {
+    name: "Test 3: POST /api/items (valid)",
+    method: "POST",
+    path: "/api/items",
+    body: JSON.stringify({ name: "Test Item", description: "A test item" }),
+  },
+  {
+    name: "Test 4: POST /api/items (invalid - missing name)",
+    method: "POST",
+    path: "/api/items",
+    body: JSON.stringify({ description: "No name" }),
+  },
+  {
+    name: "Test 5: GET /api/nonexistent (404)",
+    method: "GET",
+    path: "/api/nonexistent",
+    body: null,
+  },
+];
+
+const runTest = (test) => {
+  return new Promise((resolve) => {
+    const options = {
+      hostname: "localhost",
+      port: 3000,
+      path: test.path,
+      method: test.method,
+      headers: {
+        "Content-Type": "application/json",
+      },
+    };
+
+    const req = http.request(options, (res) => {
+      let data = "";
+
+      res.on("data", (chunk) => {
+        data += chunk;
+      });
+
+      res.on("end", () => {
+        try {
+          const json = JSON.parse(data);
+          console.log(`\n✅ ${test.name}`);
+          console.log(`   Status: ${res.statusCode}`);
+          console.log(`   Response:`, JSON.stringify(json, null, 2));
+        } catch (error) {
+          console.log(`\n✅ ${test.name}`);
+          console.log(`   Status: ${res.statusCode}`);
+          console.log(`   Response:`, data);
+        }
+        resolve();
+      });
+    });
+
+    req.on("error", (error) => {
+      console.error(`\n❌ ${test.name}`);
+      console.error(`   Error: ${error.message}`);
+      resolve();
+    });
+
+    if (test.body) {
+      req.write(test.body);
+    }
+    req.end();
+  });
+};
+
+const runTests = async () => {
+  console.log("🚀 Testing Charcole API Error Handling\n");
+  console.log("=".repeat(60));
+
+  for (const test of tests) {
+    await runTest(test);
+    await new Promise((r) => setTimeout(r, 200));
+  }
+
+  console.log("\n" + "=".repeat(60));
+  console.log("\n✅ All tests completed!");
+  process.exit(0);
+};
+
+// Wait for server to be ready
+setTimeout(runTests, 1000);