@strav/spring 0.3.0

package/src/templates/shared/database/factories/user_factory.ts

@@ -0,0 +1,11 @@
+import { Factory } from '@strav/testing'
+import User from '../../app/models/user.ts'
+
+export const UserFactory = Factory.define(User, (seq) => ({
+  id: crypto.randomUUID(),
+  email: `user-${seq}@example.com`,
+  name: `User ${seq}`,
+  password_hash: '$2b$10$92IXUNpkjO0rOQ5byMi.Ye4oKoEa3Ro9llC/.og/at2.uheWG/igi', // password
+  email_verified_at: new Date(),
+  remember_token: null,
+}))

package/src/templates/shared/database/schemas/public/user.ts

@@ -0,0 +1,13 @@
+import { defineSchema, t, Archetype } from '@strav/database'
+
+export default defineSchema('user', {
+  archetype: Archetype.Entity,
+  fields: {
+    id: t.uuid().primaryKey(),
+    email: t.string().email().unique().required(),
+    name: t.string().required(),
+    password_hash: t.string().required(),
+    email_verified_at: t.timestamp().nullable(),
+    remember_token: t.string(100).nullable(),
+  },
+})

package/src/templates/shared/database/seeders/database_seeder.ts

@@ -0,0 +1,8 @@
+import { Seeder } from '@strav/database'
+import UserSeeder from './user_seeder.ts'
+
+export default class DatabaseSeeder extends Seeder {
+  async run(): Promise<void> {
+    await this.call(UserSeeder)
+  }
+}

package/src/templates/shared/database/seeders/user_seeder.ts

@@ -0,0 +1,15 @@
+import { Seeder } from '@strav/database'
+import { UserFactory } from '../factories/user_factory.ts'
+
+export default class UserSeeder extends Seeder {
+  async run(): Promise<void> {
+    // Create admin user
+    await UserFactory.create({
+      email: 'admin@example.com',
+      name: 'Admin User',
+    })
+
+    // Create test users
+    await UserFactory.createMany(10)
+  }
+}

package/src/templates/shared/package.json

@@ -0,0 +1,24 @@
+{
+  "name": "__PROJECT_NAME__",
+  "version": "0.1.0",
+  "type": "module",
+  "private": true,
+  "scripts": {
+    "dev": "bun --hot index.ts",
+    "start": "bun index.ts",
+    "test": "bun test tests/",
+    "typecheck": "tsc --noEmit"
+  },
+  "dependencies": {
+    "@strav/kernel": "workspace:*",
+    "@strav/http": "workspace:*",
+    "@strav/database": "workspace:*",
+    "@strav/cli": "workspace:*",
+    "reflect-metadata": "^0.2.2"
+  },
+  "devDependencies": {
+    "@types/bun": "latest",
+    "@strav/testing": "workspace:*",
+    "typescript": "^5.9.3"
+  }
+}

package/src/templates/shared/routes/routes.ts

@@ -0,0 +1,13 @@
+import type { Router } from '@strav/http'
+
+export default function (router: Router) {
+  // Health check endpoint
+  router.get('/health', async (ctx) => {
+    return ctx.json({ status: 'ok', timestamp: new Date().toISOString() })
+  })
+
+  // API routes
+  router.group('/api', () => {
+    // Add your API routes here
+  })
+}

package/src/templates/shared/storage/cache/.gitkeep

@@ -0,0 +1 @@
+# This file keeps the cache directory in git

package/src/templates/shared/storage/logs/.gitkeep

@@ -0,0 +1 @@
+# This file keeps the logs directory in git

package/src/templates/shared/storage/uploads/.gitkeep

@@ -0,0 +1 @@
+# This file keeps the uploads directory in git

package/src/templates/shared/strav.ts

@@ -0,0 +1,20 @@
+#!/usr/bin/env bun
+import 'reflect-metadata'
+import { app } from '@strav/kernel'
+import { ConfigProvider, EncryptionProvider } from '@strav/kernel'
+import { DatabaseProvider } from '@strav/database'
+import { CliProvider } from '@strav/cli'
+
+// Register service providers
+app
+  .use(new ConfigProvider())
+  .use(new DatabaseProvider())
+  .use(new EncryptionProvider())
+  .use(new CliProvider())
+
+// Boot services
+await app.start()
+
+// Start CLI
+const cli = app.resolve('cli')
+await cli.handle(process.argv.slice(2))

