@nextsparkjs/theme-default 0.1.0-beta.1

package/lib/scheduled-actions/webhook.ts

@@ -0,0 +1,231 @@
+/**
+ * Webhook Scheduled Action Handler - Multi-Endpoint Support
+ *
+ * This handler supports multiple webhook endpoints configured in app.config.ts.
+ * Each endpoint can be:
+ * 1. Explicitly called by key (webhookKey in payload)
+ * 2. Auto-matched by event pattern (e.g., 'task:created' -> 'tasks' endpoint)
+ * 3. Fallback to default endpoint
+ * 4. Legacy single webhookUrl support for backward compatibility
+ *
+ * @module contents/themes/default/lib/scheduled-actions/webhook
+ */
+
+import { registerScheduledAction } from '@nextsparkjs/core/lib/scheduled-actions'
+import type { ScheduledAction } from '@nextsparkjs/core/lib/scheduled-actions'
+import { APP_CONFIG_OVERRIDES } from '@/themes/default/config/app.config'
+import type { WebhookEndpointConfig } from '@nextsparkjs/core/lib/config/types'
+
+/**
+ * Webhook payload interface with optional explicit key
+ */
+interface WebhookPayload {
+  /** Event type (e.g., 'created', 'updated', 'deleted', 'renewed') */
+  eventType: string
+  /** Entity type (e.g., 'task', 'subscription') */
+  entityType: string
+  /** Entity ID */
+  entityId: string
+  /** Full entity data */
+  data: unknown
+  /** Team ID context */
+  teamId?: string
+  /** Explicit webhook endpoint key (overrides pattern matching) */
+  webhookKey?: string
+}
+
+/**
+ * Resolved webhook endpoint
+ */
+interface ResolvedWebhook {
+  url: string
+  key: string
+}
+
+/**
+ * Get typed scheduledActions config from APP_CONFIG_OVERRIDES
+ */
+function getScheduledActionsConfig() {
+  return APP_CONFIG_OVERRIDES.scheduledActions as {
+    webhookUrl?: string
+    webhooks?: {
+      endpoints: Record<string, WebhookEndpointConfig>
+      defaultEndpoint?: string
+    }
+  } | undefined
+}
+
+/**
+ * Resolve webhook URL based on payload
+ *
+ * Resolution priority:
+ * 1. Explicit webhookKey in payload
+ * 2. Pattern matching based on entityType:eventType
+ * 3. Default endpoint
+ * 4. Legacy webhookUrl (backward compatibility)
+ *
+ * @param payload - Webhook payload with event info
+ * @returns Resolved webhook with URL and key, or null if no match
+ */
+function resolveWebhookUrl(payload: WebhookPayload): ResolvedWebhook | null {
+  const config = getScheduledActionsConfig()
+  const webhooksConfig = config?.webhooks
+  const legacyUrl = config?.webhookUrl
+
+  // 1. Explicit webhook key provided
+  if (payload.webhookKey && webhooksConfig?.endpoints[payload.webhookKey]) {
+    const endpoint = webhooksConfig.endpoints[payload.webhookKey]
+    if (endpoint.enabled !== false) {
+      const url = process.env[endpoint.envVar]
+      if (url) {
+        return { url, key: payload.webhookKey }
+      }
+      console.warn(`[webhook:send] Endpoint '${payload.webhookKey}' envVar '${endpoint.envVar}' not set`)
+    }
+  }
+
+  // 2. Pattern matching
+  if (webhooksConfig?.endpoints) {
+    const eventPattern = `${payload.entityType}:${payload.eventType}`
+
+    for (const [key, endpoint] of Object.entries(webhooksConfig.endpoints)) {
+      if (endpoint.enabled === false) continue
+      if (!endpoint.patterns) continue
+
+      for (const pattern of endpoint.patterns) {
+        if (matchesPattern(eventPattern, pattern)) {
+          const url = process.env[endpoint.envVar]
+          if (url) {
+            return { url, key }
+          }
+        }
+      }
+    }
+  }
+
+  // 3. Default endpoint
+  if (webhooksConfig?.defaultEndpoint && webhooksConfig.endpoints[webhooksConfig.defaultEndpoint]) {
+    const endpoint = webhooksConfig.endpoints[webhooksConfig.defaultEndpoint]
+    if (endpoint.enabled !== false) {
+      const url = process.env[endpoint.envVar]
+      if (url) {
+        return { url, key: webhooksConfig.defaultEndpoint }
+      }
+    }
+  }
+
+  // 4. Legacy webhookUrl (backward compatibility)
+  if (legacyUrl) {
+    return { url: legacyUrl, key: 'legacy' }
+  }
+
+  return null
+}
+
+/**
+ * Pattern matching for event routing
+ *
+ * Supports wildcard patterns:
+ * - 'task:*' matches 'task:created', 'task:updated', etc.
+ * - '*:created' matches 'task:created', 'subscription:created', etc.
+ * - '*:*' matches all events
+ *
+ * @param event - Actual event (e.g., 'task:created')
+ * @param pattern - Pattern to match (e.g., 'task:*')
+ * @returns True if pattern matches event
+ */
+function matchesPattern(event: string, pattern: string): boolean {
+  const [eventEntity, eventAction] = event.split(':')
+  const [patternEntity, patternAction] = pattern.split(':')
+
+  const entityMatch = patternEntity === '*' || patternEntity === eventEntity
+  const actionMatch = patternAction === '*' || patternAction === eventAction
+
+  return entityMatch && actionMatch
+}
+
+/**
+ * Register the webhook action handler
+ *
+ * This function registers the 'webhook:send' action handler that sends POST
+ * requests to configured webhook endpoints.
+ *
+ * @example
+ * // Register at app startup
+ * registerWebhookAction()
+ *
+ * // Schedule a webhook with explicit key
+ * await scheduleAction('webhook:send', {
+ *   eventType: 'created',
+ *   entityType: 'task',
+ *   entityId: task.id,
+ *   data: task,
+ *   webhookKey: 'tasks', // Explicit routing
+ * })
+ *
+ * // Schedule a webhook with auto-matching
+ * await scheduleAction('webhook:send', {
+ *   eventType: 'created',
+ *   entityType: 'subscription',
+ *   entityId: sub.id,
+ *   data: sub,
+ *   // Will auto-match to 'subscriptions' endpoint via pattern
+ * })
+ */
+export function registerWebhookAction() {
+  registerScheduledAction(
+    'webhook:send',
+    async (payload: unknown, action: ScheduledAction) => {
+      const webhookPayload = payload as WebhookPayload
+
+      // Validate required fields
+      if (!webhookPayload.eventType || !webhookPayload.entityType || !webhookPayload.entityId) {
+        throw new Error('Invalid webhook payload: missing required fields (eventType, entityType, entityId)')
+      }
+
+      // Resolve webhook URL
+      const resolved = resolveWebhookUrl(webhookPayload)
+
+      if (!resolved) {
+        // No URL configured - skip silently (not an error, just not configured)
+        console.log(`[webhook:send] No webhook URL configured for ${webhookPayload.entityType}:${webhookPayload.eventType}, skipping`)
+        return
+      }
+
+      console.log(`[webhook:send] Sending to '${resolved.key}' for ${webhookPayload.entityType}:${webhookPayload.eventType}`)
+
+      // Send webhook POST request
+      const response = await fetch(resolved.url, {
+        method: 'POST',
+        headers: {
+          'Content-Type': 'application/json',
+          'User-Agent': 'NextSpark-Webhook/1.0',
+          'X-Webhook-Key': resolved.key,
+        },
+        body: JSON.stringify({
+          event: webhookPayload.eventType,
+          entity: webhookPayload.entityType,
+          entityId: webhookPayload.entityId,
+          data: webhookPayload.data,
+          teamId: webhookPayload.teamId,
+          timestamp: new Date().toISOString(),
+          actionId: action.id,
+        }),
+      })
+
+      // Check if webhook was successful
+      if (!response.ok) {
+        const errorText = await response.text()
+        throw new Error(
+          `Webhook '${resolved.key}' failed with status ${response.status}: ${errorText.substring(0, 200)}`
+        )
+      }
+
+      console.log(`[webhook:send] Webhook '${resolved.key}' sent successfully (status: ${response.status})`)
+    },
+    {
+      description: 'Send webhook notification to configured endpoint',
+      timeout: 15000, // 15 seconds timeout for webhooks
+    }
+  )
+}

