create-frootjs 0.0.0-stage → 1.0.1

package/dist/templates/index.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Template Registry
+ * Central export of all available project architectural templates.
+ */
+import { TemplateDefinition } from './types.js';
+export * from './types.js';
+export declare const TEMPLATES: Record<string, TemplateDefinition>;
+export declare const TEMPLATE_LIST: TemplateDefinition[];
+export declare function getTemplate(id: string): TemplateDefinition | undefined;
+//# sourceMappingURL=index.d.ts.map

package/dist/templates/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/templates/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAShD,cAAc,YAAY,CAAC;AAE3B,eAAO,MAAM,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,kBAAkB,CAQxD,CAAC;AAEF,eAAO,MAAM,aAAa,EAAE,kBAAkB,EAA6B,CAAC;AAE5E,wBAAgB,WAAW,CAAC,EAAE,EAAE,MAAM,GAAG,kBAAkB,GAAG,SAAS,CAEtE"}

package/dist/templates/index.js

@@ -0,0 +1,26 @@
+/**
+ * Template Registry
+ * Central export of all available project architectural templates.
+ */
+import { mvcTemplate } from './mvc.js';
+import { modularTemplate } from './modular.js';
+import { streamingTemplate } from './streaming.js';
+import { websocketTemplate } from './websocket.js';
+import { openapiTemplate } from './openapi.js';
+import { fullstackTemplate } from './fullstack.js';
+import { minimalTemplate } from './minimal.js';
+export * from './types.js';
+export const TEMPLATES = {
+    mvc: mvcTemplate,
+    modular: modularTemplate,
+    streaming: streamingTemplate,
+    websocket: websocketTemplate,
+    openapi: openapiTemplate,
+    fullstack: fullstackTemplate,
+    minimal: minimalTemplate,
+};
+export const TEMPLATE_LIST = Object.values(TEMPLATES);
+export function getTemplate(id) {
+    return TEMPLATES[id.toLowerCase()];
+}
+//# sourceMappingURL=index.js.map

package/dist/templates/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/templates/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AACvC,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAC/C,OAAO,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AACnD,OAAO,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AACnD,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAC/C,OAAO,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AACnD,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAE/C,cAAc,YAAY,CAAC;AAE3B,MAAM,CAAC,MAAM,SAAS,GAAuC;IAC3D,GAAG,EAAE,WAAW;IAChB,OAAO,EAAE,eAAe;IACxB,SAAS,EAAE,iBAAiB;IAC5B,SAAS,EAAE,iBAAiB;IAC5B,OAAO,EAAE,eAAe;IACxB,SAAS,EAAE,iBAAiB;IAC5B,OAAO,EAAE,eAAe;CACzB,CAAC;AAEF,MAAM,CAAC,MAAM,aAAa,GAAyB,MAAM,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;AAE5E,MAAM,UAAU,WAAW,CAAC,EAAU;IACpC,OAAO,SAAS,CAAC,EAAE,CAAC,WAAW,EAAE,CAAC,CAAC;AACrC,CAAC"}

package/dist/templates/minimal.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Minimal Starter Template
+ * Clean, single-file starter project for microservices, quick prototypes, or lightweight APIs.
+ */
+import { TemplateDefinition } from './types.js';
+export declare const minimalTemplate: TemplateDefinition;
+//# sourceMappingURL=minimal.d.ts.map

package/dist/templates/minimal.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"minimal.d.ts","sourceRoot":"","sources":["../../src/templates/minimal.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,kBAAkB,EAAsD,MAAM,YAAY,CAAC;AAEpG,eAAO,MAAM,eAAe,EAAE,kBAyF7B,CAAC"}

package/dist/templates/minimal.js

