@nilejs/cli 0.0.3 → 0.0.5

package/README.md

@@ -2,7 +2,7 @@
 
 [![NPM Version](https://img.shields.io/npm/v/@nilejs/cli.svg)](https://www.npmjs.com/package/@nilejs/cli)
 
-CLI for scaffolding and generating [Nile](https://www.npmjs.com/package/@nilejs/nile) backend projects.
+CLI for scaffolding and generating [Nile](https://github.com/nile-js/nile/tree/main/packages/nile) backend projects.
 
 ## Install
 
@@ -60,12 +60,12 @@ The scaffolded project includes:
 
 ### `nile generate service <name>`
 
-Alias: `nile g service <name>`
+Alias: `nile gen service <name>`
 
 Generate a new service directory under `src/services/` with a demo action and barrel export. Run this from the project root.
 
 ```bash
-nile g service users
+nile gen service users
 ```
 
 Creates:
@@ -80,12 +80,12 @@ After creating the files, the CLI asks whether to auto-register the service in `
 
 ### `nile generate action <service-name> <action-name>`
 
-Alias: `nile g action <service-name> <action-name>`
+Alias: `nile gen action <service-name> <action-name>`
 
 Generate a new action file in an existing service directory.
 
 ```bash
-nile g action users get-user
+nile gen action users get-user
 ```
 
 Creates `src/services/users/get-user.ts` with:
@@ -116,12 +116,12 @@ Kebab-case names are converted to camelCase for variables and PascalCase for typ
 
 ### `nile generate schema`
 
-Alias: `nile g schema`
+Alias: `nile gen schema`
 
 Extract Zod validation schemas from your action definitions and generate TypeScript files with schema exports and inferred types.
 
 ```bash
-nile g schema
+nile gen schema
 ```
 
 The command auto-detects `src/services/services.config.ts`. If the file is not found, it prompts for the path. It spawns a `bun` subprocess to import your services config, extracts JSON Schema from each action's validation field, and converts them back to Zod code strings.
@@ -147,9 +147,9 @@ Requires [Bun](https://bun.sh) installed for the extraction subprocess.
 | Command | Description |
 |---|---|
 | `nile new <name>` | Scaffold a new project |
-| `nile g service <name>` | Add a service with a demo action |
-| `nile g action <service> <name>` | Add an action to an existing service |
-| `nile g schema` | Generate Zod schemas and TypeScript types |
+| `nile gen service <name>` | Add a service with a demo action |
+| `nile gen action <service> <name>` | Add an action to an existing service |
+| `nile gen schema` | Generate Zod schemas and TypeScript types |
 
 ## Generated Project Structure
 

package/dist/index.js

@@ -1,6 +1,7 @@
 #!/usr/bin/env node
 
 // src/index.ts
+import { resolve as resolve6 } from "node:path";
 import { Command } from "commander";
 
 // src/commands/generate-action.ts
@@ -237,14 +238,30 @@ var generateTypesFile = (extraction) => {
     generateHeader(),
     `import type { z } from "zod";`,
     "import type {",
-    ...schemaImports.map((name, i) => i < schemaImports.length - 1 ? `  ${name},` : `  ${name},`),
-    `} from "./schemas";`,
+    ...schemaImports.map((name) => `  ${name},`),
+    `} from "./schemas.js";`,
     ""
   ];
   for (const entry of entries) {
     lines.push(`export type ${entry.typeName} = z.infer<typeof ${entry.exportName}>;`);
   }
   lines.push("");
+  lines.push("/** Map of all services and their action payloads for @nilejs/client */");
+  lines.push("export type ServicePayloads = {");
+  const serviceMap = {};
+  for (const entry of entries) {
+    if (!serviceMap[entry.serviceName]) {
+      serviceMap[entry.serviceName] = [];
+    }
+    serviceMap[entry.serviceName].push(`    "${entry.actionName}": ${entry.typeName};`);
+  }
+  for (const [service, actions] of Object.entries(serviceMap)) {
+    lines.push(`  "${service}": {`);
+    lines.push(...actions);
+    lines.push("  };");
+  }
+  lines.push("};");
+  lines.push("");
   return lines.join(`
 `);
 };
@@ -587,10 +604,18 @@ var newCommand = async (projectName) => {
 };
 
 // src/index.ts
+var ensureDepsInstalled = () => {
+  const nodeModulesPath = resolve6(process.cwd(), "node_modules");
+  if (!pathExists(nodeModulesPath)) {
+    error("Dependencies not installed.");
+    hint("Run 'bun install' first, then try again.");
+    process.exit(1);
+  }
+};
 var program = new Command;
 program.name("nile").description("CLI for the Nile backend framework").version("0.0.1");
 program.command("new").argument("<project-name>", "Name of the project to create").description("Scaffold a new Nile project").action(newCommand);
-var generate = program.command("generate").alias("g").description("Generate services and actions");
+var generate = program.command("generate").alias("gen").description("Generate services and actions").hook("preAction", ensureDepsInstalled);
 generate.command("service").argument("<name>", "Service name (kebab-case recommended)").description("Generate a new service with a demo action").action(generateServiceCommand);
 generate.command("action").argument("<service-name>", "Name of the existing service").argument("<action-name>", "Name of the action to create").description("Generate a new action in an existing service").action(generateActionCommand);
 generate.command("schema").option("-e, --entry <path>", "Path to services config file").option("-o, --output <path>", "Output directory for generated files").description("Generate Zod schemas and TypeScript types from action validations").action(generateSchemaCommand);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nilejs/cli",
-  "version": "0.0.3",
+  "version": "0.0.5",
   "description": "CLI for scaffolding and generating Nile backend projects",
   "type": "module",
   "bin": {
@@ -10,10 +10,6 @@
     "dist",
     "template"
   ],
-  "scripts": {
-    "build": "bun run scripts/build.ts",
-    "dev": "bun run src/index.ts"
-  },
   "dependencies": {
     "commander": "^13.1.0",
     "json-schema-to-zod": "^2.7.0",
@@ -22,5 +18,9 @@
   "devDependencies": {
     "@types/node": "^22.8.1",
     "typescript": "^5"
+  },
+  "scripts": {
+    "build": "bun run scripts/build.ts",
+    "dev": "bun run src/index.ts"
   }
-}
+}

package/template/.env.example

@@ -1 +1 @@
-MODE=dev
+# Add your environment variables here

package/template/README.md

@@ -1,6 +1,6 @@
 # {{projectName}}
 
-Built with [Nile](https://www.npmjs.com/package/@nilejs/nile).
+Built with [Nile](https://github.com/nile-js/nile).
 
 ## Setup
 
@@ -17,6 +17,9 @@ The server starts at `http://localhost:8000`. PGLite creates an embedded Postgre
 | Script | Description |
 |---|---|
 | `bun run dev` | Start the development server |
+| `bun run gen service <name>` | Generate a new service |
+| `bun run gen action <service> <name>` | Generate a new action |
+| `bun run gen schema` | Generate Zod schemas and TypeScript types |
 | `bun run db:generate` | Generate Drizzle migrations from schema changes |
 | `bun run db:push` | Push schema changes directly to the database |
 | `bun run db:studio` | Open Drizzle Studio to browse your data |
@@ -77,8 +80,7 @@ curl -X POST http://localhost:8000/api/services \
 Generate a new service with the CLI:
 
 ```bash
-nile generate service users
-# or: nile g service users
+bun run gen service users
 ```
 
 Or manually create a directory under `src/services/` with action files and register it in `src/services/services.config.ts`.
@@ -88,8 +90,7 @@ Or manually create a directory under `src/services/` with action files and regis
 Generate a new action in an existing service:
 
 ```bash
-nile generate action users get-user
-# or: nile g action users get-user
+bun run gen action users get-user
 ```
 
 Each action file exports a single action created with `createAction`, which takes a Zod validation schema and a handler function that returns `Ok(data)` or `Err(message)`.
@@ -99,8 +100,7 @@ Each action file exports a single action created with `createAction`, which take
 Extract Zod validation schemas from your actions and generate TypeScript types:
 
 ```bash
-nile generate schema
-# or: nile g schema
+bun run gen schema
 ```
 
 This auto-detects `src/services/services.config.ts`, reads validation schemas from all actions, and outputs two files:
@@ -126,7 +126,7 @@ See the [Drizzle getting started guide](https://orm.drizzle.team/docs/get-starte
 ## Tech Stack
 
 - **Runtime:** [Bun](https://bun.sh)
-- **Framework:** [@nilejs/nile](https://www.npmjs.com/package/@nilejs/nile)
+- **Framework:** [@nilejs/nile](https://github.com/nile-js/nile/tree/main/packages/nile)
 - **Database:** [PGLite](https://electric-sql.com/product/pglite) (embedded Postgres)
 - **ORM:** [Drizzle](https://orm.drizzle.team)
 - **Validation:** [Zod](https://zod.dev)

package/template/package.json

@@ -5,6 +5,7 @@
   "private": true,
   "scripts": {
     "dev": "bun run src/index.ts",
+    "gen": "bunx @nilejs/cli generate",
     "db:generate": "bunx drizzle-kit generate",
     "db:push": "bunx drizzle-kit push",
     "db:studio": "bunx drizzle-kit studio"

package/template/src/index.ts

@@ -4,12 +4,12 @@ import { safeTry } from "slang-ts";
 import { db } from "@/db/client";
 import { services } from "@/services/services.config";
 
-const logger = createLogger("{{projectName}}", { chunking: "monthly" });
+const logger = createLogger("{{projectName}}", {
+  mode: "dev",
+  chunking: "monthly",
+});
 
-/**
- * Push schema to PGLite on boot.
- * Creates the tasks table if it doesn't exist.
- */
+/** Push schema to PGLite on boot */
 const pushSchema = async () => {
   const result = await safeTry(() =>
     db.execute(sql`
@@ -39,29 +39,32 @@ const server = createNileServer({
     port: 8000,
     allowedOrigins: ["http://localhost:8000"],
     enableStatus: true,
+    discovery: { enabled: true },
   },
   onBoot: {
-    fn: async () => {
+    fn: async (ctx) => {
       await pushSchema();
-      logger.info({
+      ctx.resources?.logger?.info({
         atFunction: "onBoot",
-        message: "{{projectName}} booted — PGLite schema ready",
+        message: "{{projectName}} booted - PGLite schema ready",
       });
     },
   },
 });
 
+// Register custom middleware (runs before all service requests)
+server.rest?.addMiddleware("/api", async (c, next) => {
+  const start = performance.now();
+  await next();
+  const ms = (performance.now() - start).toFixed(1);
+  logger.info({
+    atFunction: "requestLog",
+    message: `${c.req.method} ${c.req.path} - ${ms}ms`,
+  });
+});
+
 if (server.rest) {
   const port = server.config.rest?.port ?? 8000;
-  const { fetch } = server.rest.app;
-
-  Bun.serve({ port, fetch });
-
-  console.log(`\n{{projectName}} listening on http://localhost:${port}`);
-  console.log("\nTry it:");
-  console.log(`  curl -X POST http://localhost:${port}/api/services \\`);
-  console.log(`    -H "Content-Type: application/json" \\`);
-  console.log(
-    `    -d '{"intent":"explore","service":"*","action":"*","payload":{}}'`
-  );
+  Bun.serve({ port, fetch: server.rest.app.fetch });
+  console.log(`\n{{projectName}} listening on http://localhost:${port}\n`);
 }