@forinda/kickjs-cli 0.6.0 → 1.0.0

package/dist/index.d.ts

@@ -51,12 +51,14 @@ interface GenerateDtoOptions {
 }
 declare function generateDto(options: GenerateDtoOptions): Promise<string[]>;
 
+type ProjectTemplate = 'rest' | 'graphql' | 'ddd' | 'microservice' | 'minimal';
 interface InitProjectOptions {
     name: string;
     directory: string;
     packageManager?: 'pnpm' | 'npm' | 'yarn';
     initGit?: boolean;
     installDeps?: boolean;
+    template?: ProjectTemplate;
 }
 /** Scaffold a new KickJS project */
 declare function initProject(options: InitProjectOptions): Promise<void>;
@@ -79,14 +81,42 @@ interface KickCommandDefinition {
     /** Optional aliases (e.g. ['migrate'] for 'db:migrate') */
     aliases?: string[];
 }
+/** Project pattern — controls what generators produce and which deps are installed */
+type ProjectPattern = 'rest' | 'graphql' | 'ddd' | 'microservice' | 'minimal';
 /** Configuration for the kick.config.ts file */
 interface KickConfig {
+    /**
+     * Project pattern — controls default generator behavior.
+     * - 'rest' — Express + Swagger (default)
+     * - 'graphql' — GraphQL + GraphiQL
+     * - 'ddd' — Full DDD modules with use cases, entities, value objects
+     * - 'microservice' — REST + queue workers
+     * - 'minimal' — Bare Express with no scaffolding
+     */
+    pattern?: ProjectPattern;
     /** Where modules live (default: 'src/modules') */
     modulesDir?: string;
     /** Default repository implementation for generators */
     defaultRepo?: 'drizzle' | 'inmemory' | 'prisma';
     /** Drizzle schema output directory */
     schemaDir?: string;
+    /**
+     * Directories to copy to dist/ after build.
+     * Useful for EJS templates, email templates, static assets, etc.
+     *
+     * @example
+     * ```ts
+     * copyDirs: [
+     *   'src/views',                          // copies to dist/src/views
+     *   { src: 'src/views', dest: 'dist/views' }, // custom dest
+     *   'src/emails',
+     * ]
+     * ```
+     */
+    copyDirs?: Array<string | {
+        src: string;
+        dest?: string;
+    }>;
     /** Custom commands that extend the CLI */
     commands?: KickCommandDefinition[];
     /** Code style overrides (auto-detected from prettier when possible) */

package/dist/index.js

@@ -1043,17 +1043,46 @@ export type ${pascal}DTO = z.infer<typeof ${camel}Schema>
 __name(generateDto, "generateDto");
 
 // src/generators/project.ts
-import { join as join8 } from "path";
+import { join as join8, dirname as dirname2 } from "path";
 import { execSync } from "child_process";
+import { readFileSync } from "fs";
+import { fileURLToPath } from "url";
+var __dirname = dirname2(fileURLToPath(import.meta.url));
+var cliPkg = JSON.parse(readFileSync(join8(__dirname, "..", "package.json"), "utf-8"));
+var KICKJS_VERSION = `^${cliPkg.version}`;
 async function initProject(options) {
-  const { name, directory, packageManager = "pnpm" } = options;
+  const { name, directory, packageManager = "pnpm", template = "rest" } = options;
   const dir = directory;
   console.log(`
   Creating KickJS project: ${name}
 `);
+  const baseDeps = {
+    "@forinda/kickjs-core": KICKJS_VERSION,
+    "@forinda/kickjs-http": KICKJS_VERSION,
+    "@forinda/kickjs-config": KICKJS_VERSION,
+    express: "^5.1.0",
+    "reflect-metadata": "^0.2.2",
+    zod: "^4.3.6",
+    pino: "^10.3.1",
+    "pino-pretty": "^13.1.3"
+  };
+  if (template !== "minimal") {
+    baseDeps["@forinda/kickjs-swagger"] = KICKJS_VERSION;
+  }
+  if (template === "graphql") {
+    baseDeps["@forinda/kickjs-graphql"] = KICKJS_VERSION;
+    baseDeps["graphql"] = "^16.11.0";
+  }
+  if (template === "microservice") {
+    baseDeps["@forinda/kickjs-queue"] = KICKJS_VERSION;
+    baseDeps["@forinda/kickjs-otel"] = KICKJS_VERSION;
+  }
+  if (template === "ddd") {
+    baseDeps["@forinda/kickjs-swagger"] = KICKJS_VERSION;
+  }
   await writeFileSafe(join8(dir, "package.json"), JSON.stringify({
     name,
-    version: "0.1.0",
+    version: cliPkg.version,
     type: "module",
     scripts: {
       dev: "kick dev",
@@ -1066,19 +1095,9 @@ async function initProject(options) {
       lint: "eslint src/",
       format: "prettier --write src/"
     },
-    dependencies: {
-      "@forinda/kickjs-core": "^0.1.0",
-      "@forinda/kickjs-http": "^0.1.0",
-      "@forinda/kickjs-config": "^0.1.0",
-      "@forinda/kickjs-swagger": "^0.1.0",
-      express: "^5.1.0",
-      "reflect-metadata": "^0.2.2",
-      zod: "^4.3.6",
-      pino: "^10.3.1",
-      "pino-pretty": "^13.1.3"
-    },
+    dependencies: baseDeps,
     devDependencies: {
-      "@forinda/kickjs-cli": "^0.1.0",
+      "@forinda/kickjs-cli": KICKJS_VERSION,
       "@swc/core": "^1.7.28",
       "@types/express": "^5.0.6",
       "@types/node": "^24.5.2",
@@ -1167,27 +1186,18 @@ NODE_ENV=development
   await writeFileSafe(join8(dir, ".env.example"), `PORT=3000
 NODE_ENV=development
 `);
-  await writeFileSafe(join8(dir, "src/index.ts"), `import 'reflect-metadata'
-import { bootstrap } from '@forinda/kickjs-http'
-import { SwaggerAdapter } from '@forinda/kickjs-swagger'
-import { modules } from './modules'
-
-bootstrap({
-  modules,
-  adapters: [
-    new SwaggerAdapter({
-      info: { title: '${name}', version: '0.1.0' },
-    }),
-  ],
-})
-`);
+  await writeFileSafe(join8(dir, "src/index.ts"), getEntryFile(name, template));
   await writeFileSafe(join8(dir, "src/modules/index.ts"), `import type { AppModuleClass } from '@forinda/kickjs-core'
 
 export const modules: AppModuleClass[] = []
 `);
+  if (template === "graphql") {
+    await writeFileSafe(join8(dir, "src/resolvers/.gitkeep"), "");
+  }
   await writeFileSafe(join8(dir, "kick.config.ts"), `import { defineConfig } from '@forinda/kickjs-cli'
 
 export default defineConfig({
+  pattern: '${template}',
   modulesDir: 'src/modules',
   defaultRepo: 'inmemory',
 
@@ -1268,17 +1278,103 @@ export default defineConfig({
   console.log("  Next steps:");
   if (needsCd) console.log(`    cd ${name}`);
   if (!options.installDeps) console.log(`    ${packageManager} install`);
-  console.log("    kick g module user");
+  const genHint = {
+    rest: "kick g module user",
+    graphql: "kick g resolver user",
+    ddd: "kick g module user --repo drizzle",
+    microservice: "kick g module user && kick g job email",
+    minimal: "# add your routes to src/index.ts"
+  };
+  console.log(`    ${genHint[template] ?? genHint.rest}`);
   console.log("    kick dev");
   console.log();
   console.log("  Commands:");
   console.log("    kick dev         Start dev server with Vite HMR");
   console.log("    kick build       Production build via Vite");
   console.log("    kick start       Run production build");
-  console.log("    kick g module X  Generate a DDD module");
+  console.log(`    kick g module X  Generate a DDD module`);
+  if (template === "graphql") console.log("    kick g resolver X  Generate a GraphQL resolver");
+  if (template === "microservice") console.log("    kick g job X       Generate a queue job processor");
   console.log();
 }
 __name(initProject, "initProject");
+function getEntryFile(name, template) {
+  switch (template) {
+    case "graphql":
+      return `import 'reflect-metadata'
+import { bootstrap } from '@forinda/kickjs-http'
+import { DevToolsAdapter } from '@forinda/kickjs-http/devtools'
+import { GraphQLAdapter } from '@forinda/kickjs-graphql'
+import { modules } from './modules'
+
+// Import your resolvers here
+// import { UserResolver } from './resolvers/user.resolver'
+
+bootstrap({
+  modules,
+  adapters: [
+    new DevToolsAdapter(),
+    new GraphQLAdapter({
+      resolvers: [/* UserResolver */],
+      // Add custom type definitions here:
+      // typeDefs: userTypeDefs,
+    }),
+  ],
+})
+`;
+    case "microservice":
+      return `import 'reflect-metadata'
+import { bootstrap } from '@forinda/kickjs-http'
+import { DevToolsAdapter } from '@forinda/kickjs-http/devtools'
+import { SwaggerAdapter } from '@forinda/kickjs-swagger'
+import { OtelAdapter } from '@forinda/kickjs-otel'
+// import { QueueAdapter, BullMQProvider } from '@forinda/kickjs-queue'
+import { modules } from './modules'
+
+bootstrap({
+  modules,
+  adapters: [
+    new OtelAdapter({ serviceName: '${name}' }),
+    new DevToolsAdapter(),
+    new SwaggerAdapter({
+      info: { title: '${name}', version: '${cliPkg.version}' },
+    }),
+    // Uncomment when Redis is available:
+    // new QueueAdapter({
+    //   provider: new BullMQProvider({ host: 'localhost', port: 6379 }),
+    // }),
+  ],
+})
+`;
+    case "minimal":
+      return `import 'reflect-metadata'
+import { bootstrap } from '@forinda/kickjs-http'
+import { modules } from './modules'
+
+bootstrap({ modules })
+`;
+    case "ddd":
+    case "rest":
+    default:
+      return `import 'reflect-metadata'
+import { bootstrap } from '@forinda/kickjs-http'
+import { DevToolsAdapter } from '@forinda/kickjs-http/devtools'
+import { SwaggerAdapter } from '@forinda/kickjs-swagger'
+import { modules } from './modules'
+
+bootstrap({
+  modules,
+  adapters: [
+    new DevToolsAdapter(),
+    new SwaggerAdapter({
+      info: { title: '${name}', version: '${cliPkg.version}' },
+    }),
+  ],
+})
+`;
+  }
+}
+__name(getEntryFile, "getEntryFile");
 
 // src/config.ts
 import { readFile as readFile3, access as access2 } from "fs/promises";