betterstart-cli 0.0.100 → 0.0.102

package/dist/assets/adapters/next/templates/init/lib/actions/webhooks/get-webhook-subscriptions.ts

@@ -1,24 +1,8 @@
 'use server'
 
-import type { WebhookSubscriptionEntry } from './types'
+import type { WebhookSubscriptionEntry } from '@admin/actions/webhooks/types'
+import { readWebhookSubscriptions } from '@admin/actions/webhooks/read-webhook-subscriptions'
 import { requireRole, UserRole } from '@admin/auth/middleware'
-import db from '@admin/db'
-import { webhookSubscriptions } from '@admin/db/schema'
-import { cacheLife, cacheTag } from 'next/cache'
-import { webhooksCacheTags } from './types'
-
-async function readWebhookSubscriptions(): Promise<WebhookSubscriptionEntry[]> {
-  'use cache'
-  cacheLife('max')
-  cacheTag(webhooksCacheTags.subscriptions)
-
-  return db
-    .select({
-      webhookId: webhookSubscriptions.webhookId,
-      event: webhookSubscriptions.event
-    })
-    .from(webhookSubscriptions)
-}
 
 export async function getWebhookSubscriptions(): Promise<WebhookSubscriptionEntry[]> {
   await requireRole([UserRole.ADMIN])

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

@@ -4,7 +4,7 @@ import type { WebhooksPage, WebhooksQuery } from './types'
 import { requireRole, UserRole } from '@admin/auth/middleware'
 import db from '@admin/db'
 import { webhookDeliveries, webhookSubscriptions, webhooks } from '@admin/db/schema'
-import { getExclusiveDateUpperBound } from '@admin/utils/date/date'
+import { getExclusiveDateUpperBound } from '@admin/utils/date/get-exclusive-date-upper-bound'
 import { and, asc, count, desc, eq, gte, ilike, isNull, lt, or, sql } from 'drizzle-orm'
 
 // Deliberately uncached: filters and sorting depend on delivery rows written

package/dist/assets/adapters/next/templates/init/lib/actions/webhooks/prune-webhook-deliveries.ts

@@ -0,0 +1,26 @@
+import db from '@admin/db'
+import { webhookDeliveries } from '@admin/db/schema'
+import { and, desc, eq, notInArray } from 'drizzle-orm'
+
+const DELIVERY_LOG_LIMIT = 100
+
+export async function pruneWebhookDeliveries(webhookId: string): Promise<void> {
+  const keepRows = await db
+    .select({ id: webhookDeliveries.id })
+    .from(webhookDeliveries)
+    .where(eq(webhookDeliveries.webhookId, webhookId))
+    .orderBy(desc(webhookDeliveries.createdAt))
+    .limit(DELIVERY_LOG_LIMIT)
+
+  if (keepRows.length < DELIVERY_LOG_LIMIT) return
+
+  await db.delete(webhookDeliveries).where(
+    and(
+      eq(webhookDeliveries.webhookId, webhookId),
+      notInArray(
+        webhookDeliveries.id,
+        keepRows.map((row) => row.id)
+      )
+    )
+  )
+}

package/dist/assets/adapters/next/templates/init/lib/actions/webhooks/read-webhook-subscriptions.ts

@@ -0,0 +1,18 @@
+import type { WebhookSubscriptionEntry } from '@admin/actions/webhooks/types'
+import { webhooksCacheTags } from '@admin/actions/webhooks/types'
+import db from '@admin/db'
+import { webhookSubscriptions } from '@admin/db/schema'
+import { cacheLife, cacheTag } from 'next/cache'
+
+export async function readWebhookSubscriptions(): Promise<WebhookSubscriptionEntry[]> {
+  'use cache'
+  cacheLife('max')
+  cacheTag(webhooksCacheTags.subscriptions)
+
+  return db
+    .select({
+      webhookId: webhookSubscriptions.webhookId,
+      event: webhookSubscriptions.event
+    })
+    .from(webhookSubscriptions)
+}

package/dist/assets/adapters/next/templates/init/lib/actions/webhooks/record-webhook-delivery.ts

@@ -0,0 +1,24 @@
+import { pruneWebhookDeliveries } from '@admin/actions/webhooks/prune-webhook-deliveries'
+import db from '@admin/db'
+import { webhookDeliveries } from '@admin/db/schema'
+
+export async function recordWebhookDelivery(entry: {
+  webhookId: string
+  event: string
+  eventId: string
+  attempt: number
+  success: boolean
+  statusCode: number | null
+  durationMs: number
+  error: string | null
+}): Promise<void> {
+  try {
+    await db.insert(webhookDeliveries).values(entry)
+    await pruneWebhookDeliveries(entry.webhookId)
+  } catch (error) {
+    console.error('Failed to record webhook delivery:', {
+      event: entry.event,
+      error
+    })
+  }
+}

package/dist/assets/adapters/next/templates/init/lib/actions/webhooks/regenerate-webhook-secret.ts

@@ -4,8 +4,8 @@ import type { WebhookSecretResult } from './types'
 import { requireRole, UserRole } from '@admin/auth/middleware'
 import db from '@admin/db'
 import { webhooks } from '@admin/db/schema'
-import { toActionError } from '@admin/utils/error/action-error'
-import { generateWebhookSecret } from '@admin/utils/webhook/signature'
+import { toActionError } from '@admin/utils/error/to-action-error'
+import { generateWebhookSecret } from '@admin/utils/webhook/generate-webhook-secret'
 import { eq } from 'drizzle-orm'
 import { updateTag } from 'next/cache'
 import { webhooksCacheTags } from './types'

package/dist/assets/adapters/next/templates/init/lib/actions/webhooks/{register.ts → register-webhook-hooks.ts}

@@ -2,9 +2,10 @@ import type {
   AfterLifecycleHookEvent,
   LifecycleHookContext
 } from '@admin/lib/lifecycle-hooks/types'
+import { emitWebhookEvent } from '@admin/actions/webhooks/emit-webhook-event'
+import { entityEventPayload } from '@admin/actions/webhooks/entity-event-payload'
 import { webhookEventSources } from '@admin/data/webhook-events'
 import { registerHook } from '@admin/lib/lifecycle-hooks/registry'
-import { emitWebhookEvent } from './dispatch'
 
 let webhookHooksRegistered = false
 
@@ -21,19 +22,6 @@ const ENTITY_EVENT_HOOKS: Array<{
   { hook: 'afterReorder', suffix: 'reordered' }
 ]
 
-function entityEventPayload(hook: AfterLifecycleHookEvent, context: LifecycleHookContext): unknown {
-  if (hook === 'afterRestore') {
-    return {
-      record: context.data ?? null,
-      restoredFromVersion: context.metadata?.restoredFromVersion ?? null
-    }
-  }
-  if (hook === 'afterDelete') {
-    return context.data ?? { id: context.entityId ?? null }
-  }
-  return context.data ?? null
-}
-
 export function registerWebhookHooks(): void {
   if (webhookHooksRegistered) return
   webhookHooksRegistered = true

package/dist/assets/adapters/next/templates/init/lib/actions/webhooks/send-test-webhook.ts

@@ -4,8 +4,9 @@ import type { SendTestWebhookResult } from './types'
 import { requireRole, UserRole } from '@admin/auth/middleware'
 import db from '@admin/db'
 import { webhooks } from '@admin/db/schema'
-import { toActionError } from '@admin/utils/error/action-error'
-import { createWebhookEventId, signWebhookPayload } from '@admin/utils/webhook/signature'
+import { toActionError } from '@admin/utils/error/to-action-error'
+import { createWebhookEventId } from '@admin/utils/webhook/create-webhook-event-id'
+import { signWebhookPayload } from '@admin/utils/webhook/sign-webhook-payload'
 import { eq } from 'drizzle-orm'
 import { recordWebhookDelivery } from './dispatch'
 

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

@@ -4,7 +4,7 @@ import type { UpdateWebhookInput, WebhookResult } from './types'
 import { requireRole, UserRole } from '@admin/auth/middleware'
 import db from '@admin/db'
 import { webhookSubscriptions, webhooks } from '@admin/db/schema'
-import { toActionError } from '@admin/utils/error/action-error'
+import { toActionError } from '@admin/utils/error/to-action-error'
 import { and, eq, notInArray } from 'drizzle-orm'
 import { updateTag } from 'next/cache'
 import { webhooksCacheTags } from './types'

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

@@ -1,7 +1,7 @@
 // This file is managed by BetterStart and may be overwritten by CLI updates.
 // Add project-specific lifecycle hook registrations in register.local.ts.
 import { registerAuditHooks } from '@admin/actions/audit/register'
-import { registerWebhookHooks } from '@admin/actions/webhooks/register'
+import { registerWebhookHooks } from '@admin/actions/webhooks/register-webhook-hooks'
 
 registerAuditHooks()
 registerWebhookHooks()

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

@@ -2,7 +2,7 @@ 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 { canAccessAdmin } from '@admin/utils/auth/can-access-admin'
 import { redirect } from 'next/navigation'
 import { MinimalAccountShell } from './minimal-account-shell'
 

package/dist/assets/adapters/next/templates/init/pages/login-form.tsx

@@ -7,7 +7,7 @@ import { Card, CardContent } from '@admin/components/ui/card'
 import { Field, FieldGroup, FieldLabel } from '@admin/components/ui/field'
 import { Input } from '@admin/components/ui/input'
 import { Spinner } from '@admin/components/ui/spinner'
-import { getAdminPostLoginPath } from '@admin/utils/auth/roles'
+import { getAdminPostLoginPath } from '@admin/utils/auth/get-admin-post-login-path'
 import { cn } from '@admin/utils/shared/cn'
 import Image from 'next/image'
 import Link from 'next/link'

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

@@ -1,5 +1,5 @@
 import { getSession } from '@admin/auth/middleware'
-import { getAdminPostLoginPath } from '@admin/utils/auth/roles'
+import { getAdminPostLoginPath } from '@admin/utils/auth/get-admin-post-login-path'
 import { redirect } from 'next/navigation'
 import { LoginForm } from './login-form'
 

package/dist/assets/adapters/next/templates/init/pages/users/columns.tsx

@@ -10,7 +10,7 @@ import {
   DropdownMenuTrigger
 } from '@admin/components/ui/dropdown-menu'
 import { UserRole } from '@admin/types/auth'
-import { getUserInitials } from '@admin/utils/user/user'
+import { getUserInitials } from '@admin/utils/user/get-user-initials'
 import { Edit, MoreHorizontal, ShieldCheck } from 'lucide-react'
 import { ChangePasswordDialog } from './change-password-dialog'
 import { DeleteUserDialog } from './delete-user-dialog'

package/dist/assets/adapters/next/templates/init/pages/users/users-table.tsx

@@ -16,7 +16,7 @@ import { DataTablePagination } from '@admin/components/shared/data-table/data-ta
 import { useTableUtils } from '@admin/hooks/use-table-utils'
 import { useUsers } from '@admin/hooks/use-users'
 import { cn } from '@admin/utils/shared/cn'
-import { getUsersPage } from '@admin/utils/user/user'
+import { getUsersPage } from '@admin/utils/user/get-users-page'
 import { flexRender, getCoreRowModel, useReactTable } from '@tanstack/react-table'
 import { GripVertical } from 'lucide-react'
 import { parseAsInteger, parseAsString, useQueryStates } from 'nuqs'

package/dist/assets/adapters/next/templates/init/utils/audit/get-changed-field-names.ts

@@ -0,0 +1,18 @@
+import { normalizeComparableValue } from '@admin/utils/audit/normalize-comparable-value'
+import { shouldTrackField } from '@admin/utils/audit/should-track-field'
+
+export function getChangedFieldNames(
+  previous: Record<string, unknown> | null | undefined,
+  next: Record<string, unknown> | null | undefined
+): string[] {
+  if (!next) return []
+
+  return Object.keys(next)
+    .filter(shouldTrackField)
+    .filter((fieldName) => {
+      const previousValue = previous?.[fieldName]
+      const nextValue = next[fieldName]
+      return normalizeComparableValue(previousValue) !== normalizeComparableValue(nextValue)
+    })
+    .sort((a, b) => a.localeCompare(b))
+}

package/dist/assets/adapters/next/templates/init/utils/audit/get-touched-field-names.ts

@@ -0,0 +1,9 @@
+import { shouldTrackField } from '@admin/utils/audit/should-track-field'
+
+export function getTouchedFieldNames(input: Record<string, unknown> | null | undefined): string[] {
+  if (!input) return []
+
+  return Object.keys(input)
+    .filter(shouldTrackField)
+    .sort((a, b) => a.localeCompare(b))
+}

package/dist/assets/adapters/next/templates/init/utils/audit/normalize-comparable-value.ts

@@ -0,0 +1,14 @@
+export function normalizeComparableValue(value: unknown): string {
+  if (value instanceof Date) return value.toISOString()
+  if (Array.isArray(value)) {
+    return JSON.stringify(value.map((item) => normalizeComparableValue(item)))
+  }
+  if (value && typeof value === 'object') {
+    const entries = Object.entries(value as Record<string, unknown>)
+      .sort(([a], [b]) => a.localeCompare(b))
+      .map(([key, item]) => [key, normalizeComparableValue(item)])
+    return JSON.stringify(entries)
+  }
+
+  return JSON.stringify(value ?? null)
+}

package/dist/assets/adapters/next/templates/init/utils/audit/should-track-field.ts

@@ -0,0 +1,15 @@
+const REDACTED_FIELD_PATTERNS = [/password/i, /token/i, /secret/i, /key/i]
+const SYSTEM_FIELD_NAMES = new Set([
+  'id',
+  'createdAt',
+  'updatedAt',
+  'createdBy',
+  'updatedBy',
+  'createdByUser',
+  'updatedByUser'
+])
+
+export function shouldTrackField(fieldName: string): boolean {
+  if (SYSTEM_FIELD_NAMES.has(fieldName)) return false
+  return !REDACTED_FIELD_PATTERNS.some((pattern) => pattern.test(fieldName))
+}

package/dist/assets/adapters/next/templates/init/utils/auth/can-access-admin.ts

@@ -0,0 +1,7 @@
+import { ADMIN_ACCESS_ROLES, UserRole } from '@admin/types/auth'
+import { hasRequiredRole } from '@admin/utils/auth/has-required-role'
+import { isUserRole } from '@admin/utils/auth/is-user-role'
+
+export function canAccessAdmin(role: unknown): role is UserRole.ADMIN | UserRole.EDITOR {
+  return isUserRole(role) && hasRequiredRole(role, ADMIN_ACCESS_ROLES)
+}

package/dist/assets/adapters/next/templates/init/utils/auth/get-admin-post-login-path.ts

@@ -0,0 +1,5 @@
+import { canAccessAdmin } from '@admin/utils/auth/can-access-admin'
+
+export function getAdminPostLoginPath(role: unknown): '/admin' | '/admin/profile' {
+  return canAccessAdmin(role) ? '/admin' : '/admin/profile'
+}

package/dist/assets/adapters/next/templates/init/utils/auth/has-required-role.ts

@@ -0,0 +1,5 @@
+import type { UserRole } from '@admin/types/auth'
+
+export function hasRequiredRole(userRole: UserRole, allowedRoles: readonly UserRole[]): boolean {
+  return allowedRoles.includes(userRole)
+}

package/dist/assets/adapters/next/templates/init/utils/auth/is-user-role.ts

@@ -0,0 +1,5 @@
+import { UserRole } from '@admin/types/auth'
+
+export function isUserRole(value: unknown): value is UserRole {
+  return typeof value === 'string' && Object.values(UserRole).includes(value as UserRole)
+}

package/dist/assets/adapters/next/templates/init/utils/date/build-date-range.ts

@@ -0,0 +1,14 @@
+import type { DateRange } from 'react-day-picker'
+import { parseDateInputValue } from '@admin/utils/date/parse-date-input-value'
+
+export function buildDateRange(from?: string, to?: string): DateRange | undefined {
+  const fromDate = parseDateInputValue(from)
+  const toDate = parseDateInputValue(to)
+
+  if (!fromDate && !toDate) return undefined
+
+  return {
+    from: fromDate,
+    to: toDate
+  }
+}

package/dist/assets/adapters/next/templates/init/utils/date/date-range-end-time.ts

@@ -0,0 +1 @@
+export const DATE_RANGE_END_TIME = '23:59'

package/dist/assets/adapters/next/templates/init/utils/date/date-range-input-format.ts

@@ -0,0 +1 @@
+export const DATE_RANGE_INPUT_FORMAT = 'MMM d, yyyy'

package/dist/assets/adapters/next/templates/init/utils/date/date-range-start-time.ts

@@ -0,0 +1 @@
+export const DATE_RANGE_START_TIME = '00:00'

package/dist/assets/adapters/next/templates/init/utils/date/format-date-range-input-date.ts

@@ -0,0 +1,6 @@
+import { DATE_RANGE_INPUT_FORMAT } from '@admin/utils/date/date-range-input-format'
+import { format } from 'date-fns'
+
+export function formatDateRangeInputDate(date?: Date) {
+  return date ? format(date, DATE_RANGE_INPUT_FORMAT) : ''
+}

package/dist/assets/adapters/next/templates/init/utils/date/format-date-range-param-date.ts

@@ -0,0 +1,7 @@
+import { format } from 'date-fns'
+
+const DATE_RANGE_PARAM_FORMAT = 'yyyy-MM-dd'
+
+export function formatDateRangeParamDate(date: Date) {
+  return format(date, DATE_RANGE_PARAM_FORMAT)
+}

package/dist/assets/adapters/next/templates/init/utils/date/format-date-range-trigger-date.ts

@@ -0,0 +1,5 @@
+import { format } from 'date-fns'
+
+export function formatDateRangeTriggerDate(date: Date, includeYear = false) {
+  return format(date, includeYear ? 'MMM d, yyyy' : 'MMM d')
+}

package/dist/assets/adapters/next/templates/init/utils/date/get-date-range-trigger-label.ts

@@ -0,0 +1,24 @@
+import { formatDateRangeTriggerDate } from '@admin/utils/date/format-date-range-trigger-date'
+import { format } from 'date-fns'
+
+export function getDateRangeTriggerLabel(
+  from?: Date,
+  to?: Date,
+  placeholder = 'Pick a date range'
+) {
+  if (!from) return placeholder
+  if (!to) return `${formatDateRangeTriggerDate(from, true)} - ...`
+
+  const sameYear = from.getFullYear() === to.getFullYear()
+  const sameMonth = sameYear && from.getMonth() === to.getMonth()
+
+  if (sameMonth) {
+    return `${formatDateRangeTriggerDate(from)} - ${format(to, 'd')}`
+  }
+
+  if (sameYear) {
+    return `${formatDateRangeTriggerDate(from)} - ${formatDateRangeTriggerDate(to)}`
+  }
+
+  return `${formatDateRangeTriggerDate(from, true)} - ${formatDateRangeTriggerDate(to, true)}`
+}

package/dist/assets/adapters/next/templates/init/utils/date/get-exclusive-date-upper-bound.ts

@@ -0,0 +1,9 @@
+export function getExclusiveDateUpperBound(value?: string): string | null {
+  if (!value) return null
+
+  const date = new Date(`${value}T00:00:00.000Z`)
+  if (Number.isNaN(date.getTime())) return null
+
+  date.setUTCDate(date.getUTCDate() + 1)
+  return date.toISOString().slice(0, 10)
+}

package/dist/assets/adapters/next/templates/init/utils/date/get-ordered-date-range.ts

@@ -0,0 +1,12 @@
+import type { DateRange } from 'react-day-picker'
+import { isAfter } from 'date-fns'
+
+export function getOrderedDateRange(range?: DateRange) {
+  if (!range?.from) return range
+  if (!range.to || !isAfter(range.from, range.to)) return range
+
+  return {
+    from: range.to,
+    to: range.from
+  }
+}

package/dist/assets/adapters/next/templates/init/utils/date/normalize-date-range-time.ts

@@ -0,0 +1,5 @@
+const DATE_RANGE_TIME_PATTERN = /^([01]\d|2[0-3]):([0-5]\d)$/
+
+export function normalizeDateRangeTime(value: string, fallback: string) {
+  return DATE_RANGE_TIME_PATTERN.test(value) ? value : fallback
+}

package/dist/assets/adapters/next/templates/init/utils/date/parse-date-input-value.ts

@@ -0,0 +1,6 @@
+export function parseDateInputValue(value?: string): Date | undefined {
+  if (!value) return undefined
+
+  const parsed = new Date(`${value}T00:00:00`)
+  return Number.isNaN(parsed.getTime()) ? undefined : parsed
+}

package/dist/assets/adapters/next/templates/init/utils/date/parse-editable-date-range-date.ts

@@ -0,0 +1,17 @@
+import { DATE_RANGE_INPUT_FORMAT } from '@admin/utils/date/date-range-input-format'
+import { parseDateInputValue } from '@admin/utils/date/parse-date-input-value'
+import { isValid, parse } from 'date-fns'
+
+export function parseEditableDateRangeDate(value: string) {
+  const trimmedValue = value.trim()
+  if (!trimmedValue) return undefined
+
+  const isoDate = parseDateInputValue(trimmedValue)
+  if (isoDate) return isoDate
+
+  const parsed = parse(trimmedValue, DATE_RANGE_INPUT_FORMAT, new Date())
+  if (isValid(parsed)) return parsed
+
+  const fallback = new Date(trimmedValue)
+  return isValid(fallback) ? fallback : undefined
+}

package/dist/assets/adapters/next/templates/init/utils/editor/active-table-cell-class.ts

@@ -0,0 +1 @@
+export const ACTIVE_TABLE_CELL_CLASS = 'content-editor-active-table-cell'

package/dist/assets/adapters/next/templates/init/utils/editor/active-table-cell.ts

@@ -0,0 +1,36 @@
+import { ACTIVE_TABLE_CELL_CLASS } from '@admin/utils/editor/active-table-cell-class'
+import { Extension } from '@tiptap/core'
+import { Plugin, PluginKey } from '@tiptap/pm/state'
+import { cellAround, findTable } from '@tiptap/pm/tables'
+import { Decoration, DecorationSet } from '@tiptap/pm/view'
+
+export const ActiveTableCell = Extension.create({
+  name: 'contentEditorActiveTableCell',
+
+  addProseMirrorPlugins() {
+    return [
+      new Plugin({
+        key: new PluginKey('contentEditorActiveTableCell'),
+        props: {
+          decorations(state) {
+            if (!findTable(state.selection.$from)) {
+              return null
+            }
+
+            const cell = cellAround(state.selection.$from)
+            if (!cell) return null
+
+            const cellNode = state.doc.nodeAt(cell.pos)
+            if (!cellNode) return null
+
+            return DecorationSet.create(state.doc, [
+              Decoration.node(cell.pos, cell.pos + cellNode.nodeSize, {
+                class: ACTIVE_TABLE_CELL_CLASS
+              })
+            ])
+          }
+        }
+      })
+    ]
+  }
+})

package/dist/assets/adapters/next/templates/init/utils/editor/active-table-wrapper-class.ts

@@ -0,0 +1 @@
+export const ACTIVE_TABLE_WRAPPER_CLASS = 'content-editor-table-with-add-controls'

package/dist/assets/adapters/next/templates/init/utils/editor/append-column-to-table.ts

@@ -0,0 +1,13 @@
+import type { Editor } from '@tiptap/react'
+import { getTableRectAtPosition } from '@admin/utils/editor/get-table-rect-at-position'
+import { addColumn } from '@tiptap/pm/tables'
+
+export function appendColumnToTable(editor: Editor, tablePos: number): boolean {
+  const rect = getTableRectAtPosition(editor, tablePos)
+  if (!rect) return false
+
+  const tr = addColumn(editor.state.tr, rect, rect.map.width).scrollIntoView()
+  editor.view.dispatch(tr)
+  editor.commands.focus()
+  return true
+}

package/dist/assets/adapters/next/templates/init/utils/editor/append-row-to-table.ts

@@ -0,0 +1,13 @@
+import type { Editor } from '@tiptap/react'
+import { getTableRectAtPosition } from '@admin/utils/editor/get-table-rect-at-position'
+import { addRow } from '@tiptap/pm/tables'
+
+export function appendRowToTable(editor: Editor, tablePos: number): boolean {
+  const rect = getTableRectAtPosition(editor, tablePos)
+  if (!rect) return false
+
+  const tr = addRow(editor.state.tr, rect, rect.map.height).scrollIntoView()
+  editor.view.dispatch(tr)
+  editor.commands.focus()
+  return true
+}

package/dist/assets/adapters/next/templates/init/utils/editor/apply-cursor-change-if-available.ts

@@ -0,0 +1,8 @@
+import type { EditorView } from '@codemirror/view'
+import { applyCursorChange } from '@admin/utils/editor/apply-cursor-change'
+
+export function applyCursorChangeIfAvailable(view: EditorView | null, cursorPos: number): void {
+  if (view) {
+    applyCursorChange(view, cursorPos)
+  }
+}

package/dist/assets/adapters/next/templates/init/utils/editor/apply-cursor-change.ts

@@ -0,0 +1,10 @@
+import type { EditorView } from '@codemirror/view'
+
+export function applyCursorChange(view: EditorView, cursorPos: number): void {
+  requestAnimationFrame(() => {
+    view.dispatch({
+      selection: { anchor: Math.min(cursorPos, view.state.doc.length) }
+    })
+    view.focus()
+  })
+}

package/dist/assets/adapters/next/templates/init/utils/editor/can-insert-content-editor-media-placeholder.ts

@@ -0,0 +1,10 @@
+import type { Editor } from '@tiptap/react'
+import { CONTENT_EDITOR_MEDIA_PLACEHOLDER_NODE } from '@admin/utils/editor/content-editor-media-placeholder-node'
+import { isExtensionAvailable } from '@admin/utils/editor/is-extension-available'
+
+export function canInsertContentEditorMediaPlaceholder(editor: Editor | null): boolean {
+  if (!editor?.isEditable) return false
+  if (!isExtensionAvailable(editor, CONTENT_EDITOR_MEDIA_PLACEHOLDER_NODE)) return false
+
+  return editor.can().insertContent({ type: CONTENT_EDITOR_MEDIA_PLACEHOLDER_NODE })
+}

package/dist/assets/adapters/next/templates/init/utils/editor/checkbox-label-factory.ts

@@ -0,0 +1,5 @@
+import type { TaskItemOptions } from '@tiptap/extension-list'
+
+export type CheckboxLabelFactory = NonNullable<
+  NonNullable<TaskItemOptions['a11y']>['checkboxLabel']
+>

package/dist/assets/adapters/next/templates/init/utils/editor/clear-table-part-preview.ts

@@ -0,0 +1,11 @@
+import type { Editor } from '@tiptap/core'
+import { getEditorElement } from '@admin/utils/editor/get-editor-element'
+import { TABLE_PART_PREVIEW_CLASS } from '@admin/utils/editor/table-part-preview-class'
+
+export function clearTablePartPreview(editor: Editor | null) {
+  getEditorElement(editor)
+    ?.querySelectorAll(`.${TABLE_PART_PREVIEW_CLASS}`)
+    .forEach((cell) => {
+      cell.classList.remove(TABLE_PART_PREVIEW_CLASS)
+    })
+}

package/dist/assets/adapters/next/templates/init/utils/editor/content-editor-highlight-color-name-pattern.ts

@@ -0,0 +1,3 @@
+import { CONTENT_EDITOR_HIGHLIGHT_COLORS } from '@admin/utils/editor/content-editor-highlight-colors'
+
+export const CONTENT_EDITOR_HIGHLIGHT_COLOR_NAME_PATTERN = CONTENT_EDITOR_HIGHLIGHT_COLORS.join('|')

package/dist/assets/adapters/next/templates/init/utils/editor/content-editor-highlight-color-option.ts

@@ -0,0 +1,6 @@
+export interface ContentEditorHighlightColorOption {
+  label: string
+  value: string
+  colorValue: string
+  border: string
+}