@etus/bhono-app 0.1.5 → 0.1.7

package/templates/base/README.md

@@ -52,7 +52,7 @@ This boilerplate provides everything you need to build a modern, secure, and sca
 - Rate limiting middleware (in-memory with lazy cleanup)
 - CSRF protection via SameSite cookies
 - XSS prevention with secure headers
-- SQL injection protection via Drizzle ORM
+- SQL injection protection via parameterized queries
 
 ### Testing
 - Unit tests with Vitest (94%+ coverage)
@@ -73,7 +73,7 @@ This boilerplate provides everything you need to build a modern, secure, and sca
 | **Backend** | Hono.js 4.6 |
 | **Frontend** | React 19 + TanStack Router |
 | **Database** | Cloudflare D1 (SQLite) |
-| **ORM** | Drizzle ORM |
+| **Data Access** | SQL helpers (D1) |
 | **Sessions** | Cloudflare KV |
 | **Storage** | Cloudflare R2 |
 | **Styling** | Tailwind CSS 4.0 |
@@ -96,8 +96,8 @@ This boilerplate provides everything you need to build a modern, secure, and sca
 
 ```bash
 # Clone the repository
-git clone https://github.com/your-org/{{projectName}}.git
-cd {{projectName}}
+git clone https://github.com/your-org/hono-boilerplate.git
+cd hono-boilerplate
 
 # Install dependencies
 pnpm install
@@ -105,11 +105,11 @@ pnpm install
 # Copy environment variables
 cp .env.example .env
 
-# Apply database migrations
-pnpm db:migrate:local
+# Apply database schema
+pnpm db:schema:local
 
 # Seed test data (optional)
-pnpm db:seed
+pnpm db:seed:local
 
 # Start development server
 pnpm dev
@@ -152,7 +152,6 @@ LOG_LEVEL=info
 ├── config/                     # Configuration files
 │   ├── eslint.config.js        # ESLint configuration
 │   ├── wrangler.json           # Cloudflare Workers config
-│   ├── drizzle.config.ts       # Drizzle ORM config
 │   └── ...
 │
 ├── src/
@@ -166,8 +165,11 @@ LOG_LEVEL=info
 │   │   │   └── storage/        # File storage (R2)
 │   │   ├── services/           # Business logic
 │   │   ├── middleware/         # Request middleware
-│   │   ├── db/                 # Database (Drizzle ORM)
-│   │   │   └── schema/         # Table definitions
+│   │   ├── db/                 # Database (SQL helpers)
+│   │   │   ├── client.ts       # D1 client wrapper
+│   │   │   ├── records.ts      # Record typings (SQL results)
+│   │   │   ├── sql.ts          # Query helpers (queryOne/queryAll/execute)
+│   │   │   └── seed.ts         # Seed generator (seed.sql)
 │   │   ├── auth/               # Roles, permissions, guards
 │   │   └── lib/                # Utilities
 │   │
@@ -209,7 +211,8 @@ LOG_LEVEL=info
 ├── docs/                       # Documentation
 │   └── testing.md              # Testing guide
 │
-└── migrations/                 # D1 SQL migrations
+├── schema.sql                  # D1 schema (source of truth)
+└── seed.sql                    # Generated seed data
 ```
 
 ---
@@ -234,6 +237,8 @@ pnpm dlx @etus/bhono-app <project-name>
 npm init bhono-app <project-name>
 ```
 
+If the CLI cannot find local templates, it will clone the default Bhono template repo. You can override this by setting `BHONO_TEMPLATE_REPO` (or `ETUS_TEMPLATE_REPO`) to a git URL.
+
 ---
 
 ## Database Schema
@@ -300,14 +305,20 @@ invitations (
 )
 ```
 
