betterstart-cli 0.0.1

package/dist/assets/adapters/next/templates/init/lib/db/core/schema.ts

@@ -0,0 +1,160 @@
+import { sql } from 'drizzle-orm'
+import {
+  boolean,
+  index,
+  integer,
+  jsonb,
+  pgTable,
+  text,
+  timestamp,
+  uniqueIndex,
+  uuid,
+  varchar
+} from 'drizzle-orm/pg-core'
+
+// ============================================================================
+// Better Auth tables
+// ============================================================================
+
+export const user = pgTable('user', {
+  id: text('id').primaryKey(),
+  name: text('name').notNull(),
+  email: text('email').notNull().unique(),
+  emailVerified: boolean('email_verified').notNull().default(false),
+  image: text('image'),
+  role: text('role').notNull().default('member'),
+  createdAt: timestamp('created_at').notNull().defaultNow(),
+  updatedAt: timestamp('updated_at').notNull().defaultNow()
+})
+
+export const session = pgTable('session', {
+  id: text('id').primaryKey(),
+  expiresAt: timestamp('expires_at').notNull(),
+  token: text('token').notNull().unique(),
+  createdAt: timestamp('created_at').notNull().defaultNow(),
+  updatedAt: timestamp('updated_at').notNull().defaultNow(),
+  ipAddress: text('ip_address'),
+  userAgent: text('user_agent'),
+  userId: text('user_id')
+    .notNull()
+    .references(() => user.id, { onDelete: 'cascade' })
+})
+
+export const account = pgTable('account', {
+  id: text('id').primaryKey(),
+  accountId: text('account_id').notNull(),
+  providerId: text('provider_id').notNull(),
+  userId: text('user_id')
+    .notNull()
+    .references(() => user.id, { onDelete: 'cascade' }),
+  accessToken: text('access_token'),
+  refreshToken: text('refresh_token'),
+  idToken: text('id_token'),
+  accessTokenExpiresAt: timestamp('access_token_expires_at'),
+  refreshTokenExpiresAt: timestamp('refresh_token_expires_at'),
+  scope: text('scope'),
+  password: text('password'),
+  createdAt: timestamp('created_at').notNull().defaultNow(),
+  updatedAt: timestamp('updated_at').notNull().defaultNow()
+})
+
+export const verification = pgTable('verification', {
+  id: text('id').primaryKey(),
+  identifier: text('identifier').notNull(),
+  value: text('value').notNull(),
+  expiresAt: timestamp('expires_at').notNull(),
+  createdAt: timestamp('created_at').defaultNow(),
+  updatedAt: timestamp('updated_at').defaultNow()
+})
+
+// ============================================================================
+// Form Settings (shared table for all form configurations)
+// ============================================================================
+
+export const formSettings = pgTable(
+  'FormSettings',
+  {
+    id: uuid().defaultRandom().primaryKey().notNull(),
+    formName: varchar('formName', { length: 100 }).notNull(),
+    webhookUrl: text('webhookUrl'),
+    webhookEnabled: boolean('webhookEnabled').default(false).notNull(),
+    notificationEmails: text('notificationEmails'),
+    createdAt: timestamp('createdAt', { precision: 3, mode: 'string' })
+      .default(sql`CURRENT_TIMESTAMP`)
+      .notNull(),
+    updatedAt: timestamp('updatedAt', { precision: 3, mode: 'string' })
+      .default(sql`CURRENT_TIMESTAMP`)
+      .notNull()
+  },
+  (table) => [
+    uniqueIndex('FormSettings_formName_key').using(
+      'btree',
+      table.formName.asc().nullsLast().op('text_ops')
+    )
+  ]
+)
+
+// ============================================================================
+// Entity Versions
+// ============================================================================
+
+export const entityVersions = pgTable(
+  'EntityVersions',
+  {
+    id: uuid().defaultRandom().primaryKey().notNull(),
+    entityType: varchar('entity_type', { length: 100 }).notNull(),
+    entityId: uuid('entity_id').notNull(),
+    version: integer().notNull(),
+    data: jsonb().notNull(),
+    createdAt: timestamp('created_at', { precision: 3, mode: 'string' })
+      .default(sql`CURRENT_TIMESTAMP`)
+      .notNull(),
+    createdBy: text('created_by').references(() => user.id, {
+      onDelete: 'set null'
+    })
+  },
+  (table) => [
+    uniqueIndex('EntityVersions_entityType_entityId_version_key').using(
+      'btree',
+      table.entityType.asc().nullsLast().op('text_ops'),
+      table.entityId.asc().nullsLast().op('uuid_ops'),
+      table.version.asc().nullsLast()
+    ),
+    index('EntityVersions_entityType_entityId_createdAt_idx').using(
+      'btree',
+      table.entityType.asc().nullsLast().op('text_ops'),
+      table.entityId.asc().nullsLast().op('uuid_ops'),
+      table.createdAt.desc().nullsLast().op('timestamp_ops')
+    )
+  ]
+)
+
+// ============================================================================
+// Media Library
+// ============================================================================
+
+export const adminMedia = pgTable('AdminMedia', {
+  id: text('id')
+    .primaryKey()
+    .$defaultFn(() => crypto.randomUUID()),
+  url: text('url').notNull(),
+  filename: varchar('filename', { length: 500 }).notNull(),
+  contentType: varchar('content_type', { length: 255 }).notNull(),
+  size: integer('size').notNull(),
+  width: integer('width'),
+  height: integer('height'),
+  alt: text('alt'),
+  tags: text('tags').array(),
+  createdAt: timestamp('created_at', { precision: 3, mode: 'string' })
+    .default(sql`CURRENT_TIMESTAMP`)
+    .notNull(),
+  updatedAt: timestamp('updated_at', { precision: 3, mode: 'string' })
+    .default(sql`CURRENT_TIMESTAMP`)
+    .notNull(),
+  createdBy: text('created_by').references(() => user.id, {
+    onDelete: 'set null'
+  }),
+  updatedBy: text('updated_by').references(() => user.id, {
+    onDelete: 'set null'
+  })
+})

