create-tilcayo-app 0.0.1 → 0.0.3

package/dist/templates.js

@@ -1,99 +1,138 @@
 import { randomBytes } from "node:crypto";
+import { readFileSync } from "node:fs";
+import { adminFiles, adminBackendFiles } from "@tilcayo/cli";
+import { fullstackTemplates } from "./fullstack.js";
 export function templates(options, localPackages = {}) {
+    if (options.type === "fullstack")
+        return fullstackTemplates(options, localPackages);
+    if (options.type === "react") {
+        const files = JSON.parse(readFileSync(new URL('./react-starter.json', import.meta.url), 'utf8'));
+        const manifest = JSON.parse(files['package.json']);
+        manifest.name = options.name;
+        manifest.engines = { node: '^22.12.0 || >=24.0.0' };
+        manifest.dependencies['@tilcayo/styles'] = localPackages.styles ?? '^0.0.3';
+        manifest.dependencies['@tilcayo/react'] = localPackages.react ?? '^0.0.3';
+        manifest.dependencies['@tilcayo/ui'] = localPackages.ui ?? '^0.0.3';
+        manifest.tilcayo = { type: 'react', auth: options.auth, admin: options.admin ?? false, packageManager: options.packageManager };
+        files['package.json'] = JSON.stringify(manifest, null, 2) + '\n';
+        if (options.packageManager === 'yarn')
+            files['.yarnrc.yml'] = 'nodeLinker: node-modules\n';
+        if (options.auth) {
+            const authFiles = JSON.parse(readFileSync(new URL('./react-auth.json', import.meta.url), 'utf8'));
+            Object.assign(files, authFiles);
+            files['.gitignore'] += '\n.env\n.env.*\n!.env.example\n';
+            delete files['src/lib/api.ts'];
+        }
+        if (options.admin) {
+            files['src/components/navigation.tsx'] = files['src/components/navigation.tsx'].replace('const adminEnabled = false', 'const adminEnabled = true');
+            manifest.dependencies['@tilcayo/admin'] = localPackages.admin ?? '^0.0.3';
+            for (const file of adminFiles())
+                files[`src/${file.folder}/${file.name}`] = file.source;
+            {
+                const source = files['src/components/session-skeleton.tsx'];
+                files['src/components/session-skeleton.tsx'] = "import { AdminSessionShell } from '../features/admin/session-shell';\n" + source.replace("  const { pathname } = useLocation()", "  const { pathname } = useLocation()\n  if (/^\\/admin(?:\\/|$)/.test(pathname)) return <AdminSessionShell />");
+            }
+            files['src/routes.tsx'] = "import { adminRoutes } from './features/admin/admin.routes';\n" + files['src/routes.tsx'].replace('export const routes: RouteObject[] = [', 'export const routes: RouteObject[] = [\n  ...adminRoutes,');
+            files['README.md'] += '\nAdmin overview and user directory are at /admin and /admin/users. On a separate API, register app.routes(auth.adminRoutes) to enable /api/admin/users. Assign the admin role through trusted server code; registration does not grant admin rights. Authorize backend resource routes with auth.middleware and auth.requireRole("admin").\n';
+            files['package.json'] = JSON.stringify(manifest, null, 2) + '\n';
+        }
+        return files;
+    }
     const mongo = options.type === "api" || options.auth;
     const json = (value) => JSON.stringify(value, null, 2) + "\n";
     const env = `# Server\nPORT=9149\n${mongo ? `\n# Database\nMONGODB_URI=mongodb://127.0.0.1:27017/${options.name.replaceAll("-", "_")}\n` : ""}`;
     return {
+        ...(options.admin ? Object.fromEntries(adminBackendFiles().map(file => [`src/${file.folder}/${file.name}`, file.source])) : {}),
         "package.json": json({
             name: options.name, version: "0.0.1", private: true, type: "module",
             engines: { node: ">=22.9.0" },
             tilcayo: { database: mongo ? "mongo" : "none", type: options.type, packageManager: options.packageManager },
-            scripts: { dev: "tilcayo dev", build: "tilcayo build", start: "tilcayo start", routes: "tilcayo routes:list" },
-            dependencies: { "@tilcayo/core": localPackages.core ?? "^0.0.1", ...(options.auth ? { "@tilcayo/auth": localPackages.auth ?? "^0.0.1" } : {}), ...(mongo ? { mongoose: localPackages.mongoose ?? "^9.10.2" } : {}), zod: localPackages.zod ?? "^4.0.0" },
-            devDependencies: { "@tilcayo/cli": localPackages.cli ?? "^0.0.1", "@types/node": "^26.6.3", typescript: "^7.0.2", nodemon: "^3.1.14" },
+            scripts: { dev: "tilcayo dev", build: "tilcayo build", start: "tilcayo start", routes: "tilcayo routes:list", ...(options.admin ? { 'seed:demo': 'node --env-file-if-exists=.env dist/scripts/seed-admin-demo.js' } : {}) },
+            dependencies: { "@tilcayo/core": localPackages.core ?? "^0.0.3", ...(options.auth ? { "@tilcayo/auth": localPackages.auth ?? "^0.0.3", "@tilcayo/cloudinary": localPackages.cloudinary ?? "^0.0.3" } : {}), ...(mongo ? { mongoose: localPackages.mongoose ?? "^9.10.2" } : {}), zod: localPackages.zod ?? "^4.0.0" },
+            devDependencies: { "@tilcayo/cli": localPackages.cli ?? "^0.0.3", "@types/node": "^26.6.3", typescript: "^7.0.2", nodemon: "^3.1.14" },
         }),
         "tsconfig.json": json({ compilerOptions: { target: "ES2022", module: "NodeNext", moduleResolution: "NodeNext", strict: true, esModuleInterop: true, skipLibCheck: true, forceConsistentCasingInFileNames: true, rootDir: "src", outDir: "dist", types: ["node"] }, include: ["src/**/*.ts"] }),
         ".gitignore": "node_modules/\ndist/\n.env\n.env.*\n!.env.example\n*.log\n.DS_Store\n",
-        ".env.example": env + (options.auth ? "\n# Authentication - use private values from .env\nAUTH_ACCESS_SECRET=\nAUTH_REFRESH_SECRET=\n" : ""),
-        ".env": env + (options.auth ? `\n# Authentication - keep these secrets private\nAUTH_ACCESS_SECRET=${randomBytes(32).toString("hex")}\nAUTH_REFRESH_SECRET=${randomBytes(32).toString("hex")}\n` : ""),
+        ".env.example": env + (options.auth ? "\n# Authentication - use private values from .env\nAUTH_ACCESS_SECRET=\nAUTH_REFRESH_SECRET=\n\n# Cloudinary (backend only)\nCLOUDINARY_CLOUD_NAME=\nCLOUDINARY_API_KEY=\nCLOUDINARY_API_SECRET_KEY=\n\n# Password recovery (backend only)\nMAIL_USER=\nMAIL_PASS=\nMAIL_HOST=smtp.gmail.com\nMAIL_PORT=465\n" : ""),
+        ".env": env + (options.auth ? `\n# Authentication - keep these secrets private\nAUTH_ACCESS_SECRET=${randomBytes(32).toString("hex")}\nAUTH_REFRESH_SECRET=${randomBytes(32).toString("hex")}\n\n# Cloudinary (backend only)\nCLOUDINARY_CLOUD_NAME=\nCLOUDINARY_API_KEY=\nCLOUDINARY_API_SECRET_KEY=\n` : ""),
         ...(options.packageManager === "yarn" ? { ".yarnrc.yml": "nodeLinker: node-modules\n" } : {}),
-        "src/config.ts": `const port = Number(process.env.PORT ?? 9149);
-if (!Number.isInteger(port) || port < 0 || port > 65535) throw new Error("PORT must be an integer between 0 and 65535.");
-
-export const config = {
-  port,
-${mongo ? '  mongoUri: process.env.MONGODB_URI ?? "",\n' : ""}};
+        "src/config.ts": `const port = Number(process.env.PORT ?? 9149);
+if (!Number.isInteger(port) || port < 0 || port > 65535) throw new Error("PORT must be an integer between 0 and 65535.");
+
+export const config = {
+  port,
+${mongo ? '  mongoUri: process.env.MONGODB_URI ?? "",\n' : ""}};
 `,
-        "src/app.ts": `import { createApp, requestId, securityHeaders } from "@tilcayo/core";
-import healthRoutes from "./routes/health.routes.js";
-${options.type === "api" ? 'import notesRoutes from "./routes/notes.routes.js";\n' : ""}${options.auth ? 'import authRoutes from "./routes/auth.routes.js";\n' : ""}
-const app = createApp({ middleware: [requestId(), securityHeaders()] });
-app.routes(healthRoutes);
-${options.type === "api" ? "app.routes(notesRoutes);\n" : ""}${options.auth ? "app.routes(authRoutes);\n" : ""}
-export default app;
+        "src/app.ts": `import { createApp, requestId, securityHeaders } from "@tilcayo/core";
+import healthRoutes from "./routes/health.routes.js";
+${options.type === "api" ? 'import notesRoutes from "./routes/notes.routes.js";\n' : ""}${options.auth ? 'import authRoutes from "./routes/auth.routes.js";\n' : ""}${options.admin ? 'import { auth } from "./auth.js";\nimport adminProductsRoutes from "./routes/admin-products.routes.js";\nimport adminOrdersRoutes from "./routes/admin-orders.routes.js";\n' : ""}
+const app = createApp({ middleware: [requestId(), securityHeaders()] });
+app.routes(healthRoutes);
+${options.type === "api" ? "app.routes(notesRoutes);\n" : ""}${options.auth ? "app.routes(authRoutes);\n" : ""}${options.admin ? "app.routes(auth.adminRoutes);\napp.routes(adminProductsRoutes);\napp.routes(adminOrdersRoutes);\n" : ""}
+export default app;
 `,
-        "src/index.ts": `${mongo ? 'import { connectMongo, disconnectMongo } from "@tilcayo/core";\n' : ""}
-async function main() {
-  const { config } = await import("./config.js");
-  const { default: app } = await import("./app.js");
-${mongo ? "  await connectMongo(config.mongoUri);\n" : ""}  const server = app.listen(config.port);
-  const shutdown = () => {
-    const timeout = setTimeout(() => process.exit(1), 10_000);
-    timeout.unref();
-    server.close(() => {
-${mongo ? "      void disconnectMongo().then(() => process.exit(0), () => process.exit(1));" : "      process.exit(0);"}
-    });
-  };
-  process.once("SIGINT", shutdown);
-  process.once("SIGTERM", shutdown);
-}
-
-main().catch(() => {
-  console.error("Unable to start the API. Check .env configuration${mongo ? ", MongoDB connectivity" : ""}${options.auth ? ", and distinct auth secrets of at least 32 bytes each" : ""}.");
-  process.exitCode = 1;
-});
+        "src/index.ts": `${mongo ? 'import { connectMongo, disconnectMongo } from "@tilcayo/core";\n' : ""}
+async function main() {
+  const { config } = await import("./config.js");
+  const { default: app } = await import("./app.js");
+${mongo ? "  await connectMongo(config.mongoUri);\n" : ""}  const server = app.listen(config.port);
+  const shutdown = () => {
+    const timeout = setTimeout(() => process.exit(1), 10_000);
+    timeout.unref();
+    server.close(() => {
+${mongo ? "      void disconnectMongo().then(() => process.exit(0), () => process.exit(1));" : "      process.exit(0);"}
+    });
+  };
+  process.once("SIGINT", shutdown);
+  process.once("SIGTERM", shutdown);
+}
+
+main().catch(() => {
+  console.error("Unable to start the API. Check .env configuration${mongo ? ", MongoDB connectivity" : ""}${options.auth ? ", and distinct auth secrets of at least 32 bytes each" : ""}.");
+  process.exitCode = 1;
+});
 `,
-        "src/controllers/health.controller.ts": `import type { TilcayoContext } from "@tilcayo/core";
-
-export const health = (ctx: TilcayoContext) => ctx.response.success({ status: "ok" });
+        "src/controllers/health.controller.ts": `import type { TilcayoContext } from "@tilcayo/core";
+
+export const health = (ctx: TilcayoContext) => ctx.response.success({ status: "ok" });
 `,
-        "src/routes/health.routes.ts": `import { defineRoutes } from "@tilcayo/core";
-import { health } from "../controllers/health.controller.js";
-
-export default defineRoutes((router) => {
-  router.get("/health", health);
-});
+        "src/routes/health.routes.ts": `import { defineRoutes } from "@tilcayo/core";
+import { health } from "../controllers/health.controller.js";
+
+export default defineRoutes((router) => {
+  router.get("/health", health);
+});
 `,
         "src/models/.gitkeep": "",
         "src/services/.gitkeep": "",
         "src/validators/.gitkeep": "",
-        "README.md": `# ${options.name}
-
-Tilcayo ${options.type === "api" ? "MongoDB CRUD" : "minimal"} API${options.auth ? " with JWT authentication" : ""}.
-${Object.keys(localPackages).length ? "\nTilcayo dependencies link to your local framework checkout. Keep that checkout available and rebuild its packages after framework changes. Replace these links with published versions before moving or sharing this application.\n" : ""}
-
-Use Node.js 22.9+ and ${options.packageManager}. A local .env has been created${options.auth ? " with distinct random auth secrets" : ""}. Keep it private; .env.example contains shareable settings.
-${mongo ? "\nStart MongoDB locally or set MONGODB_URI in .env to your connection string.\n" : ""}
-Install dependencies if you skipped setup:
-
-\`\`\`sh
-${options.packageManager} install
-\`\`\`
-
-With the Tilcayo CLI on PATH:
-
-\`\`\`sh
-tilcayo dev
-tilcayo build
-tilcayo start
-tilcayo routes:list
-\`\`\`
-
-If the CLI is only installed locally, use ${options.packageManager === "npm" ? "npx tilcayo" : `${options.packageManager} exec tilcayo`} with the same commands. Package scripts also expose dev, build, start, and routes.
-
-GET /health returns the application status. The default port is 9149.
-${options.type === "api" ? "\nThe /notes resource includes GET, POST, GET /:id, PUT /:id, and DELETE /:id. Create a note with JSON {\"title\":\"First note\",\"content\":\"Hello\"}. These sample routes are public.\n" : ""}${options.auth ? "\nAuth routes: POST /api/auth/register, /login, /refresh, /logout; GET /api/auth/me. Register with name, email, and password. Send the access token as Authorization: Bearer <token>. Protect other routes with auth.middleware.\n" : ""}
-Register generated routes in src/app.ts. Database connection and server startup live in src/index.ts. Rebuild after changing routes before using routes:list. ${!mongo ? "To add MongoDB resources or auth later, set tilcayo.database to mongo, add the required packages and environment keys, and connect MongoDB in src/index.ts." : ""}
+        "README.md": `# ${options.name}
+
+Tilcayo ${options.type === "api" ? "MongoDB CRUD" : "minimal"} API${options.auth ? " with JWT authentication" : ""}.
+${Object.keys(localPackages).length ? "\nTilcayo dependencies link to your local framework checkout. Keep that checkout available and rebuild its packages after framework changes. Replace these links with published versions before moving or sharing this application.\n" : ""}
+
+Use Node.js 22.9+ and ${options.packageManager}. A local .env has been created${options.auth ? " with distinct random auth secrets" : ""}. Keep it private; .env.example contains shareable settings.
+${mongo ? "\nStart MongoDB locally or set MONGODB_URI in .env to your connection string.\n" : ""}
+Install dependencies if you skipped setup:
+
+\`\`\`sh
+${options.packageManager} install
+\`\`\`
+
+With the Tilcayo CLI on PATH:
+
+\`\`\`sh
+tilcayo dev
+tilcayo build
+tilcayo start
+tilcayo routes:list
+\`\`\`
+
+If the CLI is only installed locally, use ${options.packageManager === "npm" ? "npx tilcayo" : `${options.packageManager} exec tilcayo`} with the same commands. Package scripts also expose dev, build, start, and routes.
+
+GET /health returns the application status. The default port is 9149.
+${options.type === "api" ? "\nThe /notes resource includes GET, POST, GET /:id, PUT /:id, and DELETE /:id. Create a note with JSON {\"title\":\"First note\",\"content\":\"Hello\"}. These sample routes are public.\n" : ""}${options.auth ? "\nAuth routes: POST /api/auth/register, /login, /refresh, /logout; GET /api/auth/me. Register with name, email, and password. Send the access token as Authorization: Bearer <token>. Protect other routes with auth.middleware.\n" : ""}
+Register generated routes in src/app.ts. Database connection and server startup live in src/index.ts. Rebuild after changing routes before using routes:list. ${!mongo ? "To add MongoDB resources or auth later, set tilcayo.database to mongo, add the required packages and environment keys, and connect MongoDB in src/index.ts." : ""}
 `,
     };
 }

