npm - betterstart-cli - Versions diffs - 0.0.1 - Mend

betterstart-cli 0.0.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (369) hide show

package/dist/assets/adapters/next/templates/init/utils/email/form-delivery.ts ADDED Viewed

@@ -0,0 +1,104 @@
+export interface FormEmailDeliveryInput {
+  formName: string
+  formLabel: string
+  notificationEmails: string[]
+  submitterEmail?: string | null
+  submissionData: Record<string, unknown>
+  submittedAt: string
+}
+export function escapeHtml(value: string): string {
+  return value
+    .replace(/&/g, '&amp;')
+    .replace(/</g, '&lt;')
+    .replace(/>/g, '&gt;')
+    .replace(/"/g, '&quot;')
+    .replace(/'/g, '&#39;')
+}
+export function formatEmailValue(value: unknown): string {
+  if (value === null || value === undefined || value === '') {
+    return 'N/A'
+  }
+  if (value instanceof Date) {
+    return value.toISOString()
+  }
+  if (Array.isArray(value)) {
+    return value.length > 0 ? value.map(formatEmailValue).join(', ') : 'N/A'
+  }
+  if (typeof value === 'object') {
+    return JSON.stringify(value)
+  }
+  return String(value)
+}
+export function isValidEmail(value: string): boolean {
+  return /^[^\s@]+@[^\s@]+\.[^\s@]+$/.test(value)
+}
+export function normalizeEmailList(values: string[]): string[] {
+  return Array.from(new Set(values.map((value) => value.trim()).filter(isValidEmail)))
+}
+export function renderFormSubmissionRows(submissionData: Record<string, unknown>): string {
+  return Object.entries(submissionData)
+    .map(([key, value]) => {
+      const label = escapeHtml(key)
+      const displayValue = escapeHtml(formatEmailValue(value))
+      return `<tr>
+  <th style="border-bottom:1px solid #e2e8f0;color:#475569;font-size:12px;font-weight:600;padding:12px;text-align:left;text-transform:uppercase;vertical-align:top;width:36%;">${label}</th>
+  <td style="border-bottom:1px solid #e2e8f0;color:#0f172a;font-size:14px;line-height:20px;padding:12px;vertical-align:top;">${displayValue}</td>
+</tr>`
+    })
+    .join('\n')
+}
+export function renderNotificationEmail(input: FormEmailDeliveryInput): string {
+  const formLabel = escapeHtml(input.formLabel)
+  const formName = escapeHtml(input.formName)
+  const submittedAt = escapeHtml(new Date(input.submittedAt).toLocaleString())
+  const rows = renderFormSubmissionRows(input.submissionData)
+  return `<!doctype html>
+<html>
+  <body style="margin:0;background:#f8fafc;font-family:Inter,-apple-system,BlinkMacSystemFont,'Segoe UI',Roboto,sans-serif;color:#0f172a;">
+    <div style="margin:0 auto;max-width:640px;padding:40px 20px;">
+      <div style="border-radius:12px;background:#ffffff;border:1px solid #e2e8f0;overflow:hidden;">
+        <div style="background:#0f172a;color:#ffffff;padding:24px 28px;">
+          <p style="margin:0;color:#cbd5e1;font-size:13px;line-height:20px;">${formName}</p>
+          <h1 style="margin:4px 0 0;font-size:24px;line-height:32px;">New ${formLabel} submission</h1>
+        </div>
+        <div style="padding:24px 28px;">
+          <p style="margin:0 0 20px;color:#475569;font-size:14px;line-height:20px;">Submitted at ${submittedAt}</p>
+          <table cellpadding="0" cellspacing="0" role="presentation" style="border-collapse:collapse;width:100%;">
+            <tbody>
+${rows}
+            </tbody>
+          </table>
+        </div>
+      </div>
+    </div>
+  </body>
+</html>`
+}
+export function renderThankYouEmail(input: FormEmailDeliveryInput): string {
+  const formLabel = escapeHtml(input.formLabel.toLowerCase())
+  return `<!doctype html>
+<html>
+  <body style="margin:0;background:#f8fafc;font-family:Inter,-apple-system,BlinkMacSystemFont,'Segoe UI',Roboto,sans-serif;color:#0f172a;">
+    <div style="margin:0 auto;max-width:560px;padding:40px 20px;">
+      <div style="border-radius:12px;background:#ffffff;padding:32px;border:1px solid #e2e8f0;">
+        <h1 style="margin:0 0 16px;font-size:24px;line-height:32px;">Thank you</h1>
+        <p style="margin:0;color:#334155;font-size:16px;line-height:24px;">We received your ${formLabel} submission and will get back to you shortly.</p>
+      </div>
+    </div>
+  </body>
+</html>`
+}

package/dist/assets/adapters/next/templates/init/utils/media/fallback.ts ADDED Viewed

@@ -0,0 +1,37 @@
+import type { AdminMedia } from '@admin/types'
+export function createAdminMediaFromUrl(url: string, accept?: string): AdminMedia {
+  const filename = decodeURIComponent(url.split('/').pop()?.split('?')[0] || 'Selected media')
+  return {
+    id: url,
+    url,
+    filename,
+    contentType: inferMediaContentType(url, accept),
+    size: 0,
+    width: null,
+    height: null,
+    alt: null,
+    tags: null,
+    createdAt: '',
+    updatedAt: '',
+    createdBy: null,
+    updatedBy: null,
+    createdByUser: null,
+    updatedByUser: null
+  }
+}
+export function inferMediaContentType(url: string, accept?: string): string {
+  const pathname = url.split('?')[0]?.toLowerCase() ?? ''
+  if (/\.(avif|webp|png|jpe?g|gif|svg)$/.test(pathname)) {
+    return 'image/unknown'
+  }
+  if (/\.(mp4|webm|mov|m4v)$/.test(pathname)) {
+    return 'video/unknown'
+  }
+  if (accept?.startsWith('image/')) return 'image/unknown'
+  if (accept?.startsWith('video/')) return 'video/unknown'
+  return 'application/octet-stream'
+}

package/dist/assets/adapters/next/templates/init/utils/media/media.ts ADDED Viewed

@@ -0,0 +1,91 @@
+import { parseAcceptTypes } from '@admin/utils/upload/upload'
+export type AdminMediaType = 'image' | 'video' | 'document'
+export const IMAGE_MIME_TYPES = [
+  'image/jpeg',
+  'image/png',
+  'image/gif',
+  'image/webp',
+  'image/svg+xml'
+]
+export const VIDEO_MIME_TYPES = [
+  'video/mp4',
+  'video/webm',
+  'video/ogg',
+  'video/quicktime',
+  'video/x-msvideo'
+]
+export const MEDIA_MIME_TYPES = [...IMAGE_MIME_TYPES, ...VIDEO_MIME_TYPES]
+const IMAGE_EXTENSIONS = /\.(jpg|jpeg|png|gif|webp|svg|avif|ico|bmp|tiff?)($|\?)/i
+const VIDEO_EXTENSIONS = /\.(mp4|webm|ogg|mov|avi|mkv|m4v)($|\?)/i
+export function createPreviewUrl(file: File): string {
+  return URL.createObjectURL(file)
+}
+export function revokePreviewUrl(url?: string | null): void {
+  if (url?.startsWith('blob:')) URL.revokeObjectURL(url)
+}
+export function isDocumentOnlyAccept(accept: string): boolean {
+  if (!accept || accept === 'image/*,video/*' || accept === '*/*' || accept === '*') {
+    return false
+  }
+  const types = parseAcceptTypes(accept, { lowercase: true })
+  return types.every(
+    (type) =>
+      !type.startsWith('image/') &&
+      !type.startsWith('video/') &&
+      !IMAGE_EXTENSIONS.test(type) &&
+      !VIDEO_EXTENSIONS.test(type)
+  )
+}
+export function getMediaType(urlOrMime: string): AdminMediaType {
+  const lower = urlOrMime.toLowerCase()
+  if (VIDEO_MIME_TYPES.some((type) => lower.includes(type)) || VIDEO_EXTENSIONS.test(lower)) {
+    return 'video'
+  }
+  if (IMAGE_MIME_TYPES.some((type) => lower.includes(type)) || IMAGE_EXTENSIONS.test(lower)) {
+    return 'image'
+  }
+  return 'document'
+}
+export function getFilenameFromUrl(url: string, fallback: string): string {
+  try {
+    const parsed = new URL(url)
+    const parts = parsed.pathname.split('/').filter(Boolean)
+    return parts[parts.length - 1] || fallback
+  } catch {
+    return url.split('/').pop()?.split('?')[0] || fallback
+  }
+}
+export function getMediaUrlHelpText(accept?: string): string {
+  if (!accept) return 'Paste a direct image or video URL from a public source.'
+  if (accept.startsWith('image/')) {
+    return 'Paste a direct image URL from a public source.'
+  }
+  if (accept.startsWith('video/')) {
+    return 'Paste a direct video URL from a public source.'
+  }
+  return 'Paste a direct media URL from a public source.'
+}
+export function getMediaUrlPlaceholder(accept?: string): string {
+  if (accept?.startsWith('image/')) return 'https://example.com/cover-image.jpg'
+  if (accept?.startsWith('video/')) {
+    return 'https://example.com/launch-video.mp4'
+  }
+  return 'https://example.com/media-file'
+}

package/dist/assets/adapters/next/templates/init/utils/media/query.ts ADDED Viewed

@@ -0,0 +1,96 @@
+import db from '@admin/db'
+import { adminMedia, user } from '@admin/db/schema'
+import type { AdminMedia } from '@admin/types'
+import { eq } from 'drizzle-orm'
+import { alias } from 'drizzle-orm/pg-core'
+const createdByUser = alias(user, 'media_created_by_user')
+const updatedByUser = alias(user, 'media_updated_by_user')
+export function mapMediaRow(row: {
+  id: string
+  url: string
+  filename: string
+  contentType: string
+  size: number
+  width: number | null
+  height: number | null
+  alt: string | null
+  tags: string[] | null
+  createdAt: string
+  updatedAt: string
+  createdBy: string | null
+  updatedBy: string | null
+  createdByUser: {
+    id: string | null
+    name: string | null
+    email: string | null
+  } | null
+  updatedByUser: {
+    id: string | null
+    name: string | null
+    email: string | null
+  } | null
+}): AdminMedia {
+  return {
+    id: row.id,
+    url: row.url,
+    filename: row.filename,
+    contentType: row.contentType,
+    size: row.size,
+    width: row.width,
+    height: row.height,
+    alt: row.alt,
+    tags: row.tags,
+    createdAt: row.createdAt,
+    updatedAt: row.updatedAt,
+    createdBy: row.createdBy,
+    updatedBy: row.updatedBy,
+    createdByUser: row.createdByUser?.id
+      ? {
+          id: row.createdByUser.id,
+          name: row.createdByUser.name ?? '',
+          email: row.createdByUser.email ?? ''
+        }
+      : null,
+    updatedByUser: row.updatedByUser?.id
+      ? {
+          id: row.updatedByUser.id,
+          name: row.updatedByUser.name ?? '',
+          email: row.updatedByUser.email ?? ''
+        }
+      : null
+  }
+}
+export function selectMedia() {
+  return db
+    .select({
+      id: adminMedia.id,
+      url: adminMedia.url,
+      filename: adminMedia.filename,
+      contentType: adminMedia.contentType,
+      size: adminMedia.size,
+      width: adminMedia.width,
+      height: adminMedia.height,
+      alt: adminMedia.alt,
+      tags: adminMedia.tags,
+      createdAt: adminMedia.createdAt,
+      updatedAt: adminMedia.updatedAt,
+      createdBy: adminMedia.createdBy,
+      updatedBy: adminMedia.updatedBy,
+      createdByUser: {
+        id: createdByUser.id,
+        name: createdByUser.name,
+        email: createdByUser.email
+      },
+      updatedByUser: {
+        id: updatedByUser.id,
+        name: updatedByUser.name,
+        email: updatedByUser.email
+      }
+    })
+    .from(adminMedia)
+    .leftJoin(createdByUser, eq(adminMedia.createdBy, createdByUser.id))
+    .leftJoin(updatedByUser, eq(adminMedia.updatedBy, updatedByUser.id))
+}

package/dist/assets/adapters/next/templates/init/utils/navigation/order.ts ADDED Viewed

@@ -0,0 +1,6 @@
+export function comparePositions(a?: number, b?: number): number {
+  if (a != null && b != null) return a - b
+  if (a != null) return -1
+  if (b != null) return 1
+  return 0
+}

package/dist/assets/adapters/next/templates/init/utils/navigation/sidebar.ts ADDED Viewed

@@ -0,0 +1,26 @@
+import type { AdminNavigationItem } from '@admin/types/navigation'
+export interface AdminNavigationGroup {
+  label: string | null
+  icon?: AdminNavigationItem['icon']
+  items: AdminNavigationItem[]
+}
+export function groupAdminNavigationItems(items: AdminNavigationItem[]): AdminNavigationGroup[] {
+  const groups: AdminNavigationGroup[] = []
+  const groupMap = new Map<string | null, AdminNavigationItem[]>()
+  for (const item of items) {
+    const key = item.group ?? null
+    let groupItems = groupMap.get(key)
+    if (!groupItems) {
+      const arr: AdminNavigationItem[] = []
+      groupMap.set(key, arr)
+      groups.push({ label: key, icon: item.groupIcon, items: arr })
+      groupItems = arr
+    }
+    groupItems.push(item)
+  }
+  return groups
+}

package/dist/assets/adapters/next/templates/init/utils/page/boundary.ts ADDED Viewed

@@ -0,0 +1,32 @@
+const SCROLL_BOUNDARY_THRESHOLD = 2
+export type PageScrollBoundary = 'none' | 'top' | 'middle' | 'bottom'
+export function getPageScrollBoundary(scrollTop: number): PageScrollBoundary {
+  if (typeof window === 'undefined') {
+    return 'none'
+  }
+  const scrollingElement = document.scrollingElement ?? document.documentElement
+  const viewportHeight = window.visualViewport?.height ?? window.innerHeight
+  const scrollHeight = Math.max(
+    scrollingElement.scrollHeight,
+    document.documentElement.scrollHeight,
+    document.body?.scrollHeight ?? 0
+  )
+  const maxScrollTop = Math.max(0, scrollHeight - viewportHeight)
+  if (maxScrollTop <= SCROLL_BOUNDARY_THRESHOLD) {
+    return 'none'
+  }
+  if (scrollTop <= SCROLL_BOUNDARY_THRESHOLD) {
+    return 'top'
+  }
+  if (maxScrollTop - scrollTop <= SCROLL_BOUNDARY_THRESHOLD) {
+    return 'bottom'
+  }
+  return 'middle'
+}

package/dist/assets/adapters/next/templates/init/utils/seo/seo.ts ADDED Viewed

@@ -0,0 +1,90 @@
+import type { Metadata } from 'next'
+interface CreateMetadataOptions {
+  title: string
+  description: string
+  path?: string
+  ogImage?: string
+  noIndex?: boolean
+}
+/**
+ * Create consistent Next.js metadata for Admin-generated pages.
+ * Use this in page.tsx files for entities that have public-facing pages.
+ */
+export function createMetadata({
+  title,
+  description,
+  path,
+  ogImage,
+  noIndex = false
+}: CreateMetadataOptions): Metadata {
+  const metadata: Metadata = {
+    title,
+    description,
+    openGraph: {
+      title,
+      description,
+      type: 'website',
+      ...(ogImage && { images: [{ url: ogImage }] })
+    },
+    twitter: {
+      card: ogImage ? 'summary_large_image' : 'summary',
+      title,
+      description,
+      ...(ogImage && { images: [ogImage] })
+    }
+  }
+  if (path) {
+    metadata.alternates = { canonical: path }
+  }
+  if (noIndex) {
+    metadata.robots = { index: false, follow: false }
+  }
+  return metadata
+}
+/**
+ * Generate JSON-LD structured data for a blog post / article.
+ */
+export function generateArticleSchema({
+  title,
+  description,
+  url,
+  imageUrl,
+  datePublished,
+  dateModified,
+  authorName
+}: {
+  title: string
+  description: string
+  url: string
+  imageUrl?: string
+  datePublished: string
+  dateModified?: string
+  authorName?: string
+}) {
+  return {
+    '@context': 'https://schema.org',
+    '@type': 'BlogPosting',
+    headline: title,
+    description,
+    url,
+    ...(imageUrl && { image: imageUrl }),
+    datePublished,
+    ...(dateModified && { dateModified }),
+    ...(authorName && {
+      author: { '@type': 'Person', name: authorName }
+    })
+  }
+}
+/**
+ * Serialize a JSON-LD schema object to a string for embedding in a script tag.
+ */
+export function schemaToJson(schema: Record<string, unknown>): string {
+  return JSON.stringify(schema)
+}

package/dist/assets/adapters/next/templates/init/utils/shared/cn.ts ADDED Viewed

@@ -0,0 +1,6 @@
+import { type ClassValue, clsx } from 'clsx'
+import { twMerge } from 'tailwind-merge'
+export function cn(...inputs: ClassValue[]) {
+  return twMerge(clsx(inputs))
+}

package/dist/assets/adapters/next/templates/init/utils/storage/local.ts ADDED Viewed

@@ -0,0 +1,9 @@
+import { randomUUID } from 'node:crypto'
+export function sanitizeFilename(filename: string): string {
+  return filename.replace(/[^a-zA-Z0-9.-]/g, '_')
+}
+export function buildLocalStorageKey(filename: string, prefix = 'uploads'): string {
+  return `${prefix}/${Date.now()}-${randomUUID()}-${sanitizeFilename(filename)}`
+}

package/dist/assets/adapters/next/templates/init/utils/table/table.ts ADDED Viewed

@@ -0,0 +1,10 @@
+import type { RowData } from '@tanstack/react-table'
+export function defaultGetId<TData extends RowData>(row: TData): string | null | undefined {
+  const id = (row as { id?: unknown }).id
+  return typeof id === 'string' ? id : null
+}
+export function isString(value: string | null | undefined): value is string {
+  return typeof value === 'string'
+}

package/dist/assets/adapters/next/templates/init/utils/text/text.ts ADDED Viewed

@@ -0,0 +1,4 @@
+export function truncateText(value: string, maxLength: number): string {
+  if (value.length <= maxLength) return value
+  return `${value.slice(0, maxLength)}...`
+}

package/dist/assets/adapters/next/templates/init/utils/theme/system.ts ADDED Viewed

@@ -0,0 +1,6 @@
+export type ResolvedTheme = 'light' | 'dark'
+export function getSystemTheme(): ResolvedTheme {
+  if (typeof window === 'undefined') return 'light'
+  return window.matchMedia('(prefers-color-scheme: dark)').matches ? 'dark' : 'light'
+}

package/dist/assets/adapters/next/templates/init/utils/upload/remote.ts ADDED Viewed

@@ -0,0 +1,55 @@
+import { parseAcceptTypes } from '@admin/utils/upload/upload'
+export const DEFAULT_REMOTE_ACCEPT = 'image/*,video/*'
+export const REMOTE_FETCH_TIMEOUT_MS = 30_000
+export function isAcceptedRemoteType(
+  contentType: string,
+  filename: string,
+  accept?: string
+): boolean {
+  const allowedTypes = parseAcceptTypes(accept, { lowercase: true })
+  if (allowedTypes.length === 0) {
+    return contentType.startsWith('image/') || contentType.startsWith('video/')
+  }
+  return allowedTypes.some((type) => {
+    if (type.endsWith('/*')) {
+      return contentType.startsWith(type.slice(0, -1))
+    }
+    if (type.startsWith('.')) {
+      return filename.toLowerCase().endsWith(type)
+    }
+    return contentType === type
+  })
+}
+export function getFallbackExtension(contentType: string): string {
+  if (contentType === 'image/jpeg') return 'jpg'
+  if (contentType === 'image/png') return 'png'
+  if (contentType === 'image/webp') return 'webp'
+  if (contentType === 'image/gif') return 'gif'
+  if (contentType === 'image/svg+xml') return 'svg'
+  if (contentType === 'video/mp4') return 'mp4'
+  if (contentType === 'video/webm') return 'webm'
+  if (contentType === 'video/quicktime') return 'mov'
+  if (contentType === 'video/ogg') return 'ogg'
+  return contentType.startsWith('video/') ? 'mp4' : 'jpg'
+}
+export function getRemoteFilename(url: URL, contentType: string): string {
+  const rawFilename = url.pathname.split('/').pop() ?? ''
+  try {
+    const decodedFilename = decodeURIComponent(rawFilename).split('?')[0]
+    if (decodedFilename) return decodedFilename
+  } catch {
+    if (rawFilename) return rawFilename
+  }
+  const baseName = contentType.startsWith('video/') ? 'remote-video' : 'remote-image'
+  return `${baseName}.${getFallbackExtension(contentType)}`
+}

package/dist/assets/adapters/next/templates/init/utils/upload/upload.ts ADDED Viewed

@@ -0,0 +1,26 @@
+export type DropzoneAccept = Record<string, string[]>
+export function parseAcceptTypes(accept?: string, options: { lowercase?: boolean } = {}): string[] {
+  return (accept ?? '')
+    .split(',')
+    .map((type) => type.trim())
+    .filter(Boolean)
+    .map((type) => (options.lowercase ? type.toLowerCase() : type))
+}
+export function isWildcardAccept(accept?: string): boolean {
+  const normalized = accept?.trim()
+  return normalized === '*' || normalized === '*/*'
+}
+export function parseDropzoneAccept(accept?: string): DropzoneAccept | undefined {
+  const acceptTypes = parseAcceptTypes(accept)
+  if (acceptTypes.length === 0) return undefined
+  const entries: DropzoneAccept = {}
+  for (const type of acceptTypes) {
+    entries[type] = []
+  }
+  return Object.keys(entries).length > 0 ? entries : undefined
+}

package/dist/assets/adapters/next/templates/init/utils/user/user.ts ADDED Viewed

@@ -0,0 +1,11 @@
+export function getUserInitials(nameOrEmail: string): string {
+  const parts = nameOrEmail.includes('@')
+    ? nameOrEmail.split('@')[0].split(/[._-]/)
+    : nameOrEmail.split(' ')
+  return parts
+    .filter(Boolean)
+    .slice(0, 2)
+    .map((part) => part[0].toUpperCase())
+    .join('')
+}