@beechcms/core 0.4.0-preview.3 → 0.4.0-preview.5

package/src/richtext-render.ts

@@ -1,87 +0,0 @@
-import { generateHTML } from '@tiptap/html'
-import type { JSONContent } from '@tiptap/core'
-import Highlight from '@tiptap/extension-highlight'
-import Image from '@tiptap/extension-image'
-import Link from '@tiptap/extension-link'
-import Subscript from '@tiptap/extension-subscript'
-import Superscript from '@tiptap/extension-superscript'
-import { Table, TableCell, TableHeader, TableRow } from '@tiptap/extension-table'
-import TextAlign from '@tiptap/extension-text-align'
-import { Mathematics } from '@tiptap/extension-mathematics'
-import StarterKit from '@tiptap/starter-kit'
-
-import { isRichtextEnvelopeV1 } from './richtext.js'
-
-/**
- * Allinea l'output HTML allo schema TipTap usato dall'editor dashboard.
- * Mantieni sincronizzato con `apps/dashboard/src/features/richtext-editor/extensions/build-editor-extensions.ts`.
- */
-function createRichTextHtmlExtensions() {
-  return [
-    StarterKit.configure({
-      link: false,
-      codeBlock: {
-        HTMLAttributes: {
-          class: 'richtext-code-block',
-        },
-      },
-    }),
-    Link.configure({
-      openOnClick: false,
-      autolink: true,
-      defaultProtocol: 'https',
-    }),
-    Mathematics.configure({
-      katexOptions: {
-        throwOnError: false,
-      },
-    }),
-    Highlight,
-    Superscript,
-    Subscript,
-    Image.configure({
-      allowBase64: false,
-    }),
-    TextAlign.configure({
-      types: ['heading', 'paragraph'],
-    }),
-    Table.configure({
-      resizable: false,
-    }),
-    TableRow,
-    TableHeader,
-    TableCell,
-  ]
-}
-
-/**
- * Accetta JSON TipTap (`{ type: 'doc', ... }`), envelope v1, o stringa HTML legacy.
- */
-export function normalizeRichtextForRender(value: unknown): JSONContent | string | null {
-  if (value == null || value === '') return null
-  if (typeof value === 'string') return value
-  if (typeof value === 'object' && value !== null && !Array.isArray(value)) {
-    const o = value as Record<string, unknown>
-    if (isRichtextEnvelopeV1(value)) {
-      return o.doc as JSONContent
-    }
-    if (o.type === 'doc') {
-      return value as JSONContent
-    }
-  }
-  return null
-}
-
-/**
- * Render deterministico JSON → HTML (per display, anteprime, API pubblica).
- * Per stringhe HTML legacy restituisce la stringa sanificata come pass-through (nessun parse TipTap).
- */
-export function renderRichText(value: unknown): string {
-  const normalized = normalizeRichtextForRender(value)
-  if (normalized == null) return ''
-  if (typeof normalized === 'string') {
-    return normalized
-  }
-  const extensions = createRichTextHtmlExtensions()
-  return generateHTML(normalized, extensions)
-}

package/src/richtext.ts

@@ -1,16 +0,0 @@
-/**
- * Convenzione storage richtext TipTap nel Content Engine.
- * @see docs/Sprints/tiptap-elevation.md
- */
-export const RICHTEXT_SCHEMA_VERSION = 1 as const
-
-export type RichtextEnvelopeV1 = {
-  schemaVersion: typeof RICHTEXT_SCHEMA_VERSION
-  doc: Record<string, unknown>
-}
-
-export function isRichtextEnvelopeV1(value: unknown): value is RichtextEnvelopeV1 {
-  if (typeof value !== 'object' || value === null || Array.isArray(value)) return false
-  const o = value as Record<string, unknown>
-  return o.schemaVersion === RICHTEXT_SCHEMA_VERSION && typeof o.doc === 'object' && o.doc !== null
-}

package/src/seeds.ts