package/dist/assets/adapters/next/templates/init/lib/db/schema.ts

@@ -0,0 +1 @@
+export * from './core'

package/dist/assets/adapters/next/templates/init/lib/lifecycle-hooks/index.ts

@@ -0,0 +1,19 @@
+import './register'
+import './register.local'
+
+export {
+  getLifecycleHookSummary,
+  getRegisteredHooks,
+  registerHook
+} from './registry'
+export { runAfterHooks, runBeforeHooks } from './runner'
+export type {
+  AfterLifecycleHookEvent,
+  AfterLifecycleHookHandler,
+  BeforeLifecycleHookEvent,
+  BeforeLifecycleHookHandler,
+  LifecycleHookAbort,
+  LifecycleHookContext,
+  LifecycleHookEvent,
+  LifecycleHookHandler
+} from './types'

package/dist/assets/adapters/next/templates/init/lib/lifecycle-hooks/register.local.ts

@@ -0,0 +1,2 @@
+// Register project-specific lifecycle hooks here.
+// This file is committed so teams can share hooks alongside generated admin code.

package/dist/assets/adapters/next/templates/init/lib/lifecycle-hooks/register.ts

@@ -0,0 +1,9 @@
+// This file is managed by BetterStart and may be overwritten by CLI updates.
+// Add project-specific lifecycle hook registrations in register.local.ts.
+//
+// Example:
+// import { registerHook } from './registry'
+//
+// registerHook('posts', 'afterCreate', async ({ user, entityId, data }) => {
+//   console.log('Post created', { userId: user.id, entityId, data })
+// })

package/dist/assets/adapters/next/templates/init/lib/lifecycle-hooks/registry.ts

@@ -0,0 +1,55 @@
+import type { LifecycleHookEvent, LifecycleHookHandler } from './types'
+
+type HookBuckets = Map<LifecycleHookEvent, LifecycleHookHandler<LifecycleHookEvent>[]>
+
+const lifecycleHooks = new Map<string, HookBuckets>()
+
+export function registerHook<Event extends LifecycleHookEvent>(
+  entityType: string,
+  event: Event,
+  handler: LifecycleHookHandler<Event>
+): () => void {
+  const normalizedEntityType = entityType.trim()
+  if (!normalizedEntityType || normalizedEntityType === '*') {
+    throw new Error('Lifecycle hooks must be registered for a specific entity type')
+  }
+
+  const buckets = lifecycleHooks.get(normalizedEntityType) ?? new Map()
+  const handlers = buckets.get(event) ?? []
+  handlers.push(handler as LifecycleHookHandler<LifecycleHookEvent>)
+  buckets.set(event, handlers)
+  lifecycleHooks.set(normalizedEntityType, buckets)
+
+  return () => {
+    const currentHandlers = buckets.get(event)
+    if (!currentHandlers) return
+
+    const index = currentHandlers.indexOf(handler as LifecycleHookHandler<LifecycleHookEvent>)
+    if (index >= 0) {
+      currentHandlers.splice(index, 1)
+    }
+  }
+}
+
+export function getRegisteredHooks<Event extends LifecycleHookEvent>(
+  entityType: string,
+  event: Event
+): LifecycleHookHandler<Event>[] {
+  return [...((lifecycleHooks.get(entityType)?.get(event) ?? []) as LifecycleHookHandler<Event>[])]
+}
+
+export function getLifecycleHookSummary(): Record<
+  string,
+  Partial<Record<LifecycleHookEvent, number>>
+> {
+  const summary: Record<string, Partial<Record<LifecycleHookEvent, number>>> = {}
+
+  for (const [entityType, events] of lifecycleHooks.entries()) {
+    summary[entityType] = {}
+    for (const [event, handlers] of events.entries()) {
+      summary[entityType][event] = handlers.length
+    }
+  }
+
+  return summary
+}

