@dewtech/dare-cli 3.0.0 → 3.1.0

package/templates/stacks/go-stdlib/internal/handler/auth_handler.go.tpl

@@ -0,0 +1,71 @@
+// Package handler — net/http handlers.
+package handler
+
+import (
+	"context"
+	"errors"
+	"net/http"
+	"strings"
+
+	"{{moduleName}}/internal/config"
+	"{{moduleName}}/internal/httpx"
+	"{{moduleName}}/internal/middleware"
+	"{{moduleName}}/internal/service"
+)
+
+type AuthHandler struct {
+	auth  *service.AuthService
+	users *service.UsersService
+	cfg   *config.Config
+}
+
+func NewAuthHandler(a *service.AuthService, u *service.UsersService, cfg *config.Config) *AuthHandler {
+	return &AuthHandler{auth: a, users: u, cfg: cfg}
+}
+
+type loginBody struct {
+	Email    string `json:"email"`
+	Password string `json:"password"`
+}
+
+func (h *AuthHandler) Login(w http.ResponseWriter, r *http.Request) {
+	var body loginBody
+	if err := httpx.DecodeJSON(r, &body); err != nil {
+		httpx.WriteError(w, http.StatusBadRequest, err.Error())
+		return
+	}
+	if !strings.Contains(body.Email, "@") || len(body.Password) < 8 {
+		httpx.WriteError(w, http.StatusBadRequest, "invalid email or password")
+		return
+	}
+	token, expiresIn, err := h.auth.Login(r.Context(), body.Email, body.Password)
+	if errors.Is(err, service.ErrInvalidCredentials) {
+		httpx.WriteError(w, http.StatusUnauthorized, "invalid credentials")
+		return
+	}
+	if err != nil {
+		httpx.WriteError(w, http.StatusInternalServerError, "internal error")
+		return
+	}
+	httpx.WriteJSON(w, http.StatusOK, map[string]any{
+		"accessToken": token,
+		"tokenType":   "Bearer",
+		"expiresIn":   expiresIn,
+	})
+}
+
+func (h *AuthHandler) Me(w http.ResponseWriter, r *http.Request) {
+	claims, ok := claimsFromContext(r.Context())
+	if !ok {
+		httpx.WriteError(w, http.StatusUnauthorized, "unauthorized")
+		return
+	}
+	httpx.WriteJSON(w, http.StatusOK, claims)
+}
+
+// claimsFromContext extracts the JWT claims placed by middleware.JWT.
+func claimsFromContext(ctx context.Context) (map[string]any, bool) {
+	v := ctx.Value(middleware.ClaimsContextKey)
+	c, ok := v.(map[string]any)
+	return c, ok
+}

package/templates/stacks/go-stdlib/internal/handler/users_handler.go.tpl

