@prenta/admin 0.92.0

package/src/lib/search.ts

@@ -0,0 +1,59 @@
+type SortDirection = 'asc' | 'desc'
+
+export interface SortConfig<K extends string = string> {
+  key: K
+  direction: SortDirection
+}
+
+function toSearchText(value: unknown): string {
+  return String(value ?? '')
+}
+
+export function scoreRelevance(text: unknown, query: unknown): number {
+  if (!query) return 0
+  const lower = toSearchText(text).toLowerCase()
+  const q = toSearchText(query).toLowerCase()
+  if (lower === q) return 100
+  if (lower.startsWith(q)) return 80
+  const wordBoundary = new RegExp(`\\b${q.replace(/[.*+?^${}()|[\]\\]/g, '\\$&')}`)
+  if (wordBoundary.test(lower)) return 60
+  if (lower.includes(q)) return 40
+  return 0
+}
+
+export function sortByRelevance<T>(
+  items: T[],
+  query: string,
+  getSearchFields: (item: T) => unknown[],
+): T[] {
+  if (!query.trim()) return items
+  return [...items].sort((a, b) => {
+    const scoreA = Math.max(...getSearchFields(a).map((f) => scoreRelevance(f, query)))
+    const scoreB = Math.max(...getSearchFields(b).map((f) => scoreRelevance(f, query)))
+    return scoreB - scoreA
+  })
+}
+
+export function sortByColumn<T>(
+  items: T[],
+  sortConfig: SortConfig | null,
+  getValue: (item: T, key: string) => string | number,
+): T[] {
+  if (!sortConfig) return items
+  return [...items].sort((a, b) => {
+    const aVal = getValue(a, sortConfig.key)
+    const bVal = getValue(b, sortConfig.key)
+    const cmp =
+      typeof aVal === 'number' && typeof bVal === 'number'
+        ? aVal - bVal
+        : String(aVal).localeCompare(String(bVal))
+    return sortConfig.direction === 'asc' ? cmp : -cmp
+  })
+}
+
+export function toggleSort<K extends string>(current: SortConfig<K> | null, key: K): SortConfig<K> {
+  if (current?.key === key) {
+    return current.direction === 'asc' ? { key, direction: 'desc' } : { key, direction: 'asc' }
+  }
+  return { key, direction: 'asc' }
+}

package/src/lib/sentry.ts

@@ -0,0 +1,32 @@
+import * as Sentry from '@sentry/react'
+
+let initialized = false
+
+/** Initialize browser Sentry when a DSN is provided. Safe to call repeatedly. */
+export function initAdminSentry(dsn: string | undefined): void {
+  if (initialized || !dsn?.trim()) return
+
+  Sentry.init({
+    dsn: dsn.trim(),
+    environment: process.env.NODE_ENV ?? 'development',
+    tracesSampleRate: 0,
+  })
+  initialized = true
+}
+
+/** Report a React error boundary catch when Sentry is configured. Never throws. */
+export function captureAdminException(
+  error: Error,
+  context?: { componentStack?: string | null },
+): void {
+  try {
+    if (!initialized) return
+    Sentry.captureException(error, {
+      contexts: context?.componentStack
+        ? { react: { componentStack: context.componentStack } }
+        : undefined,
+    })
+  } catch {
+    // Observability must never break the admin UI.
+  }
+}