vasp-cli 0.1.3 → 0.2.0

package/templates/templates/shared/server/routes/queries/_query.hbs

@@ -0,0 +1,20 @@
+import { Elysia } from 'elysia'
+import { db } from '../../db/client.{{ext}}'
+{{#if requiresAuth}}
+import { requireAuth } from '../../auth/middleware.{{ext}}'
+{{/if}}
+import { {{namedExport}} } from '{{importPath fnSource ext}}'
+
+export const {{camelCase name}}Route = new Elysia()
+{{#if requiresAuth}}
+  .use(requireAuth)
+  .get('/api/queries/{{camelCase name}}', async ({ query, user }) => {
+    const result = await {{namedExport}}({ db, user, args: query })
+    return result
+  })
+{{else}}
+  .get('/api/queries/{{camelCase name}}', async ({ query }) => {
+    const result = await {{namedExport}}({ db, args: query })
+    return result
+  })
+{{/if}}

package/templates/templates/shared/server/routes/realtime/_channel.hbs

@@ -0,0 +1,78 @@
+import { Elysia } from 'elysia'
+{{#if ../hasAuth}}
+import jwt from '@elysiajs/jwt'
+{{/if}}
+
+// Room-based subscriber map for '{{name}}' channel
+// Each room key maps to a set of connected WebSocket clients
+const rooms = new Map()
+
+function getRoom(roomId) {
+  if (!rooms.has(roomId)) rooms.set(roomId, new Set())
+  return rooms.get(roomId)
+}
+
+/**
+ * Publish a realtime event to all subscribers in a specific room of '{{name}}'.
+ * Called automatically by CRUD mutation handlers.
+ */
+export function publish{{pascalCase name}}(event, data, roomId = 'default') {
+  const room = rooms.get(roomId)
+  if (!room) return
+  const message = JSON.stringify({ channel: '{{camelCase name}}', room: roomId, event, data })
+  for (const ws of room) {
+    try { ws.send(message) } catch { room.delete(ws) }
+  }
+}
+
+/**
+ * Broadcast to all rooms of '{{name}}'.
+ */
+export function broadcast{{pascalCase name}}(event, data) {
+  const message = JSON.stringify({ channel: '{{camelCase name}}', event, data })
+  for (const [, room] of rooms) {
+    for (const ws of room) {
+      try { ws.send(message) } catch { room.delete(ws) }
+    }
+  }
+}
+
+export const {{camelCase name}}Channel = new Elysia()
+{{#if ../hasAuth}}
+  .use(jwt({ name: 'jwt', secret: process.env.JWT_SECRET || 'vasp-dev-secret' }))
+{{/if}}
+  .ws('/ws/{{camelCase name}}', {
+{{#if ../hasAuth}}
+    async beforeHandle({ jwt: jwtPlugin, request }) {
+      const url = new URL(request.url)
+      const token = url.searchParams.get('token')
+      if (!token) return new Response('Unauthorized', { status: 401 })
+      const payload = await jwtPlugin.verify(token)
+      if (!payload) return new Response('Unauthorized', { status: 401 })
+    },
+{{/if}}
+    open(ws) {
+      const room = ws.data?.query?.room ?? 'default'
+      getRoom(room).add(ws)
+      ws.data._room = room
+    },
+    message(ws, msg) {
+      // Client can switch rooms via { action: 'join', room: 'roomId' }
+      try {
+        const parsed = typeof msg === 'string' ? JSON.parse(msg) : msg
+        if (parsed.action === 'join' && parsed.room) {
+          const oldRoom = ws.data._room
+          if (oldRoom) rooms.get(oldRoom)?.delete(ws)
+          ws.data._room = parsed.room
+          getRoom(parsed.room).add(ws)
+          ws.send(JSON.stringify({ ack: 'joined', room: parsed.room }))
+          return
+        }
+      } catch { /* ignore parse errors */ }
+      ws.send(JSON.stringify({ ack: msg }))
+    },
+    close(ws) {
+      const room = ws.data?._room
+      if (room) rooms.get(room)?.delete(ws)
+    },
+  })

package/templates/templates/shared/server/routes/realtime/index.hbs

@@ -0,0 +1,9 @@
+import { Elysia } from 'elysia'
+{{#each realtimes}}
+import { {{camelCase name}}Channel } from './{{camelCase name}}.{{../ext}}'
+{{/each}}
+
+export const realtimeRoutes = new Elysia()
+{{#each realtimes}}
+  .use({{camelCase name}}Channel)
+{{/each}}

package/templates/templates/shared/tsconfig.json.hbs

@@ -0,0 +1,21 @@
+{
+  "compilerOptions": {
+    "target": "ESNext",
+    "module": "ESNext",
+    "moduleResolution": "bundler",
+    "lib": ["ESNext", "DOM", "DOM.Iterable"],
+    "strict": true,
+    "noUnusedLocals": true,
+    "noUnusedParameters": true,
+    "noFallthroughCasesInSwitch": true,
+    "esModuleInterop": true,
+    "skipLibCheck": true,
+    "jsx": "preserve",
+    "paths": {
+      "@src/*": ["./src/*"],
+      "@vasp-framework/client": ["./src/vasp/client/index.ts"]
+    }
+  },
+  "include": ["src/**/*.ts", "src/**/*.vue", "server/**/*.ts", "drizzle/**/*.ts"],
+  "exclude": ["node_modules", "dist", ".vasp-gen"]
+}

package/templates/templates/spa/js/index.html.hbs

@@ -0,0 +1,12 @@
+<!DOCTYPE html>
+<html lang="en">
+  <head>
+    <meta charset="UTF-8" />
+    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+    <title>{{appTitle}}</title>
+  </head>
+  <body>
+    <div id="app"></div>
+    <script type="module" src="/src/main.js"></script>
+  </body>
+</html>

package/templates/templates/spa/js/src/App.vue.hbs

@@ -0,0 +1,3 @@
+<template>
+  <RouterView />
+</template>

package/templates/templates/spa/js/src/main.js.hbs

@@ -0,0 +1,9 @@
+import { createApp } from 'vue'
+import App from './App.vue'
+import router from './router/index.js'
+import { vaspPlugin } from './vasp/plugin.js'
+
+const app = createApp(App)
+app.use(router)
+app.use(vaspPlugin)
+app.mount('#app')

package/templates/templates/spa/js/src/router/index.js.hbs

@@ -0,0 +1,41 @@
+import { createRouter, createWebHistory } from 'vue-router'
+{{#if hasAuth}}
+import { useAuth } from '../vasp/auth.js'
+{{/if}}
+
+const routes = [
+{{#each routes}}
+  {
+    path: '{{path}}',
+    component: () => import('{{lookup ../pagesMap to}}'),
+  },
+{{/each}}
+{{#if hasAuth}}
+  {
+    path: '/login',
+    component: () => import('../pages/Login.vue'),
+  },
+  {
+    path: '/register',
+    component: () => import('../pages/Register.vue'),
+  },
+{{/if}}
+]
+
+const router = createRouter({
+  history: createWebHistory(),
+  routes,
+})
+
+{{#if hasAuth}}
+router.beforeEach(async (to) => {
+  const { user, checkAuth } = useAuth()
+  await checkAuth()
+  const publicPaths = ['/login', '/register']
+  if (!user.value && !publicPaths.includes(to.path)) {
+    return '/login'
+  }
+})
+{{/if}}
+
+export default router

package/templates/templates/spa/js/src/vasp/auth.js.hbs

@@ -0,0 +1,45 @@
+import { ref } from 'vue'
+import { $fetch } from 'ofetch'
+
+const user = ref(null)
+let checked = false
+
+const API = import.meta.env.VITE_API_URL || '/api'
+
+export function useAuth() {
+  async function checkAuth() {
+    if (checked) return
+    checked = true
+    try {
+      user.value = await $fetch(`${API}/auth/me`, { credentials: 'include' })
+    } catch {
+      user.value = null
+    }
+  }
+
+  async function login(username, password) {
+    user.value = await $fetch(`${API}/auth/login`, {
+      method: 'POST',
+      body: { username, password },
+      credentials: 'include',
+    })
+    return user.value
+  }
+
+  async function register(username, password, email) {
+    user.value = await $fetch(`${API}/auth/register`, {
+      method: 'POST',
+      body: { username, password, email },
+      credentials: 'include',
+    })
+    return user.value
+  }
+
+  async function logout() {
+    await $fetch(`${API}/auth/logout`, { method: 'POST', credentials: 'include' })
+    user.value = null
+    checked = false
+  }
+
+  return { user, checkAuth, login, register, logout }
+}

package/templates/templates/spa/js/src/vasp/client/actions.js.hbs

@@ -0,0 +1,15 @@
+// Auto-generated by Vasp — do not edit
+import { useVasp } from '@vasp-framework/runtime'
+
+{{#each actions}}
+/**
+ * Call the '{{name}}' action on the Vasp backend.
+ * @param {unknown} args - Arguments to pass to the action function
+ * @returns {Promise<unknown>}
+ */
+export async function {{camelCase name}}(args) {
+  const { $vasp } = useVasp()
+  return $vasp.action('{{camelCase name}}', args)
+}
+
+{{/each}}

package/templates/templates/spa/js/src/vasp/client/crud.js.hbs

@@ -0,0 +1,30 @@
+// Auto-generated by Vasp — do not edit
+import { $fetch } from 'ofetch'
+
+const API = import.meta.env.VITE_API_URL || '/api'
+
+{{#each cruds}}
+/**
+ * CRUD helpers for the '{{entity}}' entity.
+ */
+export function use{{pascalCase entity}}Crud() {
+  const base = `${API}/crud/{{camelCase entity}}`
+
+  return {
+{{#if (includes operations "list")}}
+    list: () => $fetch(base, { credentials: 'include' }),
+{{/if}}
+{{#if (includes operations "create")}}
+    create: (data) => $fetch(base, { method: 'POST', body: data, credentials: 'include' }),
+{{/if}}
+    get: (id) => $fetch(`${base}/${id}`, { credentials: 'include' }),
+{{#if (includes operations "update")}}
+    update: (id, data) => $fetch(`${base}/${id}`, { method: 'PUT', body: data, credentials: 'include' }),
+{{/if}}
+{{#if (includes operations "delete")}}
+    remove: (id) => $fetch(`${base}/${id}`, { method: 'DELETE', credentials: 'include' }),
+{{/if}}
+  }
+}
+
+{{/each}}

package/templates/templates/spa/js/src/vasp/client/index.js.hbs

@@ -0,0 +1,16 @@
+// Auto-generated by Vasp — do not edit directly
+// Re-run `vasp build` or restart `vasp start` to regenerate
+
+export { useVasp } from '@vasp-framework/runtime'
+{{#each queries}}
+export { {{camelCase name}} } from './queries.js'
+{{/each}}
+{{#each actions}}
+export { {{camelCase name}} } from './actions.js'
+{{/each}}
+{{#each cruds}}
+export { use{{pascalCase entity}}Crud } from './crud.js'
+{{/each}}
+{{#if hasRealtime}}
+export { useRealtime } from './realtime.js'
+{{/if}}

package/templates/templates/spa/js/src/vasp/client/queries.js.hbs

@@ -0,0 +1,15 @@
+// Auto-generated by Vasp — do not edit
+import { useVasp } from '@vasp-framework/runtime'
+
+{{#each queries}}
+/**
+ * Call the '{{name}}' query on the Vasp backend.
+ * @param {unknown} [args] - Arguments to pass to the query function
+ * @returns {Promise<unknown>}
+ */
+export async function {{camelCase name}}(args) {
+  const { $vasp } = useVasp()
+  return $vasp.query('{{camelCase name}}', args)
+}
+
+{{/each}}

package/templates/templates/spa/js/src/vasp/client/realtime.js.hbs

@@ -0,0 +1,51 @@
+// Auto-generated by Vasp — do not edit
+import { ref, onUnmounted } from 'vue'
+
+const WS_BASE = import.meta.env.VITE_WS_URL || `ws://${location.host}`
+
+/**
+ * useRealtime — subscribe to a Vasp realtime channel.
+ *
+ * @example
+ * const { on } = useRealtime('todoChannel')
+ * on('created', (todo) => todos.value.push(todo))
+ */
+export function useRealtime(channelName) {
+  const connected = ref(false)
+  const handlers = new Map()
+  let ws = null
+  let reconnectTimer = null
+
+  function connect() {
+    ws = new WebSocket(`${WS_BASE}/ws/${channelName}`)
+
+    ws.onopen = () => { connected.value = true }
+    ws.onclose = () => {
+      connected.value = false
+      reconnectTimer = setTimeout(connect, 3000) // auto-reconnect
+    }
+    ws.onerror = () => ws.close()
+    ws.onmessage = ({ data }) => {
+      try {
+        const msg = JSON.parse(data)
+        if (msg.channel === channelName && handlers.has(msg.event)) {
+          handlers.get(msg.event)(msg.data)
+        }
+      } catch {}
+    }
+  }
+
+  function on(event, handler) {
+    handlers.set(event, handler)
+  }
+
+  function disconnect() {
+    clearTimeout(reconnectTimer)
+    ws?.close()
+  }
+
+  connect()
+  onUnmounted(disconnect)
+
+  return { connected, on, disconnect }
+}

package/templates/templates/spa/js/src/vasp/plugin.js.hbs

@@ -0,0 +1,11 @@
+import { createVaspClient } from '@vasp-framework/runtime'
+
+export const vaspPlugin = {
+  install(app) {
+    const client = createVaspClient({
+      baseURL: import.meta.env.VITE_API_URL || '/api',
+    })
+    app.provide('$vasp', client)
+    app.config.globalProperties.$vasp = client
+  },
+}

package/templates/templates/spa/js/vite.config.js.hbs

@@ -0,0 +1,26 @@
+import { defineConfig } from 'vite'
+import vue from '@vitejs/plugin-vue'
+import { fileURLToPath, URL } from 'node:url'
+
+export default defineConfig({
+  plugins: [vue()],
+  resolve: {
+    alias: {
+      '@src': fileURLToPath(new URL('./src', import.meta.url)),
+      '@vasp-framework/client': fileURLToPath(new URL('./src/vasp/client', import.meta.url)),
+    },
+  },
+  server: {
+    port: {{frontendPort}},
+    proxy: {
+      '/api': {
+        target: 'http://localhost:{{backendPort}}',
+        changeOrigin: true,
+      },
+      '/ws': {
+        target: 'ws://localhost:{{backendPort}}',
+        ws: true,
+      },
+    },
+  },
+})

package/templates/templates/spa/ts/index.html.hbs

@@ -0,0 +1,12 @@
+<!DOCTYPE html>
+<html lang="en">
+  <head>
+    <meta charset="UTF-8" />
+    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+    <title>{{appTitle}}</title>
+  </head>
+  <body>
+    <div id="app"></div>
+    <script type="module" src="/src/main.ts"></script>
+  </body>
+</html>

package/templates/templates/spa/ts/src/App.vue.hbs

@@ -0,0 +1,3 @@
+<template>
+  <RouterView />
+</template>

package/templates/templates/spa/ts/src/main.ts.hbs

@@ -0,0 +1,9 @@
+import { createApp } from 'vue'
+import App from './App.vue'
+import router from './router/index.js'
+import { vaspPlugin } from './vasp/plugin.js'
+
+const app = createApp(App)
+app.use(router)
+app.use(vaspPlugin)
+app.mount('#app')

package/templates/templates/spa/ts/src/router/index.ts.hbs

@@ -0,0 +1,41 @@
+import { createRouter, createWebHistory, type RouteRecordRaw } from 'vue-router'
+{{#if hasAuth}}
+import { useAuth } from '../vasp/auth.js'
+{{/if}}
+
+const routes: RouteRecordRaw[] = [
+{{#each routes}}
+  {
+    path: '{{path}}',
+    component: () => import('{{lookup ../pagesMap to}}'),
+  },
+{{/each}}
+{{#if hasAuth}}
+  {
+    path: '/login',
+    component: () => import('../pages/Login.vue'),
+  },
+  {
+    path: '/register',
+    component: () => import('../pages/Register.vue'),
+  },
+{{/if}}
+]
+
+const router = createRouter({
+  history: createWebHistory(),
+  routes,
+})
+
+{{#if hasAuth}}
+router.beforeEach(async (to) => {
+  const { user, checkAuth } = useAuth()
+  await checkAuth()
+  const publicPaths = ['/login', '/register']
+  if (!user.value && !publicPaths.includes(to.path)) {
+    return '/login'
+  }
+})
+{{/if}}
+
+export default router

package/templates/templates/spa/ts/src/vasp/auth.ts.hbs

@@ -0,0 +1,53 @@
+import { ref, type Ref } from 'vue'
+import { $fetch } from 'ofetch'
+
+export interface AuthUser {
+  id: number
+  username: string
+  email: string | null
+  createdAt: Date
+  updatedAt: Date
+}
+
+const user: Ref<AuthUser | null> = ref(null)
+let checked = false
+
+const API = import.meta.env.VITE_API_URL || '/api'
+
+export function useAuth() {
+  async function checkAuth(): Promise<void> {
+    if (checked) return
+    checked = true
+    try {
+      user.value = await $fetch<AuthUser>(`${API}/auth/me`, { credentials: 'include' })
+    } catch {
+      user.value = null
+    }
+  }
+
+  async function login(username: string, password: string): Promise<AuthUser> {
+    user.value = await $fetch<AuthUser>(`${API}/auth/login`, {
+      method: 'POST',
+      body: { username, password },
+      credentials: 'include',
+    })
+    return user.value!
+  }
+
+  async function register(username: string, password: string, email?: string): Promise<AuthUser> {
+    user.value = await $fetch<AuthUser>(`${API}/auth/register`, {
+      method: 'POST',
+      body: { username, password, email },
+      credentials: 'include',
+    })
+    return user.value!
+  }
+
+  async function logout(): Promise<void> {
+    await $fetch(`${API}/auth/logout`, { method: 'POST', credentials: 'include' })
+    user.value = null
+    checked = false
+  }
+
+  return { user, checkAuth, login, register, logout }
+}

package/templates/templates/spa/ts/src/vasp/client/actions.ts.hbs

@@ -0,0 +1,19 @@
+// Auto-generated by Vasp — do not edit
+import { useVasp } from '@vasp-framework/runtime'
+import type {
+{{#each actions}}
+  {{pascalCase name}}Args,
+  {{pascalCase name}}Return,
+{{/each}}
+} from './types.js'
+
+{{#each actions}}
+/**
+ * Call the '{{name}}' action on the Vasp backend.
+ */
+export async function {{camelCase name}}(args: {{pascalCase name}}Args): Promise<{{pascalCase name}}Return> {
+  const { $vasp } = useVasp()
+  return $vasp.action('{{camelCase name}}', args) as Promise<{{pascalCase name}}Return>
+}
+
+{{/each}}

package/templates/templates/spa/ts/src/vasp/client/crud.ts.hbs

@@ -0,0 +1,37 @@
+// Auto-generated by Vasp — do not edit
+import { $fetch } from 'ofetch'
+import type {
+{{#each cruds}}
+  {{pascalCase entity}},
+  New{{pascalCase entity}},
+{{/each}}
+} from './types.js'
+
+const API = import.meta.env.VITE_API_URL || '/api'
+
+{{#each cruds}}
+export function use{{pascalCase entity}}Crud() {
+  const base = `${API}/crud/{{camelCase entity}}`
+
+  return {
+{{#if (includes operations "list")}}
+    list: (): Promise<{{pascalCase entity}}[]> => $fetch(base, { credentials: 'include' }),
+{{/if}}
+{{#if (includes operations "create")}}
+    create: (data: New{{pascalCase entity}}): Promise<{{pascalCase entity}}> =>
+      $fetch(base, { method: 'POST', body: data, credentials: 'include' }),
+{{/if}}
+    get: (id: number): Promise<{{pascalCase entity}}> =>
+      $fetch(`${base}/${id}`, { credentials: 'include' }),
+{{#if (includes operations "update")}}
+    update: (id: number, data: Partial<New{{pascalCase entity}}>): Promise<{{pascalCase entity}}> =>
+      $fetch(`${base}/${id}`, { method: 'PUT', body: data, credentials: 'include' }),
+{{/if}}
+{{#if (includes operations "delete")}}
+    remove: (id: number): Promise<{ ok: boolean }> =>
+      $fetch(`${base}/${id}`, { method: 'DELETE', credentials: 'include' }),
+{{/if}}
+  }
+}
+
+{{/each}}

package/templates/templates/spa/ts/src/vasp/client/index.ts.hbs

@@ -0,0 +1,17 @@
+// Auto-generated by Vasp — do not edit directly
+// Re-run `vasp build` or restart `vasp start` to regenerate
+
+export { useVasp } from '@vasp-framework/runtime'
+{{#each queries}}
+export { {{camelCase name}} } from './queries.js'
+{{/each}}
+{{#each actions}}
+export { {{camelCase name}} } from './actions.js'
+{{/each}}
+{{#each cruds}}
+export { use{{pascalCase entity}}Crud } from './crud.js'
+{{/each}}
+{{#if hasRealtime}}
+export { useRealtime } from './realtime.js'
+{{/if}}
+export type * from './types.js'

package/templates/templates/spa/ts/src/vasp/client/queries.ts.hbs

@@ -0,0 +1,19 @@
+// Auto-generated by Vasp — do not edit
+import { useVasp } from '@vasp-framework/runtime'
+import type {
+{{#each queries}}
+  {{pascalCase name}}Args,
+  {{pascalCase name}}Return,
+{{/each}}
+} from './types.js'
+
+{{#each queries}}
+/**
+ * Call the '{{name}}' query on the Vasp backend.
+ */
+export async function {{camelCase name}}(args?: {{pascalCase name}}Args): Promise<{{pascalCase name}}Return> {
+  const { $vasp } = useVasp()
+  return $vasp.query('{{camelCase name}}', args) as Promise<{{pascalCase name}}Return>
+}
+
+{{/each}}