betterstart-cli 0.0.1

package/dist/assets/adapters/next/templates/init/lib/actions/entity-versions/internal-create-entity-version.ts

@@ -0,0 +1,43 @@
+import type db from '@admin/db'
+import { entityVersions } from '@admin/db/schema'
+import { and, desc, eq, sql } from 'drizzle-orm'
+import type { EntityVersionData } from './types'
+
+type EntityVersionClient = Parameters<Parameters<typeof db.transaction>[0]>[0]
+
+interface CreateEntityVersionInput {
+  entityType: string
+  entityId: string
+  data: EntityVersionData
+  createdBy?: string | null
+}
+
+export async function createEntityVersion(
+  client: EntityVersionClient,
+  input: CreateEntityVersionInput
+): Promise<void> {
+  await client.execute(
+    sql`select pg_advisory_xact_lock(hashtext(${input.entityType}), hashtext(${input.entityId}))`
+  )
+
+  const [latestVersion] = await client
+    .select({ version: entityVersions.version })
+    .from(entityVersions)
+    .where(
+      and(
+        eq(entityVersions.entityType, input.entityType),
+        eq(entityVersions.entityId, input.entityId)
+      )
+    )
+    .orderBy(desc(entityVersions.version))
+    .limit(1)
+
+  await client.insert(entityVersions).values({
+    entityType: input.entityType,
+    entityId: input.entityId,
+    version: (latestVersion?.version ?? 0) + 1,
+    data: input.data,
+    createdAt: new Date().toISOString(),
+    createdBy: input.createdBy ?? null
+  })
+}

package/dist/assets/adapters/next/templates/init/lib/actions/entity-versions/internal-delete-entity-versions.ts

@@ -0,0 +1,19 @@
+import type db from '@admin/db'
+import { entityVersions } from '@admin/db/schema'
+import { and, eq, inArray } from 'drizzle-orm'
+
+type EntityVersionClient = Parameters<Parameters<typeof db.transaction>[0]>[0]
+
+export async function deleteEntityVersions(
+  client: EntityVersionClient,
+  entityType: string,
+  entityIds: string[]
+): Promise<void> {
+  if (entityIds.length === 0) return
+
+  await client
+    .delete(entityVersions)
+    .where(
+      and(eq(entityVersions.entityType, entityType), inArray(entityVersions.entityId, entityIds))
+    )
+}

package/dist/assets/adapters/next/templates/init/lib/actions/entity-versions/types.ts

@@ -0,0 +1,26 @@
+export type EntityVersionData = Record<string, unknown>
+
+export interface EntityVersionAuthor {
+  id: string
+  name: string
+  email: string
+  image?: string | null
+}
+
+export interface EntityVersion {
+  id: string
+  entityType: string
+  entityId: string
+  version: number
+  data: EntityVersionData
+  createdAt: string
+  createdBy: string | null
+}
+
+export interface EntityVersionWithAuthor extends EntityVersion {
+  createdByUser: EntityVersionAuthor | null
+}
+
+export const entityVersionsCacheTags = {
+  for: (entityType: string, entityId: string) => `entityVersions:${entityType}:${entityId}`
+} as const

package/dist/assets/adapters/next/templates/init/lib/actions/forms/get-all-form-settings.ts

@@ -0,0 +1,21 @@
+'use server'
+
+import db from '@admin/db'
+import { formSettings } from '@admin/db/schema'
+import { cacheLife, cacheTag } from 'next/cache'
+import type { FormSettingsData } from './types'
+import { formSettingsCacheTags } from './types'
+
+export async function getAllFormSettings(): Promise<FormSettingsData[]> {
+  'use cache'
+  cacheLife('max')
+  cacheTag(formSettingsCacheTags.all)
+
+  try {
+    const settings = await db.select().from(formSettings)
+    return settings as FormSettingsData[]
+  } catch (error) {
+    console.error('Error fetching all form settings:', error)
+    return []
+  }
+}

package/dist/assets/adapters/next/templates/init/lib/actions/forms/get-form-settings.ts

@@ -0,0 +1,27 @@
+'use server'
+
+import db from '@admin/db'
+import { formSettings } from '@admin/db/schema'
+import { eq } from 'drizzle-orm'
+import { cacheLife, cacheTag } from 'next/cache'
+import type { FormSettingsData } from './types'
+import { formSettingsCacheTags } from './types'
+
+export async function getFormSettings(formName: string): Promise<FormSettingsData | null> {
+  'use cache'
+  cacheLife('max')
+  cacheTag(formSettingsCacheTags.byName(formName))
+  cacheTag(formSettingsCacheTags.all)
+
+  try {
+    const [settings] = await db
+      .select()
+      .from(formSettings)
+      .where(eq(formSettings.formName, formName))
+      .limit(1)
+    return (settings as FormSettingsData) ?? null
+  } catch (error) {
+    console.error(`Error fetching form settings for ${formName}:`, error)
+    return null
+  }
+}

