@gapcm/cli 1.0.4

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Gapcm
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,72 @@
+# @gapcm/cli
+
+[![npm version](https://img.shields.io/npm/v/@gapcm/cli.svg)](https://www.npmjs.com/package/@gapcm/cli)
+[![GitHub repo](https://img.shields.io/badge/GitHub-nam--rgba%2Fgapcm-181717?logo=github)](https://github.com/nam-rgba/gapcm.git)
+
+`@gapcm/cli` is the public CLI package for the GAPCM ecosystem. It is the starting point for a larger full-stack framework that aims to support both backend and frontend development from one shared toolchain.
+
+It starts with CLI-based scaffolding for API modules, and is designed to grow into a broader ecosystem that can later include UI generation, shared patterns, and framework-level tooling for both BE and FE.
+
+Repository: [nam-rgba/gapcm](https://github.com/nam-rgba/gapcm.git)
+
+## What it does today
+
+- Generates backend module files from EJS templates.
+- Keeps entity, repository, service, controller, and route names aligned with the module name.
+- Exposes a single CLI entry point: `gapcm`.
+
+## Install
+
+```powershell
+npm install -g @gapcm/cli
+```
+
+## Usage
+
+Generate a module:
+
+```powershell
+gapcm add sample
+```
+
+Short alias:
+
+```powershell
+gapcm g sample
+```
+
+Run the command from your target project folder so files are created in the correct app structure.
+
+## Generated files
+
+For a module named `sample`, the CLI creates:
+
+- `src/entities/sample.entity.ts`
+- `src/repository/sample.repository.ts`
+- `src/services/sample.service.ts`
+- `src/controllers/sample.controller.ts`
+- `src/routes/sample.admin.ts`
+
+## Example
+
+```powershell
+cd app/api
+gapcm add user-profile
+```
+
+This generates `UserProfile`-based class names and `userProfile`-based file names.
+
+## Roadmap
+
+`gapcm` is intended to evolve beyond API scaffolding into a broader framework that can support:
+
+- shared backend conventions
+- frontend scaffolding and UI generation
+- reusable patterns across the full stack
+- tooling that keeps BE and FE development aligned
+
+## Notes
+
+- The package publishes `dist` and `templates`.
+- The CLI entry point is `gapcm`.
+- The package is published publicly on npm.

package/dist/index.d.mts

@@ -0,0 +1 @@
+#!/usr/bin/env node

package/dist/index.d.ts

@@ -0,0 +1 @@
+#!/usr/bin/env node

package/dist/index.js

@@ -0,0 +1,56 @@
+#!/usr/bin/env node
+"use strict";
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+
+// src/index.ts
+var import_commander = require("commander");
+var import_fs_extra = __toESM(require("fs-extra"));
+var import_path = __toESM(require("path"));
+var import_ejs = __toESM(require("ejs"));
+var import_change_case = require("change-case");
+var program = new import_commander.Command();
+program.name("gapcm").description("GAPCM resource generator");
+program.command("add <name>").alias("g").description("Generate resource").action(async (name) => {
+  const moduleName = name;
+  const pascalName = (0, import_change_case.pascalCase)(name);
+  const camelName = (0, import_change_case.camelCase)(name);
+  const templates = [
+    { name: "entity", path: "entity.template.ejs", outputDir: "src/entities", outputExt: ".entity.ts" },
+    { name: "repository", path: "repository.template.ejs", outputDir: "src/repository", outputExt: ".repository.ts" },
+    { name: "service", path: "service.template.ejs", outputDir: "src/services", outputExt: ".service.ts" },
+    { name: "controller", path: "controller.template.ejs", outputDir: "src/controllers", outputExt: ".controller.ts" },
+    { name: "route", path: "route.template.ejs", outputDir: "src/routes", outputExt: ".admin.ts" }
+  ];
+  for (const temp of templates) {
+    const templateContent = await import_fs_extra.default.readFile(
+      import_path.default.join(__dirname, `../templates/${temp.path}`),
+      "utf-8"
+    );
+    const rendered = import_ejs.default.render(templateContent, { moduleName, pascalName, camelName });
+    const outputPath = import_path.default.join(process.cwd(), `${temp.outputDir}/${camelName}${temp.outputExt}`);
+    await import_fs_extra.default.outputFile(outputPath, rendered);
+    console.log(`Generated: ${outputPath}`);
+  }
+});
+program.parse(process.argv);

package/dist/index.mjs

@@ -0,0 +1,33 @@
+#!/usr/bin/env node
+
+// src/index.ts
+import { Command } from "commander";
+import fs from "fs-extra";
+import path from "path";
+import ejs from "ejs";
+import { pascalCase, camelCase } from "change-case";
+var program = new Command();
+program.name("gapcm").description("GAPCM resource generator");
+program.command("add <name>").alias("g").description("Generate resource").action(async (name) => {
+  const moduleName = name;
+  const pascalName = pascalCase(name);
+  const camelName = camelCase(name);
+  const templates = [
+    { name: "entity", path: "entity.template.ejs", outputDir: "src/entities", outputExt: ".entity.ts" },
+    { name: "repository", path: "repository.template.ejs", outputDir: "src/repository", outputExt: ".repository.ts" },
+    { name: "service", path: "service.template.ejs", outputDir: "src/services", outputExt: ".service.ts" },
+    { name: "controller", path: "controller.template.ejs", outputDir: "src/controllers", outputExt: ".controller.ts" },
+    { name: "route", path: "route.template.ejs", outputDir: "src/routes", outputExt: ".admin.ts" }
+  ];
+  for (const temp of templates) {
+    const templateContent = await fs.readFile(
+      path.join(__dirname, `../templates/${temp.path}`),
+      "utf-8"
+    );
+    const rendered = ejs.render(templateContent, { moduleName, pascalName, camelName });
+    const outputPath = path.join(process.cwd(), `${temp.outputDir}/${camelName}${temp.outputExt}`);
+    await fs.outputFile(outputPath, rendered);
+    console.log(`Generated: ${outputPath}`);
+  }
+});
+program.parse(process.argv);

package/package.json

@@ -0,0 +1,46 @@
+{
+  "name": "@gapcm/cli",
+  "version": "1.0.4",
+  "description": "CLI scaffolder for building a larger full-stack framework across backend and frontend apps.",
+  "main": "./dist/index.js",
+  "module": "./dist/index.mjs",
+  "types": "./dist/index.d.ts",
+  "files": [
+    "dist",
+    "templates"
+  ],
+  "bin": {
+    "gapcm": "./dist/index.js"
+  },
+  "scripts": {
+    "build": "tsup src/index.ts --format cjs,esm --dts",
+    "dev": "tsup src/index.ts --format cjs,esm --watch --dts"
+  },
+  "devDependencies": {
+    "@types/ejs": "^3.1.5",
+    "@types/fs-extra": "^11.0.4",
+    "tsup": "^8.0.0",
+    "typescript": "^5.0.0"
+  },
+  "keywords": [
+    "cli",
+    "generator",
+    "scaffold",
+    "framework",
+    "fullstack",
+    "backend",
+    "frontend",
+    "typescript",
+    "ejs"
+  ],
+  "dependencies": {
+    "chalk": "^5.6.2",
+    "change-case": "^5.4.4",
+    "commander": "^15.0.0",
+    "ejs": "^6.0.1",
+    "fs-extra": "^11.3.5",
+    "ora": "^9.4.1",
+    "prompts": "^2.4.2",
+    "ts-morph": "^28.0.0"
+  }
+}

package/templates/controller.template.ejs

@@ -0,0 +1,66 @@
+<%
+const inputModuleName = typeof moduleName === "string" && moduleName.trim().length > 0
+  ? moduleName.trim()
+  : "sample"
+const words = inputModuleName
+  .replace(/([a-z0-9])([A-Z])/g, "$1 $2")
+  .split(/[-_\s]+/)
+  .filter(Boolean)
+const pascalName = words.map((w) => w.charAt(0).toUpperCase() + w.slice(1).toLowerCase()).join("")
+const camelName = pascalName.charAt(0).toLowerCase() + pascalName.slice(1)
+const pluralName = `${camelName}s`
+const kebabName = words.map((w) => w.toLowerCase()).join("-")
+%>
+
+import { NextFunction, Request, Response } from "express";
+import <%= camelName %>Service from "~/services/<%= kebabName %>.service.js";
+import { CreatedResponse, OKResponse } from "~/utils/success.res.js";
+
+class <%= pascalName %>Controller {
+
+	getAll = async(req: Request, res: Response, next: NextFunction) => {
+		return new OKResponse(
+			"Get <%= pluralName %> successfully!",
+			200,
+			await <%= camelName %>Service.getAll(req.query)
+		)
+	}
+
+	getById = async(req: Request, res: Response, next: NextFunction) => {
+		const id = Number(req.params.id)
+		return new OKResponse(
+			"Get <%= camelName %> successfully!",
+			200,
+			await <%= camelName %>Service.getById(id)
+		)
+	}
+
+	create = async(req: Request, res: Response, next: NextFunction) => {
+		return new CreatedResponse(
+			"Create <%= camelName %> successfully!",
+			201,
+			await <%= camelName %>Service.create(req.body)
+		)
+	}
+
+	update = async(req: Request, res: Response, next: NextFunction) => {
+		const id = Number(req.params.id)
+		return new OKResponse(
+			"Update <%= camelName %> successfully!",
+			200,
+			await <%= camelName %>Service.update(id, req.body)
+		)
+	}
+
+	delete = async(req: Request, res: Response, next: NextFunction) => {
+		const id = Number(req.params.id)
+		return new OKResponse(
+			"Delete <%= camelName %> successfully!",
+			200,
+			await <%= camelName %>Service.delete(id)
+		)
+	}
+}
+
+const <%= camelName %>Controller = new <%= pascalName %>Controller();
+export default <%= camelName %>Controller;

package/templates/entity.template.ejs

@@ -0,0 +1,52 @@
+<%
+const inputModuleName = typeof moduleName === 'string' && moduleName.trim().length > 0
+  ? moduleName.trim()
+  : 'Sample'
+const normalized = inputModuleName.replace(/[-_\s]+(.)?/g, (_, c) => (c ? c.toUpperCase() : ''))
+const entityName = normalized.charAt(0).toUpperCase() + normalized.slice(1)
+const entityNameLower = entityName.charAt(0).toLowerCase() + entityName.slice(1)
+%>
+
+import { Column, Entity, PrimaryGeneratedColumn } from 'typeorm'
+import z from 'zod'
+
+@Entity()
+export class <%= entityName %> {
+  @PrimaryGeneratedColumn()
+  id!: number
+
+  @Column({
+    nullable: false
+  })
+  name!: string
+
+  @Column()
+  image?: string
+
+  @Column({
+    unique: true,
+    nullable: false
+  })
+  description!: string
+
+  @Column({
+    type: 'boolean',
+    default: true
+  })
+  isVerify: boolean = true
+}
+
+export const <%= entityName %>Query = z.object({
+  page: z.number().int().min(1).default(1),
+  limit: z.number().int().min(1).max(100).default(10),
+  search: z.string().optional(),
+})
+
+export const <%= entityName %>CreateSchema = z.object({
+  name: z.string().min(1, { message: 'Name is required' }),
+  description: z.string().min(1, { message: 'Description is required' }),
+})
+
+export const <%= entityName %>ParamsSchema = z.object({
+  id: z.number().int().min(1, { message: 'Invalid <%= entityNameLower %> ID' }),
+})

package/templates/repository.template.ejs

@@ -0,0 +1,58 @@
+<%
+const inputModuleName = typeof moduleName === "string" && moduleName.trim().length > 0
+  ? moduleName.trim()
+  : "sample"
+const words = inputModuleName
+  .replace(/([a-z0-9])([A-Z])/g, "$1 $2")
+  .split(/[-_\s]+/)
+  .filter(Boolean)
+const pascalName = words.map((w) => w.charAt(0).toUpperCase() + w.slice(1).toLowerCase()).join("")
+const camelName = pascalName.charAt(0).toLowerCase() + pascalName.slice(1)
+const kebabName = words.map((w) => w.toLowerCase()).join("-")
+const pluralName = `${camelName}s`
+%>
+
+import { DataSource, Repository } from "typeorm";
+import z from "zod";
+import { <%= pascalName %>, <%= pascalName %>Query } from "~/entities/<%= kebabName %>.entity.js";
+
+export class <%= pascalName %>Repository {
+	constructor(appDataSource: DataSource) {
+		this.repo = appDataSource.getRepository(<%= pascalName %>)
+	}
+
+	private repo: Repository<<%= pascalName %>>;
+
+	// find all <%= pluralName %> ==============================================
+	public findAll = async(query: z.infer<typeof <%= pascalName %>Query>) => {
+		const { page, limit, search } = query;
+		const [<%= pluralName %>, total] = await this.repo.findAndCount({
+			where: search ? { name: z.string().regex(new RegExp(search, "i")).parse(search) } as any : {},
+			skip: (page - 1) * limit,
+			take: limit,
+		});
+		return { <%= pluralName %>, total };
+	}
+
+	// find <%= camelName %> by id ==============================================
+	public findById = async(id: number) => {
+		return await this.repo.findOneBy({ id });
+	}
+
+	// create new <%= camelName %> ==============================================
+	public create = async(entity: Partial<<%= pascalName %>>) => {
+		const newEntity = this.repo.create(entity);
+		return await this.repo.save(newEntity);
+	}
+
+	// update <%= camelName %> by id ==============================================
+	public update = async(id: number, entity: Partial<<%= pascalName %>>) => {
+		await this.repo.update(id, entity);
+		return await this.repo.findOneBy({ id });
+	}
+
+	// delete <%= camelName %> by id ==============================================
+	public delete = async(id: number) => {
+		return await this.repo.delete(id);
+	}
+}

package/templates/route.template.ejs

@@ -0,0 +1,47 @@
+<%
+const inputModuleName = typeof moduleName === "string" && moduleName.trim().length > 0
+  ? moduleName.trim()
+  : "sample"
+const words = inputModuleName
+  .replace(/([a-z0-9])([A-Z])/g, "$1 $2")
+  .split(/[-_\s]+/)
+  .filter(Boolean)
+const pascalName = words.map((w) => w.charAt(0).toUpperCase() + w.slice(1).toLowerCase()).join("")
+const kebabName = words.map((w) => w.toLowerCase()).join("-")
+const camelName = pascalName.charAt(0).toLowerCase() + pascalName.slice(1)
+%>
+
+import { Router } from "express";
+import <%= camelName %>Controller from "~/controllers/<%= kebabName %>.controller.js";
+import {
+	<%= pascalName %>CreateSchema,
+	<%= pascalName %>ParamsSchema,
+	<%= pascalName %>Query,
+} from "~/entities/<%= kebabName %>.entity.js";
+import { validate } from "~/middlewares/validate.js";
+import AsyncHandler from "~/utils/async-handler.js";
+
+const router = Router();
+
+router.get("/", validate({
+	query: <%= pascalName %>Query
+}), AsyncHandler(<%= camelName %>Controller.getAll));
+
+router.get("/:id", validate({
+	params: <%= pascalName %>ParamsSchema
+}), AsyncHandler(<%= camelName %>Controller.getById));
+
+router.post("/", validate({
+	body: <%= pascalName %>CreateSchema
+}), AsyncHandler(<%= camelName %>Controller.create));
+
+router.put("/:id", validate({
+	params: <%= pascalName %>ParamsSchema,
+	body: <%= pascalName %>CreateSchema
+}), AsyncHandler(<%= camelName %>Controller.update));
+
+router.delete("/:id", validate({
+	params: <%= pascalName %>ParamsSchema
+}), AsyncHandler(<%= camelName %>Controller.delete));
+
+export default router;

package/templates/service.template.ejs

@@ -0,0 +1,52 @@
+<%
+const inputModuleName = typeof moduleName === "string" && moduleName.trim().length > 0
+  ? moduleName.trim()
+  : "sample"
+const words = inputModuleName
+  .replace(/([a-z0-9])([A-Z])/g, "$1 $2")
+  .split(/[-_\s]+/)
+  .filter(Boolean)
+const pascalName = words.map((w) => w.charAt(0).toUpperCase() + w.slice(1).toLowerCase()).join("")
+const camelName = pascalName.charAt(0).toLowerCase() + pascalName.slice(1)
+const kebabName = words.map((w) => w.toLowerCase()).join("-")
+%>
+
+import { pick } from "lodash";
+import { AppDataSource } from "~/data-source.js";
+import { <%= pascalName %>Repository } from "~/repository/<%= kebabName %>.repository.js";
+
+export class <%= pascalName %>Service {
+
+	constructor(repo: <%= pascalName %>Repository) {
+		this.repo = repo;
+	}
+
+	private repo: <%= pascalName %>Repository;
+
+	public getAll = async(query: any) => {
+		return await this.repo.findAll(query)
+	}
+
+	public getById = async(id: number) => {
+		const entity = await this.repo.findById(id)
+		if (!entity) throw new Error(`<%= pascalName %> with id ${id} not found`)
+		return entity ? pick(entity, ["id", "name", "description", "isVerify"]) : null
+	}
+
+	public create = async(payload: any) => {
+		return await this.repo.create(payload)
+	}
+
+	public update = async(id: number, payload: any) => {
+		return await this.repo.update(id, payload)
+	}
+
+	public delete = async(id: number) => {
+		return await this.repo.delete(id)
+	}
+}
+
+const <%= camelName %>Repo = new <%= pascalName %>Repository(AppDataSource);
+const <%= camelName %>Service = new <%= pascalName %>Service(<%= camelName %>Repo);
+
+export default <%= camelName %>Service;