@@ -0,0 +1,89 @@
+/**
+ * Minimal Starter Template
+ * Clean, single-file starter project for microservices, quick prototypes, or lightweight APIs.
+ */
+import { COMMON_GITIGNORE, COMMON_TSCONFIG } from './types.js';
+export const minimalTemplate = {
+    id: 'minimal',
+    name: 'Minimal Starter (Single-file)',
+    description: 'Lean single-file API starter with basic JSON endpoints and CORS',
+    generate: (projectName) => {
+        return {
+            'package.json': JSON.stringify({
+                name: projectName,
+                version: '1.0.0',
+                type: 'module',
+                scripts: {
+                    dev: 'node --experimental-strip-types src/index.ts',
+                    build: 'tsc',
+                    start: 'node dist/index.js',
+                },
+                dependencies: {
+                    frootjs: '^1.0.1',
+                },
+                devDependencies: {
+                    '@types/node': '^22.10.0',
+                    typescript: '^5.8.0',
+                },
+            }, null, 2) + '\n',
+            'tsconfig.json': COMMON_TSCONFIG,
+            '.gitignore': COMMON_GITIGNORE,
+            'README.md': `# ${projectName}
+
+Lean, high-performance web service built with **Froot**.
+
+## Getting Started
+
+\`\`\`bash
+# 1. Install dependencies
+pnpm install
+
+# 2. Run in development mode
+pnpm run dev
+
+# 3. Test endpoint
+curl http://localhost:3000/
+\`\`\`
+`,
+            'src/index.ts': `import { Froot } from 'frootjs';
+import { cors } from 'frootjs/cors';
+
+export const app = new Froot();
+
+// Middleware
+app.use(cors());
+
+// Routes
+app.get('/', (c) => {
+  return c.json({
+    message: 'Hello from Froot!',
+    timestamp: new Date().toISOString(),
+  });
+});
+
+app.get('/health', (c) => {
+  return c.json({
+    status: 'ok',
+    uptime: process.uptime(),
+  });
+});
+
+app.post('/echo', async (c) => {
+  const body = await c.req.json();
+  return c.json({
+    received: body,
+    headers: {
+      userAgent: c.req.header('user-agent'),
+    },
+  });
+});
+
+const PORT = Number(process.env.PORT) || 3000;
+app.listen(PORT, () => {
+  console.log(\`Server is running on http://localhost:\${PORT}\`);
+});
+`,
+        };
+    },
+};
+//# sourceMappingURL=minimal.js.map

package/dist/templates/minimal.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"minimal.js","sourceRoot":"","sources":["../../src/templates/minimal.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAuC,gBAAgB,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAEpG,MAAM,CAAC,MAAM,eAAe,GAAuB;IACjD,EAAE,EAAE,SAAS;IACb,IAAI,EAAE,+BAA+B;IACrC,WAAW,EAAE,iEAAiE;IAC9E,QAAQ,EAAE,CAAC,WAAmB,EAAmB,EAAE;QACjD,OAAO;YACL,cAAc,EAAE,IAAI,CAAC,SAAS,CAC5B;gBACE,IAAI,EAAE,WAAW;gBACjB,OAAO,EAAE,OAAO;gBAChB,IAAI,EAAE,QAAQ;gBACd,OAAO,EAAE;oBACP,GAAG,EAAE,8CAA8C;oBACnD,KAAK,EAAE,KAAK;oBACZ,KAAK,EAAE,oBAAoB;iBAC5B;gBACD,YAAY,EAAE;oBACZ,OAAO,EAAE,QAAQ;iBAClB;gBACD,eAAe,EAAE;oBACf,aAAa,EAAE,UAAU;oBACzB,UAAU,EAAE,QAAQ;iBACrB;aACF,EACD,IAAI,EACJ,CAAC,CACF,GAAG,IAAI;YAER,eAAe,EAAE,eAAe;YAChC,YAAY,EAAE,gBAAgB;YAE9B,WAAW,EAAE,KAAK,WAAW;;;;;;;;;;;;;;;;CAgBlC;YAEK,cAAc,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAqCrB;SACI,CAAC;IACJ,CAAC;CACF,CAAC"}

package/dist/templates/modular.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Modular / NestJS-Style Feature Modules Template
+ * Organizes code by domain feature: each module encapsulates its routes, service, schema, and types.
+ */
+import { TemplateDefinition } from './types.js';
+export declare const modularTemplate: TemplateDefinition;
+//# sourceMappingURL=modular.d.ts.map

package/dist/templates/modular.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"modular.d.ts","sourceRoot":"","sources":["../../src/templates/modular.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,kBAAkB,EAAsD,MAAM,YAAY,CAAC;AAEpG,eAAO,MAAM,eAAe,EAAE,kBAuT7B,CAAC"}