package/dist/assets/adapters/next/templates/init/lib/lifecycle-hooks/runner.ts

@@ -0,0 +1,51 @@
+import { getRegisteredHooks } from './registry'
+import type {
+  AfterLifecycleHookEvent,
+  BeforeLifecycleHookEvent,
+  LifecycleHookAbort,
+  LifecycleHookContext
+} from './types'
+
+function isLifecycleHookAbort(value: unknown): value is LifecycleHookAbort {
+  return (
+    typeof value === 'object' &&
+    value !== null &&
+    'abort' in value &&
+    (value as { abort: unknown }).abort === true
+  )
+}
+
+function createAbortError(event: BeforeLifecycleHookEvent, context: LifecycleHookContext): Error {
+  return new Error(`Lifecycle hook ${event} aborted ${context.entityType}`)
+}
+
+export async function runBeforeHooks(
+  event: BeforeLifecycleHookEvent,
+  context: LifecycleHookContext
+): Promise<void> {
+  const handlers = getRegisteredHooks(context.entityType, event)
+
+  for (const handler of handlers) {
+    const result = await handler(context)
+    if (isLifecycleHookAbort(result)) {
+      throw result.reason ? new Error(result.reason) : createAbortError(event, context)
+    }
+  }
+}
+
+export function runAfterHooks(event: AfterLifecycleHookEvent, context: LifecycleHookContext): void {
+  const handlers = getRegisteredHooks(context.entityType, event)
+  if (handlers.length === 0) return
+
+  void Promise.allSettled(handlers.map((handler) => handler(context))).then((results) => {
+    for (const result of results) {
+      if (result.status === 'rejected') {
+        console.error('Lifecycle hook failed:', {
+          entityType: context.entityType,
+          event,
+          error: result.reason
+        })
+      }
+    }
+  })
+}

package/dist/assets/adapters/next/templates/init/lib/lifecycle-hooks/types.ts

@@ -0,0 +1,39 @@
+import type { User } from '@admin/auth'
+
+export type LifecycleHookEvent =
+  | 'beforeCreate'
+  | 'afterCreate'
+  | 'beforeUpdate'
+  | 'afterUpdate'
+  | 'beforeDelete'
+  | 'afterDelete'
+  | 'beforePublish'
+  | 'afterPublish'
+  | 'beforeUnpublish'
+  | 'afterUnpublish'
+
+export type BeforeLifecycleHookEvent = Extract<LifecycleHookEvent, `before${string}`>
+export type AfterLifecycleHookEvent = Extract<LifecycleHookEvent, `after${string}`>
+
+export interface LifecycleHookContext {
+  user: User
+  entityType: string
+  timestamp: string
+  entityId?: string | undefined
+  input?: Record<string, unknown> | undefined
+  data?: Record<string, unknown> | undefined
+}
+
+export interface LifecycleHookAbort {
+  abort: true
+  reason?: string
+}
+
+export type BeforeLifecycleHookHandler = (
+  context: LifecycleHookContext
+) => undefined | LifecycleHookAbort | Promise<undefined | LifecycleHookAbort>
+
+export type AfterLifecycleHookHandler = (context: LifecycleHookContext) => void | Promise<void>
+
+export type LifecycleHookHandler<Event extends LifecycleHookEvent> =
+  Event extends BeforeLifecycleHookEvent ? BeforeLifecycleHookHandler : AfterLifecycleHookHandler

package/dist/assets/adapters/next/templates/init/pages/account-layout.tsx