package/package.json

@@ -1,26 +1,27 @@
-{
-  "name": "create-tilcayo-app",
-  "version": "0.0.1",
-  "description": "Create a complete Tilcayo API application",
-  "type": "module",
-  "main": "./dist/index.js",
-  "types": "./dist/index.d.ts",
-  "bin": {
-    "create-tilcayo-app": "./dist/bin.js"
-  },
-  "files": [
-    "dist",
-    "README.md"
-  ],
-  "engines": {
-    "node": ">=22.9.0"
-  },
-  "scripts": {
-    "build": "tsc -p tsconfig.json"
-  },
-  "dependencies": {
-    "@clack/prompts": "^1.8.1",
-    "@tilcayo/cli": "^0.0.1",
-    "picocolors": "^1.1.1"
-  }
-}
+{
+  "name": "create-tilcayo-app",
+  "version": "0.0.3",
+  "description": "Create a complete Tilcayo API application",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "bin": {
+    "create-tilcayo-app": "dist/bin.js"
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "engines": {
+    "node": ">=22.9.0"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json && node scripts/bundle-react.mjs",
+    "prepack": "npm run build"
+  },
+  "dependencies": {
+    "@clack/prompts": "^1.8.1",
+    "@tilcayo/cli": "^0.0.3",
+    "picocolors": "^1.1.1"
+  }
+}