betterstart-cli 0.0.100 → 0.0.101

package/dist/assets/adapters/next/templates/init/hooks/content-editor/use-content-editor-media-insertion.ts

@@ -4,12 +4,10 @@ import * as React from 'react'
 import type { Editor } from '@tiptap/react'
 import { useIsBreakpoint } from '@admin/hooks/content-editor/use-is-breakpoint'
 import { useTiptapEditor } from '@admin/hooks/content-editor/use-tiptap-editor'
-import {
-  CONTENT_EDITOR_MEDIA_SHORTCUT_KEY,
-  canInsertContentEditorMediaPlaceholder,
-  insertContentEditorMediaPlaceholder,
-  isContentEditorMediaPlaceholderActive
-} from '@admin/utils/editor/tiptap'
+import { canInsertContentEditorMediaPlaceholder } from '@admin/utils/editor/can-insert-content-editor-media-placeholder'
+import { CONTENT_EDITOR_MEDIA_SHORTCUT_KEY } from '@admin/utils/editor/content-editor-media-shortcut-key'
+import { insertContentEditorMediaPlaceholder } from '@admin/utils/editor/insert-content-editor-media-placeholder'
+import { isContentEditorMediaPlaceholderActive } from '@admin/utils/editor/is-content-editor-media-placeholder-active'
 import { useHotkeys } from 'react-hotkeys-hook'
 
 export interface UseContentEditorMediaInsertionOptions {

package/dist/assets/adapters/next/templates/init/hooks/content-editor/use-content-editor-slash-menu.ts

@@ -2,14 +2,12 @@
 
 import * as React from 'react'
 import type { ContentEditorSlashCommand } from '@admin/utils/editor/slash-commands'
-import type { SlashMenuState } from '@admin/utils/editor/tiptap'
+import type { SlashMenuState } from '@admin/utils/editor/slash-menu-state'
 import type { Editor } from '@tiptap/react'
+import { getSlashMenuState } from '@admin/utils/editor/get-slash-menu-state'
+import { isSameSlashMenuState } from '@admin/utils/editor/is-same-slash-menu-state'
+import { runSlashCommand } from '@admin/utils/editor/run-slash-command'
 import { getFilteredSlashCommands } from '@admin/utils/editor/slash-commands'
-import {
-  getSlashMenuState,
-  isSameSlashMenuState,
-  runSlashCommand
-} from '@admin/utils/editor/tiptap'
 
 export function useContentEditorSlashMenu(editorRef: React.RefObject<Editor | null>) {
   const [slashMenu, setSlashMenu] = React.useState<SlashMenuState | null>(null)

package/dist/assets/adapters/next/templates/init/hooks/content-editor/use-content-editor-source-mode.tsx

@@ -1,35 +1,34 @@
 'use client'
 
 import * as React from 'react'
-import type { ContentEditorSelectionRequest } from '@admin/utils/editor/content-editor'
-import type { MarkdownHeadingLevel, MarkdownListType } from '@admin/utils/editor/markdown'
+import type { ContentEditorSelectionRequest } from '@admin/utils/editor/content-editor-selection-request'
+import type { MarkdownHeadingLevel } from '@admin/utils/editor/markdown-heading-level'
+import type { MarkdownListType } from '@admin/utils/editor/markdown-list-type'
 import type { ViewUpdate } from '@codemirror/view'
 import type { QueryClient } from '@tanstack/react-query'
 import type { ReactCodeMirrorRef } from '@uiw/react-codemirror'
 import type { Root } from 'react-dom/client'
 import { MediaField } from '@admin/components/custom/media-field'
 import { useTheme } from '@admin/hooks/use-admin-theme'
-import {
-  applyCursorChange,
-  applyCursorChangeIfAvailable,
-  createMarkdownTableText,
-  findMarkdownLinkRange,
-  formatMarkdownBlockquoteLine,
-  formatMarkdownHeadingLine,
-  formatMarkdownListLine,
-  getMarkdownHeadingFallback,
-  getMarkdownListFallback,
-  insertComponentAtCursor,
-  insertMarkdownTextAtPosition,
-  insertTextAtCursor,
-  parseContentEditorMathInput,
-  removeHighlightSpanAtCursor,
-  removeMarkdownLinkAtCursor,
-  setMarkdownLinkAtCursor,
-  transformSelectedMarkdownLines
-} from '@admin/utils/editor/markdown'
-import { createMarkdownTextFromUrl } from '@admin/utils/editor/source-media'
-import { sanitizeUrl } from '@admin/utils/editor/tiptap'
+import { applyCursorChange } from '@admin/utils/editor/apply-cursor-change'
+import { applyCursorChangeIfAvailable } from '@admin/utils/editor/apply-cursor-change-if-available'
+import { createMarkdownTableText } from '@admin/utils/editor/create-markdown-table-text'
+import { createMarkdownTextFromUrl } from '@admin/utils/editor/create-markdown-text-from-url'
+import { findMarkdownLinkRange } from '@admin/utils/editor/find-markdown-link-range'
+import { formatMarkdownBlockquoteLine } from '@admin/utils/editor/format-markdown-blockquote-line'
+import { formatMarkdownHeadingLine } from '@admin/utils/editor/format-markdown-heading-line'
+import { formatMarkdownListLine } from '@admin/utils/editor/format-markdown-list-line'
+import { getMarkdownHeadingFallback } from '@admin/utils/editor/get-markdown-heading-fallback'
+import { getMarkdownListFallback } from '@admin/utils/editor/get-markdown-list-fallback'
+import { insertComponentAtCursor } from '@admin/utils/editor/insert-component-at-cursor'
+import { insertMarkdownTextAtPosition } from '@admin/utils/editor/insert-markdown-text-at-position'
+import { insertTextAtCursor } from '@admin/utils/editor/insert-text-at-cursor'
+import { parseContentEditorMathInput } from '@admin/utils/editor/parse-content-editor-math-input'
+import { removeHighlightSpanAtCursor } from '@admin/utils/editor/remove-highlight-span-at-cursor'
+import { removeMarkdownLinkAtCursor } from '@admin/utils/editor/remove-markdown-link-at-cursor'
+import { sanitizeUrl } from '@admin/utils/editor/sanitize-url'
+import { setMarkdownLinkAtCursor } from '@admin/utils/editor/set-markdown-link-at-cursor'
+import { transformSelectedMarkdownLines } from '@admin/utils/editor/transform-selected-markdown-lines'
 import { redo, redoDepth, undo, undoDepth } from '@codemirror/commands'
 import { markdown } from '@codemirror/lang-markdown'
 import { Decoration, EditorView, WidgetType } from '@codemirror/view'

package/dist/assets/adapters/next/templates/init/hooks/content-editor/use-content-editor-table-add-controls.ts

@@ -1,16 +1,15 @@
 'use client'
 
 import * as React from 'react'
-import type { TableAddControlsState } from '@admin/utils/editor/table-add-controls'
+import type { TableAddControlsState } from '@admin/utils/editor/table-add-controls-state'
 import type { Editor } from '@tiptap/react'
-import {
-  ACTIVE_TABLE_WRAPPER_CLASS,
-  getMountedEditorView,
-  getSelectionTable,
-  getTableFromEventTarget,
-  getTableFromWrapper
-} from '@admin/utils/editor/table-add-controls'
-import { appendColumnToTable, appendRowToTable } from '@admin/utils/editor/tiptap'
+import { ACTIVE_TABLE_WRAPPER_CLASS } from '@admin/utils/editor/active-table-wrapper-class'
+import { appendColumnToTable } from '@admin/utils/editor/append-column-to-table'
+import { appendRowToTable } from '@admin/utils/editor/append-row-to-table'
+import { getMountedEditorView } from '@admin/utils/editor/editor-view'
+import { getSelectionTable } from '@admin/utils/editor/get-selection-table'
+import { getTableFromEventTarget } from '@admin/utils/editor/get-table-from-event-target'
+import { getTableFromWrapper } from '@admin/utils/editor/get-table-from-wrapper'
 
 export interface ContentEditorTableAddControls {
   addColumn: () => void

package/dist/assets/adapters/next/templates/init/hooks/content-editor/use-content-editor.ts

@@ -1,34 +1,28 @@
 'use client'
 
 import * as React from 'react'
-import type {
-  ContentEditorMode,
-  ContentEditorSelectionRequest
-} from '@admin/utils/editor/content-editor'
+import type { ContentEditorMode } from '@admin/utils/editor/content-editor-mode'
+import type { ContentEditorSelectionRequest } from '@admin/utils/editor/content-editor-selection-request'
 import type { Editor } from '@tiptap/react'
 import { NodeBackground } from '@admin/components/custom/content-editor/tiptap-extension/node-background-extension'
 import { HorizontalRule } from '@admin/components/custom/content-editor/tiptap-node/horizontal-rule-node/horizontal-rule-node-extension'
 import { MediaGalleryPlaceholderNode } from '@admin/components/custom/content-editor/tiptap-node/media-gallery-placeholder-node/media-gallery-placeholder-node-extension'
 import { RemovableImage } from '@admin/components/custom/content-editor/tiptap-node/removable-image-node/removable-image-node-extension'
 import { ContentEditorTaskItem } from '@admin/components/custom/content-editor/tiptap-node/task-item-node/task-item-node-extension'
-import {
-  docPositionFromPlainTextOffset,
-  getPlainTextOffsetBeforeDocPosition,
-  getPlainTextOffsetBeforeMarkdownOffset,
-  markdownOffsetFromPlainTextOffset,
-  normalizeEditorMarkdown,
-  prepareMarkdownForRichMode
-} from '@admin/utils/editor/content-editor'
-import {
-  ContentEditorHighlight,
-  ContentEditorInlineMath,
-  ContentEditorKeyboard,
-  ContentEditorRawContentBlock,
-  ContentEditorSubscript,
-  ContentEditorSuperscript,
-  ContentEditorUnderline
-} from '@admin/utils/editor/content-editor-rich-extensions'
-import { ActiveTableCell } from '@admin/utils/editor/table-bubble'
+import { ActiveTableCell } from '@admin/utils/editor/active-table-cell'
+import { ContentEditorHighlight } from '@admin/utils/editor/content-editor-highlight'
+import { ContentEditorInlineMath } from '@admin/utils/editor/content-editor-inline-math'
+import { ContentEditorKeyboard } from '@admin/utils/editor/content-editor-keyboard'
+import { ContentEditorRawContentBlock } from '@admin/utils/editor/content-editor-raw-content-block'
+import { ContentEditorSubscript } from '@admin/utils/editor/content-editor-subscript'
+import { ContentEditorSuperscript } from '@admin/utils/editor/content-editor-superscript'
+import { ContentEditorUnderline } from '@admin/utils/editor/content-editor-underline'
+import { docPositionFromPlainTextOffset } from '@admin/utils/editor/doc-position-from-plain-text-offset'
+import { getPlainTextOffsetBeforeDocPosition } from '@admin/utils/editor/get-plain-text-offset-before-doc-position'
+import { getPlainTextOffsetBeforeMarkdownOffset } from '@admin/utils/editor/get-plain-text-offset-before-markdown-offset'
+import { markdownOffsetFromPlainTextOffset } from '@admin/utils/editor/markdown-offset-from-plain-text-offset'
+import { normalizeEditorMarkdown } from '@admin/utils/editor/normalize-editor-markdown'
+import { prepareMarkdownForRichMode } from '@admin/utils/editor/prepare-markdown-for-rich-mode'
 import { TaskList } from '@tiptap/extension-list'
 import Placeholder from '@tiptap/extension-placeholder'
 import { Table } from '@tiptap/extension-table'

package/dist/assets/adapters/next/templates/init/hooks/content-editor/use-heading.ts

@@ -2,14 +2,12 @@
 
 import type { Editor } from '@tiptap/react'
 import { useTiptapEditor } from '@admin/hooks/content-editor/use-tiptap-editor'
-import {
-  findNodePosition,
-  getSelectedBlockNodes,
-  isNodeInSchema,
-  isNodeTypeSelected,
-  isValidPosition,
-  selectionWithinConvertibleTypes
-} from '@admin/utils/editor/tiptap'
+import { findNodePosition } from '@admin/utils/editor/find-node-position'
+import { getSelectedBlockNodes } from '@admin/utils/editor/get-selected-block-nodes'
+import { isNodeInSchema } from '@admin/utils/editor/is-node-in-schema'
+import { isNodeTypeSelected } from '@admin/utils/editor/is-node-type-selected'
+import { isValidPosition } from '@admin/utils/editor/is-valid-position'
+import { selectionWithinConvertibleTypes } from '@admin/utils/editor/selection-within-convertible-types'
 import { NodeSelection, TextSelection } from '@tiptap/pm/state'
 import {
   Heading5Icon as HeadingFiveIcon,

package/dist/assets/adapters/next/templates/init/hooks/content-editor/use-link-popover.ts

@@ -2,7 +2,9 @@
 
 import type { Editor } from '@tiptap/react'
 import { useTiptapEditor } from '@admin/hooks/content-editor/use-tiptap-editor'
-import { isMarkInSchema, isNodeTypeSelected, sanitizeUrl } from '@admin/utils/editor/tiptap'
+import { isMarkInSchema } from '@admin/utils/editor/is-mark-in-schema'
+import { isNodeTypeSelected } from '@admin/utils/editor/is-node-type-selected'
+import { sanitizeUrl } from '@admin/utils/editor/sanitize-url'
 import { LinkIcon } from 'lucide-react'
 import { useCallback, useEffect, useState } from 'react'
 

package/dist/assets/adapters/next/templates/init/hooks/content-editor/use-list-dropdown-menu.ts

@@ -3,7 +3,7 @@
 import type { ListType } from './use-list'
 import type { Editor } from '@tiptap/react'
 import { useTiptapEditor } from '@admin/hooks/content-editor/use-tiptap-editor'
-import { isNodeInSchema } from '@admin/utils/editor/tiptap'
+import { isNodeInSchema } from '@admin/utils/editor/is-node-in-schema'
 import { ListIcon, ListOrderedIcon, ListTodoIcon } from 'lucide-react'
 import { useEffect, useMemo, useState } from 'react'
 import { canToggleList, isListActive, listIcons } from './use-list'

package/dist/assets/adapters/next/templates/init/hooks/content-editor/use-list.ts

@@ -2,14 +2,12 @@
 
 import type { Editor } from '@tiptap/react'
 import { useTiptapEditor } from '@admin/hooks/content-editor/use-tiptap-editor'
-import {
-  findNodePosition,
-  getSelectedBlockNodes,
-  isNodeInSchema,
-  isNodeTypeSelected,
-  isValidPosition,
-  selectionWithinConvertibleTypes
-} from '@admin/utils/editor/tiptap'
+import { findNodePosition } from '@admin/utils/editor/find-node-position'
+import { getSelectedBlockNodes } from '@admin/utils/editor/get-selected-block-nodes'
+import { isNodeInSchema } from '@admin/utils/editor/is-node-in-schema'
+import { isNodeTypeSelected } from '@admin/utils/editor/is-node-type-selected'
+import { isValidPosition } from '@admin/utils/editor/is-valid-position'
+import { selectionWithinConvertibleTypes } from '@admin/utils/editor/selection-within-convertible-types'
 import { NodeSelection, TextSelection } from '@tiptap/pm/state'
 import { ListIcon, ListOrderedIcon, ListTodoIcon } from 'lucide-react'
 import { useCallback, useEffect, useState } from 'react'

package/dist/assets/adapters/next/templates/init/hooks/content-editor/use-mark.ts

@@ -2,7 +2,8 @@
 
 import type { Editor } from '@tiptap/react'
 import { useTiptapEditor } from '@admin/hooks/content-editor/use-tiptap-editor'
-import { isMarkInSchema, isNodeTypeSelected } from '@admin/utils/editor/tiptap'
+import { isMarkInSchema } from '@admin/utils/editor/is-mark-in-schema'
+import { isNodeTypeSelected } from '@admin/utils/editor/is-node-type-selected'
 import {
   BoldIcon,
   Code2Icon,

package/dist/assets/adapters/next/templates/init/hooks/content-editor/use-table-button.ts

@@ -2,8 +2,8 @@
 
 import * as React from 'react'
 import type { Editor } from '@tiptap/core'
+import { insertContentEditorTable } from '@admin/utils/editor/insert-content-editor-table'
 import { normalizeCount } from '@admin/utils/editor/table-input'
-import { insertContentEditorTable } from '@admin/utils/editor/tiptap'
 
 const DEFAULT_TABLE_ROWS = 3
 const DEFAULT_TABLE_COLS = 3

package/dist/assets/adapters/next/templates/init/hooks/content-editor/use-undo-redo.ts

@@ -2,7 +2,7 @@
 
 import type { Editor } from '@tiptap/react'
 import { useTiptapEditor } from '@admin/hooks/content-editor/use-tiptap-editor'
-import { isNodeTypeSelected } from '@admin/utils/editor/tiptap'
+import { isNodeTypeSelected } from '@admin/utils/editor/is-node-type-selected'
 import { Redo2Icon, Undo2Icon } from 'lucide-react'
 import { useCallback, useEffect, useState } from 'react'
 

package/dist/assets/adapters/next/templates/init/hooks/use-table-utils.ts

@@ -10,7 +10,8 @@ import type {
   SortingState,
   Table
 } from '@tanstack/react-table'
-import { defaultGetId, isString } from '@admin/utils/table/table'
+import { defaultGetId } from '@admin/utils/table/default-get-id'
+import { isString } from '@admin/utils/table/is-string'
 
 interface ColumnResizeInfo {
   id: string

package/dist/assets/adapters/next/templates/init/hooks/use-upload.ts

@@ -2,11 +2,11 @@
 
 import * as React from 'react'
 import type { UploadFileResult, UploadProgress } from '@admin/types'
-import type { FileValidationConfig } from '@admin/utils/validation/validation'
+import type { FileValidationConfig } from '@admin/utils/validation/file-validation-config'
 import type { UseMutationResult } from '@tanstack/react-query'
 import { uploadMediaFromUrl } from '@admin/actions/upload'
-import { parseAcceptTypes } from '@admin/utils/upload/upload'
-import { validateFiles } from '@admin/utils/validation/validation'
+import { parseAcceptTypes } from '@admin/utils/upload/parse-accept-types'
+import { validateFiles } from '@admin/utils/validation/validate-files'
 import { useMutation } from '@tanstack/react-query'
 
 export interface UseUploadOptions {

package/dist/assets/adapters/next/templates/init/lib/actions/audit/clamp-page.ts

@@ -0,0 +1,6 @@
+const DEFAULT_AUDIT_LOG_PAGE = 0
+
+export function clampPage(value: number | undefined): number {
+  if (typeof value !== 'number' || !Number.isFinite(value)) return DEFAULT_AUDIT_LOG_PAGE
+  return Math.max(0, Math.floor(value))
+}

package/dist/assets/adapters/next/templates/init/lib/actions/audit/cleanup-audit-logs.ts

@@ -1,23 +1,18 @@
 'use server'
 
-import type { CleanupAuditLogsResult } from './types'
+import type { CleanupAuditLogsResult } from '@admin/actions/audit/types'
+import { getAuditRequestMetadata } from '@admin/actions/audit/get-audit-request-metadata'
+import { getRetentionDays } from '@admin/actions/audit/get-retention-days'
 import { getSetting } from '@admin/actions/settings'
 import { requireRole, UserRole } from '@admin/auth/middleware'
 import db from '@admin/db'
 import { auditLog } from '@admin/db/schema'
 import { runAdminEventHooks } from '@admin/lib/lifecycle-hooks'
-import { toActionError } from '@admin/utils/error/action-error'
+import { toActionError } from '@admin/utils/error/to-action-error'
 import { lt } from 'drizzle-orm'
-import { getAuditRequestMetadata } from './request-metadata'
 
 const MS_PER_DAY = 24 * 60 * 60 * 1000
 
-function getRetentionDays(value: unknown): number | null {
-  if (typeof value !== 'number' || !Number.isFinite(value)) return null
-  const days = Math.floor(value)
-  return days > 0 ? days : null
-}
-
 export async function cleanupAuditLogs(): Promise<CleanupAuditLogsResult> {
   const actor = await requireRole([UserRole.ADMIN])
 

package/dist/assets/adapters/next/templates/init/lib/actions/audit/first-header-value.ts

@@ -0,0 +1,3 @@
+export function firstHeaderValue(value: string | null): string | null {
+  return value?.split(',')[0]?.trim() || null
+}

package/dist/assets/adapters/next/templates/init/lib/actions/audit/get-audit-log-order-by.ts

@@ -0,0 +1,25 @@
+import type { AuditLogQuery } from '@admin/actions/audit/types'
+import { auditLog } from '@admin/db/schema'
+import { asc, desc } from 'drizzle-orm'
+
+export function getAuditLogOrderBy(query: AuditLogQuery) {
+  const sortFn = query.dir === 'asc' ? asc : desc
+
+  switch (query.sort) {
+    case 'event':
+      return [sortFn(auditLog.category), sortFn(auditLog.action), desc(auditLog.createdAt)]
+    case 'target':
+      return [
+        sortFn(auditLog.targetType),
+        sortFn(auditLog.targetLabel),
+        sortFn(auditLog.targetId),
+        desc(auditLog.createdAt)
+      ]
+    case 'actor':
+      return [sortFn(auditLog.actorEmail), sortFn(auditLog.actorName), desc(auditLog.createdAt)]
+    case 'sourceType':
+      return [sortFn(auditLog.sourceType), desc(auditLog.createdAt)]
+    default:
+      return [sortFn(auditLog.createdAt)]
+  }
+}

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

@@ -1,115 +1,8 @@
 'use server'
 
-import type { AuditLogEntry, AuditLogPage, AuditLogQuery } from './types'
+import type { AuditLogPage, AuditLogQuery } from '@admin/actions/audit/types'
+import { queryAuditLogs } from '@admin/actions/audit/query-audit-logs'
 import { requireRole, UserRole } from '@admin/auth/middleware'
-import db from '@admin/db'
-import { auditLog } from '@admin/db/schema'
-import { getExclusiveDateUpperBound } from '@admin/utils/date/date'
-import { and, asc, desc, eq, gte, ilike, lt, or, sql } from 'drizzle-orm'
-
-const DEFAULT_AUDIT_LOG_PAGE = 0
-const DEFAULT_AUDIT_LOG_PAGE_SIZE = 20
-const MAX_AUDIT_LOG_PAGE_SIZE = 100
-
-function clampPage(value: number | undefined): number {
-  if (typeof value !== 'number' || !Number.isFinite(value)) return DEFAULT_AUDIT_LOG_PAGE
-  return Math.max(0, Math.floor(value))
-}
-
-function normalizePageSize(value: number | undefined): number | null {
-  if (value === -1) return null
-
-  if (typeof value !== 'number' || !Number.isFinite(value) || value <= 0) {
-    return DEFAULT_AUDIT_LOG_PAGE_SIZE
-  }
-
-  return Math.min(MAX_AUDIT_LOG_PAGE_SIZE, Math.max(1, Math.floor(value)))
-}
-
-function getAuditLogOrderBy(query: AuditLogQuery) {
-  const sortFn = query.dir === 'asc' ? asc : desc
-
-  switch (query.sort) {
-    case 'event':
-      return [sortFn(auditLog.category), sortFn(auditLog.action), desc(auditLog.createdAt)]
-    case 'target':
-      return [
-        sortFn(auditLog.targetType),
-        sortFn(auditLog.targetLabel),
-        sortFn(auditLog.targetId),
-        desc(auditLog.createdAt)
-      ]
-    case 'actor':
-      return [sortFn(auditLog.actorEmail), sortFn(auditLog.actorName), desc(auditLog.createdAt)]
-    case 'sourceType':
-      return [sortFn(auditLog.sourceType), desc(auditLog.createdAt)]
-    default:
-      return [sortFn(auditLog.createdAt)]
-  }
-}
-
-async function queryAuditLogs(query: AuditLogQuery = {}): Promise<AuditLogPage> {
-  const page = clampPage(query.page)
-  const pageSize = normalizePageSize(query.pageSize)
-  const offset = pageSize ? page * pageSize : 0
-  const conditions = []
-
-  if (query.category) conditions.push(eq(auditLog.category, query.category))
-  if (query.action) conditions.push(eq(auditLog.action, query.action))
-  if (query.targetType) conditions.push(ilike(auditLog.targetType, `%${query.targetType}%`))
-  if (query.actor) {
-    const actorPattern = `%${query.actor}%`
-    conditions.push(
-      or(ilike(auditLog.actorEmail, actorPattern), ilike(auditLog.actorName, actorPattern))
-    )
-  }
-  if (query.createdAtFrom) {
-    conditions.push(gte(auditLog.createdAt, query.createdAtFrom))
-  }
-  const createdAtExclusiveTo = getExclusiveDateUpperBound(query.createdAtTo)
-  if (createdAtExclusiveTo) {
-    conditions.push(lt(auditLog.createdAt, createdAtExclusiveTo))
-  }
-  if (query.search) {
-    const searchPattern = `%${query.search}%`
-    conditions.push(
-      or(
-        ilike(auditLog.targetId, searchPattern),
-        ilike(auditLog.targetLabel, searchPattern),
-        ilike(auditLog.actorEmail, searchPattern),
-        ilike(auditLog.actorName, searchPattern),
-        ilike(auditLog.sourceType, searchPattern),
-        ilike(auditLog.ipAddress, searchPattern),
-        ilike(auditLog.userAgent, searchPattern)
-      )
-    )
-  }
-
-  const where = conditions.length > 0 ? and(...conditions) : undefined
-  const orderBy = getAuditLogOrderBy(query)
-  const orderedQuery = db
-    .select()
-    .from(auditLog)
-    .where(where)
-    .orderBy(...orderBy)
-  const [rows, countResult] = await Promise.all([
-    pageSize ? orderedQuery.limit(pageSize).offset(offset) : orderedQuery,
-    db
-      .select({ count: sql<number>`count(*)` })
-      .from(auditLog)
-      .where(where)
-  ])
-  const total = Number(countResult[0]?.count ?? 0)
-  const resolvedPageSize = pageSize ?? total
-
-  return {
-    auditLogs: rows as AuditLogEntry[],
-    total,
-    page,
-    pageSize: resolvedPageSize,
-    totalPages: pageSize ? Math.max(1, Math.ceil(total / pageSize)) : 1
-  }
-}
 
 export async function getAuditLogs(query: AuditLogQuery = {}): Promise<AuditLogPage> {
   await requireRole([UserRole.ADMIN])

package/dist/assets/adapters/next/templates/init/lib/actions/audit/{request-metadata.ts → get-audit-request-metadata.ts}

@@ -1,17 +1,13 @@
+import { firstHeaderValue } from '@admin/actions/audit/first-header-value'
+import { MAX_IP_LENGTH } from '@admin/actions/audit/max-ip-length'
+import { MAX_USER_AGENT_LENGTH } from '@admin/actions/audit/max-user-agent-length'
 import { headers } from 'next/headers'
 
-const MAX_IP_LENGTH = 100
-const MAX_USER_AGENT_LENGTH = 500
-
 function truncate(value: string | null, maxLength: number): string | null {
   if (!value) return null
   return value.length > maxLength ? value.slice(0, maxLength) : value
 }
 
-function firstHeaderValue(value: string | null): string | null {
-  return value?.split(',')[0]?.trim() || null
-}
-
 export async function getAuditRequestMetadata(): Promise<{
   ipAddress: string | null
   userAgent: string | null

package/dist/assets/adapters/next/templates/init/lib/actions/audit/get-retention-days.ts

@@ -0,0 +1,5 @@
+export function getRetentionDays(value: unknown): number | null {
+  if (typeof value !== 'number' || !Number.isFinite(value)) return null
+  const days = Math.floor(value)
+  return days > 0 ? days : null
+}

package/dist/assets/adapters/next/templates/init/lib/actions/audit/max-ip-length.ts

@@ -0,0 +1 @@
+export const MAX_IP_LENGTH = 100

package/dist/assets/adapters/next/templates/init/lib/actions/audit/max-user-agent-length.ts

@@ -0,0 +1 @@
+export const MAX_USER_AGENT_LENGTH = 500

package/dist/assets/adapters/next/templates/init/lib/actions/audit/normalize-changed-fields.ts

@@ -0,0 +1,3 @@
+export function normalizeChangedFields(value: readonly string[] | undefined): string[] {
+  return [...new Set(value ?? [])].filter(Boolean).sort((a, b) => a.localeCompare(b))
+}

package/dist/assets/adapters/next/templates/init/lib/actions/audit/normalize-page-size.ts

@@ -0,0 +1,12 @@
+const DEFAULT_AUDIT_LOG_PAGE_SIZE = 20
+const MAX_AUDIT_LOG_PAGE_SIZE = 100
+
+export function normalizePageSize(value: number | undefined): number | null {
+  if (value === -1) return null
+
+  if (typeof value !== 'number' || !Number.isFinite(value) || value <= 0) {
+    return DEFAULT_AUDIT_LOG_PAGE_SIZE
+  }
+
+  return Math.min(MAX_AUDIT_LOG_PAGE_SIZE, Math.max(1, Math.floor(value)))
+}

package/dist/assets/adapters/next/templates/init/lib/actions/audit/query-audit-logs.ts

@@ -0,0 +1,71 @@
+import type { AuditLogEntry, AuditLogPage, AuditLogQuery } from '@admin/actions/audit/types'
+import { clampPage } from '@admin/actions/audit/clamp-page'
+import { getAuditLogOrderBy } from '@admin/actions/audit/get-audit-log-order-by'
+import { normalizePageSize } from '@admin/actions/audit/normalize-page-size'
+import db from '@admin/db'
+import { auditLog } from '@admin/db/schema'
+import { getExclusiveDateUpperBound } from '@admin/utils/date/get-exclusive-date-upper-bound'
+import { and, eq, gte, ilike, lt, or, sql } from 'drizzle-orm'
+
+export async function queryAuditLogs(query: AuditLogQuery = {}): Promise<AuditLogPage> {
+  const page = clampPage(query.page)
+  const pageSize = normalizePageSize(query.pageSize)
+  const offset = pageSize ? page * pageSize : 0
+  const conditions = []
+
+  if (query.category) conditions.push(eq(auditLog.category, query.category))
+  if (query.action) conditions.push(eq(auditLog.action, query.action))
+  if (query.targetType) conditions.push(ilike(auditLog.targetType, `%${query.targetType}%`))
+  if (query.actor) {
+    const actorPattern = `%${query.actor}%`
+    conditions.push(
+      or(ilike(auditLog.actorEmail, actorPattern), ilike(auditLog.actorName, actorPattern))
+    )
+  }
+  if (query.createdAtFrom) {
+    conditions.push(gte(auditLog.createdAt, query.createdAtFrom))
+  }
+  const createdAtExclusiveTo = getExclusiveDateUpperBound(query.createdAtTo)
+  if (createdAtExclusiveTo) {
+    conditions.push(lt(auditLog.createdAt, createdAtExclusiveTo))
+  }
+  if (query.search) {
+    const searchPattern = `%${query.search}%`
+    conditions.push(
+      or(
+        ilike(auditLog.targetId, searchPattern),
+        ilike(auditLog.targetLabel, searchPattern),
+        ilike(auditLog.actorEmail, searchPattern),
+        ilike(auditLog.actorName, searchPattern),
+        ilike(auditLog.sourceType, searchPattern),
+        ilike(auditLog.ipAddress, searchPattern),
+        ilike(auditLog.userAgent, searchPattern)
+      )
+    )
+  }
+
+  const where = conditions.length > 0 ? and(...conditions) : undefined
+  const orderBy = getAuditLogOrderBy(query)
+  const orderedQuery = db
+    .select()
+    .from(auditLog)
+    .where(where)
+    .orderBy(...orderBy)
+  const [rows, countResult] = await Promise.all([
+    pageSize ? orderedQuery.limit(pageSize).offset(offset) : orderedQuery,
+    db
+      .select({ count: sql<number>`count(*)` })
+      .from(auditLog)
+      .where(where)
+  ])
+  const total = Number(countResult[0]?.count ?? 0)
+  const resolvedPageSize = pageSize ?? total
+
+  return {
+    auditLogs: rows as AuditLogEntry[],
+    total,
+    page,
+    pageSize: resolvedPageSize,
+    totalPages: pageSize ? Math.max(1, Math.ceil(total / pageSize)) : 1
+  }
+}

package/dist/assets/adapters/next/templates/init/lib/actions/audit/record-audit-event.ts

@@ -1,21 +1,18 @@
 import type { AdminEventContext } from '@admin/lib/lifecycle-hooks/types'
+import { MAX_IP_LENGTH } from '@admin/actions/audit/max-ip-length'
+import { MAX_USER_AGENT_LENGTH } from '@admin/actions/audit/max-user-agent-length'
+import { normalizeChangedFields } from '@admin/actions/audit/normalize-changed-fields'
 import db from '@admin/db'
 import { auditLog } from '@admin/db/schema'
 
 const MAX_TARGET_TYPE_LENGTH = 100
 const MAX_SOURCE_TYPE_LENGTH = 50
-const MAX_IP_LENGTH = 100
-const MAX_USER_AGENT_LENGTH = 500
 
 function truncate(value: string | null | undefined, maxLength: number): string | null {
   if (!value) return null
   return value.length > maxLength ? value.slice(0, maxLength) : value
 }
 
-function normalizeChangedFields(value: readonly string[] | undefined): string[] {
-  return [...new Set(value ?? [])].filter(Boolean).sort((a, b) => a.localeCompare(b))
-}
-
 export async function recordAuditEvent(event: AdminEventContext): Promise<void> {
   await db.insert(auditLog).values({
     category: event.category,