package/dist/assets/adapters/next/templates/init/lib/actions/forms/index.ts

@@ -0,0 +1,9 @@
+export { getAllFormSettings } from './get-all-form-settings'
+export { getFormSettings } from './get-form-settings'
+export { testFormWebhook } from './test-form-webhook'
+export type {
+  FormSettingsData,
+  FormSettingsResult,
+  UpsertFormSettingsInput
+} from './types'
+export { upsertFormSettings } from './upsert-form-settings'

package/dist/assets/adapters/next/templates/init/lib/actions/forms/test-form-webhook.ts

@@ -0,0 +1,40 @@
+'use server'
+
+import { getFormSettings } from './get-form-settings'
+
+export async function testFormWebhook(
+  formName: string
+): Promise<{ success: boolean; error?: string }> {
+  try {
+    const settings = await getFormSettings(formName)
+    if (!settings?.webhookUrl) {
+      return { success: false, error: 'No webhook URL configured' }
+    }
+
+    const formData = new URLSearchParams()
+    formData.append('form_name', formName)
+    formData.append('test', 'true')
+    formData.append('message', 'This is a test webhook from BetterStart')
+    formData.append('timestamp', new Date().toISOString())
+
+    const response = await fetch(settings.webhookUrl, {
+      method: 'POST',
+      headers: { 'Content-Type': 'application/x-www-form-urlencoded' },
+      body: formData.toString()
+    })
+
+    if (!response.ok) {
+      return {
+        success: false,
+        error: `Webhook returned status ${response.status}`
+      }
+    }
+
+    return { success: true }
+  } catch (error) {
+    return {
+      success: false,
+      error: error instanceof Error ? error.message : 'Failed to send test webhook'
+    }
+  }
+}

package/dist/assets/adapters/next/templates/init/lib/actions/forms/types.ts

@@ -0,0 +1,26 @@
+export interface FormSettingsData {
+  id: string
+  formName: string
+  webhookUrl: string | null
+  webhookEnabled: boolean
+  notificationEmails: string | null
+  createdAt: string
+  updatedAt: string
+}
+
+export interface UpsertFormSettingsInput {
+  webhookUrl?: string | null
+  webhookEnabled?: boolean
+  notificationEmails?: string | null
+}
+
+export interface FormSettingsResult {
+  success: boolean
+  error?: string
+  settings?: FormSettingsData
+}
+
+export const formSettingsCacheTags = {
+  all: 'form-settings:all',
+  byName: (formName: string) => `form-settings:name:${formName}`
+} as const

package/dist/assets/adapters/next/templates/init/lib/actions/forms/upsert-form-settings.ts

@@ -0,0 +1,40 @@
+'use server'
+
+import db from '@admin/db'
+import { formSettings } from '@admin/db/schema'
+import { updateTag } from 'next/cache'
+import type { FormSettingsData, FormSettingsResult, UpsertFormSettingsInput } from './types'
+import { formSettingsCacheTags } from './types'
+
+export async function upsertFormSettings(
+  formName: string,
+  data: UpsertFormSettingsInput
+): Promise<FormSettingsResult> {
+  try {
+    const [settings] = await db
+      .insert(formSettings)
+      .values({
+        formName,
+        webhookUrl: data.webhookUrl ?? null,
+        webhookEnabled: data.webhookEnabled ?? false,
+        notificationEmails: data.notificationEmails ?? null
+      })
+      .onConflictDoUpdate({
+        target: formSettings.formName,
+        set: {
+          ...data,
+          updatedAt: new Date().toISOString()
+        }
+      })
+      .returning()
+    updateTag(formSettingsCacheTags.all)
+    updateTag(formSettingsCacheTags.byName(formName))
+    return { success: true, settings: settings as FormSettingsData }
+  } catch (error) {
+    console.error(`Error upserting form settings for ${formName}:`, error)
+    return {
+      success: false,
+      error: error instanceof Error ? error.message : 'Failed to save form settings'
+    }
+  }
+}

package/dist/assets/adapters/next/templates/init/lib/actions/media/create-media.ts