package/dist/templates/modular.js

@@ -0,0 +1,300 @@
+/**
+ * Modular / NestJS-Style Feature Modules Template
+ * Organizes code by domain feature: each module encapsulates its routes, service, schema, and types.
+ */
+import { COMMON_GITIGNORE, COMMON_TSCONFIG } from './types.js';
+export const modularTemplate = {
+    id: 'modular',
+    name: 'Modular Architecture (NestJS-style)',
+    description: 'Domain feature modules (routes, service, schema) with common guards & filters',
+    generate: (projectName) => {
+        return {
+            'package.json': JSON.stringify({
+                name: projectName,
+                version: '1.0.0',
+                type: 'module',
+                scripts: {
+                    dev: 'node --experimental-strip-types src/server.ts',
+                    build: 'tsc',
+                    start: 'node dist/server.js',
+                    test: 'node --test tests/*.test.ts',
+                },
+                dependencies: {
+                    frootjs: '^1.0.1',
+                },
+                devDependencies: {
+                    '@types/node': '^22.10.0',
+                    typescript: '^5.8.0',
+                },
+            }, null, 2) + '\n',
+            'tsconfig.json': COMMON_TSCONFIG,
+            '.gitignore': COMMON_GITIGNORE,
+            'README.md': `# ${projectName}
+
+Froot application built with the **Modular Architecture (NestJS-style)** pattern.
+
+## Directory Structure
+
+\`\`\`
+src/
+├── common/             # Cross-cutting concerns
+│   ├── guards/         # Auth & role guards
+│   │   └── auth.guard.ts
+│   └── filters/        # Global error filters
+│       └── error.filter.ts
+├── modules/            # Feature modules
+│   ├── auth/           # Authentication module (JWT & login)
+│   │   ├── auth.routes.ts
+│   │   └── auth.service.ts
+│   ├── users/          # Users management module
+│   │   ├── users.routes.ts
+│   │   ├── users.service.ts
+│   │   └── users.types.ts
+│   └── products/       # Products catalog module
+│       ├── products.routes.ts
+│       ├── products.service.ts
+│       └── products.types.ts
+├── app.ts              # Root application module orchestrator
+└── server.ts           # Server bootstrap
+\`\`\`
+
+## Getting Started
+
+\`\`\`bash
+# 1. Install dependencies
+pnpm install
+
+# 2. Run in development mode
+pnpm run dev
+
+# 3. Build for production
+pnpm run build
+pnpm start
+\`\`\`
+`,
+            'src/common/guards/auth.guard.ts': `import type { Context, MiddlewareHandler } from 'frootjs';
+import { verifyJwt } from 'frootjs/jwt';
+
+const JWT_SECRET = process.env.JWT_SECRET || 'froot-secret-key-change-in-production';
+
+export interface AuthContextVariables {
+  user: {
+    id: string;
+    email: string;
+    role: string;
+  };
+}
+
+export const authGuard: MiddlewareHandler = async (c, next) => {
+  const authHeader = c.req.header('authorization');
+  if (!authHeader || !authHeader.startsWith('Bearer ')) {
+    return c.json({ error: 'Unauthorized: missing or invalid authorization header' }, 401);
+  }
+
+  const token = authHeader.slice(7).trim();
+  const payload = await verifyJwt(token, JWT_SECRET);
+
+  if (!payload) {
+    return c.json({ error: 'Unauthorized: token is invalid or expired' }, 401);
+  }
+
+  c.set('user', payload);
+  await next();
+};
+`,
+            'src/common/filters/error.filter.ts': `import type { Context } from 'frootjs';
+
+export function errorHandler(err: unknown, c: Context): Response {
+  console.error('[ErrorFilter] Caught unhandled error:', err);
+
+  if (err instanceof Error) {
+    return c.json(
+      {
+        error: err.name,
+        message: err.message,
+        statusCode: 500,
+      },
+      500
+    );
+  }
+
+  return c.json(
+    {
+      error: 'Internal Server Error',
+      message: 'An unexpected error occurred',
+      statusCode: 500,
+    },
+    500
+  );
+}
+`,
+            'src/modules/auth/auth.service.ts': `import { signJwt } from 'frootjs/jwt';
+
+const JWT_SECRET = process.env.JWT_SECRET || 'froot-secret-key-change-in-production';
+
+export class AuthService {
+  static async createToken(user: { id: string; email: string; role: string }): Promise<string> {
+    return signJwt(
+      {
+        sub: user.id,
+        email: user.email,
+        role: user.role,
+        exp: Math.floor(Date.now() / 1000) + 60 * 60 * 24, // 24 hours
+      },
+      JWT_SECRET
+    );
+  }
+}
+`,
+            'src/modules/auth/auth.routes.ts': `import { Froot } from 'frootjs';
+import { AuthService } from './auth.service.js';
+
+export const authModule = new Froot();
+
+authModule.post('/auth/login', async (c) => {
+  const body = await c.req.json<{ email?: string; password?: string }>();
+  if (!body.email || !body.password) {
+    return c.json({ error: 'Email and password required' }, 400);
+  }
+
+  // Demo validation: any credentials pass for showcase
+  const user = {
+    id: 'usr_demo',
+    email: body.email,
+    role: 'admin',
+  };
+
+  const token = await AuthService.createToken(user);
+  return c.json({
+    token,
+    user,
+    message: 'Login successful',
+  });
+});
+`,
+            'src/modules/users/users.types.ts': `export interface UserProfile {
+  id: string;
+  name: string;
+  email: string;
+  role: string;
+}
+`,
+            'src/modules/users/users.service.ts': `import type { UserProfile } from './users.types.js';
+
+const mockUsers: UserProfile[] = [
+  { id: 'usr_1', name: 'Ada Lovelace', email: 'ada@froot.dev', role: 'admin' },
+  { id: 'usr_2', name: 'Alan Turing', email: 'alan@froot.dev', role: 'engineer' },
+];
+
+export class UsersService {
+  static getAll(): UserProfile[] {
+    return mockUsers;
+  }
+
+  static getById(id: string): UserProfile | undefined {
+    return mockUsers.find((u) => u.id === id);
+  }
+}
+`,
+            'src/modules/users/users.routes.ts': `import { Froot } from 'frootjs';
+import { UsersService } from './users.service.js';
+import { authGuard } from '../../common/guards/auth.guard.js';
+
+export const usersModule = new Froot();
+
+// Public route: list users
+usersModule.get('/users', (c) => {
+  return c.json(UsersService.getAll());
+});
+
+// Protected route: user details (guarded by JWT)
+usersModule.get('/users/:id', authGuard, (c) => {
+  const id = c.req.param('id');
+  const user = UsersService.getById(id);
+  if (!user) {
+    return c.json({ error: 'User not found' }, 404);
+  }
+  return c.json(user);
+});
+`,
+            'src/modules/products/products.types.ts': `export interface Product {
+  id: string;
+  title: string;
+  price: number;
+  inventory: number;
+}
+`,
+            'src/modules/products/products.service.ts': `import type { Product } from './products.types.js';
+
+const productsTable: Product[] = [
+  { id: 'prod_1', title: 'High-Performance Microservice', price: 99.0, inventory: 50 },
+  { id: 'prod_2', title: 'Real-Time Edge Gateway', price: 149.0, inventory: 25 },
+];
+
+export class ProductsService {
+  static list(): Product[] {
+    return productsTable;
+  }
+
+  static find(id: string): Product | undefined {
+    return productsTable.find((p) => p.id === id);
+  }
+}
+`,
+            'src/modules/products/products.routes.ts': `import { Froot } from 'frootjs';
+import { ProductsService } from './products.service.js';
+
+export const productsModule = new Froot();
+
+productsModule.get('/products', (c) => {
+  return c.json(ProductsService.list());
+});
+
+productsModule.get('/products/:id', (c) => {
+  const id = c.req.param('id');
+  const product = ProductsService.find(id);
+  if (!product) {
+    return c.json({ error: 'Product not found' }, 404);
+  }
+  return c.json(product);
+});
+`,
+            'src/app.ts': `import { Froot } from 'frootjs';
+import { cors } from 'frootjs/cors';
+import { errorHandler } from './common/filters/error.filter.js';
+import { authModule } from './modules/auth/auth.routes.js';
+import { usersModule } from './modules/users/users.routes.js';
+import { productsModule } from './modules/products/products.routes.js';
+
+export const app = new Froot();
+
+// Global middleware & filters
+app.use(cors());
+app.onError(errorHandler);
+
+// Mount feature modules under /api prefix
+app.route('/api', authModule);
+app.route('/api', usersModule);
+app.route('/api', productsModule);
+
+// Health check
+app.get('/health', (c) => {
+  return c.json({
+    status: 'ok',
+    uptime: process.uptime(),
+    modules: ['auth', 'users', 'products'],
+  });
+});
+`,
+            'src/server.ts': `import { app } from './app.js';
+
+const PORT = Number(process.env.PORT) || 3000;
+
+app.listen(PORT, () => {
+  console.log(\`Modular Froot Server running on http://localhost:\${PORT}\`);
+});
+`,
+        };
+    },
+};
+//# sourceMappingURL=modular.js.map