package/lib/selectors.ts

@@ -0,0 +1,197 @@
+/**
+ * Theme Block Selectors
+ *
+ * This file defines selectors for block components in the theme.
+ * It's placed in lib/ instead of tests/ so TypeScript can resolve imports.
+ *
+ * Used by:
+ * - Block components (for data-cy attributes)
+ * - Cypress tests (via tests/cypress/src/selectors.ts)
+ */
+
+import { createSelectorHelpers } from '@nextsparkjs/core/lib/test/selector-factory'
+import { CORE_SELECTORS } from '@nextsparkjs/core/lib/test/core-selectors'
+
+// =============================================================================
+// BLOCK SELECTORS
+// =============================================================================
+
+/**
+ * Block-specific selectors for the default theme.
+ * Each block has at minimum a 'container' selector.
+ * Dynamic selectors use {index} placeholder.
+ */
+export const BLOCK_SELECTORS = {
+  hero: {
+    container: 'block-hero',
+  },
+  faqAccordion: {
+    container: 'block-faq-accordion',
+    item: 'faq-item-{index}',
+    question: 'faq-question-{index}',
+    answer: 'faq-answer-{index}',
+  },
+  benefits: {
+    container: 'block-benefits',
+  },
+  ctaSection: {
+    container: 'block-cta-section',
+  },
+  featuresGrid: {
+    container: 'block-features-grid',
+  },
+  heroWithForm: {
+    container: 'block-hero-with-form',
+    form: {
+      firstname: 'hero-form-firstname',
+      lastname: 'hero-form-lastname',
+      email: 'hero-form-email',
+      phone: 'hero-form-phone',
+      area: 'hero-form-area',
+      consent: 'hero-form-consent',
+      submit: 'hero-form-submit',
+    },
+  },
+  jumbotron: {
+    container: 'block-jumbotron',
+  },
+  logoCloud: {
+    container: 'block-logo-cloud',
+    item: 'logo-item-{index}',
+    link: 'logo-link-{index}',
+  },
+  postContent: {
+    container: 'block-post-content',
+    divider: 'post-content-divider',
+    cta: 'post-content-cta',
+  },
+  pricingTable: {
+    container: 'block-pricing-table',
+    plan: 'pricing-plan-{index}',
+    features: 'plan-features',
+    cta: 'plan-cta-{index}',
+  },
+  splitContent: {
+    container: 'block-split-content',
+  },
+  statsCounter: {
+    container: 'block-stats-counter',
+  },
+  testimonials: {
+    container: 'block-testimonials',
+  },
+  textContent: {
+    container: 'block-text-content',
+  },
+  timeline: {
+    container: 'block-timeline',
+  },
+  videoHero: {
+    container: 'block-video-hero',
+  },
+} as const
+
+// =============================================================================
+// THEME SELECTORS (CORE + BLOCKS)
+// =============================================================================
+
+// =============================================================================
+// DEVTOOLS SELECTORS
+// =============================================================================
+
+/**
+ * DevTools-specific selectors for the default theme.
+ */
+export const DEVTOOLS_SELECTORS = {
+  scheduledActions: {
+    page: 'devtools-scheduled-actions-page',
+    filterStatus: 'scheduled-actions-filter-status',
+    filterType: 'scheduled-actions-filter-type',
+    filterApply: 'scheduled-actions-filter-apply',
+    filterReset: 'scheduled-actions-filter-reset',
+    table: 'scheduled-actions-table',
+    row: 'scheduled-actions-row-{id}',
+    cellType: 'scheduled-actions-cell-type',
+    cellStatus: 'scheduled-actions-cell-status',
+    cellScheduledAt: 'scheduled-actions-cell-scheduled-at',
+    cellTeam: 'scheduled-actions-cell-team',
+    cellPayload: 'scheduled-actions-cell-payload',
+    cellError: 'scheduled-actions-cell-error',
+    statusPending: 'scheduled-actions-status-pending',
+    statusRunning: 'scheduled-actions-status-running',
+    statusCompleted: 'scheduled-actions-status-completed',
+    statusFailed: 'scheduled-actions-status-failed',
+    pagination: 'scheduled-actions-pagination',
+    paginationPrev: 'scheduled-actions-pagination-prev',
+    paginationNext: 'scheduled-actions-pagination-next',
+    emptyState: 'scheduled-actions-empty-state',
+  },
+} as const
+
+// =============================================================================
+// THEME SELECTORS (CORE + BLOCKS + DEVTOOLS)
+// =============================================================================
+
+/**
+ * Complete theme selectors merging core and blocks.
+ */
+export const THEME_SELECTORS = {
+  ...CORE_SELECTORS,
+  blocks: BLOCK_SELECTORS,
+  devtools: DEVTOOLS_SELECTORS,
+} as const
+
+// =============================================================================
+// EXPORTS
+// =============================================================================
+
+/**
+ * Create helpers bound to theme selectors
+ */
+const helpers = createSelectorHelpers(THEME_SELECTORS)
+
+/**
+ * Full selectors object (core + theme extensions)
+ */
+export const SELECTORS = helpers.SELECTORS
+
+/**
+ * Get a selector value by path
+ *
+ * @example
+ * sel('auth.login.form') // 'login-form'
+ * sel('blocks.hero.container') // 'block-hero'
+ * sel('blocks.faqAccordion.item', { index: '0' }) // 'faq-item-0'
+ */
+export const sel = helpers.sel
+
+/**
+ * Alias for sel
+ */
+export const s = helpers.s
+
+/**
+ * Get selector only in dev/test environments
+ */
+export const selDev = helpers.selDev
+
+/**
+ * Get Cypress selector string [data-cy="..."]
+ *
+ * @example
+ * cySelector('blocks.hero.container') // '[data-cy="block-hero"]'
+ */
+export const cySelector = helpers.cySelector
+
+/**
+ * Create entity-specific selector helpers
+ */
+export const entitySelectors = helpers.entitySelectors
+
+/**
+ * Type exports
+ */
+export type ThemeSelectorsType = typeof THEME_SELECTORS
+export type BlockSelectorsType = typeof BLOCK_SELECTORS
+export type { Replacements } from '@nextsparkjs/core/lib/test/selector-factory'
+export { CORE_SELECTORS }