@@ -0,0 +1,84 @@
+package handler
+
+import (
+	"errors"
+	"net/http"
+	"strconv"
+
+	"{{moduleName}}/internal/httpx"
+	"{{moduleName}}/internal/service"
+)
+
+type UsersHandler struct {
+	svc *service.UsersService
+}
+
+func NewUsersHandler(s *service.UsersService) *UsersHandler {
+	return &UsersHandler{svc: s}
+}
+
+func (h *UsersHandler) List(w http.ResponseWriter, r *http.Request) {
+	page, _ := strconv.Atoi(r.URL.Query().Get("page"))
+	limit, _ := strconv.Atoi(r.URL.Query().Get("limit"))
+	if page < 1 {
+		page = 1
+	}
+	if limit < 1 || limit > 100 {
+		limit = 20
+	}
+	items, total, err := h.svc.Page(r.Context(), page, limit)
+	if err != nil {
+		httpx.WriteError(w, http.StatusInternalServerError, "internal")
+		return
+	}
+	httpx.WriteJSON(w, http.StatusOK, map[string]any{
+		"items": items, "total": total, "page": page,
+	})
+}
+
+type createUserBody struct {
+	Email    string  `json:"email"`
+	Password string  `json:"password"`
+	Role     *string `json:"role,omitempty"`
+}
+
+func (h *UsersHandler) Create(w http.ResponseWriter, r *http.Request) {
+	claims, ok := claimsFromContext(r.Context())
+	if !ok {
+		httpx.WriteError(w, http.StatusUnauthorized, "unauthorized")
+		return
+	}
+	if role, _ := claims["role"].(string); role != "ADMIN" {
+		httpx.WriteError(w, http.StatusForbidden, "admin role required")
+		return
+	}
+
+	var body createUserBody
+	if err := httpx.DecodeJSON(r, &body); err != nil {
+		httpx.WriteError(w, http.StatusBadRequest, err.Error())
+		return
+	}
+	if len(body.Password) < 8 {
+		httpx.WriteError(w, http.StatusBadRequest, "password must be at least 8 chars")
+		return
+	}
+	role := "USER"
+	if body.Role != nil {
+		if *body.Role != "USER" && *body.Role != "ADMIN" {
+			httpx.WriteError(w, http.StatusBadRequest, "role must be USER or ADMIN")
+			return
+		}
+		role = *body.Role
+	}
+
+	user, err := h.svc.Create(r.Context(), body.Email, body.Password, role)
+	if errors.Is(err, service.ErrEmailExists) {
+		httpx.WriteError(w, http.StatusConflict, "email already in use")
+		return
+	}
+	if err != nil {
+		httpx.WriteError(w, http.StatusInternalServerError, "internal")
+		return
+	}
+	httpx.WriteJSON(w, http.StatusCreated, user)
+}

package/templates/stacks/go-stdlib/internal/handler/ws_handler.go

@@ -0,0 +1,36 @@
+package handler
+
+import (
+	"context"
+	"net/http"
+	"time"
+
+	"github.com/coder/websocket"
+)
+
+type WSHandler struct{}
+
+func NewWSHandler() *WSHandler { return &WSHandler{} }
+
+func (h *WSHandler) Handle(w http.ResponseWriter, r *http.Request) {
+	c, err := websocket.Accept(w, r, &websocket.AcceptOptions{
+		InsecureSkipVerify: true, // tighten for production
+	})
+	if err != nil {
+		return
+	}
+	defer c.CloseNow()
+
+	ctx, cancel := context.WithTimeout(r.Context(), 10*time.Minute)
+	defer cancel()
+
+	for {
+		typ, data, err := c.Read(ctx)
+		if err != nil {
+			return
+		}
+		if err := c.Write(ctx, typ, data); err != nil {
+			return
+		}
+	}
+}

package/templates/stacks/go-stdlib/internal/httpx/json.go

@@ -0,0 +1,32 @@
+// Package httpx — small helpers around encoding/json for handlers.
+package httpx
+
+import (
+	"encoding/json"
+	"net/http"
+)
+
+// WriteJSON encodes v as JSON with the given status.
+func WriteJSON(w http.ResponseWriter, status int, v any) {
+	w.Header().Set("Content-Type", "application/json; charset=utf-8")
+	w.WriteHeader(status)
+	_ = json.NewEncoder(w).Encode(v)
+}
+
+// WriteError writes an RFC 7807 Problem Details JSON.
+func WriteError(w http.ResponseWriter, status int, detail string) {
+	WriteJSON(w, status, map[string]any{
+		"type":   "urn:problem:" + http.StatusText(status),
+		"title":  http.StatusText(status),
+		"status": status,
+		"detail": detail,
+	})
+}
+
+// DecodeJSON reads a JSON body into v. Returns nil on success, error on
+// malformed body or unexpected extra fields.
+func DecodeJSON(r *http.Request, v any) error {
+	dec := json.NewDecoder(r.Body)
+	dec.DisallowUnknownFields()
+	return dec.Decode(v)
+}

package/templates/stacks/go-stdlib/internal/llm/dummy.go

@@ -0,0 +1,14 @@
+package llm
+
+import "context"
+
+type DummyProvider struct{}
+
+func NewDummyProvider() *DummyProvider { return &DummyProvider{} }
+
+func (d *DummyProvider) Complete(_ context.Context, prompt string, maxTokens int) (string, error) {
+	if maxTokens > 0 && len(prompt) > maxTokens {
+		return "[dummy] " + prompt[:maxTokens], nil
+	}
+	return "[dummy] " + prompt, nil
+}