package/dist/templates/modular.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"modular.js","sourceRoot":"","sources":["../../src/templates/modular.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAuC,gBAAgB,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAEpG,MAAM,CAAC,MAAM,eAAe,GAAuB;IACjD,EAAE,EAAE,SAAS;IACb,IAAI,EAAE,qCAAqC;IAC3C,WAAW,EAAE,+EAA+E;IAC5F,QAAQ,EAAE,CAAC,WAAmB,EAAmB,EAAE;QACjD,OAAO;YACL,cAAc,EAAE,IAAI,CAAC,SAAS,CAC5B;gBACE,IAAI,EAAE,WAAW;gBACjB,OAAO,EAAE,OAAO;gBAChB,IAAI,EAAE,QAAQ;gBACd,OAAO,EAAE;oBACP,GAAG,EAAE,+CAA+C;oBACpD,KAAK,EAAE,KAAK;oBACZ,KAAK,EAAE,qBAAqB;oBAC5B,IAAI,EAAE,6BAA6B;iBACpC;gBACD,YAAY,EAAE;oBACZ,OAAO,EAAE,QAAQ;iBAClB;gBACD,eAAe,EAAE;oBACf,aAAa,EAAE,UAAU;oBACzB,UAAU,EAAE,QAAQ;iBACrB;aACF,EACD,IAAI,EACJ,CAAC,CACF,GAAG,IAAI;YAER,eAAe,EAAE,eAAe;YAChC,YAAY,EAAE,gBAAgB;YAE9B,WAAW,EAAE,KAAK,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA0ClC;YAEK,iCAAiC,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA6BxC;YAEK,oCAAoC,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;CAyB3C;YAEK,kCAAkC,EAAE;;;;;;;;;;;;;;;;;CAiBzC;YAEK,iCAAiC,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;CAyBxC;YAEK,kCAAkC,EAAE;;;;;;CAMzC;YAEK,oCAAoC,EAAE;;;;;;;;;;;;;;;;CAgB3C;YAEK,mCAAmC,EAAE;;;;;;;;;;;;;;;;;;;;CAoB1C;YAEK,wCAAwC,EAAE;;;;;;CAM/C;YAEK,0CAA0C,EAAE;;;;;;;;;;;;;;;;CAgBjD;YAEK,yCAAyC,EAAE;;;;;;;;;;;;;;;;;CAiBhD;YAEK,YAAY,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;CA0BnB;YAEK,eAAe,EAAE;;;;;;;CAOtB;SACI,CAAC;IACJ,CAAC;CACF,CAAC"}

package/dist/templates/mvc.d.ts

@@ -0,0 +1,7 @@
+/**
+ * MVC / Layered Architecture Template
+ * Organizes code by layer: Routes -> Controllers -> Services -> Models.
+ */
+import { TemplateDefinition } from './types.js';
+export declare const mvcTemplate: TemplateDefinition;
+//# sourceMappingURL=mvc.d.ts.map

package/dist/templates/mvc.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mvc.d.ts","sourceRoot":"","sources":["../../src/templates/mvc.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,kBAAkB,EAAsD,MAAM,YAAY,CAAC;AAEpG,eAAO,MAAM,WAAW,EAAE,kBAwPzB,CAAC"}