@donkeylabs/cli 1.1.11 → 1.1.13

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@donkeylabs/cli",
-  "version": "1.1.11",
+  "version": "1.1.13",
   "type": "module",
   "description": "CLI for @donkeylabs/server - project scaffolding and code generation",
   "main": "./src/index.ts",

package/templates/starter/.env.example

@@ -1,3 +1,44 @@
-DATABASE_URL=app.db
+# =============================================================================
+# DATABASE
+# =============================================================================
+
+# SQLite database path (relative to project root)
+# Use ":memory:" for in-memory database during development
+DATABASE_URL=":memory:"
+
+# For production, use a file path:
+# DATABASE_URL="./data/app.db"
+
+# =============================================================================
+# SERVER
+# =============================================================================
+
+# Port for the API server
 PORT=3000
+
+# Node environment
 NODE_ENV=development
+
+# =============================================================================
+# AUTHENTICATION (if using auth plugin)
+# =============================================================================
+
+# JWT secret for signing tokens (generate with: openssl rand -base64 32)
+# JWT_SECRET=your-secret-key-here
+
+# =============================================================================
+# EXTERNAL SERVICES (examples)
+# =============================================================================
+
+# Email service
+# RESEND_API_KEY=re_xxxxxxxxxxxx
+
+# Payment processing
+# STRIPE_SECRET_KEY=sk_test_xxxxxxxxxxxx
+
+# =============================================================================
+# FEATURE FLAGS
+# =============================================================================
+
+# Enable debug logging
+# DEBUG=true

package/templates/sveltekit-app/.env.example

@@ -1,3 +1,57 @@
-PORT=3000
-DATABASE_URL=app.db
+# =============================================================================
+# DATABASE
+# =============================================================================
+
+# SQLite database path (relative to project root)
+# Use ":memory:" for in-memory database during development
+DATABASE_URL=":memory:"
+
+# For production, use a file path:
+# DATABASE_URL="./data/app.db"
+
+# =============================================================================
+# SERVER
+# =============================================================================
+
+# Port for the API server (optional, defaults to 3000)
+# PORT=3000
+
+# Node environment
 NODE_ENV=development
+
+# =============================================================================
+# AUTHENTICATION (if using auth plugin)
+# =============================================================================
+
+# JWT secret for signing tokens (generate with: openssl rand -base64 32)
+# JWT_SECRET=your-secret-key-here
+
+# Session duration in seconds (default: 7 days)
+# SESSION_DURATION=604800
+
+# =============================================================================
+# EXTERNAL SERVICES (examples)
+# =============================================================================
+
+# Email service (e.g., Resend, SendGrid)
+# RESEND_API_KEY=re_xxxxxxxxxxxx
+
+# Payment processing (e.g., Stripe)
+# STRIPE_SECRET_KEY=sk_test_xxxxxxxxxxxx
+# STRIPE_WEBHOOK_SECRET=whsec_xxxxxxxxxxxx
+
+# File storage (e.g., S3, Cloudflare R2)
+# S3_BUCKET=my-bucket
+# S3_REGION=us-east-1
+# S3_ACCESS_KEY=xxxxxxxxxxxx
+# S3_SECRET_KEY=xxxxxxxxxxxx
+
+# =============================================================================
+# FEATURE FLAGS
+# =============================================================================
+
+# Enable debug logging
+# DEBUG=true
+
+# Enable SSE real-time updates
+# ENABLE_SSE=true

package/templates/sveltekit-app/package.json

@@ -31,6 +31,7 @@
     "clsx": "^2.1.1",
     "kysely": "^0.27.6",
     "kysely-bun-sqlite": "^0.3.2",
+    "runed": "^0.23.4",
     "tailwind-merge": "^3.4.0",
     "tailwind-variants": "^3.2.2",
     "zod": "^3.24.0"

package/templates/sveltekit-app/src/server/index.ts

@@ -6,6 +6,7 @@ import { Database } from "bun:sqlite";
 import { demoPlugin } from "./plugins/demo";
 import { workflowDemoPlugin } from "./plugins/workflow-demo";
 import demoRoutes from "./routes/demo";
+import { exampleRouter } from "./routes/example";
 
 // Simple in-memory database
 const db = new Kysely<{}>({
@@ -27,6 +28,7 @@ server.registerPlugin(workflowDemoPlugin);
 
 // Register routes
 server.use(demoRoutes);
+server.use(exampleRouter);
 
 // Handle CLI type generation (must be after routes are registered)
 server.handleGenerateMode();

package/templates/sveltekit-app/src/server/routes/example/example.schemas.ts

@@ -0,0 +1,22 @@
+import { z } from "zod";
+
+// =============================================================================
+// GREETING SCHEMAS
+// =============================================================================
+
+export const greetInputSchema = z.object({
+  name: z.string().min(1, "Name is required"),
+  formal: z.boolean().optional().default(false),
+});
+
+export const greetOutputSchema = z.object({
+  message: z.string(),
+  timestamp: z.string(),
+});
+
+// =============================================================================
+// DERIVED TYPES
+// =============================================================================
+
+export type GreetInput = z.infer<typeof greetInputSchema>;
+export type GreetOutput = z.infer<typeof greetOutputSchema>;

package/templates/sveltekit-app/src/server/routes/example/handlers/greet.handler.ts

@@ -0,0 +1,23 @@
+import type { Handler, Routes, AppContext } from "$server/api";
+
+/**
+ * Greet Handler
+ *
+ * Example handler demonstrating the feature module pattern.
+ * Business logic lives directly in the handler - no separate model layer needed.
+ */
+export class GreetHandler implements Handler<Routes.Example.Greet> {
+  constructor(private ctx: AppContext) {}
+
+  handle(input: Routes.Example.Greet.Input): Routes.Example.Greet.Output {
+    // Business logic directly in handler
+    const greeting = input.formal
+      ? `Good day, ${input.name}. How may I assist you?`
+      : `Hey ${input.name}!`;
+
+    return {
+      message: greeting,
+      timestamp: new Date().toISOString(),
+    };
+  }
+}

package/templates/sveltekit-app/src/server/routes/example/index.ts

@@ -0,0 +1,28 @@
+/**
+ * Example Router - Demonstrates the feature module pattern
+ *
+ * Feature modules organize app-specific routes with:
+ * - Thin router (just wiring)
+ * - Handler classes with business logic
+ * - Schemas in separate file
+ *
+ * Structure:
+ *   routes/example/
+ *   ├── index.ts              <- Router (this file)
+ *   ├── example.schemas.ts    <- Zod schemas + types
+ *   └── handlers/
+ *       └── greet.handler.ts  <- Handler with business logic
+ */
+
+import { createRouter } from "@donkeylabs/server";
+import { greetInputSchema, greetOutputSchema } from "./example.schemas";
+import { GreetHandler } from "./handlers/greet.handler";
+
+export const exampleRouter = createRouter("example")
+
+  // Simple greeting route
+  .route("greet").typed({
+    input: greetInputSchema,
+    output: greetOutputSchema,
+    handle: GreetHandler,
+  });