package/templates/stacks/go-stdlib/internal/llm/provider.go

@@ -0,0 +1,8 @@
+// Package llm — LLM provider abstraction.
+package llm
+
+import "context"
+
+type Provider interface {
+	Complete(ctx context.Context, prompt string, maxTokens int) (string, error)
+}

package/templates/stacks/go-stdlib/internal/middleware/chain.go

@@ -0,0 +1,21 @@
+// Package middleware — composable HTTP middlewares for net/http.
+package middleware
+
+import "net/http"
+
+// Middleware is the canonical wrapping shape.
+type Middleware func(http.Handler) http.Handler
+
+// Chain applies middlewares in order: Chain(h, A, B, C) → A(B(C(h))).
+func Chain(h http.Handler, mws ...Middleware) http.Handler {
+	for i := len(mws) - 1; i >= 0; i-- {
+		h = mws[i](h)
+	}
+	return h
+}
+
+// contextKey is unexported so callers can't collide on the value.
+type contextKey string
+
+// ClaimsContextKey is the request-context key where JWT claims are stashed.
+const ClaimsContextKey contextKey = "jwt.claims"

package/templates/stacks/go-stdlib/internal/middleware/cors.go

@@ -0,0 +1,27 @@
+package middleware
+
+import "net/http"
+
+// CORS applies a whitelist of origins (NEVER use "*"). Empty list disables CORS.
+func CORS(allow []string) Middleware {
+	set := make(map[string]bool, len(allow))
+	for _, o := range allow {
+		set[o] = true
+	}
+	return func(next http.Handler) http.Handler {
+		return http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {
+			origin := r.Header.Get("Origin")
+			if origin != "" && set[origin] {
+				w.Header().Set("Access-Control-Allow-Origin", origin)
+				w.Header().Set("Vary", "Origin")
+				w.Header().Set("Access-Control-Allow-Headers", "Authorization, Content-Type")
+				w.Header().Set("Access-Control-Allow-Methods", "GET, POST, PUT, DELETE, OPTIONS")
+			}
+			if r.Method == http.MethodOptions {
+				w.WriteHeader(http.StatusNoContent)
+				return
+			}
+			next.ServeHTTP(w, r)
+		})
+	}
+}

package/templates/stacks/go-stdlib/internal/middleware/jwt.go.tpl

@@ -0,0 +1,51 @@
+package middleware
+
+import (
+	"context"
+	"encoding/json"
+	"net/http"
+	"strings"
+
+	"github.com/golang-jwt/jwt/v5"
+
+	"{{moduleName}}/internal/config"
+)
+
+// JWT returns a middleware that validates a Bearer token and stashes the
+// claims as a map[string]any in request context under ClaimsContextKey.
+func JWT(cfg *config.Config) Middleware {
+	return func(next http.Handler) http.Handler {
+		return http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {
+			raw := r.Header.Get("Authorization")
+			token := strings.TrimPrefix(raw, "Bearer ")
+			if token == raw || token == "" {
+				writeAuthError(w, http.StatusUnauthorized, "missing bearer")
+				return
+			}
+			parsed, err := jwt.Parse(token, func(t *jwt.Token) (any, error) {
+				if _, ok := t.Method.(*jwt.SigningMethodHMAC); !ok {
+					return nil, jwt.ErrSignatureInvalid
+				}
+				return []byte(cfg.JWTSecret), nil
+			})
+			if err != nil || !parsed.Valid {
+				writeAuthError(w, http.StatusUnauthorized, "invalid token")
+				return
+			}
+			claims, _ := parsed.Claims.(jwt.MapClaims)
+			ctx := context.WithValue(r.Context(), ClaimsContextKey, map[string]any(claims))
+			next.ServeHTTP(w, r.WithContext(ctx))
+		})
+	}
+}
+
+func writeAuthError(w http.ResponseWriter, status int, detail string) {
+	w.Header().Set("Content-Type", "application/json; charset=utf-8")
+	w.WriteHeader(status)
+	_ = json.NewEncoder(w).Encode(map[string]any{
+		"type":   "urn:problem:Unauthorized",
+		"title":  http.StatusText(status),
+		"status": status,
+		"detail": detail,
+	})
+}