-### Migrations
+### Database Schema
 
 ```bash
-# Apply migrations locally
-pnpm db:migrate:local
+# Apply schema.sql locally
+pnpm db:schema:local
+
+# Apply schema.sql to production (optional)
+pnpm db:schema:remote
+
+# Generate + seed locally
+pnpm db:seed:local
 
-# Apply migrations to production
-pnpm db:migrate:remote
+# Full reset (schema + seed)
+pnpm db:reset:local
 
 # Generate Cloudflare types
 pnpm cf-typegen
@@ -474,17 +485,17 @@ wrangler deploy --config config/wrangler.json
 
 ```json
 {
-  "name": "{{projectName}}",
+  "name": "hono-boilerplate",
   "main": "../src/server/index.ts",
   "compatibility_date": "2025-01-01",
   "compatibility_flags": ["nodejs_compat"],
   "d1_databases": [{
     "binding": "DB",
-    "database_name": "{{projectName}}-db"
+    "database_name": "boilerplate-db"
   }],
   "r2_buckets": [{
     "binding": "R2_BUCKET",
-    "bucket_name": "{{projectName}}-storage"
+    "bucket_name": "boilerplate-storage"
   }],
   "kv_namespaces": [{
     "binding": "SESSIONS",
@@ -505,10 +516,10 @@ wrangler deploy --config config/wrangler.json
 
 ```bash
 # Create D1 database
-wrangler d1 create {{projectName}}-db
+wrangler d1 create boilerplate-db
 
 # Create R2 bucket
-wrangler r2 bucket create {{projectName}}-storage
+wrangler r2 bucket create boilerplate-storage
 
 # Create KV namespace
 wrangler kv:namespace create SESSIONS
@@ -556,7 +567,7 @@ Client (React SPA)
 │              │                    │
 │              ▼                    │
 │  ┌─────────────────────────────┐  │
-│  │      Drizzle ORM            │  │
+│  │      SQL Helpers            │  │
 │  └─────────────────────────────┘  │
 │              │                    │
 └──────────────┼────────────────────┘
@@ -586,9 +597,11 @@ import { createUser } from '@server/services/users'  // Server
 | `pnpm lint` | Run ESLint |
 | `pnpm typecheck` | Run TypeScript checks |
 | **Database** | |
-| `pnpm db:migrate:local` | Apply local migrations |
-| `pnpm db:migrate:remote` | Apply remote migrations |
-| `pnpm db:seed` | Seed database |
+| `pnpm db:schema:local` | Apply schema.sql locally |
+| `pnpm db:schema:remote` | Apply schema.sql remotely |
+| `pnpm db:seed` | Generate seed.sql |
+| `pnpm db:seed:local` | Generate + seed locally |
+| `pnpm db:reset:local` | Apply schema + seed locally |
 | `pnpm cf-typegen` | Generate Cloudflare types |
 | **API** | |
 | `pnpm api:spec` | Generate OpenAPI spec (docs/openapi.json) |
@@ -614,7 +627,7 @@ import { createUser } from '@server/services/users'  // Server
 - **CSRF**: SameSite cookies + CORS validation
 - **XSS**: Secure headers + React's built-in escaping
 - **Session Hijacking**: httpOnly cookies, secure flag in production
-- **SQL Injection**: Parameterized queries via Drizzle ORM
+- **SQL Injection**: Parameterized queries via SQL helpers
 - **Rate Limiting**: In-memory store with configurable limits per route
 - **Fingerprint Validation**: User-agent validation for sessions
 
@@ -663,7 +676,7 @@ MIT License - see [LICENSE](LICENSE) for details.
 ## Acknowledgments
 
 - [Hono.js](https://hono.dev/) - Ultrafast web framework
-- [Drizzle ORM](https://orm.drizzle.team/) - TypeScript ORM
+- [Cloudflare D1](https://developers.cloudflare.com/d1/) - Serverless SQLite
 - [TanStack Router](https://tanstack.com/router) - Type-safe routing
 - [Tailwind CSS](https://tailwindcss.com/) - Utility-first CSS
 - [Cloudflare Workers](https://workers.cloudflare.com/) - Edge computing platform

package/templates/base/config/eslint.config.js

@@ -37,6 +37,7 @@ export default tseslint.config(
       "**/.pnpm*",
       "**/config/**",
       "**/.test-output/**",
+      "**/scripts/**",
     ],
   },
 

package/templates/base/config/wrangler.json

@@ -1,31 +1,30 @@
 {
   "$schema": "../node_modules/wrangler/config-schema.json",
-  "name": "{{projectName}}",
+  "name": "hono-boilerplate",
+  "account_id": "10ca68c044521baa536840a17160933b",
   "main": "../src/server/index.ts",
   "compatibility_date": "2025-01-01",
-  "compatibility_flags": [
-    "nodejs_compat"
-  ],
+  "compatibility_flags": ["nodejs_compat"],
   "dev": {
     "port": 3000
   },
   "d1_databases": [
     {
       "binding": "DB",
-      "database_name": "{{projectName}}-db",
-      "database_id": "TO_BE_PROVISIONED"
+      "database_name": "boilerplate-db",
+      "database_id": "a9de77f8-3189-41d9-84dd-a38d3c9c27bd"
     }
   ],
   "r2_buckets": [
     {
       "binding": "R2_BUCKET",
-      "bucket_name": "{{projectName}}-storage"
+      "bucket_name": "boilerplate-storage"
     }
   ],
   "kv_namespaces": [
     {
       "binding": "SESSIONS",
-      "id": "TO_BE_PROVISIONED"
+      "id": "3dea2b79495f490ca088a18c6bab6b38"
     }
   ],
   "assets": {
@@ -39,36 +38,36 @@
   },
   "vars": {
     "ENVIRONMENT": "production",
-    "APP_URL": "https://{{projectName}}.a3s.workers.dev",
-    "GOOGLE_REDIRECT_URI": "https://{{projectName}}.a3s.workers.dev/auth/callback",
+    "APP_URL": "https://hono-boilerplate.a3s.workers.dev",
+    "GOOGLE_REDIRECT_URI": "https://hono-boilerplate.a3s.workers.dev/auth/callback",
     "R2_PUBLIC_URL": "https://pub-your-bucket-id.r2.dev"
   },
   "env": {
     "staging": {
-      "name": "{{projectName}}-staging",
+      "name": "hono-boilerplate-staging",
       "d1_databases": [
         {
           "binding": "DB",
-          "database_name": "{{projectName}}-db-staging",
-          "database_id": "TO_BE_PROVISIONED"
+          "database_name": "boilerplate-db-staging",
+          "database_id": "2fe5e1b5-8168-4024-9060-be7972380228"
         }
       ],
       "kv_namespaces": [
         {
           "binding": "SESSIONS",
-          "id": "TO_BE_PROVISIONED"
+          "id": "c341542f0efd466a93b65e6cadf1f9ba"
         }
       ],
       "r2_buckets": [
         {
           "binding": "R2_BUCKET",
-          "bucket_name": "{{projectName}}-storage-staging"
+          "bucket_name": "boilerplate-storage-staging"
         }
       ],
       "vars": {
         "ENVIRONMENT": "staging",
-        "APP_URL": "https://{{projectName}}-staging.a3s.workers.dev",
-        "GOOGLE_REDIRECT_URI": "https://{{projectName}}-staging.a3s.workers.dev/auth/callback",
+        "APP_URL": "https://hono-boilerplate-staging.a3s.workers.dev",
+        "GOOGLE_REDIRECT_URI": "https://hono-boilerplate-staging.a3s.workers.dev/auth/callback",
         "R2_PUBLIC_URL": "https://pub-your-bucket-id.r2.dev"
       }
     }