@@ -0,0 +1,11 @@
+import { ContentSkeleton } from '@admin/components/layouts/content-skeleton'
+import { Suspense } from 'react'
+import { AccountShellRsc } from './account-shell-rsc'
+
+export default function AccountLayout({ children }: { children: React.ReactNode }) {
+  return (
+    <Suspense fallback={<ContentSkeleton />}>
+      <AccountShellRsc>{children}</AccountShellRsc>
+    </Suspense>
+  )
+}

package/dist/assets/adapters/next/templates/init/pages/account-shell-rsc.tsx

@@ -0,0 +1,30 @@
+import { getSession } from '@admin/auth/middleware'
+import { AdminSidebar } from '@admin/components/layouts/admin-sidebar'
+import { SidebarProvider } from '@admin/components/ui/sidebar'
+import { admin } from '@admin/utils/app/admin'
+import { canAccessAdmin } from '@admin/utils/auth/roles'
+import { redirect } from 'next/navigation'
+import { MinimalAccountShell } from './minimal-account-shell'
+
+export async function AccountShellRsc({ children }: { children: React.ReactNode }) {
+  const session = await getSession({ disableCookieCache: true })
+
+  if (!session?.user) {
+    redirect('/admin/login')
+  }
+
+  if (!canAccessAdmin(session.user.role)) {
+    return (
+      <MinimalAccountShell name={session.user.name ?? admin.name}>{children}</MinimalAccountShell>
+    )
+  }
+
+  return (
+    <SidebarProvider className="min-h-svh">
+      <AdminSidebar />
+      <div className="relative flex min-w-0 flex-1 flex-col [--admin-shell-content-left:0px] md:[--admin-shell-content-left:var(--sidebar-width)] md:peer-data-[state=collapsed]:[--admin-shell-content-left:var(--sidebar-width-icon)]">
+        {children}
+      </div>
+    </SidebarProvider>
+  )
+}

package/dist/assets/adapters/next/templates/init/pages/admin-layout.tsx

@@ -0,0 +1,24 @@
+import '@admin/admin-globals.css'
+import { AdminProviders } from '@admin/components/layouts/admin-providers'
+import { cn } from '@admin/utils/shared/cn'
+import { GeistMono } from 'geist/font/mono'
+import { GeistSans } from 'geist/font/sans'
+import { NuqsAdapter } from 'nuqs/adapters/next/app'
+
+export default function AdminLayout({ children }: { children: React.ReactNode }) {
+  return (
+    <NuqsAdapter>
+      <AdminProviders>
+        <div
+          className={cn(
+            'admin-root min-h-screen antialiased w-screen mt-px',
+            GeistSans.variable,
+            GeistMono.variable
+          )}
+        >
+          {children}
+        </div>
+      </AdminProviders>
+    </NuqsAdapter>
+  )
+}

package/dist/assets/adapters/next/templates/init/pages/auth-gate-rsc.tsx

@@ -0,0 +1,6 @@
+import { requireRole, UserRole } from '@admin/auth/middleware'
+
+export async function AuthGateRsc({ children }: { children: React.ReactNode }) {
+  await requireRole([UserRole.ADMIN, UserRole.EDITOR])
+  return <>{children}</>
+}

package/dist/assets/adapters/next/templates/init/pages/authenticated-layout.tsx

@@ -0,0 +1,18 @@
+import { AdminSidebar } from '@admin/components/layouts/admin-sidebar'
+import { ContentSkeleton } from '@admin/components/layouts/content-skeleton'
+import { SidebarProvider } from '@admin/components/ui/sidebar'
+import { Suspense } from 'react'
+import { AuthGateRsc } from './auth-gate-rsc'
+
+export default function AdminAuthLayout({ children }: { children: React.ReactNode }) {
+  return (
+    <SidebarProvider className="min-h-svh">
+      <AdminSidebar />
+      <div className="relative flex min-w-0 flex-1 flex-col [--admin-shell-content-left:0px] md:[--admin-shell-content-left:var(--sidebar-width)] md:peer-data-[state=collapsed]:[--admin-shell-content-left:var(--sidebar-width-icon)]">
+        <Suspense fallback={<ContentSkeleton />}>
+          <AuthGateRsc>{children}</AuthGateRsc>
+        </Suspense>
+      </div>
+    </SidebarProvider>
+  )
+}

package/dist/assets/adapters/next/templates/init/pages/dashboard-page.tsx