package/src/templates/shared/tests/example.test.ts

@@ -0,0 +1,11 @@
+import { test, expect } from 'bun:test'
+
+test('example test', () => {
+  expect(1 + 1).toBe(2)
+})
+
+test('health endpoint returns ok', async () => {
+  // TODO: Add integration tests for your routes
+  // Use @strav/testing for HTTP testing helpers
+  expect(true).toBe(true)
+})

package/src/templates/shared/tsconfig.json

@@ -0,0 +1,20 @@
+{
+  "compilerOptions": {
+    "strict": true,
+    "target": "ES2022",
+    "module": "ESNext",
+    "moduleResolution": "bundler",
+    "allowImportingTsExtensions": true,
+    "noEmit": true,
+    "composite": false,
+    "skipLibCheck": true,
+    "allowSyntheticDefaultImports": true,
+    "forceConsistentCasingInFileNames": true,
+    "experimentalDecorators": true,
+    "emitDecoratorMetadata": true,
+    "useDefineForClassFields": false,
+    "types": ["bun-types"]
+  },
+  "include": ["**/*.ts"],
+  "exclude": ["node_modules", "dist"]
+}

package/src/templates/web/app/controllers/home_controller.ts

@@ -0,0 +1,24 @@
+import type { Context } from '@strav/http'
+import { Controller } from './controller.ts'
+import User from '../models/user.ts'
+
+export default class HomeController extends Controller {
+  async index(ctx: Context) {
+    const userCount = await User.count()
+
+    return ctx.view('pages/home', {
+      title: 'Welcome to __PROJECT_NAME__',
+      userCount,
+      message: 'Welcome to your new Strav application!',
+    })
+  }
+
+  async users(ctx: Context) {
+    const users = await User.all()
+
+    return ctx.view('pages/users', {
+      title: 'Users',
+      users,
+    })
+  }
+}

package/src/templates/web/config/session.ts

@@ -0,0 +1,10 @@
+import { env } from '@strav/kernel'
+
+export default {
+  secret: env('SESSION_SECRET'),
+  cookieName: env('SESSION_COOKIE_NAME', 'session'),
+  maxAge: 1000 * 60 * 60 * 24 * 7, // 1 week
+  secure: env('APP_ENV') === 'production',
+  httpOnly: true,
+  sameSite: 'lax' as const,
+}

package/src/templates/web/config/view.ts

@@ -0,0 +1,7 @@
+import { env } from '@strav/kernel'
+
+export default {
+  directory: 'resources/views',
+  cache: env.bool('VIEW_CACHE', true),
+  assets: ['/css/app.css', '/islands.js'],
+}

package/src/templates/web/index.ts

@@ -0,0 +1,48 @@
+import 'reflect-metadata'
+import { app } from '@strav/kernel'
+import { router } from '@strav/http'
+import { ConfigProvider, EncryptionProvider } from '@strav/kernel'
+import { DatabaseProvider } from '@strav/database'
+import { SessionProvider } from '@strav/http'
+import { ViewProvider } from '@strav/view'
+import BaseModel from '@strav/database/orm/base_model'
+import Database from '@strav/database/database/database'
+import Server from '@strav/http/server'
+import { ExceptionHandler } from '@strav/kernel'
+import { IslandBuilder } from '@strav/view'
+
+// Register service providers
+app
+  .use(new ConfigProvider())
+  .use(new DatabaseProvider())
+  .use(new EncryptionProvider())
+  .use(new SessionProvider())
+  .use(new ViewProvider())
+
+// Boot services (loads config, connects database, derives encryption keys, starts sessions)
+await app.start()
+
+// Initialize ORM
+new BaseModel(app.resolve(Database))
+
+// Build Vue islands for development
+if (process.env.NODE_ENV !== 'production') {
+  const islands = new IslandBuilder({
+    islandsDir: './resources/ts/islands',
+    outDir: './public',
+    outFile: 'islands.js',
+  })
+  await islands.build()
+  islands.watch() // Auto-rebuild on changes
+}
+
+// Configure router
+router.useExceptionHandler(new ExceptionHandler(true))
+
+// Load routes
+await import('./routes/routes')
+
+// Start HTTP server
+app.singleton(Server)
+const server = app.resolve(Server)
+server.start(router)

package/src/templates/web/package.json