@@ -0,0 +1,39 @@
+'use server'
+
+import { getSession } from '@admin/auth/middleware'
+import db from '@admin/db'
+import { adminMedia } from '@admin/db/schema'
+import { updateTag } from 'next/cache'
+import { getMediaById } from './get-media-by-id'
+import { type CreateMediaInput, type CreateMediaResult, mediaCacheTags } from './types'
+
+export async function createMedia(data: CreateMediaInput): Promise<CreateMediaResult> {
+  try {
+    const session = await getSession()
+    const actorId = session?.user?.id ?? null
+    const now = new Date().toISOString()
+    const [row] = await db
+      .insert(adminMedia)
+      .values({
+        ...data,
+        createdAt: now,
+        updatedAt: now,
+        createdBy: actorId,
+        updatedBy: actorId
+      })
+      .returning({ id: adminMedia.id })
+    if (row?.id) {
+      updateTag(mediaCacheTags.all)
+      updateTag(mediaCacheTags.byId(row.id))
+    }
+    const media = row ? await getMediaById(row.id) : null
+    return media
+      ? { success: true, media }
+      : { success: false, error: 'Failed to create media record' }
+  } catch (error) {
+    return {
+      success: false,
+      error: error instanceof Error ? error.message : 'Failed to create media record'
+    }
+  }
+}

package/dist/assets/adapters/next/templates/init/lib/actions/media/delete-media-bulk.ts

@@ -0,0 +1,29 @@
+'use server'
+
+import db from '@admin/db'
+import { adminMedia } from '@admin/db/schema'
+import { inArray } from 'drizzle-orm'
+import { updateTag } from 'next/cache'
+import type { DeleteMediaBulkResult } from './types'
+import { mediaCacheTags } from './types'
+
+export async function deleteMediaBulk(ids: string[]): Promise<DeleteMediaBulkResult> {
+  if (ids.length === 0) return { success: true, deletedCount: 0 }
+
+  try {
+    const deletedRows = await db
+      .delete(adminMedia)
+      .where(inArray(adminMedia.id, ids))
+      .returning({ id: adminMedia.id })
+    updateTag(mediaCacheTags.all)
+    for (const id of ids) {
+      updateTag(mediaCacheTags.byId(id))
+    }
+    return { success: true, deletedCount: deletedRows.length }
+  } catch (error) {
+    return {
+      success: false,
+      error: error instanceof Error ? error.message : 'Failed to delete media'
+    }
+  }
+}

package/dist/assets/adapters/next/templates/init/lib/actions/media/delete-media.ts

@@ -0,0 +1,22 @@
+'use server'
+
+import db from '@admin/db'
+import { adminMedia } from '@admin/db/schema'
+import { eq } from 'drizzle-orm'
+import { updateTag } from 'next/cache'
+import type { DeleteMediaResult } from './types'
+import { mediaCacheTags } from './types'
+
+export async function deleteMedia(id: string): Promise<DeleteMediaResult> {
+  try {
+    await db.delete(adminMedia).where(eq(adminMedia.id, id))
+    updateTag(mediaCacheTags.all)
+    updateTag(mediaCacheTags.byId(id))
+    return { success: true }
+  } catch (error) {
+    return {
+      success: false,
+      error: error instanceof Error ? error.message : 'Failed to delete media'
+    }
+  }
+}

package/dist/assets/adapters/next/templates/init/lib/actions/media/get-media-by-id.ts

@@ -0,0 +1,18 @@
+'use server'
+
+import { adminMedia } from '@admin/db/schema'
+import type { AdminMedia } from '@admin/types'
+import { mapMediaRow, selectMedia } from '@admin/utils/media/query'
+import { eq } from 'drizzle-orm'
+import { cacheLife, cacheTag } from 'next/cache'
+import { mediaCacheTags } from './types'
+
+export async function getMediaById(id: string): Promise<AdminMedia | null> {
+  'use cache'
+  cacheLife('max')
+  cacheTag(mediaCacheTags.byId(id))
+  cacheTag(mediaCacheTags.all)
+
+  const [row] = await selectMedia().where(eq(adminMedia.id, id)).limit(1)
+  return row ? mapMediaRow(row) : null
+}

package/dist/assets/adapters/next/templates/init/lib/actions/media/get-media-by-ids.ts