package/messages/de/admin.json

@@ -0,0 +1,219 @@
+{
+  "pages": {
+    "title": "Seiten",
+    "description": "Verwalten Sie Ihre dynamischen Seiten",
+    "loading": "Seiten werden geladen...",
+    "empty": "Keine Seiten gefunden. Erstellen Sie Ihre erste Seite, um zu beginnen.",
+    "search": {
+      "placeholder": "Seiten suchen..."
+    },
+    "filters": {
+      "locale": "Sprache",
+      "allLocales": "Alle Sprachen",
+      "status": "Status",
+      "allStatuses": "Alle Status",
+      "published": "Veroeffentlicht",
+      "draft": "Entwurf"
+    },
+    "table": {
+      "title": "Titel",
+      "slug": "Slug",
+      "locale": "Sprache",
+      "status": "Status",
+      "updated": "Zuletzt aktualisiert"
+    },
+    "status": {
+      "published": "Veroeffentlicht",
+      "draft": "Entwurf",
+      "unsaved": "Ungespeicherte Aenderungen"
+    },
+    "actions": {
+      "create": "Seite erstellen",
+      "edit": "Bearbeiten",
+      "view": "Ansehen",
+      "delete": "Loeschen",
+      "save": "Speichern",
+      "saving": "Speichern...",
+      "publish": "Veroeffentlichen",
+      "preview": "Vorschau"
+    },
+    "new": {
+      "title": "Neue Seite erstellen",
+      "description": "Erstellen Sie eine neue dynamische Seite fuer Ihre Website",
+      "back": "Zurueck zu Seiten",
+      "success": "Seite erfolgreich erstellt",
+      "form": {
+        "title": "Seitendetails",
+        "description": "Geben Sie die grundlegenden Informationen Ihrer Seite ein",
+        "fields": {
+          "title": "Seitentitel",
+          "slug": "URL-Slug",
+          "locale": "Sprache"
+        },
+        "placeholders": {
+          "title": "Ueber uns",
+          "slug": "ueber-uns"
+        },
+        "hints": {
+          "slug": "URL-freundliche Version des Titels (Kleinbuchstaben, keine Leerzeichen)"
+        },
+        "actions": {
+          "cancel": "Abbrechen",
+          "create": "Seite erstellen",
+          "creating": "Erstellen..."
+        }
+      }
+    },
+    "edit": {
+      "title": "Seite bearbeiten",
+      "loading": "Seite wird geladen...",
+      "back": "Zurueck zu Seiten",
+      "fields": {
+        "title": "Titel",
+        "slug": "Slug"
+      },
+      "placeholders": {
+        "title": "Seitentitel",
+        "slug": "seiten-slug"
+      },
+      "status": {
+        "published": "Veroeffentlicht",
+        "unsaved": "Ungespeicherte Aenderungen"
+      },
+      "actions": {
+        "save": "Speichern",
+        "saving": "Speichern...",
+        "publish": "Veroeffentlichen",
+        "preview": "Vorschau",
+        "viewPage": "Ansehen"
+      },
+      "viewMode": {
+        "layout": "Layout",
+        "preview": "Vorschau"
+      },
+      "messages": {
+        "saved": "Seite erfolgreich gespeichert"
+      }
+    },
+    "settings": {
+      "title": "Seiteneinstellungen",
+      "seo": {
+        "title": "SEO-Einstellungen",
+        "metaTitle": "Meta-Titel",
+        "metaTitlePlaceholder": "Geben Sie den Titel fuer Suchmaschinen ein",
+        "metaTitleHint": "Empfohlen: 50-60 Zeichen",
+        "metaDescription": "Meta-Beschreibung",
+        "metaDescriptionPlaceholder": "Geben Sie eine kurze Beschreibung fuer Suchmaschinen ein",
+        "characters": "Zeichen",
+        "metaKeywords": "Schluesselwoerter",
+        "metaKeywordsPlaceholder": "wort1, wort2, wort3",
+        "metaKeywordsHint": "Durch Komma getrennte Schluesselwoerter",
+        "ogImage": "Social-Media-Bild (OG Image)",
+        "ogImagePlaceholder": "https://beispiel.de/bild.jpg",
+        "ogImageHint": "Bild, das beim Teilen in sozialen Netzwerken angezeigt wird"
+      },
+      "customFields": {
+        "title": "Benutzerdefinierte Felder",
+        "empty": "Keine benutzerdefinierten Felder hinzugefuegt",
+        "keyPlaceholder": "Feldschluessel",
+        "valuePlaceholder": "Feldwert",
+        "add": "Feld hinzufuegen"
+      }
+    }
+  },
+  "blockEditor": {
+    "picker": {
+      "title": "Block-Bibliothek",
+      "description": "Bloecke ziehen oder klicken zum Hinzufuegen",
+      "empty": "Keine Bloecke gefunden",
+      "search": {
+        "placeholder": "Bloecke suchen..."
+      },
+      "categories": {
+        "all": "Alle"
+      }
+    },
+    "canvas": {
+      "empty": {
+        "message": "Noch keine Bloecke hinzugefuegt",
+        "hint": "Ziehen Sie Bloecke aus der Bibliothek, um Ihre Seite zu erstellen"
+      }
+    },
+    "block": {
+      "error": {
+        "notFound": "Block '{slug}' nicht gefunden"
+      }
+    },
+    "settings": {
+      "empty": {
+        "message": "Kein Block ausgewaehlt",
+        "hint": "Waehlen Sie einen Block auf der Arbeitsflaeche aus, um seine Einstellungen zu bearbeiten"
+      },
+      "error": {
+        "notFound": "Block-Einstellungen nicht gefunden"
+      },
+      "noFields": "Dieser Block hat keine konfigurierbaren Felder",
+      "actions": {
+        "reset": "Zuruecksetzen",
+        "remove": "Entfernen"
+      },
+      "tabs": {
+        "content": "Inhalt",
+        "design": "Design",
+        "advanced": "Erweitert",
+        "noContentFields": "Keine Inhaltsfelder verfuegbar",
+        "noDesignFields": "Keine Designfelder verfuegbar",
+        "noAdvancedFields": "Keine erweiterten Felder verfuegbar"
+      }
+    },
+    "form": {
+      "selectPlaceholder": "Option auswaehlen",
+      "emptyArray": "Keine Elemente hinzugefuegt",
+      "itemNumber": "Element {number}",
+      "addItem": "Element hinzufuegen",
+      "itemCount": "{current} von {max} Elementen"
+    }
+  },
+  "builder": {
+    "back": "Zurueck",
+    "loading": "Laden...",
+    "fields": {
+      "title": "Titel",
+      "slug": "Slug"
+    },
+    "placeholders": {
+      "title": "Titel eingeben...",
+      "slug": "url-slug",
+      "excerpt": "Kurze Beschreibung...",
+      "imageUrl": "https://beispiel.de/bild.jpg"
+    },
+    "status": {
+      "published": "Veroeffentlicht",
+      "draft": "Entwurf",
+      "scheduled": "Geplant",
+      "archived": "Archiviert",
+      "unsaved": "Ungespeicherte Aenderungen"
+    },
+    "actions": {
+      "save": "Speichern",
+      "saving": "Speichern...",
+      "viewPage": "Ansehen"
+    },
+    "viewMode": {
+      "layout": "Layout",
+      "preview": "Vorschau"
+    },
+    "sidebar": {
+      "blocks": "Bloecke",
+      "fields": "Felder",
+      "fieldsTitle": "Entitaetsfelder",
+      "fieldsDescription": "Zusaetzliche Eigenschaften konfigurieren",
+      "noFields": "Keine zusaetzlichen Felder verfuegbar",
+      "noCategories": "Keine Kategorien verfuegbar"
+    },
+    "messages": {
+      "saved": "Erfolgreich gespeichert",
+      "created": "Erfolgreich erstellt"
+    }
+  }
+}