@@ -0,0 +1,26 @@
+{
+  "name": "__PROJECT_NAME__",
+  "version": "0.1.0",
+  "type": "module",
+  "private": true,
+  "scripts": {
+    "dev": "bun --hot index.ts",
+    "start": "bun index.ts",
+    "test": "bun test tests/",
+    "typecheck": "tsc --noEmit"
+  },
+  "dependencies": {
+    "@strav/kernel": "workspace:*",
+    "@strav/http": "workspace:*",
+    "@strav/view": "workspace:*",
+    "@strav/database": "workspace:*",
+    "@strav/cli": "workspace:*",
+    "vue": "^3.5.28",
+    "reflect-metadata": "^0.2.2"
+  },
+  "devDependencies": {
+    "@types/bun": "latest",
+    "@strav/testing": "workspace:*",
+    "typescript": "^5.9.3"
+  }
+}

package/src/templates/web/resources/css/app.css

@@ -0,0 +1,176 @@
+/* Basic Tailwind CSS-inspired styles */
+/* In a real project, you'd use Tailwind CSS or your preferred CSS framework */
+
+* {
+  margin: 0;
+  padding: 0;
+  box-sizing: border-box;
+}
+
+body {
+  font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', 'Roboto', 'Oxygen',
+    'Ubuntu', 'Cantarell', 'Open Sans', 'Helvetica Neue', sans-serif;
+  line-height: 1.6;
+  color: #374151;
+}
+
+/* Basic utility classes */
+.bg-gray-50 { background-color: #f9fafb; }
+.bg-white { background-color: #ffffff; }
+.bg-blue-600 { background-color: #2563eb; }
+.bg-blue-700 { background-color: #1d4ed8; }
+.bg-red-500 { background-color: #ef4444; }
+.bg-red-600 { background-color: #dc2626; }
+.bg-green-500 { background-color: #10b981; }
+.bg-green-600 { background-color: #059669; }
+.bg-gray-100 { background-color: #f3f4f6; }
+.bg-yellow-50 { background-color: #fffbeb; }
+
+.text-white { color: #ffffff; }
+.text-gray-900 { color: #111827; }
+.text-gray-600 { color: #4b5563; }
+.text-gray-500 { color: #6b7280; }
+.text-blue-600 { color: #2563eb; }
+.text-green-600 { color: #059669; }
+
+.text-xs { font-size: 0.75rem; }
+.text-sm { font-size: 0.875rem; }
+.text-base { font-size: 1rem; }
+.text-lg { font-size: 1.125rem; }
+.text-xl { font-size: 1.25rem; }
+.text-2xl { font-size: 1.5rem; }
+.text-4xl { font-size: 2.25rem; }
+
+.font-bold { font-weight: 700; }
+.font-semibold { font-weight: 600; }
+.font-medium { font-weight: 500; }
+
+.max-w-7xl { max-width: 80rem; }
+.max-w-4xl { max-width: 56rem; }
+.max-w-md { max-width: 28rem; }
+.mx-auto { margin-left: auto; margin-right: auto; }
+
+.px-4 { padding-left: 1rem; padding-right: 1rem; }
+.py-6 { padding-top: 1.5rem; padding-bottom: 1.5rem; }
+.p-6 { padding: 1.5rem; }
+.px-6 { padding-left: 1.5rem; padding-right: 1.5rem; }
+.py-4 { padding-top: 1rem; padding-bottom: 1rem; }
+.px-3 { padding-left: 0.75rem; padding-right: 0.75rem; }
+.py-1 { padding-top: 0.25rem; padding-bottom: 0.25rem; }
+.py-2 { padding-top: 0.5rem; padding-bottom: 0.5rem; }
+.py-12 { padding-top: 3rem; padding-bottom: 3rem; }
+
+.mb-4 { margin-bottom: 1rem; }
+.mb-8 { margin-bottom: 2rem; }
+.mt-8 { margin-top: 2rem; }
+.mt-2 { margin-top: 0.5rem; }
+
+.flex { display: flex; }
+.grid { display: grid; }
+.grid-cols-1 { grid-template-columns: repeat(1, minmax(0, 1fr)); }
+.grid-cols-3 { grid-template-columns: repeat(3, minmax(0, 1fr)); }
+.gap-6 { gap: 1.5rem; }
+.space-x-4 > * + * { margin-left: 1rem; }
+.space-y-6 > * + * { margin-top: 1.5rem; }
+.items-center { align-items: center; }
+.justify-between { justify-content: space-between; }
+
+.rounded { border-radius: 0.25rem; }
+.rounded-lg { border-radius: 0.5rem; }
+.shadow { box-shadow: 0 1px 3px 0 rgba(0, 0, 0, 0.1), 0 1px 2px 0 rgba(0, 0, 0, 0.06); }
+
+.border { border-width: 1px; }
+.border-4 { border-width: 4px; }
+.border-dashed { border-style: dashed; }
+.border-gray-200 { border-color: #e5e7eb; }
+
+.text-center { text-align: center; }
+
+.hover\:bg-blue-700:hover { background-color: #1d4ed8; }
+.hover\:bg-red-600:hover { background-color: #dc2626; }
+.hover\:bg-green-600:hover { background-color: #059669; }
+.hover\:text-gray-900:hover { color: #111827; }
+
+.transition-colors {
+  transition-property: color, background-color, border-color, text-decoration-color, fill, stroke;
+  transition-timing-function: cubic-bezier(0.4, 0, 0.2, 1);
+  transition-duration: 150ms;
+}
+
+/* Navigation styles */
+nav {
+  border-bottom: 1px solid #e5e7eb;
+}
+
+nav a {
+  text-decoration: none;
+  transition: color 0.15s ease-in-out;
+}
+
+/* Table styles */
+table {
+  border-collapse: collapse;
+  width: 100%;
+}
+
+th, td {
+  text-align: left;
+  border-bottom: 1px solid #e5e7eb;
+}
+
+th {
+  background-color: #f9fafb;
+  font-weight: 500;
+  text-transform: uppercase;
+  letter-spacing: 0.025em;
+}
+
+/* Form styles */
+input[type="text"],
+input[type="email"],
+textarea {
+  border: 1px solid #d1d5db;
+  border-radius: 0.375rem;
+  padding: 0.5rem 0.75rem;
+  width: 100%;
+  transition: border-color 0.15s ease-in-out, box-shadow 0.15s ease-in-out;
+}
+
+input:focus,
+textarea:focus {
+  outline: none;
+  border-color: #3b82f6;
+  box-shadow: 0 0 0 3px rgba(59, 130, 246, 0.1);
+}
+
+button {
+  cursor: pointer;
+  border: none;
+  border-radius: 0.375rem;
+  font-weight: 500;
+  text-align: center;
+  transition: background-color 0.15s ease-in-out;
+}
+
+button:disabled {
+  opacity: 0.5;
+  cursor: not-allowed;
+}
+
+code {
+  background-color: #f3f4f6;
+  padding: 0.125rem 0.5rem;
+  border-radius: 0.25rem;
+  font-family: ui-monospace, SFMono-Regular, "SF Mono", Consolas, "Liberation Mono", Menlo, monospace;
+}
+
+/* Media queries for responsiveness */
+@media (min-width: 768px) {
+  .md\:grid-cols-3 { grid-template-columns: repeat(3, minmax(0, 1fr)); }
+  .md\:grid-cols-2 { grid-template-columns: repeat(2, minmax(0, 1fr)); }
+}
+
+@media (min-width: 640px) {
+  .sm\:px-6 { padding-left: 1.5rem; padding-right: 1.5rem; }
+  .sm\:px-0 { padding-left: 0; padding-right: 0; }
+}

package/src/templates/web/resources/ts/islands/counter.vue

@@ -0,0 +1,42 @@
+<template>
+  <div class="flex items-center space-x-4">
+    <button
+      @click="decrement"
+      class="px-3 py-1 bg-red-500 text-white rounded hover:bg-red-600 transition-colors"
+    >
+      -
+    </button>
+
+    <span class="text-xl font-bold text-gray-900 min-w-[3rem] text-center">
+      {{ count }}
+    </span>
+
+    <button
+      @click="increment"
+      class="px-3 py-1 bg-green-500 text-white rounded hover:bg-green-600 transition-colors"
+    >
+      +
+    </button>
+
+    <span class="text-sm text-gray-600 ml-4">{{ label }}</span>
+  </div>
+</template>
+
+<script setup>
+import { ref } from 'vue'
+
+const props = defineProps({
+  initial: { type: Number, default: 0 },
+  label: { type: String, default: 'Counter' }
+})
+
+const count = ref(props.initial)
+
+function increment() {
+  count.value++
+}
+
+function decrement() {
+  count.value--
+}
+</script>

package/src/templates/web/resources/ts/islands/user_manager.vue

@@ -0,0 +1,127 @@
+<template>
+  <div class="bg-white p-6 rounded-lg shadow">
+    <h3 class="text-lg font-semibold text-gray-900 mb-4">Interactive User Management</h3>
+
+    <div class="grid grid-cols-1 md:grid-cols-2 gap-6">
+      <!-- Add User Form -->
+      <div>
+        <h4 class="font-medium text-gray-900 mb-3">Add New User</h4>
+        <form @submit.prevent="addUser" class="space-y-3">
+          <input
+            v-model="newUser.name"
+            type="text"
+            placeholder="Full Name"
+            required
+            class="w-full px-3 py-2 border border-gray-300 rounded-md focus:ring-blue-500 focus:border-blue-500"
+          />
+          <input
+            v-model="newUser.email"
+            type="email"
+            placeholder="Email Address"
+            required
+            class="w-full px-3 py-2 border border-gray-300 rounded-md focus:ring-blue-500 focus:border-blue-500"
+          />
+          <button
+            type="submit"
+            :disabled="isLoading"
+            class="w-full px-4 py-2 bg-blue-600 text-white rounded-md hover:bg-blue-700 disabled:opacity-50"
+          >
+            {{ isLoading ? 'Adding...' : 'Add User' }}
+          </button>
+        </form>
+      </div>
+
+      <!-- User Stats -->
+      <div>
+        <h4 class="font-medium text-gray-900 mb-3">Statistics</h4>
+        <div class="space-y-2">
+          <div class="flex justify-between">
+            <span class="text-gray-600">Total Users:</span>
+            <span class="font-semibold">{{ users.length }}</span>
+          </div>
+          <div class="flex justify-between">
+            <span class="text-gray-600">Users Added:</span>
+            <span class="font-semibold text-green-600">+{{ addedCount }}</span>
+          </div>
+          <div class="flex justify-between">
+            <span class="text-gray-600">Last Added:</span>
+            <span class="text-sm text-gray-500">
+              {{ lastAdded || 'None yet' }}
+            </span>
+          </div>
+        </div>
+      </div>
+    </div>
+
+    <!-- Recent Users List -->
+    <div class="mt-6">
+      <h4 class="font-medium text-gray-900 mb-3">Recent Users</h4>
+      <div v-if="users.length === 0" class="text-center text-gray-500 py-8">
+        No users yet. Add one above!
+      </div>
+      <div v-else class="space-y-2 max-h-48 overflow-y-auto">
+        <div
+          v-for="(user, index) in users.slice(-5).reverse()"
+          :key="user.id || index"
+          class="flex items-center justify-between p-3 bg-gray-50 rounded-md"
+        >
+          <div>
+            <div class="font-medium text-gray-900">{{ user.name }}</div>
+            <div class="text-sm text-gray-500">{{ user.email }}</div>
+          </div>
+          <span v-if="index === 0" class="text-xs bg-green-100 text-green-800 px-2 py-1 rounded">
+            Latest
+          </span>
+        </div>
+      </div>
+    </div>
+  </div>
+</template>
+
+<script setup>
+import { ref, reactive, computed } from 'vue'
+
+const props = defineProps({
+  initialUsers: { type: String, default: '[]' }
+})
+
+// Parse initial users from JSON string
+const users = ref(JSON.parse(props.initialUsers))
+const addedCount = ref(0)
+const isLoading = ref(false)
+
+const newUser = reactive({
+  name: '',
+  email: ''
+})
+
+const lastAdded = computed(() => {
+  if (addedCount.value === 0) return null
+  const latest = users.value[users.value.length - 1]
+  return latest ? `${latest.name} (${latest.email})` : null
+})
+
+async function addUser() {
+  if (!newUser.name || !newUser.email) return
+
+  isLoading.value = true
+
+  // Simulate API call
+  await new Promise(resolve => setTimeout(resolve, 500))
+
+  // Add the new user
+  users.value.push({
+    id: crypto.randomUUID(),
+    name: newUser.name,
+    email: newUser.email,
+    created_at: new Date()
+  })
+
+  addedCount.value++
+
+  // Reset form
+  newUser.name = ''
+  newUser.email = ''
+  isLoading.value = false
+}
+</script>