package/templates/stacks/go-stdlib/internal/middleware/rate_limit.go

@@ -0,0 +1,81 @@
+package middleware
+
+import (
+	"encoding/json"
+	"net"
+	"net/http"
+	"strings"
+	"sync"
+	"time"
+
+	"golang.org/x/time/rate"
+)
+
+// RateLimit is a token-bucket-per-IP middleware. Idle entries are pruned
+// every 5 minutes to keep memory bounded.
+func RateLimit(perSec, burst int) Middleware {
+	type bucket struct {
+		limiter *rate.Limiter
+		seen    time.Time
+	}
+	var (
+		mu      sync.Mutex
+		buckets = make(map[string]*bucket)
+	)
+
+	go func() {
+		t := time.NewTicker(5 * time.Minute)
+		defer t.Stop()
+		for now := range t.C {
+			mu.Lock()
+			for ip, b := range buckets {
+				if now.Sub(b.seen) > 10*time.Minute {
+					delete(buckets, ip)
+				}
+			}
+			mu.Unlock()
+		}
+	}()
+
+	return func(next http.Handler) http.Handler {
+		return http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {
+			ip := clientIP(r)
+			mu.Lock()
+			b, ok := buckets[ip]
+			if !ok {
+				b = &bucket{limiter: rate.NewLimiter(rate.Limit(perSec), burst)}
+				buckets[ip] = b
+			}
+			b.seen = time.Now()
+			mu.Unlock()
+
+			if !b.limiter.Allow() {
+				w.Header().Set("Content-Type", "application/json; charset=utf-8")
+				w.WriteHeader(http.StatusTooManyRequests)
+				_ = json.NewEncoder(w).Encode(map[string]any{
+					"type":   "urn:problem:TooManyRequests",
+					"title":  http.StatusText(http.StatusTooManyRequests),
+					"status": http.StatusTooManyRequests,
+					"detail": "rate limit exceeded",
+				})
+				return
+			}
+			next.ServeHTTP(w, r)
+		})
+	}
+}
+
+func clientIP(r *http.Request) string {
+	if xff := r.Header.Get("X-Forwarded-For"); xff != "" {
+		// First IP in chain.
+		if i := strings.Index(xff, ","); i >= 0 {
+			return strings.TrimSpace(xff[:i])
+		}
+		return strings.TrimSpace(xff)
+	}
+	host, _, err := net.SplitHostPort(r.RemoteAddr)
+	if err != nil {
+		return r.RemoteAddr
+	}
+	return host
+}

package/templates/stacks/go-stdlib/internal/model/user.go

@@ -0,0 +1,17 @@
+// Package model — domain entities.
+package model
+
+import (
+	"time"
+
+	"github.com/google/uuid"
+)
+
+type User struct {
+	ID        uuid.UUID `json:"id"`
+	Email     string    `json:"email"`
+	Password  string    `json:"-"`
+	Role      string    `json:"role"`
+	CreatedAt time.Time `json:"createdAt"`
+	UpdatedAt time.Time `json:"updatedAt"`
+}

package/templates/stacks/go-stdlib/internal/repository/users_repository.go.tpl