@@ -0,0 +1,25 @@
+'use server'
+
+import { adminMedia } from '@admin/db/schema'
+import type { AdminMedia } from '@admin/types'
+import { mapMediaRow, selectMedia } from '@admin/utils/media/query'
+import { inArray } from 'drizzle-orm'
+import { cacheLife, cacheTag } from 'next/cache'
+import { mediaCacheTags } from './types'
+
+export async function getMediaByIds(ids: string[]): Promise<(AdminMedia | null)[]> {
+  'use cache'
+  cacheLife('max')
+  cacheTag(mediaCacheTags.all)
+  for (const id of ids) {
+    cacheTag(mediaCacheTags.byId(id))
+  }
+
+  if (ids.length === 0) return []
+
+  const uniqueIds = [...new Set(ids)]
+  const rows = await selectMedia().where(inArray(adminMedia.id, uniqueIds))
+
+  const map = new Map(rows.map((row) => [row.id, mapMediaRow(row)]))
+  return ids.map((id) => map.get(id) ?? null)
+}

package/dist/assets/adapters/next/templates/init/lib/actions/media/get-media.ts

@@ -0,0 +1,71 @@
+'use server'
+
+import db from '@admin/db'
+import { adminMedia } from '@admin/db/schema'
+import type { MediaListParams, MediaListResult } from '@admin/types'
+import { mapMediaRow, selectMedia } from '@admin/utils/media/query'
+import { and, desc, ilike, sql } from 'drizzle-orm'
+import { cacheLife, cacheTag } from 'next/cache'
+import { mediaCacheTags } from './types'
+
+const DEFAULT_MEDIA_PAGE = 1
+const DEFAULT_MEDIA_PAGE_SIZE = 40
+
+type GetMediaParams = MediaListParams
+type GetMediaResult = MediaListResult
+
+function clampMediaPage(value: number | undefined): number {
+  if (typeof value !== 'number' || !Number.isFinite(value)) {
+    return DEFAULT_MEDIA_PAGE
+  }
+
+  return Math.max(DEFAULT_MEDIA_PAGE, Math.floor(value))
+}
+
+function clampMediaPageSize(value: number | undefined): number {
+  if (typeof value !== 'number' || !Number.isFinite(value) || value <= 0) {
+    return DEFAULT_MEDIA_PAGE_SIZE
+  }
+
+  return Math.max(1, Math.floor(value))
+}
+
+export async function getMedia(params: GetMediaParams = {}) {
+  'use cache'
+  cacheLife('max')
+  cacheTag(mediaCacheTags.all)
+
+  const { search, contentType } = params
+  const page = clampMediaPage(params.page)
+  const pageSize = clampMediaPageSize(params.pageSize)
+  const offset = (page - 1) * pageSize
+
+  const conditions = []
+  if (search) {
+    conditions.push(ilike(adminMedia.filename, `%${search}%`))
+  }
+  if (contentType) {
+    conditions.push(ilike(adminMedia.contentType, `${contentType}%`))
+  }
+
+  const where = conditions.length > 0 ? and(...conditions) : undefined
+  const itemsQuery = selectMedia()
+    .where(where)
+    .orderBy(desc(adminMedia.createdAt))
+    .limit(pageSize)
+    .offset(offset)
+
+  const [items, countResult] = await Promise.all([
+    itemsQuery,
+    db.select({ count: sql<number>`count(*)` }).from(adminMedia).where(where)
+  ])
+
+  const result: GetMediaResult = {
+    media: items.map(mapMediaRow),
+    total: Number(countResult[0]?.count ?? 0),
+    page,
+    pageSize
+  }
+
+  return result
+}

package/dist/assets/adapters/next/templates/init/lib/actions/media/index.ts

@@ -0,0 +1,14 @@
+export { createMedia } from './create-media'
+export { deleteMedia } from './delete-media'
+export { deleteMediaBulk } from './delete-media-bulk'
+export { getMedia } from './get-media'
+export { getMediaById } from './get-media-by-id'
+export { getMediaByIds } from './get-media-by-ids'
+export type {
+  CreateMediaInput,
+  CreateMediaResult,
+  DeleteMediaBulkResult,
+  DeleteMediaResult,
+  UpdateMediaResult
+} from './types'
+export { updateMedia } from './update-media'

package/dist/assets/adapters/next/templates/init/lib/actions/media/types.ts

@@ -0,0 +1,31 @@
+import type { AdminMedia } from '@admin/types'
+
+export type CreateMediaInput = Omit<
+  AdminMedia,
+  'id' | 'createdAt' | 'updatedAt' | 'createdBy' | 'updatedBy' | 'createdByUser' | 'updatedByUser'
+>
+
+export interface CreateMediaResult {
+  success: boolean
+  error?: string
+  media?: AdminMedia
+}
+
+export interface UpdateMediaResult {
+  success: boolean
+  error?: string
+}
+
+export interface DeleteMediaResult {
+  success: boolean
+  error?: string
+}
+
+export interface DeleteMediaBulkResult extends DeleteMediaResult {
+  deletedCount?: number
+}
+
+export const mediaCacheTags = {
+  all: 'media:all',
+  byId: (id: string) => `media:id:${id}`
+} as const