@@ -1,28 +0,0 @@
-/**
- * Seed Registry: configurazione degli schemi di contenuto.
- * In v0.4.0 ogni Seed genera una tabella `content_{slug}` con colonne reali.
- * `branch.alias` è il nome della colonna SQL.
- */
-import type { Seed } from './types.js'
-
-/**
- * Registro globale dei Seed. 
- * In produzione, questo viene popolato dalle definizioni dell'utente.
- */
-export const SEED_REGISTRY: Record<string, Seed> = {}
-
-/**
- * Registra un set di Seed nel registro globale.
- */
-export function registerSeeds(seeds: Seed[]) {
-  seeds.forEach(seed => {
-    SEED_REGISTRY[seed.slug] = seed
-  })
-}
-
-/** 
- * Ritorna il Seed per lo slug dato, o null se non esiste. 
- */
-export function getSeed(slug: string): Seed | null {
-  return SEED_REGISTRY[slug] ?? null
-}

package/src/slug-utils.ts

@@ -1,33 +0,0 @@
-/**
- * Utility per la gestione degli slug.
- * Condivisa tra Dashboard e API pubbliche.
- */
-
-/**
- * Converte una stringa in uno slug URL-safe.
- * Limita la lunghezza a 15 caratteri come richiesto.
- */
-export function slugify(value: string): string {
-  return value
-    .normalize('NFKD')               // Normalizza caratteri accentati
-    .replace(/[^\w\s-]/g, '')        // Rimuove tutto ciò che non è alfanumerico (accetta underscore temporaneamente)
-    .trim()
-    .toLowerCase()
-    .replace(/[\s_-]+/g, '-')        // Sostituisce spazi, underscore e trattini multipli con singolo trattino
-    .replace(/^-+|-+$/g, '')         // Rimuove trattini all'inizio o alla fine
-    .slice(0, 15)                    // Limita a 15 caratteri
-}
-
-/**
- * Genera uno slug da un input (es. titolo o nome) o un fallback UUID.
- */
-export function generateEntrySlug(input: { slug?: string; title?: unknown; name?: unknown }): string {
-  const candidate =
-    (typeof input.slug === 'string' && input.slug) ||
-    (typeof input.title === 'string' && input.title) ||
-    (typeof input.name === 'string' && input.name) ||
-    Math.random().toString(36).slice(2, 10) // Fallback compatto se crypto non disponibile (o slice 8)
-
-  const normalized = slugify(candidate)
-  return normalized || Math.random().toString(36).slice(2, 10)
-}

package/src/types.ts