@@ -0,0 +1,75 @@
+// Package repository — the only layer with SQL strings. Production setups can
+// swap in sqlc-generated code from db/queries/users.sql.
+package repository
+
+import (
+	"context"
+	"errors"
+
+	"github.com/google/uuid"
+	"github.com/jackc/pgx/v5"
+	"github.com/jackc/pgx/v5/pgxpool"
+
+	"{{moduleName}}/internal/model"
+)
+
+type UsersRepository struct {
+	pool *pgxpool.Pool
+}
+
+func NewUsersRepository(pool *pgxpool.Pool) *UsersRepository {
+	return &UsersRepository{pool: pool}
+}
+
+func (r *UsersRepository) FindByEmail(ctx context.Context, email string) (*model.User, error) {
+	row := r.pool.QueryRow(ctx,
+		`SELECT id, email, password, role, created_at, updated_at FROM users WHERE email = $1`, email)
+	u := &model.User{}
+	if err := row.Scan(&u.ID, &u.Email, &u.Password, &u.Role, &u.CreatedAt, &u.UpdatedAt); err != nil {
+		if errors.Is(err, pgx.ErrNoRows) {
+			return nil, nil
+		}
+		return nil, err
+	}
+	return u, nil
+}
+
+func (r *UsersRepository) Page(ctx context.Context, offset, limit int64) ([]*model.User, error) {
+	rows, err := r.pool.Query(ctx,
+		`SELECT id, email, password, role, created_at, updated_at
+		 FROM users ORDER BY created_at DESC LIMIT $1 OFFSET $2`, limit, offset)
+	if err != nil {
+		return nil, err
+	}
+	defer rows.Close()
+
+	var out []*model.User
+	for rows.Next() {
+		u := &model.User{}
+		if err := rows.Scan(&u.ID, &u.Email, &u.Password, &u.Role, &u.CreatedAt, &u.UpdatedAt); err != nil {
+			return nil, err
+		}
+		out = append(out, u)
+	}
+	return out, rows.Err()
+}
+
+func (r *UsersRepository) Count(ctx context.Context) (int64, error) {
+	var total int64
+	err := r.pool.QueryRow(ctx, `SELECT COUNT(*) FROM users`).Scan(&total)
+	return total, err
+}
+
+func (r *UsersRepository) Create(ctx context.Context, email, passwordHash, role string) (*model.User, error) {
+	u := &model.User{}
+	err := r.pool.QueryRow(ctx,
+		`INSERT INTO users (id, email, password, role)
+		 VALUES ($1, $2, $3, $4)
+		 RETURNING id, email, password, role, created_at, updated_at`,
+		uuid.New(), email, passwordHash, role,
+	).Scan(&u.ID, &u.Email, &u.Password, &u.Role, &u.CreatedAt, &u.UpdatedAt)
+	if err != nil {
+		return nil, err
+	}
+	return u, nil
+}

package/templates/stacks/go-stdlib/internal/service/auth_service.go.tpl

@@ -0,0 +1,55 @@
+// Package service — business logic.
+package service
+
+import (
+	"context"
+	"errors"
+	"strings"
+	"time"
+
+	"github.com/golang-jwt/jwt/v5"
+	"golang.org/x/crypto/bcrypt"
+
+	"{{moduleName}}/internal/config"
+	"{{moduleName}}/internal/repository"
+)
+
+var ErrInvalidCredentials = errors.New("invalid credentials")
+
+type AuthService struct {
+	repo *repository.UsersRepository
+	cfg  *config.Config
+}
+
+func NewAuthService(r *repository.UsersRepository, cfg *config.Config) *AuthService {
+	return &AuthService{repo: r, cfg: cfg}
+}
+
+func (s *AuthService) Login(ctx context.Context, email, password string) (string, int64, error) {
+	email = strings.TrimSpace(strings.ToLower(email))
+	user, err := s.repo.FindByEmail(ctx, email)
+	if err != nil {
+		return "", 0, err
+	}
+	if user == nil {
+		return "", 0, ErrInvalidCredentials
+	}
+	if err := bcrypt.CompareHashAndPassword([]byte(user.Password), []byte(password)); err != nil {
+		return "", 0, ErrInvalidCredentials
+	}
+
+	expHours := s.cfg.JWTExpHours
+	expiresAt := time.Now().Add(time.Duration(expHours) * time.Hour)
+	claims := jwt.MapClaims{
+		"sub":   user.ID.String(),
+		"email": user.Email,
+		"role":  user.Role,
+		"exp":   expiresAt.Unix(),
+	}
+	token := jwt.NewWithClaims(jwt.SigningMethodHS256, claims)
+	signed, err := token.SignedString([]byte(s.cfg.JWTSecret))
+	if err != nil {
+		return "", 0, err
+	}
+	return signed, int64(expHours) * 3600, nil
+}