package/messages/de/aiUsage.json

@@ -0,0 +1,36 @@
+{
+  "title": "KI-Nutzung",
+  "description": "Ueberwachen Sie Ihre KI-Token-Nutzung und Kosten",
+  "loading": "Nutzungsdaten werden geladen...",
+  "error": "Fehler beim Laden der Nutzungsdaten",
+  "period": {
+    "today": "Heute",
+    "7d": "7 Tage",
+    "30d": "30 Tage",
+    "all": "Gesamte Zeit"
+  },
+  "stats": {
+    "totalTokens": {
+      "title": "Tokens Gesamt",
+      "input": "Eingabe",
+      "output": "Ausgabe"
+    },
+    "estimatedCost": {
+      "title": "Geschaetzte Kosten",
+      "currency": "EUR"
+    },
+    "requests": {
+      "title": "Anfragen",
+      "description": "Gesamte KI-Anfragen"
+    }
+  },
+  "usageByModel": {
+    "title": "Nutzung nach Modell",
+    "tokens": "Tokens"
+  },
+  "dailyUsage": {
+    "title": "Taegliche Nutzung",
+    "noData": "Keine Nutzungsdaten fuer diesen Zeitraum",
+    "tokens": "Tokens"
+  }
+}

package/messages/de/buttons.json

@@ -0,0 +1,19 @@
+{
+  "save": "Speichern",
+  "cancel": "Abbrechen",
+  "delete": "Loeschen",
+  "edit": "Bearbeiten",
+  "add": "Hinzufuegen",
+  "update": "Aktualisieren",
+  "submit": "Absenden",
+  "close": "Schliessen",
+  "back": "Zurueck",
+  "next": "Weiter",
+  "previous": "Zurueck",
+  "continue": "Fortfahren",
+  "finish": "Abschliessen",
+  "signIn": "Anmelden",
+  "signUp": "Registrieren",
+  "signOut": "Abmelden",
+  "signingOut": "Abmelden..."
+}