@@ -1,144 +0,0 @@
-export type BranchType = 'text' | 'number' | 'boolean' | 'json' | 'date' | 'richtext' | 'file'
-
-/** Branch: definizione di una proprietà. alias = nome colonna SQL. */
-export interface Branch {
-  /** Alias human-readable, usato nel payload API e come nome colonna SQL nella tabella dedicata */
-  alias: string
-  /** Etichetta per la UI */
-  label: string
-  /** Tipo del valore */
-  type: BranchType
-  /**
-   * Variante semantica opzionale del campo per UI/validazione.
-   * `asset-list` su `file` multiplo abilita la gestione galleria.
-   */
-  format?: 'plain' | 'markdown' | 'html' | 'date' | 'datetime' | 'asset-list'
-  /**
-   * Cardinalità opzionale per campi media:
-   * - false/undefined: singolo asset (string URL)
-   * - true: lista asset (string[] URL)
-   */
-  multiple?: boolean
-  /**
-   * Vocabolario predefinito per campi tag/select/multiselect.
-   * Lista statica definita nel Seed (non salvata nel DB).
-   */
-  options?: string[]
-  /** Campo obbligatorio in creazione — genera NOT NULL in generateCreateTable */
-  requiredOnCreate?: boolean
-  /** Campo obbligatorio in update */
-  requiredOnUpdate?: boolean
-  /**
-   * Policy di accesso e trattamento del campo.
-   * Tutti i valori sono opzionali — `resolvePolicies(branch)` fornisce i default.
-   */
-  policies?: {
-    /** Come il valore viene memorizzato. Default: 'plain' */
-    privacy?: 'plain' | 'hash' | 'encrypt'
-    /** Come il valore viene restituito nelle risposte API. Default: 'full' */
-    visibility?: 'full' | 'masked' | 'hidden'
-    /** Il campo è incluso nelle query di ricerca full-text. Default: true */
-    search?: boolean
-    /** Il campo è disponibile come colonna di filtro nella dashboard. Default: true */
-    filter?: boolean
-    /** Il campo è disponibile come colonna di ordinamento nella dashboard. Default: true */
-    sort?: boolean
-    /** Il campo è incluso nelle risposte della Public API. Default: true */
-    public?: boolean
-  }
-}
-
-/** Dashboard-specific config embedded in a Seed. All fields optional — defaults applied by the dashboard. */
-export interface DashboardSeedConfig {
-  /** Lucide icon name (string, resolved to component client-side). Default: 'Folder' */
-  icon?: string
-  /** Sidebar group label. Ungrouped seeds share a single 'Contents' section. */
-  group?: string
-  /** Sort order within the group. Lower = higher. Default: 99 */
-  order?: number
-  /** Hide from sidebar navigation. Default: false */
-  hidden?: boolean
-  /** Tooltip description shown in the sidebar. */
-  description?: string
-  /** UI feature toggles. All default to true unless specified. */
-  features?: {
-    search?: boolean
-    filter?: boolean
-    export?: boolean
-    bulkDelete?: boolean
-  }
-}
-
-/** Seed: definizione dello schema di un tipo di contenuto */
-export interface Seed {
-  /** Slug identificativo — anche nome tabella: `content_{slug}` */
-  slug: string
-  /** Etichetta singolare per la UI */
-  label: string
-  /** Etichetta plurale per la UI. Se assente si usa `label`. */
-  labelPlural?: string
-  /** Abilita lettura dalla Public API (`GET /api/v1/public/:seed`). Default: false */
-  allowPublicRead?: boolean
-  /** Abilita creazione dalla Public API (`POST /api/v1/public/:seed/add`). Default: false */
-  allowPublicPost?: boolean
-  /** Abilita modifica dalla Public API (`PUT /api/v1/public/:seed/edit/:id`). Default: false */
-  allowPublicEdit?: boolean
-  /**
-   * Abilita la feature "bozza in attesa" per questo seed.
-   * Quando true, genera tabella `content_{slug}_drafts` e abilita gli endpoint `/draft`.
-   * Default: false
-   */
-  allowDrafts?: boolean
-  /**
-   * Alias del branch usato come nome leggibile dell'entry (es. "title", "name", "author").
-   * Obbligatorio — le UI lo usano per display senza euristica.
-   */
-  displayNameAlias: string
-  /** Lista dei campi (Branch) */
-  branches: Branch[]
-  /** Optional dashboard-specific UI config. Ignored by the Botanical Engine. */
-  dashboard?: DashboardSeedConfig
-}
-
-// ---- Query types (usati da buildSelectQuery nel Botanical Engine) ----
-
-export type FilterOperator =
-  | 'eq'
-  | 'gt'
-  | 'gte'
-  | 'lt'
-  | 'lte'
-  | 'contains'
-  | 'is_empty'
-  | 'is_not_empty'
-
-export type FilterType = 'text' | 'number' | 'date' | 'boolean' | 'tags' | 'select' | 'system'
-
-export interface FilterCondition {
-  op: FilterOperator
-  value: string | number | boolean | null
-}
-
-export interface FilterGroup {
-  /** Nome colonna: system column (id/slug/status/created_at/updated_at) o branch alias */
-  column: string
-  type: FilterType
-  conditions: FilterCondition[]
-}
-
-export interface SelectOptions {
-  filters?: FilterGroup[]
-  orderBy?: { column: string; dir: 'ASC' | 'DESC' }
-  pagination?: { limit: number; offset: number }
-  /** Filtra per status. null = nessun filtro status. */
-  status?: string | null
-  /** Full-text search — usa FTS5 se il seed ha branch richtext indicizzabili */
-  search?: string
-  /** Proiezione colonne. Vuoto = SELECT * */
-  fields?: string[]
-}
-
-export interface ParameterizedQuery {
-  sql: string
-  bindings: (string | number | boolean | null)[]
-}