package/templates/stacks/go-stdlib/internal/service/users_service.go.tpl

@@ -0,0 +1,53 @@
+package service
+
+import (
+	"context"
+	"errors"
+	"strings"
+
+	"golang.org/x/crypto/bcrypt"
+
+	"{{moduleName}}/internal/config"
+	"{{moduleName}}/internal/model"
+	"{{moduleName}}/internal/repository"
+)
+
+var ErrEmailExists = errors.New("email already in use")
+
+type UsersService struct {
+	repo *repository.UsersRepository
+	cfg  *config.Config
+}
+
+func NewUsersService(r *repository.UsersRepository, cfg *config.Config) *UsersService {
+	return &UsersService{repo: r, cfg: cfg}
+}
+
+func (s *UsersService) Page(ctx context.Context, page, limit int) ([]*model.User, int64, error) {
+	offset := int64((page - 1) * limit)
+	items, err := s.repo.Page(ctx, offset, int64(limit))
+	if err != nil {
+		return nil, 0, err
+	}
+	total, err := s.repo.Count(ctx)
+	if err != nil {
+		return nil, 0, err
+	}
+	return items, total, nil
+}
+
+func (s *UsersService) Create(ctx context.Context, email, password, role string) (*model.User, error) {
+	email = strings.TrimSpace(strings.ToLower(email))
+	existing, err := s.repo.FindByEmail(ctx, email)
+	if err != nil {
+		return nil, err
+	}
+	if existing != nil {
+		return nil, ErrEmailExists
+	}
+	hash, err := bcrypt.GenerateFromPassword([]byte(password), s.cfg.BcryptCost)
+	if err != nil {
+		return nil, err
+	}
+	return s.repo.Create(ctx, email, string(hash), role)
+}

package/templates/stacks/go-stdlib/llms.txt.tpl

@@ -0,0 +1,60 @@
+# {{projectName}}
+
+DARE-shaped Go API on **net/http stdlib** (no framework). Layered Design.
+
+## Setup
+
+```bash
+cp .env.example .env
+docker compose up -d postgres
+go mod tidy
+sqlc generate
+go run ./cmd/server
+```
+
+## Commands
+
+- `go run ./cmd/server` — dev server (port 8000)
+- `go test ./...` — tests
+- `golangci-lint run` — lint
+- `govulncheck ./...` — vuln scan
+- `sqlc generate` — regenerate type-safe DB code from db/queries/*.sql
+
+## Endpoints
+
+| Method | Path | Auth | Description |
+|---|---|---|---|
+| POST | `/auth/login` | none | Exchange email+password for JWT |
+| GET | `/auth/me` | Bearer | Current user |
+| GET | `/users` | Bearer | List (query: page, limit) |
+| POST | `/users` | Bearer (admin) | Create user |
+| GET | `/ws` | upgrade | WebSocket echo |
+| GET | `/openapi.json` | none | OpenAPI document |
+
+## Layered Design
+
+- `internal/handler/` — HTTP layer (net/http handlers)
+- `internal/service/` — business logic
+- `internal/repository/` — pgx queries (sqlc-compatible)
+- `internal/model/` — domain structs
+- `internal/middleware/` — JWT + rate limit + CORS + chain helper
+- `internal/llm/` — provider abstraction
+- `internal/httpx/` — JSON helpers (encode/decode)
+
+Handlers never call pgx directly.
+
+## Why net/http stdlib?
+
+Go 1.22 added method+pattern routing to `http.ServeMux`:
+`mux.HandleFunc("POST /auth/login", h.Login)`. That covers 80% of what
+Gin / Echo / Chi were used for, with zero deps. Frameworks only buy
+nicer middleware DX and a slightly faster path tree — both replaceable
+with the helpers in `internal/middleware/`.
+
+## Env vars
+
+See `.env.example`. Required: `DATABASE_URL`, `JWT_SECRET`.
+
+## DARE skills
+
+See `.dare/skills.yml`.