@buenojs/bueno 0.8.6 → 0.8.7

package/.claude/settings.local.json

@@ -0,0 +1,9 @@
+{
+  "permissions": {
+    "allow": [
+      "Bash(bunx @buenojs/bueno@latest new test-website --template website --skip-install -y)",
+      "Bash(bun /home/sivaraj/Work/Bueno/bueno/src/cli/bin.ts new test-api --template api --database none --skip-install -y)",
+      "Bash(bun /home/sivaraj/Work/Bueno/bueno/src/cli/bin.ts new test-website --template website --skip-install -y)"
+    ]
+  }
+}

package/README.md

@@ -71,7 +71,7 @@ server.listen(3000);
 
 ### `bueno new <name>`
 
-Create a new Bueno project.
+Create a new Bueno project with automatic frontend setup for fullstack template.
 
 ```bash
 bueno new my-app
@@ -80,9 +80,22 @@ bueno new my-fullstack --template fullstack --framework react
 bueno new my-app --database postgresql --docker
 ```
 
+**Two-Stage Fullstack Creation:**
+When using `--template fullstack`, Bueno creates your project in two stages:
+1. **Stage 1**: Creates the API backend with your chosen database
+2. **Stage 2**: Automatically runs `add:frontend` with your selected framework
+
+```bash
+# Creates API + React frontend together
+bueno new my-app --template fullstack --framework react
+
+# Creates API + Vue frontend together
+bueno new my-app --template fullstack --framework vue --database postgresql
+```
+
 | Option | Default | Description |
 |--------|---------|-------------|
-| `--template` | `default` | Project template (`default`, `minimal`, `fullstack`, `api`) |
+| `--template` | `default` | Project template (`default`, `minimal`, `fullstack`, `api`, `website`) |
 | `--framework` | `react` | Frontend framework (`react`, `vue`, `svelte`, `solid`) |
 | `--database` | `sqlite` | Database type (`sqlite`, `postgresql`, `mysql`) |
 | `--docker` | `false` | Generate Docker configuration |
@@ -91,6 +104,54 @@ bueno new my-app --database postgresql --docker
 | `--skip-git` | `false` | Skip git initialization |
 | `--yes` | `false` | Use default options |
 
+### `bueno add:frontend <framework>`
+
+Add a frontend framework to an existing Bueno project.
+
+```bash
+# Interactive prompt to choose framework
+bueno add:frontend
+
+# Add React frontend
+bueno add:frontend react
+
+# Add Vue frontend
+bueno add:frontend vue
+
+# Add Svelte frontend
+bueno add:frontend svelte
+
+# Add SolidJS frontend
+bueno add:frontend solid
+
+# Skip dependency installation
+bueno add:frontend react --skip-install
+```
+
+**What Gets Added:**
+- `client/` directory with full frontend setup
+- Framework-specific entry point (`main.tsx` or `main.ts`)
+- Example components and styles
+- Tailwind CSS + PostCSS configuration
+- Bun bundler configuration (framework-optimized)
+- TypeScript configuration for client
+- Development scripts: `dev:server`, `dev:client`, `dev` (concurrent)
+- Build script: `build:client`
+
+**Supported Frameworks:**
+| Framework | Entry Point | JSX Mode |
+|-----------|-------------|----------|
+| React | `client/src/main.tsx` | `react-jsx` |
+| Vue | `client/src/main.ts` | N/A |
+| Svelte | `client/src/main.ts` | N/A |
+| SolidJS | `client/src/main.tsx` | `preserve` |
+
+| Option | Default | Description |
+|--------|---------|-------------|
+| `framework` (positional) | (interactive) | Frontend framework (`react`, `vue`, `svelte`, `solid`) |
+| `-f, --framework` | - | Frontend framework as option |
+| `--skip-install` | `false` | Skip dependency installation |
+
 ### `bueno dev`
 
 Start the development server with Hot Module Replacement (HMR).
