stackkit-cli 0.3.0 → 0.4.0

package/README.md

@@ -1,39 +1,42 @@
 # stackkit-cli
 
-Main CLI package for StackKit - production-ready project generator with modular architecture.
+Add modules to existing projects.
 
-[![npm](https://img.shields.io/npm/v/stackkit-cli)](https://www.npmjs.com/package/stackkit-cli)
-
-## Installation
+## Usage
 
 ```bash
-# Global installation
-npm install -g stackkit-cli
+# Add authentication
+npx stackkit-cli add auth
 
-# Or use directly with npx
-npx stackkit-cli@latest init my-app
+# Add database
+npx stackkit-cli add database --provider prisma-postgresql
+
+# List available modules
+npx stackkit-cli list
 ```
 
-## Usage
+## Commands
 
-```bash
-# Create new project
-npx stackkit-cli init my-app
+- `add <module>` - Add module to your project
+- `list` - List available modules
+- `init` - Create new project (same as create-stackkit-app)
 
-# List available resources
-npx stackkit-cli list
+## Development
 
-# Add modules to existing project
-npx stackkit-cli add auth
+```bash
+pnpm install
+pnpm build
+npx . add auth
 ```
 
-## Commands
+See [main README](../../README.md) for full documentation.
 
 ### `init [project-name]`
 
 Create a new project from a template.
 
 **Options:**
+
 - `--template <name>` - Template to use
 - `--pm <npm|yarn|pnpm>` - Package manager (default: auto-detect)
 - `--no-install` - Skip dependency installation
@@ -41,6 +44,7 @@ Create a new project from a template.
 - `--yes` - Skip all prompts
 
 **Examples:**
+
 ```bash
 npx stackkit-cli init my-app
 npx stackkit-cli init my-app --template next-prisma-postgres-shadcn --pm pnpm
@@ -52,10 +56,12 @@ npx stackkit-cli init my-app --no-install --no-git --yes
 List available templates and modules.
 
 **Options:**
+
 - `--templates` - Show templates only
 - `--modules` - Show modules only
 
 **Examples:**
+
 ```bash
 npx stackkit-cli list
 npx stackkit-cli list --templates
@@ -67,11 +73,13 @@ npx stackkit-cli list --modules
 Add a module to your existing project.
 
 **Options:**
+
 - `--dry-run` - Preview changes without applying
 - `--force` - Overwrite existing files
 - `--no-install` - Skip dependency installation
 
 **Examples:**
+
 ```bash
 npx stackkit-cli add auth
 npx stackkit-cli add auth --dry-run

package/dist/commands/add.d.ts

@@ -6,4 +6,3 @@ interface AddOptions {
 }
 export declare function addCommand(module: string, options: AddOptions): Promise<void>;
 export {};
-//# sourceMappingURL=add.d.ts.map

package/dist/commands/add.js

@@ -123,8 +123,12 @@ async function loadModuleMetadata(modulesDir, moduleName, provider) {
             const metadataPath = path_1.default.join(modulePath, 'module.json');
             if (await fs_extra_1.default.pathExists(metadataPath)) {
                 const metadata = await fs_extra_1.default.readJSON(metadataPath);
-                // Match by module name or provider
-                if (metadata.name === moduleName || (provider && moduleDir === provider)) {
+                // If provider is specified, match by directory name (exact match)
+                if (provider && moduleDir === provider) {
+                    return metadata;
+                }
+                // Otherwise, match by module name (category)
+                if (!provider && metadata.name === moduleName) {
                     return metadata;
                 }
             }
@@ -189,8 +193,12 @@ async function findModulePath(modulesDir, moduleName, provider) {
             const metadataPath = path_1.default.join(modulePath, 'module.json');
             if (await fs_extra_1.default.pathExists(metadataPath)) {
                 const metadata = await fs_extra_1.default.readJSON(metadataPath);
-                // Match by module name or provider
-                if (metadata.name === moduleName || (provider && moduleDir === provider)) {
+                // If provider is specified, match by directory name (exact match)
+                if (provider && moduleDir === provider) {
+                    return modulePath;
+                }
+                // Otherwise, match by module name (category)
+                if (!provider && metadata.name === moduleName) {
                     return modulePath;
                 }
             }
@@ -198,4 +206,3 @@ async function findModulePath(modulesDir, moduleName, provider) {
     }
     return null;
 }
-//# sourceMappingURL=add.js.map

package/dist/commands/init.d.ts

@@ -8,4 +8,3 @@ interface InitOptions {
 }
 export declare function initCommand(projectName: string | undefined, options: InitOptions): Promise<void>;
 export {};
-//# sourceMappingURL=init.d.ts.map

package/dist/commands/init.js

@@ -150,4 +150,3 @@ async function getAvailableTemplates(templatesDir) {
     }
     return templates;
 }
-//# sourceMappingURL=init.js.map

package/dist/commands/list.d.ts

@@ -4,4 +4,3 @@ interface ListOptions {
 }
 export declare function listCommand(options: ListOptions): Promise<void>;
 export {};
-//# sourceMappingURL=list.d.ts.map

package/dist/commands/list.js

@@ -98,4 +98,3 @@ async function getAvailableModules(modulesDir) {
     }
     return modules;
 }
-//# sourceMappingURL=list.js.map

package/dist/index.d.ts

@@ -1,3 +1,2 @@
 #!/usr/bin/env node
 export {};
-//# sourceMappingURL=index.d.ts.map

package/dist/index.js

@@ -13,7 +13,7 @@ const program = new commander_1.Command();
 program
     .name('stackkit')
     .description('Production-ready project generator and module CLI')
-    .version('0.1.0');
+    .version('0.3.2');
 // Init command
 program
     .command('init [project-name]')
@@ -47,4 +47,3 @@ program.on('command:*', () => {
     process.exit(1);
 });
 program.parse();
-//# sourceMappingURL=index.js.map

package/dist/types/index.d.ts

@@ -47,12 +47,13 @@ export interface ModifyJsonPatch extends ModulePatch {
     }[];
 }
 export interface ProjectInfo {
-    framework: 'nextjs' | 'unknown';
+    framework: 'nextjs' | 'express' | 'react' | 'react-vite' | 'unknown';
     router: 'app' | 'pages' | 'unknown';
     language: 'ts' | 'js';
     packageManager: 'npm' | 'yarn' | 'pnpm';
     hasAuth: boolean;
     hasPrisma: boolean;
+    hasDatabase: boolean;
     rootDir: string;
 }
 export interface CLIOptions {
@@ -62,4 +63,3 @@ export interface CLIOptions {
     noInstall?: boolean;
     pm?: 'npm' | 'yarn' | 'pnpm';
 }
-//# sourceMappingURL=index.d.ts.map

package/dist/types/index.js

@@ -1,3 +1,2 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-//# sourceMappingURL=index.js.map

package/dist/utils/code-inject.d.ts

@@ -12,4 +12,3 @@ export declare function injectCode(filePath: string, injection: CodeInjection, p
 }): Promise<void>;
 export declare function removeInjection(content: string, id: string): string;
 export declare function hasInjection(content: string, id: string): boolean;
-//# sourceMappingURL=code-inject.d.ts.map

package/dist/utils/code-inject.js

@@ -10,7 +10,7 @@ const fs_extra_1 = __importDefault(require("fs-extra"));
 const CODE_MARKER_START = (id) => `// StackKit:${id}:start`;
 const CODE_MARKER_END = (id) => `// StackKit:${id}:end`;
 async function injectCode(filePath, injection, position, options = {}) {
-    if (!await fs_extra_1.default.pathExists(filePath)) {
+    if (!(await fs_extra_1.default.pathExists(filePath))) {
         throw new Error(`File not found: ${filePath}`);
     }
     let content = await fs_extra_1.default.readFile(filePath, 'utf-8');
@@ -68,4 +68,3 @@ function removeInjection(content, id) {
 function hasInjection(content, id) {
     return content.includes(CODE_MARKER_START(id));
 }
-//# sourceMappingURL=code-inject.js.map

package/dist/utils/detect.d.ts

@@ -2,4 +2,3 @@ import { ProjectInfo } from '../types';
 export declare function detectProjectInfo(targetDir: string): Promise<ProjectInfo>;
 export declare function getRouterBasePath(projectInfo: ProjectInfo): string;
 export declare function getLibPath(projectInfo: ProjectInfo): string;
-//# sourceMappingURL=detect.d.ts.map

package/dist/utils/detect.js

@@ -10,27 +10,47 @@ const fs_extra_1 = __importDefault(require("fs-extra"));
 const path_1 = __importDefault(require("path"));
 async function detectProjectInfo(targetDir) {
     const packageJsonPath = path_1.default.join(targetDir, 'package.json');
-    if (!await fs_extra_1.default.pathExists(packageJsonPath)) {
+    if (!(await fs_extra_1.default.pathExists(packageJsonPath))) {
         throw new Error('No package.json found. This does not appear to be a Node.js project.');
     }
     const packageJson = await fs_extra_1.default.readJSON(packageJsonPath);
     // Detect framework
     const isNextJs = packageJson.dependencies?.next || packageJson.devDependencies?.next;
-    const framework = isNextJs ? 'nextjs' : 'unknown';
+    const isExpress = packageJson.dependencies?.express || packageJson.devDependencies?.express;
+    const isReact = packageJson.dependencies?.react || packageJson.devDependencies?.react;
+    const isVite = packageJson.dependencies?.vite || packageJson.devDependencies?.vite;
+    let framework;
+    if (isNextJs) {
+        framework = 'nextjs';
+    }
+    else if (isExpress) {
+        framework = 'express';
+    }
+    else if (isReact && isVite) {
+        framework = 'react-vite';
+    }
+    else if (isReact) {
+        framework = 'react';
+    }
+    else {
+        framework = 'unknown';
+    }
     if (framework === 'unknown') {
-        throw new Error('Only Next.js projects are currently supported.');
+        throw new Error('Only Next.js, Express, and React projects are currently supported.');
     }
-    // Detect router type
-    const appDirExists = await fs_extra_1.default.pathExists(path_1.default.join(targetDir, 'app'));
-    const pagesDirExists = await fs_extra_1.default.pathExists(path_1.default.join(targetDir, 'pages'));
-    const srcAppDirExists = await fs_extra_1.default.pathExists(path_1.default.join(targetDir, 'src', 'app'));
-    const srcPagesDirExists = await fs_extra_1.default.pathExists(path_1.default.join(targetDir, 'src', 'pages'));
+    // Detect router type (only for Next.js)
     let router = 'unknown';
-    if (appDirExists || srcAppDirExists) {
-        router = 'app';
-    }
-    else if (pagesDirExists || srcPagesDirExists) {
-        router = 'pages';
+    if (framework === 'nextjs') {
+        const appDirExists = await fs_extra_1.default.pathExists(path_1.default.join(targetDir, 'app'));
+        const pagesDirExists = await fs_extra_1.default.pathExists(path_1.default.join(targetDir, 'pages'));
+        const srcAppDirExists = await fs_extra_1.default.pathExists(path_1.default.join(targetDir, 'src', 'app'));
+        const srcPagesDirExists = await fs_extra_1.default.pathExists(path_1.default.join(targetDir, 'src', 'pages'));
+        if (appDirExists || srcAppDirExists) {
+            router = 'app';
+        }
+        else if (pagesDirExists || srcPagesDirExists) {
+            router = 'pages';
+        }
     }
     // Detect TypeScript vs JavaScript
     const tsconfigExists = await fs_extra_1.default.pathExists(path_1.default.join(targetDir, 'tsconfig.json'));
@@ -47,11 +67,16 @@ async function detectProjectInfo(targetDir) {
     }
     // Check for existing integrations
     const hasAuth = !!(packageJson.dependencies?.['next-auth'] ||
+        packageJson.dependencies?.['better-auth'] ||
         packageJson.dependencies?.['@auth/core'] ||
         packageJson.dependencies?.['@clerk/nextjs'] ||
-        packageJson.dependencies?.['@kinde-oss/kinde-auth-nextjs']);
-    const hasPrisma = !!(packageJson.dependencies?.['@prisma/client'] ||
-        packageJson.devDependencies?.['prisma']);
+        packageJson.dependencies?.['@kinde-oss/kinde-auth-nextjs'] ||
+        packageJson.dependencies?.['passport']);
+    const hasPrisma = !!(packageJson.dependencies?.['@prisma/client'] || packageJson.devDependencies?.['prisma']);
+    const hasDatabase = hasPrisma ||
+        !!(packageJson.dependencies?.['mongoose'] ||
+            packageJson.dependencies?.['typeorm'] ||
+            packageJson.dependencies?.['drizzle-orm']);
     return {
         framework,
         router,
@@ -59,6 +84,7 @@ async function detectProjectInfo(targetDir) {
         packageManager,
         hasAuth,
         hasPrisma,
+        hasDatabase,
         rootDir: targetDir,
     };
 }
@@ -73,7 +99,9 @@ function getRouterBasePath(projectInfo) {
     throw new Error('Unknown router type');
 }
 function getLibPath(projectInfo) {
+    if (projectInfo.framework === 'express') {
+        return 'src/lib';
+    }
     const srcExists = fs_extra_1.default.existsSync(path_1.default.join(projectInfo.rootDir, 'src'));
     return srcExists ? 'src/lib' : 'lib';
 }
-//# sourceMappingURL=detect.js.map

package/dist/utils/env-editor.d.ts

@@ -8,4 +8,3 @@ export declare function addEnvVariables(projectRoot: string, variables: EnvVaria
     force?: boolean;
 }): Promise<void>;
 export declare function removeEnvVariables(projectRoot: string, keys: string[]): Promise<void>;
-//# sourceMappingURL=env-editor.d.ts.map

package/dist/utils/env-editor.js

@@ -59,7 +59,7 @@ async function appendToEnvFile(filePath, variables, fileType, options = {}) {
         if (variable.description) {
             content += `# ${variable.description}\n`;
         }
-        const value = fileType === 'example' ? (variable.value || '') : (variable.value || '');
+        const value = fileType === 'example' ? variable.value || '' : variable.value || '';
         content += `${variable.key}=${value}\n`;
     }
     content += `${ENV_MARKER_END}\n`;
@@ -74,7 +74,7 @@ async function removeEnvVariables(projectRoot, keys) {
     }
 }
 async function removeFromEnvFile(filePath, keys) {
-    if (!await fs_extra_1.default.pathExists(filePath)) {
+    if (!(await fs_extra_1.default.pathExists(filePath))) {
         return;
     }
     let content = await fs_extra_1.default.readFile(filePath, 'utf-8');
@@ -89,4 +89,3 @@ async function removeFromEnvFile(filePath, keys) {
     }
     await fs_extra_1.default.writeFile(filePath, newLines.join('\n'), 'utf-8');
 }
-//# sourceMappingURL=env-editor.js.map

package/dist/utils/files.d.ts

@@ -4,4 +4,3 @@ export declare function createFile(targetPath: string, content: string, options?
 }): Promise<void>;
 export declare function readFile(filePath: string): Promise<string>;
 export declare function fileExists(filePath: string): Promise<boolean>;
-//# sourceMappingURL=files.d.ts.map

package/dist/utils/files.js

@@ -11,7 +11,7 @@ const fs_extra_1 = __importDefault(require("fs-extra"));
 const path_1 = __importDefault(require("path"));
 const logger_1 = require("./logger");
 async function copyTemplate(templatePath, targetPath, projectName) {
-    if (!await fs_extra_1.default.pathExists(templatePath)) {
+    if (!(await fs_extra_1.default.pathExists(templatePath))) {
         throw new Error(`Template not found: ${templatePath}`);
     }
     // Create target directory
@@ -48,4 +48,3 @@ async function readFile(filePath) {
 async function fileExists(filePath) {
     return fs_extra_1.default.pathExists(filePath);
 }
-//# sourceMappingURL=files.js.map

package/dist/utils/json-editor.d.ts

@@ -6,4 +6,3 @@ export declare function addToPackageJson(filePath: string, section: 'dependencie
 export declare function setJsonValue(filePath: string, path: string, value: any, options?: {
     merge?: boolean;
 }): Promise<void>;
-//# sourceMappingURL=json-editor.d.ts.map

package/dist/utils/json-editor.js

@@ -47,4 +47,3 @@ async function setJsonValue(filePath, path, value, options = {}) {
         return json;
     });
 }
-//# sourceMappingURL=json-editor.js.map

package/dist/utils/logger.d.ts

@@ -14,4 +14,3 @@ export declare class Logger {
     footer(): void;
 }
 export declare const logger: Logger;
-//# sourceMappingURL=logger.d.ts.map

package/dist/utils/logger.js

@@ -7,7 +7,9 @@ exports.logger = exports.Logger = void 0;
 const chalk_1 = __importDefault(require("chalk"));
 const ora_1 = __importDefault(require("ora"));
 class Logger {
-    spinner = null;
+    constructor() {
+        this.spinner = null;
+    }
     info(message) {
         console.log(chalk_1.default.blue('ℹ'), message);
     }
@@ -55,4 +57,3 @@ class Logger {
 }
 exports.Logger = Logger;
 exports.logger = new Logger();
-//# sourceMappingURL=logger.js.map

package/dist/utils/package-manager.d.ts

@@ -3,4 +3,3 @@ export declare function detectPackageManager(cwd: string): Promise<PackageManage
 export declare function installDependencies(cwd: string, pm: PackageManager, dev?: boolean): Promise<void>;
 export declare function addDependencies(cwd: string, pm: PackageManager, packages: string[], dev?: boolean): Promise<void>;
 export declare function initGit(cwd: string): Promise<void>;
-//# sourceMappingURL=package-manager.d.ts.map

package/dist/utils/package-manager.js

@@ -76,4 +76,3 @@ async function initGit(cwd) {
         // Don't throw - git init is optional
     }
 }
-//# sourceMappingURL=package-manager.js.map

package/modules/auth/authjs-express/files/lib/auth.ts

@@ -0,0 +1,40 @@
+import Credentials from '@auth/core/providers/credentials';
+
+export const authConfig = {
+  secret: process.env.AUTH_SECRET,
+  trustHost: true,
+  providers: [
+    // GitHub OAuth Provider
+    // Uncomment and add GITHUB_ID and GITHUB_SECRET to .env
+    // GitHub({
+    //   clientId: process.env.GITHUB_ID!,
+    //   clientSecret: process.env.GITHUB_SECRET!,
+    // }),
+
+    // Google OAuth Provider
+    // Uncomment and add GOOGLE_ID and GOOGLE_SECRET to .env
+    // Google({
+    //   clientId: process.env.GOOGLE_ID!,
+    //   clientSecret: process.env.GOOGLE_SECRET!,
+    // }),
+
+    // Credentials Provider (email/password)
+    Credentials({
+      credentials: {
+        email: { label: 'Email', type: 'email' },
+        password: { label: 'Password', type: 'password' },
+      },
+      authorize: async (credentials) => {
+        // Add your own authentication logic here
+        if (credentials?.email === 'demo@example.com' && credentials?.password === 'demo') {
+          return {
+            id: '1',
+            name: 'Demo User',
+            email: 'demo@example.com',
+          };
+        }
+        return null;
+      },
+    }),
+  ],
+};

package/modules/auth/authjs-express/files/routes/auth.ts

@@ -0,0 +1,12 @@
+import { Auth } from '@auth/core';
+import { Router } from 'express';
+import { authConfig } from '../lib/auth';
+
+const router = Router();
+
+router.all('/auth/*', async (req, res) => {
+  const response = await Auth(req, authConfig);
+  return res.status(response.status).json(response.body);
+});
+
+export default router;

package/modules/auth/authjs-express/module.json

@@ -0,0 +1,39 @@
+{
+  "name": "auth",
+  "displayName": "Auth.js (Express)",
+  "description": "Authentication with Auth.js for Express",
+  "category": "auth",
+  "supportedFrameworks": ["express"],
+  "dependencies": {
+    "@auth/express": "^0.7.6",
+    "@auth/core": "^0.37.4"
+  },
+  "envVars": [
+    {
+      "key": "AUTH_SECRET",
+      "value": "",
+      "description": "Secret for encrypting tokens. Generate with: openssl rand -base64 32",
+      "required": true
+    },
+    {
+      "key": "AUTH_TRUST_HOST",
+      "value": "true",
+      "description": "Trust the host header (required for Express)",
+      "required": true
+    }
+  ],
+  "patches": [
+    {
+      "type": "create-file",
+      "description": "Create Auth.js configuration",
+      "source": "lib/auth.ts",
+      "destination": "src/lib/auth.ts"
+    },
+    {
+      "type": "create-file",
+      "description": "Create auth routes",
+      "source": "routes/auth.ts",
+      "destination": "src/routes/auth.ts"
+    }
+  ]
+}

package/modules/auth/authjs-nextjs/files/lib/auth.ts

@@ -0,0 +1,43 @@
+import NextAuth from 'next-auth';
+import Credentials from 'next-auth/providers/credentials';
+
+export const { handlers, signIn, signOut, auth } = NextAuth({
+  providers: [
+    // GitHub OAuth Provider
+    // Uncomment and add GITHUB_ID and GITHUB_SECRET to .env
+    // GitHub({
+    //   clientId: process.env.GITHUB_ID!,
+    //   clientSecret: process.env.GITHUB_SECRET!,
+    // }),
+
+    // Google OAuth Provider
+    // Uncomment and add GOOGLE_ID and GOOGLE_SECRET to .env
+    // Google({
+    //   clientId: process.env.GOOGLE_ID!,
+    //   clientSecret: process.env.GOOGLE_SECRET!,
+    // }),
+
+    // Credentials Provider (email/password)
+    Credentials({
+      credentials: {
+        email: { label: 'Email', type: 'email' },
+        password: { label: 'Password', type: 'password' },
+      },
+      authorize: async (credentials) => {
+        // Add your own authentication logic here
+        // This is just a demo - DO NOT use in production
+        if (credentials?.email === 'demo@example.com' && credentials?.password === 'demo') {
+          return {
+            id: '1',
+            name: 'Demo User',
+            email: 'demo@example.com',
+          };
+        }
+        return null;
+      },
+    }),
+  ],
+  pages: {
+    signIn: '/auth/signin',
+  },
+});

package/modules/auth/authjs-nextjs/module.json

@@ -0,0 +1,38 @@
+{
+  "name": "auth",
+  "displayName": "Auth.js v5 (Next.js)",
+  "description": "Modern authentication with Auth.js v5 (NextAuth successor)",
+  "category": "auth",
+  "supportedFrameworks": ["nextjs"],
+  "dependencies": {
+    "next-auth": "^5.0.0-beta.25"
+  },
+  "envVars": [
+    {
+      "key": "AUTH_SECRET",
+      "value": "",
+      "description": "Secret for encrypting tokens. Generate with: openssl rand -base64 32",
+      "required": true
+    },
+    {
+      "key": "AUTH_URL",
+      "value": "http://localhost:3000",
+      "description": "Canonical URL of your site (change in production)",
+      "required": false
+    }
+  ],
+  "patches": [
+    {
+      "type": "create-file",
+      "description": "Create Auth.js configuration",
+      "source": "lib/auth.ts",
+      "destination": "{{lib}}/auth.ts"
+    },
+    {
+      "type": "create-file",
+      "description": "Create Auth.js API route",
+      "source": "api/auth/[...nextauth]/route.ts",
+      "destination": "{{router}}/api/auth/[...nextauth]/route.ts"
+    }
+  ]
+}

package/modules/auth/better-auth-express/files/lib/auth.ts

@@ -0,0 +1,16 @@
+import { betterAuth } from 'better-auth';
+
+export const auth = betterAuth({
+  secret: process.env.BETTER_AUTH_SECRET!,
+  baseURL: process.env.BETTER_AUTH_URL!,
+
+  emailAndPassword: {
+    enabled: true,
+  },
+
+  // Uncomment to add database adapter
+  // database: {
+  //   provider: "pg", // or "mongodb", "mysql"
+  //   url: process.env.DATABASE_URL!,
+  // },
+});

package/modules/auth/better-auth-express/files/routes/auth.ts

@@ -0,0 +1,12 @@
+import { Router } from 'express';
+import { auth } from '../lib/auth';
+
+const router = Router();
+
+// Mount Better Auth handlers
+router.all('/auth/*', async (req, res) => {
+  const response = await auth.handler(req);
+  return res.status(response.status).json(response.body);
+});
+
+export default router;