@@ -0,0 +1,121 @@
+import { PageHeader } from '@admin/components/shared/page-header'
+import {
+  Accordion,
+  AccordionContent,
+  AccordionItem,
+  AccordionTrigger
+} from '@admin/components/ui/accordion'
+import { Badge } from '@admin/components/ui/badge'
+import { Button } from '@admin/components/ui/button'
+import { Card, CardContent, CardHeader, CardTitle } from '@admin/components/ui/card'
+import { Blocks, CircleGauge, FileQuestion, Globe, PlugZap, ShieldEllipsis } from 'lucide-react'
+import React from 'react'
+
+const envVariables = [
+  {
+    label: 'Database',
+    name: 'DATABASE_URL',
+    value: process.env.DATABASE_URL
+  },
+  {
+    label: 'Storage (Cloudflare R2)',
+    name: 'BETTERSTART_R2_BUCKET_NAME',
+    value: process.env.BETTERSTART_R2_BUCKET_NAME
+  },
+  {
+    label: 'Email (Resend)',
+    name: 'BETTERSTART_RESEND_API_KEY',
+    value: process.env.BETTERSTART_RESEND_API_KEY
+  }
+]
+
+export default function DashboardPage() {
+  return (
+    <React.Fragment>
+      <PageHeader title="Dashboard" hasBackButton={false} />
+
+      <div className="p-6 space-y-6 w-full">
+        <Card>
+          <CardHeader>
+            <div className="flex items-center gap-2">
+              <CircleGauge className="size-4 text-muted-foreground" />
+              <CardTitle className="font-medium">Setup your dashboard</CardTitle>
+            </div>
+          </CardHeader>
+          <CardContent className="p-10!">
+            <div className="grid grid-cols-2 gap-10">
+              <div className="flex flex-col w-full gap-1">
+                <p className="text-base font-medium">Hey, let's get started</p>
+                <p className="text-muted-foreground">
+                  Lorem ipsum dolor sit amet consectetur adipisicing elit. Quisquam, quos.
+                </p>
+              </div>
+              <div className="flex flex-col w-full">
+                <Accordion type="single" collapsible defaultValue="item-1">
+                  <AccordionItem value="item-1">
+                    <AccordionTrigger>
+                      <div className="flex items-center gap-3">
+                        <ShieldEllipsis className="size-4 text-muted-foreground" />
+                        <span>Setup ENV Variables</span>
+                      </div>
+                    </AccordionTrigger>
+                    <AccordionContent className="pl-7 h-auto">
+                      <div className="flex flex-col w-full gap-1">
+                        {envVariables.map((env) => (
+                          <div
+                            className="flex flex-col w-full bg-card border shadow-card border-border rounded-lg pl-4 pr-2 py-2"
+                            key={env.name}
+                          >
+                            <div className="flex items-center justify-between">
+                              <div className="flex items-center gap-2">
+                                <span className="">{env.label}</span>
+                                <Badge variant={env.value ? 'success' : 'destructive'}>
+                                  {env.value ? 'Connected' : 'Not configured'}
+                                </Badge>
+                              </div>
+
+                              <Button variant="ghost" className="size-8">
+                                <FileQuestion className="size-4" />
+                              </Button>
+                            </div>
+                          </div>
+                        ))}
+                      </div>
+                    </AccordionContent>
+                  </AccordionItem>
+                  <AccordionItem value="item-2">
+                    <AccordionTrigger>
+                      <div className="flex items-center gap-3">
+                        <Blocks className="size-4 text-muted-foreground" />
+                        <span>Install Pre-built Modules</span>
+                      </div>
+                    </AccordionTrigger>
+                    <AccordionContent className="pl-7">Lorem</AccordionContent>
+                  </AccordionItem>
+                  <AccordionItem value="item-3">
+                    <AccordionTrigger>
+                      <div className="flex items-center gap-3">
+                        <PlugZap className="size-4 text-muted-foreground" />
+                        <span>Setup Provider Integrations</span>
+                      </div>
+                    </AccordionTrigger>
+                    <AccordionContent className="pl-7">Lorem</AccordionContent>
+                  </AccordionItem>
+                  <AccordionItem value="item-4">
+                    <AccordionTrigger>
+                      <div className="flex items-center gap-3">
+                        <Globe className="size-4 text-muted-foreground" />
+                        <span>Deploy</span>
+                      </div>
+                    </AccordionTrigger>
+                    <AccordionContent className="pl-7">Lorem</AccordionContent>
+                  </AccordionItem>
+                </Accordion>
+              </div>
+            </div>
+          </CardContent>
+        </Card>
+      </div>
+    </React.Fragment>
+  )
+}