@@ -978,25 +1039,81 @@ describe('UserController', () => {
 
 ## Frontend Support
 
-Bueno provides first-class support for modern frontend frameworks with SSR, SSG, and Island Architecture.
+Bueno provides first-class support for modern frontend frameworks with built-in Bun bundler integration, SSR, SSG, and Island Architecture.
+
+### Getting Started with Frontend
+
+**Option 1: Two-Stage Fullstack (Recommended)**
+```bash
+# Creates API backend + chosen frontend automatically
+bueno new my-app --template fullstack --framework react
+```
+
+**Option 2: Add Frontend to Existing Project**
+```bash
+bueno add:frontend react
+# or with other frameworks
+bueno add:frontend vue
+bueno add:frontend svelte
+bueno add:frontend solid
+```
 
 ### Supported Frameworks
 
-- **React** - Full support with SSR and hydration
-- **Vue** - Server-side rendering with Vue 3
-- **Svelte** - SvelteKit-like experience
-- **Solid** - SolidJS with SSR
+- **React** - Full support with SSR and hydration, Tailwind CSS included
+- **Vue** - Server-side rendering with Vue 3, Tailwind CSS included
+- **Svelte** - SvelteKit-like experience, Tailwind CSS included
+- **SolidJS** - SolidJS with SSR, Tailwind CSS included
 
-### Features
+### Built-in Features
 
 | Feature | Description |
 |---------|-------------|
-| **SSR** | Server-side rendering for SEO and performance |
-| **SSG** | Static site generation at build time |
-| **ISR** | Incremental Static Regeneration |
-| **Islands** | Interactive components with partial hydration |
-| **File-based Routing** | Automatic route generation from file structure |
-| **HMR** | Hot module replacement for instant updates |
+| **Bun Bundler** | Native Bun bundler with zero additional dependencies |
+| **Tailwind CSS** | Pre-configured with PostCSS and autoprefixer |
+| **TypeScript** | Full TypeScript support for client and server |
+| **HMR** | Hot module replacement for instant updates during development |
+| **Dev Scripts** | Convenient scripts for concurrent server/client development |
+| **Framework-Specific** | Optimized loader configurations for each framework |
+
+### Development Workflow
+
+After creating a fullstack project, you get two development modes:
+
+```bash
+# Terminal 1: Backend API
+bun run dev:server
+
+# Terminal 2: Frontend bundler
+bun run dev:client
+
+# Or run both concurrently
+bun run dev
+```
+
+### Project Structure (Fullstack)
+
+```
+my-bueno-app/
+├── server/              # Backend API
+│   ├── main.ts
+│   ├── modules/
+│   └── database/
+├── client/              # Frontend application
+│   ├── src/
+│   │   ├── main.tsx/main.ts  # Entry point
+│   │   ├── App.tsx/vue/svelte # Main component
+│   │   └── styles/            # Global styles (Tailwind)
+│   ├── public/          # Static assets
+│   ├── index.html       # HTML template
+│   ├── bun.bundler.ts   # Bun bundler config
+│   ├── tailwind.config.ts
+│   ├── postcss.config.js
+│   └── tsconfig.json
+├── bueno.config.ts
+├── package.json
+└── tsconfig.json
+```
 
 ### Example
 
@@ -1129,7 +1246,7 @@ bun dev
 
 ## Links
 
-- **Documentation**: [https://buenojs.dev](https://bueno.github.io)
+- **Documentation**: [https://bueno.github.io](https://bueno.github.io)
 - **GitHub**: [https://github.com/buenojs/bueno](https://github.com/buenojs/bueno)
 - **Issues**: [https://github.com/buenojs/bueno/issues](https://github.com/buenojs/bueno/issues)
 - **npm**: [https://www.npmjs.com/package/@buenojs/bueno](https://www.npmjs.com/package/@buenojs/bueno)

package/dist/cache/index.d.ts

@@ -0,0 +1,187 @@
+/**
+ * Caching Layer
+ *
+ * Unified interface over Bun.redis with in-memory fallback.
+ * Uses Bun 1.3+ native Redis client for production.
+ */
+export interface CacheConfig {
+    driver?: "redis" | "memory";
+    url?: string;
+    ttl?: number;
+    keyPrefix?: string;
+    enableMetrics?: boolean;
+}
+/**
+ * Cache metrics for observability
+ */
+export interface CacheMetrics {
+    hits: number;
+    misses: number;
+    sets: number;
+    deletes: number;
+    errors: number;
+    avgLatency: number;
+    totalOperations: number;
+}
+export interface SessionData {
+    [key: string]: unknown;
+}
+export interface SessionStoreOptions {
+    ttl?: number;
+    prefix?: string;
+    driver?: "redis" | "memory";
+    url?: string;
+}
+export interface PubSubMessage {
+    channel: string;
+    message: string;
+}
+export declare class Cache {
+    private driver;
+    private keyPrefix;
+    private defaultTTL;
+    private _isConnected;
+    private driverType;
+    private enableMetrics;
+    private metrics;
+    private totalLatency;
+    constructor(config?: CacheConfig);
+    /**
+     * Get current metrics snapshot
+     */
+    getMetrics(): CacheMetrics;
+    /**
+     * Reset metrics counters
+     */
+    resetMetrics(): void;
+    /**
+     * Update metrics counters
+     */
+    private updateMetrics;
+    /**
+     * Get current timestamp in milliseconds
+     */
+    private getTimestamp;
+    /**
+     * Connect to cache
+     */
+    connect(): Promise<void>;
+    /**
+     * Disconnect from cache
+     */
+    disconnect(): Promise<void>;
+    /**
+     * Check if connected
+     */
+    get isConnected(): boolean;
+    /**
+     * Get the driver type
+     */
+    getDriverType(): "redis" | "memory";
+    /**
+     * Get a value
+     */
+    get<T = unknown>(key: string): Promise<T | null>;
+    /**
+     * Set a value
+     */
+    set<T>(key: string, value: T, ttl?: number): Promise<void>;
+    /**
+     * Delete a value
+     */
+    delete(key: string): Promise<boolean>;
+    /**
+     * Check if key exists
+     */
+    has(key: string): Promise<boolean>;
+    /**
+     * Increment a value
+     */
+    increment(key: string, by?: number): Promise<number>;
+    /**
+     * Decrement a value
+     */
+    decrement(key: string, by?: number): Promise<number>;
+    /**
+     * Get remaining TTL
+     */
+    ttl(key: string): Promise<number>;
+    /**
+     * Set expiration on a key
+     */
+    expire(key: string, ttl: number): Promise<boolean>;
+    /**
+     * Set multiple values
+     */
+    mset(values: Record<string, unknown>, ttl?: number): Promise<void>;
+    /**
+     * Get multiple values
+     */
+    mget<T = unknown>(keys: string[]): Promise<(T | null)[]>;
+    /**
+     * Clear all keys with prefix
+     */
+    clear(): Promise<void>;
+    /**
+     * Get or set (cache-aside pattern)
+     */
+    getOrSet<T>(key: string, factory: () => Promise<T>, ttl?: number): Promise<T>;
+    /**
+     * Delete multiple keys
+     */
+    mdelete(keys: string[]): Promise<void>;
+    /**
+     * Publish a message to a channel (Redis only)
+     */
+    publish(channel: string, message: string): Promise<number>;
+    /**
+     * Subscribe to a channel (Redis only)
+     */
+    subscribe(channel: string, callback: (message: string) => void): Promise<void>;
+    /**
+     * Remember with lock (prevent cache stampede)
+     */
+    remember<T>(key: string, factory: () => Promise<T>, ttl?: number, lockTimeout?: number): Promise<T>;
+}
+export declare class SessionStore {
+    private cache;
+    private ttl;
+    constructor(options?: SessionStoreOptions);
+    /**
+     * Initialize the session store
+     */
+    init(): Promise<void>;
+    /**
+     * Create a new session
+     */
+    create(data: SessionData): Promise<string>;
+    /**
+     * Get session data
+     */
+    get(sessionId: string): Promise<SessionData | null>;
+    /**
+     * Update session data
+     */
+    update(sessionId: string, data: SessionData): Promise<void>;
+    /**
+     * Delete a session
+     */
+    delete(sessionId: string): Promise<void>;
+    /**
+     * Refresh session TTL
+     */
+    refresh(sessionId: string): Promise<boolean>;
+    /**
+     * Check if session exists
+     */
+    has(sessionId: string): Promise<boolean>;
+}
+/**
+ * Create a cache instance
+ */
+export declare function createCache(config?: CacheConfig): Cache;
+/**
+ * Create a session store
+ */
+export declare function createSessionStore(options?: SessionStoreOptions): SessionStore;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/cache/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,MAAM,WAAW,WAAW;IAC3B,MAAM,CAAC,EAAE,OAAO,GAAG,QAAQ,CAAC;IAC5B,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,aAAa,CAAC,EAAE,OAAO,CAAC;CACxB;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,eAAe,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,WAAW;IAC3B,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACvB;AAED,MAAM,WAAW,mBAAmB;IACnC,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,OAAO,GAAG,QAAQ,CAAC;IAC5B,GAAG,CAAC,EAAE,MAAM,CAAC;CACb;AAED,MAAM,WAAW,aAAa;IAC7B,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;CAChB;AAgRD,qBAAa,KAAK;IACjB,OAAO,CAAC,MAAM,CAAc;IAC5B,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,YAAY,CAAS;IAC7B,OAAO,CAAC,UAAU,CAAqB;IACvC,OAAO,CAAC,aAAa,CAAU;IAG/B,OAAO,CAAC,OAAO,CAQb;IACF,OAAO,CAAC,YAAY,CAAK;gBAEb,MAAM,GAAE,WAAgB;IAapC;;OAEG;IACH,UAAU,IAAI,YAAY;IAI1B;;OAEG;IACH,YAAY,IAAI,IAAI;IAapB;;OAEG;IACH,OAAO,CAAC,aAAa;IAqCrB;;OAEG;IACH,OAAO,CAAC,YAAY;IASpB;;OAEG;IACG,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAO9B;;OAEG;IACG,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAejC;;OAEG;IACH,IAAI,WAAW,IAAI,OAAO,CAEzB;IAED;;OAEG;IACH,aAAa,IAAI,OAAO,GAAG,QAAQ;IAInC;;OAEG;IACG,GAAG,CAAC,CAAC,GAAG,OAAO,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC;IA6BtD;;OAEG;IACG,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAiBhE;;OAEG;IACG,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAgB3C;;OAEG;IACG,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAKxC;;OAEG;IACG,SAAS,CAAC,GAAG,EAAE,MAAM,EAAE,EAAE,SAAI,GAAG,OAAO,CAAC,MAAM,CAAC;IAYrD;;OAEG;IACG,SAAS,CAAC,GAAG,EAAE,MAAM,EAAE,EAAE,SAAI,GAAG,OAAO,CAAC,MAAM,CAAC;IAIrD;;OAEG;IACG,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAQvC;;OAEG;IACG,MAAM,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAQxD;;OAEG;IACG,IAAI,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAMxE;;OAEG;IACG,IAAI,CAAC,CAAC,GAAG,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,EAAE,CAAC;IAI9D;;OAEG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAI5B;;OAEG;IACG,QAAQ,CAAC,CAAC,EACf,GAAG,EAAE,MAAM,EACX,OAAO,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EACzB,GAAG,CAAC,EAAE,MAAM,GACV,OAAO,CAAC,CAAC,CAAC;IAYb;;OAEG;IACG,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAM5C;;OAEG;IACG,OAAO,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAQhE;;OAEG;IACG,SAAS,CACd,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,GACjC,OAAO,CAAC,IAAI,CAAC;IAOhB;;OAEG;IACG,QAAQ,CAAC,CAAC,EACf,GAAG,EAAE,MAAM,EACX,OAAO,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EACzB,GAAG,CAAC,EAAE,MAAM,EACZ,WAAW,SAAK,GACd,OAAO,CAAC,CAAC,CAAC;CA4Bb;AAID,qBAAa,YAAY;IACxB,OAAO,CAAC,KAAK,CAAQ;IACrB,OAAO,CAAC,GAAG,CAAS;gBAER,OAAO,GAAE,mBAAwB;IAU7C;;OAEG;IACG,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAI3B;;OAEG;IACG,MAAM,CAAC,IAAI,EAAE,WAAW,GAAG,OAAO,CAAC,MAAM,CAAC;IAMhD;;OAEG;IACG,GAAG,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC;IAIzD;;OAEG;IACG,MAAM,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC;IAOjE;;OAEG;IACG,MAAM,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAI9C;;OAEG;IACG,OAAO,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IASlD;;OAEG;IACG,GAAG,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;CAG9C;AAID;;GAEG;AACH,wBAAgB,WAAW,CAAC,MAAM,CAAC,EAAE,WAAW,GAAG,KAAK,CAGvD;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CACjC,OAAO,CAAC,EAAE,mBAAmB,GAC3B,YAAY,CAEd"}

package/dist/cli/bin.d.ts

@@ -0,0 +1,8 @@
+#!/usr/bin/env bun
+/**
+ * Bueno CLI Executable
+ *
+ * This is the entry point for the CLI when installed globally or run via npx
+ */
+export {};
+//# sourceMappingURL=bin.d.ts.map

package/dist/cli/bin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bin.d.ts","sourceRoot":"","sources":["../../src/cli/bin.ts"],"names":[],"mappings":";AACA;;;;GAIG"}