create-charcole 2.0.4 → 2.2.0

package/template/ts/basePackage.json

@@ -1,32 +1,36 @@
 {
   "name": "charcole",
-  "version": "2.0.4",
+  "version": "2.2.0",
   "description": "Production-grade Node.js Express API",
-  "main": "src/server.js",
+  "main": "dist/server.js",
+  "type": "module",
   "scripts": {
-    "start": "node src/server.js",
-    "dev": "nodemon src/server.js",
-    "lint": "echo 'Add linting here'",
-    "test": "echo 'Add tests here'"
+    "start": "node dist/server.js",
+    "dev": "tsx watch src/server.ts",
+    "build": "node build.js",
+    "clean": "rimraf dist",
+    "prebuild": "npm run clean",
+    "lint": "echo \"Add linting here\"",
+    "test": "echo \"Add tests here\""
   },
   "engines": {
     "node": ">=18.0.0"
   },
-  "keywords": [],
-  "author": "",
-  "license": "ISC",
-  "type": "module",
   "dependencies": {
+    "express": "^4.18.2",
     "cors": "^2.8.5",
     "dotenv": "^16.3.1",
-    "express": "^4.18.2",
-    "zod": "^3.22.4"
+    "zod": "^3.25.76"
   },
   "devDependencies": {
+    "@types/cors": "^2.8.19",
     "@types/express": "^4.17.21",
     "@types/node": "^25.0.10",
-    "nodemon": "^3.0.2",
-    "ts-node-dev": "^2.0.0",
+    "esbuild": "^0.24.2",
+    "rimraf": "^6.0.1",
+    "tsc-alias": "^1.8.8",
+    "tsx": "^4.19.2",
     "typescript": "^5.9.3"
-  }
+  },
+  "license": "ISC"
 }

package/template/ts/build.js

@@ -0,0 +1,46 @@
+import { build } from "esbuild";
+import { glob } from "glob";
+import fs from "fs";
+import path from "path";
+
+const entryPoints = await glob("src/**/*.ts");
+
+// Custom plugin to rewrite .ts imports to .js
+const rewriteImportsPlugin = {
+  name: "rewrite-imports",
+  setup(build) {
+    build.onLoad({ filter: /\.ts$/ }, async (args) => {
+      const contents = await fs.promises.readFile(args.path, "utf8");
+
+      // Replace .ts extensions with .js in imports
+      const modifiedContents = contents
+        .replace(/from\s+['"]([^'"]+)\.ts['"]/g, 'from "$1.js"')
+        .replace(/import\s+['"]([^'"]+)\.ts['"]/g, 'import "$1.js"');
+
+      return {
+        contents: modifiedContents,
+        loader: "ts",
+      };
+    });
+  },
+};
+
+await build({
+  entryPoints,
+  outdir: "dist",
+  bundle: false,
+  platform: "node",
+  format: "esm",
+  target: "es2020",
+  sourcemap: true,
+  outExtension: { ".js": ".js" },
+  packages: "external",
+  plugins: [rewriteImportsPlugin],
+})
+  .then(() => {
+    console.log("✅ Build completed successfully!");
+  })
+  .catch((error) => {
+    console.error("❌ Build failed:", error);
+    process.exit(1);
+  });

package/template/ts/src/app.ts

@@ -1,16 +1,18 @@
 import express, { Request, Response, NextFunction } from "express";
 import cors from "cors";
-
-import { env } from "./config/env.js";
-import { requestLogger } from "./middlewares/requestLogger.js";
+import { userRepo } from "./repositories/user.repo.ts";
+import { env } from "./config/env.ts";
+import { requestLogger } from "./middlewares/requestLogger.ts";
 import {
   errorHandler,
   asyncHandler,
   NotFoundError,
-} from "./middlewares/errorHandler.js";
-import { sendSuccess } from "./utils/response.js";
-import { logger } from "./utils/logger.js";
-import routes from "./routes.js";
+} from "./middlewares/errorHandler.ts";
+import { sendSuccess } from "./utils/response.ts";
+import { logger } from "./utils/logger.ts";
+import routes from "./routes/index.ts";
+import swaggerOptions from "./config/swagger.config.ts";
+import { setupSwagger } from "@charcoles/swagger";
 
 export const app = express();
 
@@ -36,6 +38,8 @@ app.use((req: Request, res: Response, next: NextFunction) => {
 
 app.use(requestLogger);
 
+setupSwagger(app, swaggerOptions);
+
 app.use("/api", routes);
 
 app.get(
@@ -64,3 +68,4 @@ app.use((req: Request) => {
 app.use(errorHandler);
 
 logger.info("Express app configured successfully");
+app.locals.userRepo = userRepo;

package/template/ts/src/config/swagger.config.ts

@@ -0,0 +1,30 @@
+import { registerSchema, loginSchema } from "../modules/auth/auth.schemas.ts";
+import { createItemSchema } from "../modules/health/controller.ts";
+
+const swaggerConfig = {
+  title: process.env.APP_NAME || "Charcole API",
+  version: process.env.APP_VERSION || "1.0.0",
+  description: "Production-ready Node.js Express API",
+  path: "/api-docs",
+  servers: [
+    {
+      url: process.env.APP_URL || "http://localhost:3000",
+      description:
+        process.env.NODE_ENV === "production"
+          ? "Production server"
+          : "Development server",
+    },
+  ],
+  // NEW: Auto-register Zod schemas - no more manual duplication!
+  schemas: {
+    registerSchema,
+    loginSchema,
+    createItemSchema,
+  },
+  // Common response templates are included by default
+  includeCommonResponses: true,
+};
+
+export type SwaggerConfig = typeof swaggerConfig;
+
+export default swaggerConfig;