package/dist/assets/adapters/next/templates/init/lib/actions/media/update-media.ts

@@ -0,0 +1,35 @@
+'use server'
+
+import { getSession } from '@admin/auth/middleware'
+import db from '@admin/db'
+import { adminMedia } from '@admin/db/schema'
+import { eq } from 'drizzle-orm'
+import { updateTag } from 'next/cache'
+import type { UpdateMediaResult } from './types'
+import { mediaCacheTags } from './types'
+
+export async function updateMedia(
+  id: string,
+  data: { alt?: string; tags?: string[] }
+): Promise<UpdateMediaResult> {
+  try {
+    const session = await getSession()
+    const actorId = session?.user?.id ?? null
+    await db
+      .update(adminMedia)
+      .set({
+        ...data,
+        updatedAt: new Date().toISOString(),
+        updatedBy: actorId
+      })
+      .where(eq(adminMedia.id, id))
+    updateTag(mediaCacheTags.all)
+    updateTag(mediaCacheTags.byId(id))
+    return { success: true }
+  } catch (error) {
+    return {
+      success: false,
+      error: error instanceof Error ? error.message : 'Failed to update media'
+    }
+  }
+}

package/dist/assets/adapters/next/templates/init/lib/actions/profile/index.ts

@@ -0,0 +1,4 @@
+export { invalidateUsersCache } from './invalidate-users-cache'
+export { isEmailConfigured } from './is-email-configured'
+export type { UpdateEmailResult } from './types'
+export { updateEmail } from './update-email'

package/dist/assets/adapters/next/templates/init/lib/actions/profile/invalidate-users-cache.ts

@@ -0,0 +1,14 @@
+'use server'
+
+import { getSession } from '@admin/auth/middleware'
+import { updateTag } from 'next/cache'
+import { usersCacheTags } from '../users/types'
+
+export async function invalidateUsersCache(): Promise<void> {
+  const session = await getSession()
+  if (!session?.user) {
+    return
+  }
+
+  updateTag(usersCacheTags.all)
+}

package/dist/assets/adapters/next/templates/init/lib/actions/profile/is-email-configured.ts

@@ -0,0 +1,7 @@
+'use server'
+
+import { isEmailDeliveryConfigured } from '@admin/actions/email'
+
+export async function isEmailConfigured(): Promise<boolean> {
+  return isEmailDeliveryConfigured()
+}

package/dist/assets/adapters/next/templates/init/lib/actions/profile/types.ts

@@ -0,0 +1,4 @@
+export interface UpdateEmailResult {
+  success: boolean
+  error?: string
+}

package/dist/assets/adapters/next/templates/init/lib/actions/profile/update-email.ts

@@ -0,0 +1,57 @@
+'use server'
+
+import { auth } from '@admin/auth'
+import { getSession } from '@admin/auth/middleware'
+import db from '@admin/db'
+import { user } from '@admin/db/schema'
+import { eq } from 'drizzle-orm'
+import { headers } from 'next/headers'
+import { invalidateUsersCache } from './invalidate-users-cache'
+import type { UpdateEmailResult } from './types'
+
+export async function updateEmail(
+  newEmail: string,
+  currentPassword: string
+): Promise<UpdateEmailResult> {
+  try {
+    const session = await getSession({ disableCookieCache: true })
+    if (!session?.user) {
+      return { success: false, error: 'Not authenticated' }
+    }
+
+    const verification = await auth.api
+      .verifyPassword({
+        body: { password: currentPassword },
+        headers: await headers()
+      })
+      .catch(() => null)
+
+    if (!verification?.status) {
+      return { success: false, error: 'Incorrect password' }
+    }
+
+    const existing = await db
+      .select({ id: user.id })
+      .from(user)
+      .where(eq(user.email, newEmail))
+      .limit(1)
+
+    if (existing.length > 0) {
+      return { success: false, error: 'Email already in use' }
+    }
+
+    await db
+      .update(user)
+      .set({ email: newEmail, updatedAt: new Date() })
+      .where(eq(user.id, session.user.id))
+
+    await invalidateUsersCache()
+
+    return { success: true }
+  } catch (error) {
+    return {
+      success: false,
+      error: error instanceof Error ? error.message : 'Failed to update email'
+    }
+  }
+}

package/dist/assets/adapters/next/templates/init/lib/actions/storage/index.ts

@@ -0,0 +1,2 @@
+export { getStorageProvider } from './provider'
+export { saveUpload } from './save-upload'