-
-
-
-
-
-
-
-
-```
-
-#### Option B: React
-
-```tsx
-import React, { useEffect, useState } from 'react';
-import { Form } from '@formio/react';
-
-function SonicJSForm({ formName }) {
- const [formSchema, setFormSchema] = useState(null);
- const [submitUrl, setSubmitUrl] = useState('');
-
- useEffect(() => {
- async function loadForm() {
- const response = await fetch(`https://your-sonicjs-site.com/forms/${formName}/schema`);
- const data = await response.json();
- setFormSchema(data.schema);
- setSubmitUrl(data.submitUrl);
- }
- loadForm();
- }, [formName]);
-
- const handleSubmit = async (submission) => {
- const response = await fetch(`https://your-sonicjs-site.com${submitUrl}`, {
- method: 'POST',
- headers: { 'Content-Type': 'application/json' },
- body: JSON.stringify({ data: submission.data })
- });
-
- if (response.ok) {
- alert('Form submitted successfully!');
- }
- };
-
- if (!formSchema) return Contact Us
- - - -Loading form...
;
-
- return (
-
-
-
- );
-}
-
-export default SonicJSForm;
-```
-
-### Step 3: Apply Custom Styling
-
-#### Override Form.io CSS with Your Site's Styles
-
-```css
-/* Your site's custom form styles */
-.formio-component {
- margin-bottom: 1.5rem;
-}
-
-.formio-component label {
- font-family: 'Your Font', sans-serif;
- font-size: 16px;
- font-weight: 600;
- color: #333;
- margin-bottom: 0.5rem;
- display: block;
-}
-
-.formio-component input,
-.formio-component textarea,
-.formio-component select {
- width: 100%;
- padding: 0.75rem;
- border: 2px solid #e0e0e0;
- border-radius: 8px;
- font-family: 'Your Font', sans-serif;
- font-size: 16px;
- transition: border-color 0.2s;
-}
-
-.formio-component input:focus,
-.formio-component textarea:focus,
-.formio-component select:focus {
- outline: none;
- border-color: #3b82f6;
- box-shadow: 0 0 0 3px rgba(59, 130, 246, 0.1);
-}
-
-/* Submit button */
-.formio-component button[type="submit"] {
- background: #3b82f6;
- color: white;
- padding: 0.75rem 2rem;
- border: none;
- border-radius: 8px;
- font-size: 16px;
- font-weight: 600;
- cursor: pointer;
- transition: background 0.2s;
-}
-
-.formio-component button[type="submit"]:hover {
- background: #2563eb;
-}
-
-/* Error messages */
-.formio-errors {
- color: #ef4444;
- font-size: 14px;
- margin-top: 0.25rem;
-}
-
-/* Success message */
-.formio-component .alert-success {
- background: #10b981;
- color: white;
- padding: 1rem;
- border-radius: 8px;
- margin-bottom: 1rem;
-}
-```
-
----
-
-## Method 2: iFrame Embed
-
-**Best for:** Quick embeds when you don't need deep styling customization.
-
-### Basic iFrame Embed
-
-```html
-
-```
-
-### Responsive iFrame
-
-```html
-
-
-
-```
-
-### iFrame with Auto-Height (Advanced)
-
-```html
-
-
-
-```
-
-### Styling Limitations with iFrame
-
-β οΈ **Important:** iFrames have **limited styling control** due to cross-origin restrictions. You can:
-- β
Control iframe container (border, shadow, margin)
-- β Cannot override internal form styles
-- β Cannot match your site's fonts/colors exactly
-
-**Solution:** Use Method 1 (Direct API Integration) for full styling control.
-
----
-
-## Method 3: JavaScript Widget (Coming Soon)
-
-**Best for:** Non-developers who want a simple embed code with decent styling.
-
-### Widget Code (Future Feature)
-
-```html
-
-
-
-
-```
-
----
-
-## π¨ Styling Your Forms
-
-### Strategy 1: No Form.io CSS (Full Custom Styling)
-
-**Don't load** Form.io's CSS and write all styles from scratch:
-
-```html
-
-
-
-
-
-```
-
-Then create your own CSS targeting `.formio-component` classes.
-
-### Strategy 2: Form.io CSS + Overrides (Easiest)
-
-Load Form.io's CSS as a **base**, then override specific styles:
-
-```html
-
-
-
-
-
-```
-
-### Strategy 3: CSS Variables (Best for Themes)
-
-Define CSS variables for easy theming:
-
-```css
-:root {
- --form-primary-color: #3b82f6;
- --form-border-color: #e0e0e0;
- --form-border-radius: 8px;
- --form-input-padding: 0.75rem;
- --form-font-family: 'Inter', sans-serif;
-}
-
-.formio-component input,
-.formio-component select,
-.formio-component textarea {
- border: 2px solid var(--form-border-color);
- border-radius: var(--form-border-radius);
- padding: var(--form-input-padding);
- font-family: var(--form-font-family);
-}
-
-.formio-component button[type="submit"] {
- background: var(--form-primary-color);
- border-radius: var(--form-border-radius);
-}
-```
-
----
-
-## π± Making Forms Responsive
-
-### Mobile-Friendly CSS
-
-```css
-/* Desktop styles */
-.formio-component {
- max-width: 600px;
- margin: 0 auto;
-}
-
-/* Mobile adjustments */
-@media (max-width: 768px) {
- .formio-component input,
- .formio-component textarea,
- .formio-component select {
- font-size: 16px; /* Prevents iOS zoom */
- padding: 1rem;
- }
-
- .formio-component button[type="submit"] {
- width: 100%;
- padding: 1rem;
- }
-}
-```
-
----
-
-## π Handling Authentication
-
-If your form requires authentication, include credentials:
-
-```javascript
-// Fetch with auth
-const response = await fetch('https://your-sonicjs-site.com/forms/private_form/schema', {
- credentials: 'include', // Send cookies
- headers: {
- 'Authorization': 'Bearer YOUR_TOKEN' // Or use Bearer token
- }
-});
-
-// Submit with auth
-await fetch(submitUrl, {
- method: 'POST',
- credentials: 'include',
- headers: {
- 'Content-Type': 'application/json',
- 'Authorization': 'Bearer YOUR_TOKEN'
- },
- body: JSON.stringify({ data: submission.data })
-});
-```
-
----
-
-## π CORS Configuration
-
-To embed forms on external domains, ensure your SonicJS instance allows CORS:
-
-```typescript
-// In your SonicJS wrangler.toml or middleware
-app.use('*', async (c, next) => {
- c.res.headers.set('Access-Control-Allow-Origin', 'https://your-external-site.com');
- c.res.headers.set('Access-Control-Allow-Methods', 'GET, POST, OPTIONS');
- c.res.headers.set('Access-Control-Allow-Headers', 'Content-Type, Authorization');
- c.res.headers.set('Access-Control-Allow-Credentials', 'true');
-
- if (c.req.method === 'OPTIONS') {
- return c.text('', 204);
- }
-
- await next();
-});
-```
-
----
-
-## π― Complete Working Example
-
-### HTML + Vanilla JS with Full Custom Styling
-
-```html
-
-
-
-
-
-
-
-
-
-
-
-
-
-```
-
----
-
-## π§ Troubleshooting
-
-### Form Not Loading
-- β
Check browser console for errors
-- β
Verify CORS is configured correctly
-- β
Ensure form is set to "public" in SonicJS admin
-
-### Styling Not Applied
-- β
Use `!important` to override Form.io default styles
-- β
Check CSS specificity (use browser DevTools)
-- β
Ensure custom CSS loads **after** Form.io CSS
-
-### Submissions Not Working
-- β
Check network tab for failed POST requests
-- β
Verify `submitUrl` in schema response
-- β
Ensure authentication is handled if required
-
----
-
-## π Additional Resources
-
-- **[Forms Headless Frontend Guide](./FORMS_HEADLESS_FRONTEND.md)** - Framework-specific examples (React, Astro, Angular, Vue, Svelte)
-- **[Forms Quick Reference](./FORMS_QUICK_REFERENCE.md)** - Cheat sheet for common tasks
-- **[Form.io Documentation](https://help.form.io/)** - Official Form.io docs
-- **[SonicJS Forms API](./FORMS_API.md)** - Complete API reference
-
----
-
-## π Need Help?
-
-- π¬ **Discord:** Join our community for support
-- π§ **Email:** support@sonicjs.com
-- π **Issues:** GitHub Issues
-- π **Docs:** Full documentation at docs.sonicjs.com
-
----
-
-**Created:** January 2026
-**Last Updated:** January 2026
-**Version:** 1.0.0
diff --git a/docs/FORMS_EXAMPLES.md b/docs/FORMS_EXAMPLES.md
deleted file mode 100644
index af96d5089..000000000
--- a/docs/FORMS_EXAMPLES.md
+++ /dev/null
@@ -1,897 +0,0 @@
-# SonicJS Forms - Interactive Examples
-
-**Live, interactive examples showcasing all features of the SonicJS Forms system.**
-
----
-
-## π― Navigation
-
-- [Basic Form Examples](#-basic-form-examples)
-- [Multi-Page Wizards](#-multi-page-wizards)
-- [Advanced Components](#-advanced-components)
-- [Validation & Conditional Logic](#-validation--conditional-logic)
-- [Headless Integration](#-headless-integration)
-- [Custom Styling](#-custom-styling)
-- [File Uploads](#-file-uploads)
-- [Embedding Examples](#-embedding-examples)
-
----
-
-## π Basic Form Examples
-
-### Example 1: Simple Contact Form
-
-**What it demonstrates:** Basic text fields, email validation, text area, and submit button.
-
-#### Live Preview
-```
-http://localhost:8787/forms/simple_contact
-```
-
-#### Schema (JSON)
-```json
-{
- "display": "form",
- "components": [
- {
- "type": "textfield",
- "key": "name",
- "label": "Full Name",
- "placeholder": "Enter your name",
- "validate": {
- "required": true,
- "minLength": 2,
- "maxLength": 100
- }
- },
- {
- "type": "email",
- "key": "email",
- "label": "Email Address",
- "placeholder": "you@example.com",
- "validate": {
- "required": true
- }
- },
- {
- "type": "textarea",
- "key": "message",
- "label": "Message",
- "placeholder": "How can we help you?",
- "rows": 5,
- "validate": {
- "required": true,
- "minLength": 10
- }
- },
- {
- "type": "button",
- "action": "submit",
- "label": "Send Message",
- "theme": "primary"
- }
- ]
-}
-```
-
-#### How to Create
-```typescript
-// Via API
-await fetch('/admin/forms', {
- method: 'POST',
- body: new URLSearchParams({
- name: 'simple_contact',
- displayName: 'Simple Contact Form',
- category: 'contact'
- })
-});
-
-// Then use builder to add components
-```
-
----
-
-### Example 2: Newsletter Signup
-
-**What it demonstrates:** Minimal form with checkbox for consent.
-
-#### Live Preview
-```
-http://localhost:8787/forms/newsletter_signup
-```
-
-#### Schema
-```json
-{
- "display": "form",
- "components": [
- {
- "type": "email",
- "key": "email",
- "label": "Email Address",
- "validate": { "required": true }
- },
- {
- "type": "checkbox",
- "key": "consent",
- "label": "I agree to receive marketing emails",
- "validate": { "required": true }
- },
- {
- "type": "button",
- "action": "submit",
- "label": "Subscribe"
- }
- ]
-}
-```
-
----
-
-### Example 3: Feedback Survey
-
-**What it demonstrates:** Radio buttons, select dropdowns, ratings.
-
-#### Schema
-```json
-{
- "display": "form",
- "components": [
- {
- "type": "radio",
- "key": "satisfaction",
- "label": "How satisfied are you with our service?",
- "values": [
- { "label": "Very Satisfied", "value": "very_satisfied" },
- { "label": "Satisfied", "value": "satisfied" },
- { "label": "Neutral", "value": "neutral" },
- { "label": "Dissatisfied", "value": "dissatisfied" },
- { "label": "Very Dissatisfied", "value": "very_dissatisfied" }
- ],
- "validate": { "required": true }
- },
- {
- "type": "select",
- "key": "category",
- "label": "What category best describes your feedback?",
- "data": {
- "values": [
- { "label": "Product Quality", "value": "quality" },
- { "label": "Customer Service", "value": "service" },
- { "label": "Pricing", "value": "pricing" },
- { "label": "Delivery", "value": "delivery" },
- { "label": "Other", "value": "other" }
- ]
- }
- },
- {
- "type": "textarea",
- "key": "comments",
- "label": "Additional Comments",
- "rows": 4
- }
- ]
-}
-```
-
----
-
-## π§ Multi-Page Wizards
-
-### Example 4: Job Application Wizard
-
-**What it demonstrates:** Multi-step form with personal info β experience β upload resume.
-
-#### Live Preview
-```
-http://localhost:8787/forms/job_application
-```
-
-#### Schema Structure
-```json
-{
- "display": "wizard",
- "components": [
- {
- "type": "panel",
- "key": "personalInfo",
- "title": "Personal Information",
- "components": [
- {
- "type": "textfield",
- "key": "firstName",
- "label": "First Name",
- "validate": { "required": true }
- },
- {
- "type": "textfield",
- "key": "lastName",
- "label": "Last Name",
- "validate": { "required": true }
- },
- {
- "type": "email",
- "key": "email",
- "label": "Email",
- "validate": { "required": true }
- },
- {
- "type": "phoneNumber",
- "key": "phone",
- "label": "Phone Number"
- }
- ]
- },
- {
- "type": "panel",
- "key": "experience",
- "title": "Work Experience",
- "components": [
- {
- "type": "textfield",
- "key": "currentPosition",
- "label": "Current Position"
- },
- {
- "type": "textfield",
- "key": "currentCompany",
- "label": "Current Company"
- },
- {
- "type": "number",
- "key": "yearsExperience",
- "label": "Years of Experience",
- "validate": { "min": 0, "max": 50 }
- }
- ]
- },
- {
- "type": "panel",
- "key": "documents",
- "title": "Documents",
- "components": [
- {
- "type": "file",
- "key": "resume",
- "label": "Upload Resume",
- "storage": "r2",
- "fileTypes": [
- { "label": "PDF", "value": "application/pdf" },
- { "label": "Word", "value": "application/vnd.openxmlformats-officedocument.wordprocessingml.document" }
- ],
- "validate": { "required": true }
- },
- {
- "type": "textarea",
- "key": "coverLetter",
- "label": "Cover Letter",
- "rows": 8
- }
- ]
- }
- ]
-}
-```
-
-#### Navigation Features
-- β
Previous/Next buttons auto-generated
-- β
Progress indicator shows current step
-- β
Per-page validation (can't proceed with errors)
-- β
Data persists when going back/forward
-
----
-
-### Example 5: Product Registration Wizard
-
-**What it demonstrates:** Conditional pages based on previous answers.
-
-#### Conditional Logic
-```json
-{
- "display": "wizard",
- "components": [
- {
- "type": "panel",
- "key": "productType",
- "title": "Product Type",
- "components": [
- {
- "type": "select",
- "key": "type",
- "label": "What product did you purchase?",
- "data": {
- "values": [
- { "label": "Software", "value": "software" },
- { "label": "Hardware", "value": "hardware" }
- ]
- }
- }
- ]
- },
- {
- "type": "panel",
- "key": "softwareDetails",
- "title": "Software Details",
- "conditional": {
- "show": true,
- "when": "type",
- "eq": "software"
- },
- "components": [
- {
- "type": "textfield",
- "key": "licenseKey",
- "label": "License Key"
- }
- ]
- },
- {
- "type": "panel",
- "key": "hardwareDetails",
- "title": "Hardware Details",
- "conditional": {
- "show": true,
- "when": "type",
- "eq": "hardware"
- },
- "components": [
- {
- "type": "textfield",
- "key": "serialNumber",
- "label": "Serial Number"
- }
- ]
- }
- ]
-}
-```
-
----
-
-## π¨ Advanced Components
-
-### Example 6: Address with Google Maps
-
-**What it demonstrates:** Google Maps autocomplete for addresses.
-
-#### Configuration
-```json
-{
- "type": "address",
- "key": "address",
- "label": "Delivery Address",
- "map": {
- "key": "YOUR_GOOGLE_MAPS_API_KEY",
- "region": "US"
- },
- "provider": "google",
- "validate": { "required": true }
-}
-```
-
-#### Setup Required
-1. Get Google Maps API key
-2. Enable Places API and Maps JavaScript API
-3. Add key to component's `map.key` field in builder
-
-**See:** [Google Maps Setup Guide](./GOOGLE_MAPS_SETUP.md)
-
----
-
-### Example 7: Signature Component
-
-**What it demonstrates:** Digital signature capture.
-
-```json
-{
- "type": "signature",
- "key": "signature",
- "label": "Sign Here",
- "width": "100%",
- "height": "150px",
- "penColor": "black",
- "backgroundColor": "rgb(245,245,245)",
- "validate": { "required": true }
-}
-```
-
----
-
-### Example 8: Date & Time Picker
-
-**What it demonstrates:** Date selection with validation.
-
-```json
-{
- "type": "datetime",
- "key": "appointmentDate",
- "label": "Preferred Appointment Date",
- "format": "yyyy-MM-dd",
- "enableDate": true,
- "enableTime": false,
- "validate": {
- "required": true
- },
- "datePicker": {
- "minDate": "2026-01-01",
- "maxDate": "2026-12-31",
- "disable": ["2026-12-25", "2026-01-01"]
- }
-}
-```
-
----
-
-## β
Validation & Conditional Logic
-
-### Example 9: Dynamic Field Visibility
-
-**What it demonstrates:** Show/hide fields based on user input.
-
-```json
-{
- "components": [
- {
- "type": "checkbox",
- "key": "hasCompany",
- "label": "I'm registering on behalf of a company"
- },
- {
- "type": "textfield",
- "key": "companyName",
- "label": "Company Name",
- "conditional": {
- "show": true,
- "when": "hasCompany",
- "eq": true
- },
- "validate": { "required": true }
- },
- {
- "type": "textfield",
- "key": "taxId",
- "label": "Tax ID",
- "conditional": {
- "show": true,
- "when": "hasCompany",
- "eq": true
- }
- }
- ]
-}
-```
-
----
-
-### Example 10: Complex Validation Rules
-
-**What it demonstrates:** Custom validation patterns.
-
-```json
-{
- "components": [
- {
- "type": "textfield",
- "key": "username",
- "label": "Username",
- "validate": {
- "required": true,
- "minLength": 3,
- "maxLength": 20,
- "pattern": "^[a-zA-Z0-9_]+$",
- "customMessage": "Username must be 3-20 characters and contain only letters, numbers, and underscores"
- }
- },
- {
- "type": "password",
- "key": "password",
- "label": "Password",
- "validate": {
- "required": true,
- "minLength": 8,
- "pattern": "^(?=.*[a-z])(?=.*[A-Z])(?=.*\\d)(?=.*[@$!%*?&])[A-Za-z\\d@$!%*?&]",
- "customMessage": "Password must contain uppercase, lowercase, number, and special character"
- }
- },
- {
- "type": "password",
- "key": "confirmPassword",
- "label": "Confirm Password",
- "validate": {
- "required": true,
- "custom": "valid = (input === data.password) ? true : 'Passwords must match';"
- }
- }
- ]
-}
-```
-
----
-
-## π Headless Integration
-
-### Example 11: React Integration
-
-**Live Demo:** See full code in [FORMS_HEADLESS_FRONTEND.md](./FORMS_HEADLESS_FRONTEND.md)
-
-```tsx
-import { Form } from '@formio/react';
-
-function ContactForm() {
- const [schema, setSchema] = useState(null);
-
- useEffect(() => {
- fetch('https://your-api.com/forms/contact/schema')
- .then(r => r.json())
- .then(data => setSchema(data.schema));
- }, []);
-
- const handleSubmit = async (submission) => {
- await fetch('https://your-api.com/api/forms/contact/submit', {
- method: 'POST',
- body: JSON.stringify({ data: submission.data })
- });
- };
-
- return schema ? : π§ Contact Us
- -Loading form...
-
- Loading...
;
-}
-```
-
----
-
-### Example 12: Astro SSG Integration
-
-```astro
----
-// Fetch form at build time
-const response = await fetch('https://your-api.com/forms/contact/schema');
-const formData = await response.json();
----
-
-
-
-
-```
-
----
-
-## π¨ Custom Styling
-
-### Example 13: Minimal Form (No Form.io CSS)
-
-**What it demonstrates:** 100% custom styles, no Form.io defaults.
-
-```html
-
-
-
-
-
-
-
-
-
-
-
-
-
-```
-
-**See:** [Forms Embedding Guide](./FORMS_EMBEDDING_GUIDE.md) for complete styling examples.
-
----
-
-### Example 14: Themed Form with CSS Variables
-
-```html
-
-```
-
----
-
-## π€ File Uploads
-
-### Example 15: Resume Upload Form
-
-**What it demonstrates:** File upload to Cloudflare R2.
-
-```json
-{
- "components": [
- {
- "type": "textfield",
- "key": "fullName",
- "label": "Full Name",
- "validate": { "required": true }
- },
- {
- "type": "email",
- "key": "email",
- "label": "Email",
- "validate": { "required": true }
- },
- {
- "type": "file",
- "key": "resume",
- "label": "Upload Resume",
- "storage": "r2",
- "url": "/api/forms/upload",
- "fileTypes": [
- { "label": "PDF", "value": "application/pdf" },
- { "label": "Word", "value": "application/vnd.openxmlformats-officedocument.wordprocessingml.document" }
- ],
- "fileMaxSize": "5MB",
- "validate": { "required": true }
- }
- ]
-}
-```
-
-#### R2 Configuration
-File uploads are automatically stored in Cloudflare R2 when `storage: "r2"` is set. Files are tracked in the `form_files` table.
-
----
-
-### Example 16: Multiple File Upload
-
-```json
-{
- "type": "file",
- "key": "documents",
- "label": "Upload Documents",
- "multiple": true,
- "storage": "r2",
- "fileMaxSize": "10MB",
- "fileMinSize": "1KB"
-}
-```
-
----
-
-## π Embedding Examples
-
-### Example 17: iFrame Embed
-
-**Quickest way to embed a form:**
-
-```html
-
-```
-
-**Pros:**
-- β
Instant embed, no coding required
-- β
Form updates automatically
-
-**Cons:**
-- β οΈ Limited styling control
-- β οΈ Can't match your site's exact design
-
----
-
-### Example 18: JavaScript Embed with Custom Styles
-
-**Best for matching your site's design:**
-
-```html
-
-
-
-
-
-
-```
-
----
-
-## π§ͺ Try It Yourself
-
-### Create a Test Form
-
-1. **Go to the builder:**
- ```
- http://localhost:8787/admin/forms/new
- ```
-
-2. **Create a simple form:**
- - Name: `test_form`
- - Display Name: `My Test Form`
-
-3. **Add components:**
- - Drag "Text Field" from sidebar
- - Configure label and validation
- - Drag "Email" field
- - Drag "Text Area"
- - Drag "Button" (Submit)
-
-4. **Save and test:**
- - Click "Save Form"
- - Visit `/forms/test_form`
- - Submit and check `/admin/forms/{id}/submissions`
-
----
-
-## π Complex Examples
-
-### Example 19: Event Registration with Payment
-
-```json
-{
- "display": "wizard",
- "components": [
- {
- "type": "panel",
- "key": "attendeeInfo",
- "title": "Attendee Information",
- "components": [
- { "type": "textfield", "key": "name", "label": "Full Name" },
- { "type": "email", "key": "email", "label": "Email" },
- { "type": "phoneNumber", "key": "phone", "label": "Phone" }
- ]
- },
- {
- "type": "panel",
- "key": "ticketSelection",
- "title": "Ticket Selection",
- "components": [
- {
- "type": "select",
- "key": "ticketType",
- "label": "Ticket Type",
- "data": {
- "values": [
- { "label": "Early Bird - $99", "value": "early_bird" },
- { "label": "Regular - $149", "value": "regular" },
- { "label": "VIP - $299", "value": "vip" }
- ]
- }
- },
- {
- "type": "number",
- "key": "quantity",
- "label": "Number of Tickets",
- "defaultValue": 1,
- "validate": { "min": 1, "max": 10 }
- }
- ]
- },
- {
- "type": "panel",
- "key": "payment",
- "title": "Payment",
- "components": [
- {
- "type": "htmlelement",
- "key": "totalPrice",
- "tag": "div",
- "content": "Total: $0
" - } - ] - } - ] -} -``` - ---- - -## π― Best Practices Demonstrated - -### β Form Design -- Keep forms under 10 fields when possible -- Use wizards for forms >6 fields -- Group related fields in panels -- Use clear, actionable button text -- Provide helpful placeholder text - -### β Validation -- Mark required fields clearly -- Provide instant feedback on errors -- Use appropriate input types (email, tel, number) -- Add custom validation messages -- Validate before allowing progression - -### β User Experience -- Show progress in wizards -- Allow users to go back and edit -- Persist data between pages -- Show clear success messages -- Handle errors gracefully - -### β Performance -- Lazy load forms with scripts -- Use CDN for Form.io library -- Minimize custom CSS -- Cache form schemas -- Optimize file upload sizes - ---- - -## π Related Documentation - -- **[Quick Reference](./FORMS_QUICK_REFERENCE.md)** - One-page cheat sheet -- **[Embedding Guide](./FORMS_EMBEDDING_GUIDE.md)** - How to embed forms with custom styling -- **[Headless Frontend](./FORMS_HEADLESS_FRONTEND.md)** - React, Astro, Angular, Vue examples -- **[API Reference](./FORMS_API.md)** - Programmatic form creation -- **[Wizard Forms](./FORMIO_WIZARD_FORMS.md)** - Multi-page forms guide -- **[Testing Guide](./FORMS_TESTING_SUITE.md)** - E2E, unit, and manual tests - ---- - -## π Need More Examples? - -**Can't find what you're looking for?** - -- π Check [Form.io Examples](https://formio.github.io/formio.js/app/examples/) for more Form.io features -- π¬ Join our Discord for help -- π Open a GitHub issue for documentation requests -- π§ Contact support@sonicjs.com - ---- - -**Last Updated:** January 2026 -**Version:** 1.0.0 diff --git a/docs/FORMS_HEADLESS_FRONTEND.md b/docs/FORMS_HEADLESS_FRONTEND.md deleted file mode 100644 index 8e5214427..000000000 --- a/docs/FORMS_HEADLESS_FRONTEND.md +++ /dev/null @@ -1,1018 +0,0 @@ -# Using SonicJS Forms in Headless Frontends - -**Complete guide for integrating SonicJS forms into any modern frontend framework: React, Astro, Angular, Vue, Svelte, Next.js, and more.** - ---- - -## π― Overview - -SonicJS forms are **fully headless-ready** with a JSON API that returns Form.io schemas. You can: - -β **Fetch form schemas** via REST API -β **Render forms** using Form.io React/Angular/Vue components -β **Submit data** back to SonicJS -β **Use any frontend framework** - React, Astro, Angular, Vue, Svelte, etc. -β **Full TypeScript support** - ---- - -## π‘ API Endpoints - -### Get Form Schema (JSON) - -**Endpoint:** `GET /forms/:identifier/schema` -**Auth:** No authentication required for public forms -**Identifier:** Form ID (UUID) or form name - -#### Response Format - -```json -{ - "id": "550e8400-e29b-41d4-a716-446655440000", - "name": "contact_form", - "displayName": "Contact Us", - "description": "Customer contact form", - "category": "customer_service", - "schema": { - "display": "form", - "components": [ - { - "type": "textfield", - "key": "name", - "label": "Full Name", - "validate": { "required": true } - }, - { - "type": "email", - "key": "email", - "label": "Email Address", - "validate": { "required": true } - } - ] - }, - "settings": { - "submitButtonText": "Send Message", - "successMessage": "Thank you for contacting us!", - "requireAuth": false - }, - "submitUrl": "/api/forms/550e8400-e29b-41d4-a716-446655440000/submit" -} -``` - -### Submit Form Data - -**Endpoint:** `POST /api/forms/:identifier/submit` -**Content-Type:** `application/json` -**Auth:** Optional (depends on form settings) - -#### Request Body - -```json -{ - "data": { - "name": "John Doe", - "email": "john@example.com", - "message": "Hello!" - } -} -``` - -#### Response - -```json -{ - "success": true, - "submissionId": "660e8400-e29b-41d4-a716-446655440001", - "message": "Form submitted successfully" -} -``` - ---- - -## βοΈ React Integration - -### Installation - -```bash -npm install @formio/react -``` - -### Basic React Component - -```tsx -// components/SonicForm.tsx -import { Form } from '@formio/react' -import { useState, useEffect } from 'react' - -interface SonicFormProps { - formName: string - apiUrl?: string -} - -export function SonicForm({ formName, apiUrl = 'http://localhost:8787' }: SonicFormProps) { - const [formSchema, setFormSchema] = useStateLoading form...
- if (error) return Error: {error}
- if (submitted) return {formSchema.settings.successMessage}
-
- return (
-
-
- )
-}
-```
-
-### Usage in React App
-
-```tsx
-// pages/Contact.tsx
-import { SonicForm } from '../components/SonicForm'
-
-export default function ContactPage() {
- return (
- {formSchema.displayName}
- {formSchema.description &&{formSchema.description}
} - - -
-
- )
-}
-```
-
-### Next.js Example (App Router)
-
-```tsx
-// app/contact/page.tsx
-'use client'
-
-import { SonicForm } from '@/components/SonicForm'
-
-export default function ContactPage() {
- return (
-
-
-
-
-
-
-
-```
-
-### Astro + React Island
-
-```astro
----
-// pages/contact.astro
-import { SonicForm } from '../components/SonicForm'
-
-const API_URL = import.meta.env.PUBLIC_API_URL || 'http://localhost:8787'
----
-
-{formData.displayName}
- {formData.description &&{formData.description}
} - - - -
-
- `
-})
-export class ContactFormComponent implements OnInit {
- formData: any
- submitted = false
- private apiUrl = 'http://localhost:8787'
-
- constructor(private http: HttpClient) {}
-
- ngOnInit() {
- this.http.get(`${this.apiUrl}/forms/contact_form/schema`)
- .subscribe(data => {
- this.formData = data
- })
- }
-
- onSubmit(submission: any) {
- this.http.post(`${this.apiUrl}${this.formData.submitUrl}`, submission)
- .subscribe(
- () => this.submitted = true,
- error => alert('Submission failed')
- )
- }
-}
-```
-
-### Angular Module
-
-```typescript
-// app.module.ts
-import { FormioModule } from '@formio/angular'
-
-@NgModule({
- imports: [
- BrowserModule,
- HttpClientModule,
- FormioModule // Add Form.io module
- ],
- declarations: [ContactFormComponent]
-})
-export class AppModule {}
-```
-
----
-
-## π Vue.js Integration
-
-### Installation
-
-```bash
-npm install @formio/vue
-```
-
-### Vue Component
-
-```vue
-
-
- {{ formData?.displayName }}
-{{ formData.description }}
- -
- {{ formData?.settings?.successMessage }}
-
-
-
-
-
-
-
-
-```
-
-### Usage in Vue App
-
-```vue
-
-
- {{ formData.displayName }}
-{{ formData.description }}
- -
- {{ formData?.settings?.successMessage }}
-
-
- {#if formData}
-
-
-
-```
-
----
-
-## π§ Vanilla JavaScript
-
-For frameworks not listed or custom implementations:
-
-```html
-
-
-
-
- {formData.displayName}
- {#if formData.description} -{formData.description}
- {/if} - - {#if !submitted} - - {:else} -
- {formData.settings.successMessage}
-
- {/if}
- {/if}
-
-
-
-
-
-
-
-
-
-
-
-```
-
----
-
-## π¨ Styling & Customization
-
-### Custom CSS
-
-```css
-/* Override Form.io styles */
-.formio-component-label {
- font-weight: 600;
- color: #374151;
-}
-
-.formio-component-textfield input,
-.formio-component-email input {
- border: 1px solid #d1d5db;
- border-radius: 0.375rem;
- padding: 0.5rem 0.75rem;
-}
-
-.formio-component-button button {
- background: #3b82f6;
- color: white;
- padding: 0.75rem 1.5rem;
- border-radius: 0.5rem;
- font-weight: 600;
-}
-
-.formio-component-button button:hover {
- background: #2563eb;
-}
-```
-
-### Tailwind CSS Integration
-
-```tsx
-// Wrapper component with Tailwind
-export function StyledSonicForm({ formName }: { formName: string }) {
- return (
-
-
- )
-}
-```
-
----
-
-## π Authentication
-
-### Authenticated Requests
-
-If your form requires authentication:
-
-```typescript
-// React example with auth
-const handleSubmit = async (submission: any) => {
- const token = localStorage.getItem('auth_token')
-
- const response = await fetch(`${apiUrl}${formData.submitUrl}`, {
- method: 'POST',
- headers: {
- 'Content-Type': 'application/json',
- 'Authorization': `Bearer ${token}` // Add auth header
- },
- body: JSON.stringify(submission)
- })
-
- if (response.ok) {
- setSubmitted(true)
- } else if (response.status === 401) {
- alert('Please log in to submit this form')
- }
-}
-```
-
----
-
-## π Advanced Features
-
-### Multi-Page Wizards
-
-Wizards work automatically with Form.io components:
-
-```tsx
-// React - Wizard forms render with navigation automatically
-
-
-// The schema.display === 'wizard' automatically enables:
-// - Previous/Next buttons
-// - Progress indicator
-// - Per-page validation
-```
-
-### File Uploads
-
-File components work with your R2 storage:
-
-```typescript
-// The file component automatically handles uploads to your configured storage
-{
- "type": "file",
- "key": "resume",
- "label": "Upload Resume",
- "storage": "r2" // Uses your R2 bucket
-}
-```
-
-### Conditional Logic
-
-Form.io conditional logic works client-side:
-
-```json
-{
- "type": "textfield",
- "key": "businessName",
- "label": "Business Name",
- "conditional": {
- "show": true,
- "when": "userType",
- "eq": "business"
- }
-}
-```
-
----
-
-## π§ͺ TypeScript Support
-
-### Type Definitions
-
-```typescript
-// types/sonic-forms.ts
-
-export interface FormSchema {
- display: 'form' | 'wizard'
- components: FormComponent[]
-}
-
-export interface FormComponent {
- type: string
- key: string
- label: string
- validate?: {
- required?: boolean
- [key: string]: any
- }
- [key: string]: any
-}
-
-export interface SonicFormData {
- id: string
- name: string
- displayName: string
- description?: string
- category: string
- schema: FormSchema
- settings: {
- submitButtonText: string
- successMessage: string
- requireAuth: boolean
- emailNotifications?: boolean
- [key: string]: any
- }
- submitUrl: string
-}
-
-export interface FormSubmission {
- data: Record
- {{#if component.label}}
-
- {{/if}}
-
-
-
-
- {{#if component.description}}
-
-`;
-```
-
-### Step 3: Database Migration
-
-```sql
--- packages/core/migrations/030_add_turnstile_to_forms.sql
-
--- Add Turnstile configuration to forms table
-ALTER TABLE forms ADD COLUMN turnstile_enabled INTEGER DEFAULT 0;
-ALTER TABLE forms ADD COLUMN turnstile_settings TEXT;
-
--- Update existing forms to inherit global settings
-UPDATE forms SET turnstile_settings = '{"inherit":true}' WHERE turnstile_settings IS NULL;
-```
-
-### Step 4: Update Form Submission Handler
-
-```typescript
-// packages/core/src/routes/public-forms.ts
-
-import { TurnstileService } from '../plugins/core-plugins/turnstile-plugin/services/turnstile'
-
-// Modify POST /:identifier/submit endpoint
-publicFormsRoutes.post('/:identifier/submit', async (c) => {
- try {
- const db = c.env.DB
- const identifier = c.req.param('identifier')
- const body = await c.req.json()
-
- // Get form by ID or name
- const form = await db.prepare(
- 'SELECT * FROM forms WHERE (id = ? OR name = ?) AND is_active = 1'
- ).bind(identifier, identifier).first()
-
- if (!form) {
- return c.json({ error: 'Form not found' }, 404)
- }
-
- // Check if Turnstile is enabled for this form
- const turnstileEnabled = form.turnstile_enabled === 1
- const turnstileSettings = form.turnstile_settings
- ? JSON.parse(form.turnstile_settings as string)
- : { inherit: true }
-
- // If Turnstile is enabled (or inheriting global settings)
- if (turnstileEnabled || turnstileSettings.inherit) {
- const turnstileService = new TurnstileService(db)
-
- // Check if Turnstile is globally enabled
- const globalEnabled = await turnstileService.isEnabled()
-
- if (globalEnabled || turnstileEnabled) {
- // Extract Turnstile token from submission data
- const turnstileToken = body.data?.turnstile || body.turnstile
-
- if (!turnstileToken) {
- return c.json({
- error: 'Turnstile verification required',
- code: 'TURNSTILE_MISSING'
- }, 400)
- }
-
- // Verify the token
- const clientIp = c.req.header('cf-connecting-ip')
- const verification = await turnstileService.verifyToken(turnstileToken, clientIp)
-
- if (!verification.success) {
- return c.json({
- error: verification.error || 'Turnstile verification failed',
- code: 'TURNSTILE_INVALID'
- }, 403)
- }
-
- // Remove Turnstile token from submission data before storing
- if (body.data?.turnstile) {
- delete body.data.turnstile
- }
- }
- }
-
- // Create submission (existing code)
- const submissionId = crypto.randomUUID()
- const now = Date.now()
-
- await db.prepare(`
- INSERT INTO form_submissions (
- id, form_id, submission_data, user_id, ip_address, user_agent,
- submitted_at, updated_at
- ) VALUES (?, ?, ?, ?, ?, ?, ?, ?)
- `).bind(
- submissionId,
- form.id,
- JSON.stringify(body.data),
- null,
- c.req.header('cf-connecting-ip') || null,
- c.req.header('user-agent') || null,
- now,
- now
- ).run()
-
- // Update submission count
- await db.prepare(`
- UPDATE forms
- SET submission_count = submission_count + 1,
- updated_at = ?
- WHERE id = ?
- `).bind(now, form.id).run()
-
- return c.json({
- success: true,
- submissionId,
- message: 'Form submitted successfully'
- })
- } catch (error: any) {
- console.error('Error submitting form:', error)
- return c.json({ error: 'Failed to submit form' }, 500)
- }
-})
-```
-
-### Step 5: Headless Integration Helpers
-
-```typescript
-// packages/core/src/plugins/core-plugins/turnstile-plugin/headless-helpers.ts
-
-export interface TurnstileConfig {
- enabled: boolean
- siteKey: string
- theme?: 'light' | 'dark' | 'auto'
- size?: 'normal' | 'compact'
- mode?: 'managed' | 'non-interactive' | 'invisible'
- appearance?: 'always' | 'execute' | 'interaction-only'
-}
-
-/**
- * Get Turnstile configuration for a form
- * Use this in your headless frontend to determine if Turnstile is needed
- */
-export async function getTurnstileConfig(formId: string): Promise{{component.description}}
- {{/if}}
-\\n
\\n );\\n}\\n\\nexport default Counter;',\\n 'javascript',\\n 'frontend',\\n 'react,hooks,state',\\n 1,\\n 1),\\n\\n('TypeScript Interface Example',\\n 'Defining a TypeScript interface for type-safe objects.',\\n 'interface User {\\n id: string;\\n email: string;\\n name: string;\\n role: ''admin'' | ''editor'' | ''viewer'';\\n createdAt: Date;\\n}\\n\\nfunction greetUser(user: User): string {\\n return `Hello, ${user.name}!`;\\n}\\n\\nconst user: User = {\\n id: ''123'',\\n email: ''user@example.com'',\\n name: ''John Doe'',\\n role: ''admin'',\\n createdAt: new Date()\\n};\\n\\nconsole.log(greetUser(user));',\\n 'typescript',\\n 'backend',\\n 'typescript,types,interface',\\n 1,\\n 2),\\n\\n('Python List Comprehension',\\n 'Elegant way to create lists in Python using list comprehensions.',\\n '# Basic list comprehension\\nsquares = [x**2 for x in range(10)]\\nprint(squares) # [0, 1, 4, 9, 16, 25, 36, 49, 64, 81]\\n\\n# With condition\\neven_squares = [x**2 for x in range(10) if x % 2 == 0]\\nprint(even_squares) # [0, 4, 16, 36, 64]\\n\\n# Nested list comprehension\\nmatrix = [[i+j for j in range(3)] for i in range(3)]\\nprint(matrix) # [[0, 1, 2], [1, 2, 3], [2, 3, 4]]',\\n 'python',\\n 'general',\\n 'python,lists,comprehension',\\n 1,\\n 3),\\n\\n('SQL Join Example',\\n 'Common SQL JOIN patterns for combining data from multiple tables.',\\n '-- INNER JOIN: Returns only matching rows\\nSELECT users.name, orders.total\\nFROM users\\nINNER JOIN orders ON users.id = orders.user_id;\\n\\n-- LEFT JOIN: Returns all users, even without orders\\nSELECT users.name, orders.total\\nFROM users\\nLEFT JOIN orders ON users.id = orders.user_id;\\n\\n-- Multiple JOINs\\nSELECT\\n users.name,\\n orders.order_date,\\n products.name AS product_name\\nFROM users\\nINNER JOIN orders ON users.id = orders.user_id\\nINNER JOIN order_items ON orders.id = order_items.order_id\\nINNER JOIN products ON order_items.product_id = products.id;',\\n 'sql',\\n 'database',\\n 'sql,joins,queries',\\n 1,\\n 4),\\n\\n('Go Error Handling',\\n 'Idiomatic error handling pattern in Go.',\\n 'package main\\n\\nimport (\\n\\t\\\"errors\\\"\\n\\t\\\"fmt\\\"\\n)\\n\\nfunc divide(a, b float64) (float64, error) {\\n\\tif b == 0 {\\n\\t\\treturn 0, errors.New(\\\"division by zero\\\")\\n\\t}\\n\\treturn a / b, nil\\n}\\n\\nfunc main() {\\n\\tresult, err := divide(10, 2)\\n\\tif err != nil {\\n\\t\\tfmt.Println(\\\"Error:\\\", err)\\n\\t\\treturn\\n\\t}\\n\\tfmt.Printf(\\\"Result: %.2f\\\\n\\\", result)\\n\\n\\t// This will error\\n\\t_, err = divide(10, 0)\\n\\tif err != nil {\\n\\t\\tfmt.Println(\\\"Error:\\\", err)\\n\\t}\\n}',\\n 'go',\\n 'backend',\\n 'go,error-handling,functions',\\n 1,\\n 5);\\n\"\n },\n {\n id: '014',\n name: 'Fix Plugin Registry',\n filename: '014_fix_plugin_registry.sql',\n description: 'Migration 014: Fix Plugin Registry',\n sql: \"-- Fix Plugin Registry\\n-- Migration: 014_fix_plugin_registry\\n-- Description: Add missing plugins and fix plugin name mismatches\\n\\n-- Note: Cannot easily update plugin names as they may be referenced elsewhere\\n-- Instead we'll add the missing plugins with correct names\\n\\n-- Insert missing plugins\\n\\n-- Core Analytics Plugin\\nINSERT OR IGNORE INTO plugins (\\n id, name, display_name, description, version, author, category, icon,\\n status, is_core, permissions, installed_at, last_updated\\n) VALUES (\\n 'core-analytics',\\n 'core-analytics',\\n 'Analytics & Tracking',\\n 'Core analytics tracking and reporting plugin with page views and event tracking',\\n '1.0.0',\\n 'SonicJS Team',\\n 'seo',\\n 'π',\\n 'active',\\n TRUE,\\n '[\\\"view:analytics\\\", \\\"manage:tracking\\\"]',\\n unixepoch(),\\n unixepoch()\\n);\\n\\n-- FAQ Plugin\\nINSERT OR IGNORE INTO plugins (\\n id, name, display_name, description, version, author, category, icon,\\n status, is_core, permissions, installed_at, last_updated\\n) VALUES (\\n 'faq-plugin',\\n 'faq-plugin',\\n 'FAQ Management',\\n 'Frequently Asked Questions management plugin with categories, search, and custom styling',\\n '1.0.0',\\n 'SonicJS',\\n 'content',\\n 'β',\\n 'active',\\n FALSE,\\n '[\\\"manage:faqs\\\"]',\\n unixepoch(),\\n unixepoch()\\n);\\n\\n-- Seed Data Plugin\\nINSERT OR IGNORE INTO plugins (\\n id, name, display_name, description, version, author, category, icon,\\n status, is_core, permissions, installed_at, last_updated\\n) VALUES (\\n 'seed-data',\\n 'seed-data',\\n 'Seed Data Generator',\\n 'Generate realistic example users and content for testing and development',\\n '1.0.0',\\n 'SonicJS Team',\\n 'development',\\n 'π±',\\n 'inactive',\\n FALSE,\\n '[\\\"admin\\\"]',\\n unixepoch(),\\n unixepoch()\\n);\\n\\n-- Database Tools Plugin\\nINSERT OR IGNORE INTO plugins (\\n id, name, display_name, description, version, author, category, icon,\\n status, is_core, permissions, installed_at, last_updated\\n) VALUES (\\n 'database-tools',\\n 'database-tools',\\n 'Database Tools',\\n 'Database management tools including truncate, backup, and validation',\\n '1.0.0',\\n 'SonicJS Team',\\n 'system',\\n 'ποΈ',\\n 'active',\\n FALSE,\\n '[\\\"manage:database\\\", \\\"admin\\\"]',\\n unixepoch(),\\n unixepoch()\\n);\\n\"\n },\n {\n id: '015',\n name: 'Add Remaining Plugins',\n filename: '015_add_remaining_plugins.sql',\n description: 'Migration 015: Add Remaining Plugins',\n sql: \"-- Add Remaining Plugins\\n-- Migration: 015_add_remaining_plugins\\n-- Description: Add all remaining core plugins that were missing from the registry\\n\\n-- Testimonials Plugin (with correct name)\\nINSERT OR IGNORE INTO plugins (\\n id, name, display_name, description, version, author, category, icon,\\n status, is_core, permissions, dependencies, settings, installed_at, last_updated\\n) VALUES (\\n 'testimonials-plugin',\\n 'testimonials-plugin',\\n 'Customer Testimonials',\\n 'Manage customer testimonials and reviews with rating support',\\n '1.0.0',\\n 'SonicJS',\\n 'content',\\n 'β',\\n 'active',\\n FALSE,\\n '[\\\"manage:testimonials\\\"]',\\n '[]',\\n '{\\\"defaultPublished\\\": true, \\\"requireRating\\\": false}',\\n unixepoch(),\\n unixepoch()\\n);\\n\\n-- Code Examples Plugin (with correct name)\\nINSERT OR IGNORE INTO plugins (\\n id, name, display_name, description, version, author, category, icon,\\n status, is_core, permissions, dependencies, settings, installed_at, last_updated\\n) VALUES (\\n 'code-examples-plugin',\\n 'code-examples-plugin',\\n 'Code Examples',\\n 'Manage code snippets and examples with syntax highlighting support',\\n '1.0.0',\\n 'SonicJS',\\n 'content',\\n 'π»',\\n 'active',\\n FALSE,\\n '[\\\"manage:code-examples\\\"]',\\n '[]',\\n '{\\\"defaultPublished\\\": true, \\\"supportedLanguages\\\": [\\\"javascript\\\", \\\"typescript\\\", \\\"python\\\", \\\"go\\\", \\\"rust\\\", \\\"java\\\", \\\"php\\\", \\\"ruby\\\", \\\"sql\\\"]}',\\n unixepoch(),\\n unixepoch()\\n);\\n\\n-- Workflow Plugin (with correct name)\\nINSERT OR IGNORE INTO plugins (\\n id, name, display_name, description, version, author, category, icon,\\n status, is_core, permissions, dependencies, installed_at, last_updated\\n) VALUES (\\n 'workflow-plugin',\\n 'workflow-plugin',\\n 'Workflow Engine',\\n 'Content workflow management with approval chains, scheduling, and automation',\\n '1.0.0',\\n 'SonicJS Team',\\n 'content',\\n 'π',\\n 'active',\\n TRUE,\\n '[\\\"manage:workflows\\\", \\\"approve:content\\\"]',\\n '[]',\\n unixepoch(),\\n unixepoch()\\n);\\n\\n-- Demo Login Plugin (already exists with correct name from migration 007, but let's ensure it's there)\\nINSERT OR IGNORE INTO plugins (\\n id, name, display_name, description, version, author, category, icon,\\n status, is_core, permissions, dependencies, installed_at, last_updated\\n) VALUES (\\n 'demo-login-plugin',\\n 'demo-login-plugin',\\n 'Demo Login Prefill',\\n 'Prefills login form with demo credentials for easy site demonstration',\\n '1.0.0',\\n 'SonicJS',\\n 'demo',\\n 'π―',\\n 'active',\\n FALSE,\\n '[]',\\n '[]',\\n unixepoch(),\\n unixepoch()\\n);\\n\"\n },\n {\n id: '016',\n name: 'Remove Duplicate Cache Plugin',\n filename: '016_remove_duplicate_cache_plugin.sql',\n description: 'Migration 016: Remove Duplicate Cache Plugin',\n sql: \"-- Migration: Remove duplicate cache plugin entry\\n-- Description: Removes the old 'cache' plugin (id: 'cache') that is a duplicate of 'core-cache'\\n-- This fixes the issue where Cache System appears twice in the plugins list\\n-- Created: 2025-10-14\\n\\n-- Remove the old 'cache' plugin entry if it exists\\n-- The correct plugin is 'core-cache' which is managed by plugin-bootstrap.ts\\nDELETE FROM plugins WHERE id = 'cache' AND name = 'cache';\\n\\n-- Clean up any related entries in plugin activity log\\nDELETE FROM plugin_activity_log WHERE plugin_id = 'cache';\\n\\n-- Clean up any related entries in plugin hooks\\nDELETE FROM plugin_hooks WHERE plugin_id = 'cache';\\n\\n-- Clean up any related entries in plugin routes\\nDELETE FROM plugin_routes WHERE plugin_id = 'cache';\\n\"\n },\n {\n id: '017',\n name: 'Auth Configurable Fields',\n filename: '017_auth_configurable_fields.sql',\n description: 'Migration 017: Auth Configurable Fields',\n sql: \"-- Migration: Make authentication fields configurable\\n-- This migration updates the core-auth plugin to support configurable required fields\\n\\n-- The settings will be stored in the plugins table as JSON\\n-- Default settings for core-auth plugin include:\\n-- {\\n-- \\\"requiredFields\\\": {\\n-- \\\"email\\\": { \\\"required\\\": true, \\\"minLength\\\": 5 },\\n-- \\\"password\\\": { \\\"required\\\": true, \\\"minLength\\\": 8 },\\n-- \\\"username\\\": { \\\"required\\\": true, \\\"minLength\\\": 3 },\\n-- \\\"firstName\\\": { \\\"required\\\": true, \\\"minLength\\\": 1 },\\n-- \\\"lastName\\\": { \\\"required\\\": true, \\\"minLength\\\": 1 }\\n-- },\\n-- \\\"validation\\\": {\\n-- \\\"emailFormat\\\": true,\\n-- \\\"allowDuplicateUsernames\\\": false\\n-- }\\n-- }\\n\\n-- Update core-auth plugin settings with configurable field requirements\\nUPDATE plugins\\nSET settings = json_object(\\n 'requiredFields', json_object(\\n 'email', json_object('required', 1, 'minLength', 5, 'label', 'Email', 'type', 'email'),\\n 'password', json_object('required', 1, 'minLength', 8, 'label', 'Password', 'type', 'password'),\\n 'username', json_object('required', 1, 'minLength', 3, 'label', 'Username', 'type', 'text'),\\n 'firstName', json_object('required', 1, 'minLength', 1, 'label', 'First Name', 'type', 'text'),\\n 'lastName', json_object('required', 1, 'minLength', 1, 'label', 'Last Name', 'type', 'text')\\n ),\\n 'validation', json_object(\\n 'emailFormat', 1,\\n 'allowDuplicateUsernames', 0,\\n 'passwordRequirements', json_object(\\n 'requireUppercase', 0,\\n 'requireLowercase', 0,\\n 'requireNumbers', 0,\\n 'requireSpecialChars', 0\\n )\\n ),\\n 'registration', json_object(\\n 'enabled', 1,\\n 'requireEmailVerification', 0,\\n 'defaultRole', 'viewer'\\n )\\n)\\nWHERE id = 'core-auth';\\n\\n-- If core-auth plugin doesn't exist, this migration will be handled by bootstrap\\n-- No need to insert here as plugin bootstrap handles initial plugin creation\\n\"\n },\n {\n id: '018',\n name: 'Settings Table',\n filename: '018_settings_table.sql',\n description: 'Migration 018: Settings Table',\n sql: \"-- Create settings table for storing application settings\\nCREATE TABLE IF NOT EXISTS settings (\\n id TEXT PRIMARY KEY,\\n category TEXT NOT NULL, -- 'general', 'appearance', 'security', etc.\\n key TEXT NOT NULL,\\n value TEXT NOT NULL, -- JSON value\\n created_at INTEGER NOT NULL,\\n updated_at INTEGER NOT NULL,\\n UNIQUE(category, key)\\n);\\n\\n-- Insert default general settings\\nINSERT OR IGNORE INTO settings (id, category, key, value, created_at, updated_at)\\nVALUES\\n (lower(hex(randomblob(16))), 'general', 'siteName', '\\\"SonicJS AI\\\"', unixepoch() * 1000, unixepoch() * 1000),\\n (lower(hex(randomblob(16))), 'general', 'siteDescription', '\\\"A modern headless CMS powered by AI\\\"', unixepoch() * 1000, unixepoch() * 1000),\\n (lower(hex(randomblob(16))), 'general', 'timezone', '\\\"UTC\\\"', unixepoch() * 1000, unixepoch() * 1000),\\n (lower(hex(randomblob(16))), 'general', 'language', '\\\"en\\\"', unixepoch() * 1000, unixepoch() * 1000),\\n (lower(hex(randomblob(16))), 'general', 'maintenanceMode', 'false', unixepoch() * 1000, unixepoch() * 1000);\\n\\n-- Create index for faster lookups\\nCREATE INDEX IF NOT EXISTS idx_settings_category ON settings(category);\\nCREATE INDEX IF NOT EXISTS idx_settings_category_key ON settings(category, key);\\n\"\n },\n {\n id: '019',\n name: 'Remove Blog Posts Collection',\n filename: '019_remove_blog_posts_collection.sql',\n description: 'Migration 019: Remove Blog Posts Collection',\n sql: \"-- Migration: Remove blog_posts from database-managed collections\\n-- Description: Remove blog-posts-collection from the database so it can be managed by code-based collection\\n-- Created: 2025-11-04\\n\\n-- Delete content associated with blog-posts-collection\\nDELETE FROM content WHERE collection_id = 'blog-posts-collection';\\n\\n-- Delete content fields for blog-posts-collection\\nDELETE FROM content_fields WHERE collection_id = 'blog-posts-collection';\\n\\n-- Delete the blog-posts collection itself\\nDELETE FROM collections WHERE id = 'blog-posts-collection';\\n\\n-- The blog-posts collection will now be managed by the code-based collection\\n-- in src/collections/blog-posts.collection.ts\\n\"\n },\n {\n id: '020',\n name: 'Add Email Plugin',\n filename: '020_add_email_plugin.sql',\n description: 'Migration 020: Add Email Plugin',\n sql: \"-- Add Email Plugin\\n-- Migration: 020_add_email_plugin\\n-- Description: Add email plugin for transactional emails via Resend\\n\\nINSERT OR IGNORE INTO plugins (\\n id, name, display_name, description, version, author, category, icon,\\n status, is_core, permissions, installed_at, last_updated\\n) VALUES (\\n 'email',\\n 'email',\\n 'Email',\\n 'Send transactional emails using Resend',\\n '1.0.0-beta.1',\\n 'SonicJS Team',\\n 'utilities',\\n 'π§',\\n 'inactive',\\n TRUE,\\n '[\\\"email:manage\\\", \\\"email:send\\\", \\\"email:view-logs\\\"]',\\n unixepoch(),\\n unixepoch()\\n);\\n\"\n },\n {\n id: '021',\n name: 'Add Magic Link Auth Plugin',\n filename: '021_add_magic_link_auth_plugin.sql',\n description: 'Migration 021: Add Magic Link Auth Plugin',\n sql: \"-- Add Magic Link Authentication Plugin\\n-- Migration: 021_add_magic_link_auth_plugin\\n-- Description: Add magic link authentication plugin for passwordless login\\n\\n-- Create magic_links table\\nCREATE TABLE IF NOT EXISTS magic_links (\\n id TEXT PRIMARY KEY,\\n user_email TEXT NOT NULL,\\n token TEXT NOT NULL UNIQUE,\\n expires_at INTEGER NOT NULL,\\n used INTEGER DEFAULT 0,\\n used_at INTEGER,\\n ip_address TEXT,\\n user_agent TEXT,\\n created_at INTEGER NOT NULL\\n);\\n\\n-- Create indexes for performance\\nCREATE INDEX IF NOT EXISTS idx_magic_links_token ON magic_links(token);\\nCREATE INDEX IF NOT EXISTS idx_magic_links_email ON magic_links(user_email);\\nCREATE INDEX IF NOT EXISTS idx_magic_links_expires ON magic_links(expires_at);\\n\\n-- Register the plugin\\nINSERT OR IGNORE INTO plugins (\\n id, name, display_name, description, version, author, category, icon,\\n status, is_core, permissions, dependencies, installed_at, last_updated\\n) VALUES (\\n 'magic-link-auth',\\n 'magic-link-auth',\\n 'Magic Link Authentication',\\n 'Passwordless authentication via email magic links. Users receive a secure one-time link to sign in without entering a password.',\\n '1.0.0',\\n 'SonicJS Team',\\n 'security',\\n 'π',\\n 'inactive',\\n FALSE,\\n '[\\\"auth:manage\\\", \\\"auth:magic-link\\\"]',\\n '[\\\"email\\\"]',\\n unixepoch(),\\n unixepoch()\\n);\\n\"\n },\n {\n id: '022',\n name: 'Add Tinymce Plugin',\n filename: '022_add_tinymce_plugin.sql',\n description: 'Migration 022: Add Tinymce Plugin',\n sql: \"-- Add TinyMCE Rich Text Editor Plugin\\n-- Migration: 022_add_tinymce_plugin\\n-- Description: Add TinyMCE plugin for WYSIWYG rich text editing\\n\\n-- Register the plugin (active by default since it replaces hardcoded TinyMCE)\\nINSERT OR IGNORE INTO plugins (\\n id, name, display_name, description, version, author, category, icon,\\n status, is_core, permissions, dependencies, settings, installed_at, last_updated\\n) VALUES (\\n 'tinymce-plugin',\\n 'tinymce-plugin',\\n 'TinyMCE Rich Text Editor',\\n 'Powerful WYSIWYG rich text editor for content creation. Provides a full-featured editor with formatting, media embedding, and customizable toolbars for richtext fields.',\\n '1.0.0',\\n 'SonicJS Team',\\n 'editor',\\n 'βοΈ',\\n 'active',\\n FALSE,\\n '[]',\\n '[]',\\n '{\\\"apiKey\\\":\\\"no-api-key\\\",\\\"defaultHeight\\\":300,\\\"defaultToolbar\\\":\\\"full\\\",\\\"skin\\\":\\\"oxide-dark\\\"}',\\n unixepoch(),\\n unixepoch()\\n);\\n\"\n },\n {\n id: '023',\n name: 'Add Easy Mdx Plugin',\n filename: '023_add_easy_mdx_plugin.sql',\n description: 'Migration 023: Add Easy Mdx Plugin',\n sql: \"-- Add EasyMDE Markdown Editor Plugin\\n-- Migration: 023_add_easy_mdx_plugin\\n-- Description: Add EasyMDE plugin for lightweight markdown editing\\n\\n-- Register the plugin (active by default)\\nINSERT OR IGNORE INTO plugins (\\n id, name, display_name, description, version, author, category, icon,\\n status, is_core, permissions, dependencies, settings, installed_at, last_updated\\n) VALUES (\\n 'easy-mdx',\\n 'easy-mdx',\\n 'EasyMDE Markdown Editor',\\n 'Lightweight markdown editor with live preview. Provides a simple and efficient editor with markdown support for richtext fields.',\\n '1.0.0',\\n 'SonicJS Team',\\n 'editor',\\n 'π',\\n 'active',\\n FALSE,\\n '[]',\\n '[]',\\n '{\\\"defaultHeight\\\":400,\\\"theme\\\":\\\"dark\\\",\\\"toolbar\\\":\\\"full\\\",\\\"placeholder\\\":\\\"Start writing your content...\\\"}',\\n unixepoch(),\\n unixepoch()\\n);\\n\"\n },\n {\n id: '024',\n name: 'Add Quill Editor Plugin',\n filename: '024_add_quill_editor_plugin.sql',\n description: 'Migration 024: Add Quill Editor Plugin',\n sql: \"-- Add Quill Rich Text Editor Plugin\\n-- Migration: 024_add_quill_editor_plugin\\n-- Description: Add Quill plugin for modern rich text editing\\n\\n-- Register the plugin (active by default)\\nINSERT OR IGNORE INTO plugins (\\n id, name, display_name, description, version, author, category, icon,\\n status, is_core, permissions, dependencies, settings, installed_at, last_updated\\n) VALUES (\\n 'quill-editor',\\n 'quill-editor',\\n 'Quill Rich Text Editor',\\n 'Modern rich text editor for content creation. Provides a clean, intuitive WYSIWYG editor with customizable toolbars for richtext fields.',\\n '1.0.0',\\n 'SonicJS Team',\\n 'editor',\\n 'βοΈ',\\n 'active',\\n FALSE,\\n '[]',\\n '[]',\\n '{\\\"theme\\\":\\\"snow\\\",\\\"defaultHeight\\\":300,\\\"defaultToolbar\\\":\\\"full\\\",\\\"placeholder\\\":\\\"Start writing your content...\\\"}',\\n unixepoch(),\\n unixepoch()\\n);\\n\"\n },\n {\n id: '025',\n name: 'Add Easymde Plugin',\n filename: '025_add_easymde_plugin.sql',\n description: 'Migration 025: Add Easymde Plugin',\n sql: \"-- Add EasyMDE Rich Text Editor Plugin\\n-- Migration: 025_add_easymde_plugin\\n-- Description: Add EasyMDE plugin for markdown-based rich text editing\\n\\n-- Register the plugin (inactive by default, replacing MDXEditor)\\nINSERT OR IGNORE INTO plugins (\\n id, name, display_name, description, version, author, category, icon,\\n status, is_core, permissions, dependencies, settings, installed_at, last_updated\\n) VALUES (\\n 'easymde-editor',\\n 'easymde-editor',\\n 'EasyMDE Editor',\\n 'Lightweight markdown editor for content creation. Simple, elegant WYSIWYG markdown editor with live preview, toolbar, and dark mode support for richtext fields.',\\n '1.0.0',\\n 'SonicJS Team',\\n 'editor',\\n 'βοΈ',\\n 'inactive',\\n TRUE,\\n '[]',\\n '[]',\\n '{\\\"theme\\\":\\\"dark\\\",\\\"defaultHeight\\\":300,\\\"toolbar\\\":\\\"full\\\",\\\"spellChecker\\\":false,\\\"placeholder\\\":\\\"Start writing your content...\\\"}',\\n unixepoch(),\\n unixepoch()\\n);\\n\"\n },\n {\n id: '026',\n name: 'Add Otp Login',\n filename: '026_add_otp_login.sql',\n description: 'Migration 026: Add Otp Login',\n sql: \"-- Add OTP Login Plugin\\n-- Migration: 021_add_otp_login\\n-- Description: Add OTP login plugin for passwordless authentication via email codes\\n\\n-- Create table for OTP codes\\nCREATE TABLE IF NOT EXISTS otp_codes (\\n id TEXT PRIMARY KEY,\\n user_email TEXT NOT NULL,\\n code TEXT NOT NULL,\\n expires_at INTEGER NOT NULL,\\n used INTEGER DEFAULT 0,\\n used_at INTEGER,\\n ip_address TEXT,\\n user_agent TEXT,\\n attempts INTEGER DEFAULT 0,\\n created_at INTEGER NOT NULL\\n);\\n\\n-- Create indexes for performance\\nCREATE INDEX IF NOT EXISTS idx_otp_email_code ON otp_codes(user_email, code);\\nCREATE INDEX IF NOT EXISTS idx_otp_expires ON otp_codes(expires_at);\\nCREATE INDEX IF NOT EXISTS idx_otp_used ON otp_codes(used);\\n\\n-- Add plugin record\\nINSERT OR IGNORE INTO plugins (\\n id, name, display_name, description, version, author, category, icon,\\n status, is_core, permissions, installed_at, last_updated\\n) VALUES (\\n 'otp-login',\\n 'otp-login',\\n 'OTP Login',\\n 'Passwordless authentication via email one-time codes',\\n '1.0.0-beta.1',\\n 'SonicJS Team',\\n 'security',\\n 'π’',\\n 'inactive',\\n TRUE,\\n '[\\\"otp:manage\\\", \\\"otp:request\\\", \\\"otp:verify\\\"]',\\n unixepoch(),\\n unixepoch()\\n);\\n\"\n },\n {\n id: '027',\n name: 'Fix Slug Field Type',\n filename: '027_fix_slug_field_type.sql',\n description: 'Migration 027: Fix Slug Field Type',\n sql: \"-- Migration: Fix slug field type\\n-- Description: Update slug fields to use 'slug' field type instead of 'text' for proper auto-generation\\n-- Created: 2026-01-10\\n\\n-- Update pages collection slug field to use 'slug' field type\\nUPDATE content_fields \\nSET field_type = 'slug'\\nWHERE field_name = 'slug' AND collection_id = 'pages-collection';\\n\\n-- Update blog posts slug field if it exists\\nUPDATE content_fields \\nSET field_type = 'slug'\\nWHERE field_name = 'slug' AND collection_id = 'blog-posts-collection';\\n\\n-- Update news slug field if it exists\\nUPDATE content_fields \\nSET field_type = 'slug'\\nWHERE field_name = 'slug' AND collection_id = 'news-collection';\\n\"\n },\n {\n id: '028',\n name: 'Fix Slug Field Type In Schemas',\n filename: '028_fix_slug_field_type_in_schemas.sql',\n description: 'Migration 028: Fix Slug Field Type In Schemas',\n sql: \"-- Migration: Fix slug field type in collection schemas\\n-- Description: Update slug fields in collection schemas to use 'slug' type instead of 'string'\\n-- Created: 2026-01-10\\n\\n-- Update pages-collection schema\\nUPDATE collections \\nSET schema = REPLACE(\\n schema,\\n '\\\"slug\\\":{\\\"type\\\":\\\"string\\\"',\\n '\\\"slug\\\":{\\\"type\\\":\\\"slug\\\"'\\n)\\nWHERE id = 'pages-collection' AND schema LIKE '%\\\"slug\\\":{\\\"type\\\":\\\"string\\\"%';\\n\\n-- Update blog-posts-collection schema if it exists\\nUPDATE collections \\nSET schema = REPLACE(\\n schema,\\n '\\\"slug\\\":{\\\"type\\\":\\\"string\\\"',\\n '\\\"slug\\\":{\\\"type\\\":\\\"slug\\\"'\\n)\\nWHERE id = 'blog-posts-collection' AND schema LIKE '%\\\"slug\\\":{\\\"type\\\":\\\"string\\\"%';\\n\\n-- Update news-collection schema if it exists\\nUPDATE collections \\nSET schema = REPLACE(\\n schema,\\n '\\\"slug\\\":{\\\"type\\\":\\\"string\\\"',\\n '\\\"slug\\\":{\\\"type\\\":\\\"slug\\\"'\\n)\\nWHERE id = 'news-collection' AND schema LIKE '%\\\"slug\\\":{\\\"type\\\":\\\"string\\\"%';\\n\"\n },\n {\n id: '029',\n name: 'Add Forms System',\n filename: '029_add_forms_system.sql',\n description: 'Migration 029: Add Forms System',\n sql: \"-- Migration: 029_add_forms_system.sql\\n-- Description: Add Form.io integration for advanced form building\\n-- Date: January 23, 2026\\n-- Phase: 1 - Database Schema\\n\\n-- =====================================================\\n-- Table: forms\\n-- Description: Stores form definitions and configuration\\n-- =====================================================\\n\\nCREATE TABLE IF NOT EXISTS forms (\\n id TEXT PRIMARY KEY,\\n name TEXT NOT NULL UNIQUE, -- Machine name (e.g., \\\"contact-form\\\")\\n display_name TEXT NOT NULL, -- Human name (e.g., \\\"Contact Form\\\")\\n description TEXT, -- Optional description\\n category TEXT DEFAULT 'general', -- Form category (contact, survey, registration, etc.)\\n \\n -- Form.io schema (JSON)\\n formio_schema TEXT NOT NULL, -- Complete Form.io JSON schema\\n \\n -- Settings\\n settings TEXT, -- JSON: {\\n -- emailNotifications: true,\\n -- notifyEmail: \\\"admin@example.com\\\",\\n -- successMessage: \\\"Thank you!\\\",\\n -- redirectUrl: \\\"/thank-you\\\",\\n -- allowAnonymous: true,\\n -- requireAuth: false,\\n -- maxSubmissions: null,\\n -- submitButtonText: \\\"Submit\\\",\\n -- saveProgress: true,\\n -- webhookUrl: null\\n -- }\\n \\n -- Status & Management\\n is_active INTEGER DEFAULT 1, -- Active/inactive flag\\n is_public INTEGER DEFAULT 1, -- Public (anyone) vs private (auth required)\\n managed INTEGER DEFAULT 0, -- Code-managed (like collections)\\n \\n -- Metadata\\n icon TEXT, -- Optional icon for admin UI\\n color TEXT, -- Optional color (hex) for admin UI\\n tags TEXT, -- JSON array of tags\\n \\n -- Stats\\n submission_count INTEGER DEFAULT 0, -- Total submissions received\\n view_count INTEGER DEFAULT 0, -- Form views (optional tracking)\\n \\n -- Ownership\\n created_by TEXT REFERENCES users(id), -- User who created the form\\n updated_by TEXT REFERENCES users(id), -- User who last updated\\n \\n -- Timestamps\\n created_at INTEGER NOT NULL,\\n updated_at INTEGER NOT NULL\\n);\\n\\n-- Indexes for forms\\nCREATE INDEX IF NOT EXISTS idx_forms_name ON forms(name);\\nCREATE INDEX IF NOT EXISTS idx_forms_category ON forms(category);\\nCREATE INDEX IF NOT EXISTS idx_forms_active ON forms(is_active);\\nCREATE INDEX IF NOT EXISTS idx_forms_public ON forms(is_public);\\nCREATE INDEX IF NOT EXISTS idx_forms_created_by ON forms(created_by);\\n\\n-- =====================================================\\n-- Table: form_submissions\\n-- Description: Stores submitted form data\\n-- =====================================================\\n\\nCREATE TABLE IF NOT EXISTS form_submissions (\\n id TEXT PRIMARY KEY,\\n form_id TEXT NOT NULL REFERENCES forms(id) ON DELETE CASCADE,\\n \\n -- Submission data\\n submission_data TEXT NOT NULL, -- JSON: The actual form data submitted\\n \\n -- Submission metadata\\n status TEXT DEFAULT 'pending', -- pending, reviewed, approved, rejected, spam\\n submission_number INTEGER, -- Sequential number per form\\n \\n -- User information (if authenticated)\\n user_id TEXT REFERENCES users(id), -- Submitter user ID (if logged in)\\n user_email TEXT, -- Email from form (or user account)\\n \\n -- Tracking information\\n ip_address TEXT, -- IP address of submitter\\n user_agent TEXT, -- Browser user agent\\n referrer TEXT, -- Page that referred to form\\n utm_source TEXT, -- UTM tracking params\\n utm_medium TEXT,\\n utm_campaign TEXT,\\n \\n -- Review/Processing\\n reviewed_by TEXT REFERENCES users(id), -- Admin who reviewed\\n reviewed_at INTEGER, -- Review timestamp\\n review_notes TEXT, -- Admin notes\\n \\n -- Flags\\n is_spam INTEGER DEFAULT 0, -- Spam flag\\n is_archived INTEGER DEFAULT 0, -- Archived flag\\n \\n -- Timestamps\\n submitted_at INTEGER NOT NULL,\\n updated_at INTEGER NOT NULL\\n);\\n\\n-- Indexes for submissions\\nCREATE INDEX IF NOT EXISTS idx_form_submissions_form_id ON form_submissions(form_id);\\nCREATE INDEX IF NOT EXISTS idx_form_submissions_status ON form_submissions(status);\\nCREATE INDEX IF NOT EXISTS idx_form_submissions_user_id ON form_submissions(user_id);\\nCREATE INDEX IF NOT EXISTS idx_form_submissions_email ON form_submissions(user_email);\\nCREATE INDEX IF NOT EXISTS idx_form_submissions_submitted_at ON form_submissions(submitted_at);\\nCREATE INDEX IF NOT EXISTS idx_form_submissions_spam ON form_submissions(is_spam);\\n\\n-- Trigger to auto-increment submission_number per form\\nCREATE TRIGGER IF NOT EXISTS set_submission_number\\nAFTER INSERT ON form_submissions\\nBEGIN\\n UPDATE form_submissions \\n SET submission_number = (\\n SELECT COUNT(*) \\n FROM form_submissions \\n WHERE form_id = NEW.form_id \\n AND id <= NEW.id\\n )\\n WHERE id = NEW.id;\\nEND;\\n\\n-- Trigger to update form submission_count\\nCREATE TRIGGER IF NOT EXISTS increment_form_submission_count\\nAFTER INSERT ON form_submissions\\nBEGIN\\n UPDATE forms \\n SET submission_count = submission_count + 1,\\n updated_at = unixepoch() * 1000\\n WHERE id = NEW.form_id;\\nEND;\\n\\n-- =====================================================\\n-- Table: form_files (Optional)\\n-- Description: Link form submissions to uploaded files\\n-- =====================================================\\n\\nCREATE TABLE IF NOT EXISTS form_files (\\n id TEXT PRIMARY KEY,\\n submission_id TEXT NOT NULL REFERENCES form_submissions(id) ON DELETE CASCADE,\\n media_id TEXT NOT NULL REFERENCES media(id) ON DELETE CASCADE,\\n field_name TEXT NOT NULL, -- Form field that uploaded this file\\n uploaded_at INTEGER NOT NULL\\n);\\n\\n-- Indexes for form files\\nCREATE INDEX IF NOT EXISTS idx_form_files_submission ON form_files(submission_id);\\nCREATE INDEX IF NOT EXISTS idx_form_files_media ON form_files(media_id);\\n\\n-- =====================================================\\n-- Sample Data: Create a default contact form\\n-- =====================================================\\n\\nINSERT OR IGNORE INTO forms (\\n id,\\n name,\\n display_name,\\n description,\\n category,\\n formio_schema,\\n settings,\\n is_active,\\n is_public,\\n created_at,\\n updated_at\\n) VALUES (\\n 'default-contact-form',\\n 'contact',\\n 'Contact Form',\\n 'A simple contact form for getting in touch',\\n 'contact',\\n '{\\\"components\\\":[]}',\\n '{\\\"emailNotifications\\\":false,\\\"successMessage\\\":\\\"Thank you for your submission!\\\",\\\"submitButtonText\\\":\\\"Submit\\\",\\\"requireAuth\\\":false}',\\n 1,\\n 1,\\n unixepoch() * 1000,\\n unixepoch() * 1000\\n);\\n\"\n },\n {\n id: '030',\n name: 'Add Turnstile To Forms',\n filename: '030_add_turnstile_to_forms.sql',\n description: 'Migration 030: Add Turnstile To Forms',\n sql: \"-- Add Turnstile configuration to forms table\\n-- This allows per-form Turnstile settings with global fallback\\n\\n-- Add columns (D1 may not support CHECK constraints in ALTER TABLE)\\nALTER TABLE forms ADD COLUMN turnstile_enabled INTEGER DEFAULT 0;\\nALTER TABLE forms ADD COLUMN turnstile_settings TEXT;\\n\\n-- Set default to inherit global settings for existing forms\\nUPDATE forms \\nSET turnstile_settings = '{\\\"inherit\\\":true}' \\nWHERE turnstile_settings IS NULL;\\n\\n-- Add index for faster lookups\\nCREATE INDEX IF NOT EXISTS idx_forms_turnstile ON forms(turnstile_enabled);\\n\"\n },\n {\n id: '031',\n name: 'Ai Search Plugin',\n filename: '031_ai_search_plugin.sql',\n description: 'Migration 031: Ai Search Plugin',\n sql: \"-- AI Search plugin settings\\nCREATE TABLE IF NOT EXISTS ai_search_settings (\\n id INTEGER PRIMARY KEY AUTOINCREMENT,\\n enabled BOOLEAN DEFAULT 0,\\n ai_mode_enabled BOOLEAN DEFAULT 1,\\n selected_collections TEXT, -- JSON array of collection IDs to index\\n dismissed_collections TEXT, -- JSON array of collection IDs user chose not to index\\n autocomplete_enabled BOOLEAN DEFAULT 1,\\n cache_duration INTEGER DEFAULT 1, -- hours\\n results_limit INTEGER DEFAULT 20,\\n index_media BOOLEAN DEFAULT 0,\\n index_status TEXT, -- JSON object with status per collection\\n last_indexed_at INTEGER,\\n created_at INTEGER DEFAULT (strftime('%s', 'now') * 1000),\\n updated_at INTEGER DEFAULT (strftime('%s', 'now') * 1000)\\n);\\n\\n-- Search history/analytics\\nCREATE TABLE IF NOT EXISTS ai_search_history (\\n id INTEGER PRIMARY KEY AUTOINCREMENT,\\n query TEXT NOT NULL,\\n mode TEXT, -- 'ai' or 'keyword'\\n results_count INTEGER,\\n user_id INTEGER,\\n created_at INTEGER DEFAULT (strftime('%s', 'now') * 1000)\\n);\\n\\n-- Index metadata tracking (per collection)\\nCREATE TABLE IF NOT EXISTS ai_search_index_meta (\\n id INTEGER PRIMARY KEY AUTOINCREMENT,\\n collection_id INTEGER NOT NULL,\\n collection_name TEXT NOT NULL, -- Cache collection name for display\\n total_items INTEGER DEFAULT 0,\\n indexed_items INTEGER DEFAULT 0,\\n last_sync_at INTEGER,\\n status TEXT DEFAULT 'pending', -- 'pending', 'indexing', 'completed', 'error'\\n error_message TEXT,\\n UNIQUE(collection_id)\\n);\\n\\n-- Indexes for performance\\nCREATE INDEX IF NOT EXISTS idx_ai_search_history_created_at ON ai_search_history(created_at);\\nCREATE INDEX IF NOT EXISTS idx_ai_search_history_mode ON ai_search_history(mode);\\nCREATE INDEX IF NOT EXISTS idx_ai_search_index_meta_collection_id ON ai_search_index_meta(collection_id);\\nCREATE INDEX IF NOT EXISTS idx_ai_search_index_meta_status ON ai_search_index_meta(status);\\n\"\n }\n]\n\n// Map for quick lookup by ID\nexport const migrationsByIdMap = new MapCount: {count}
\\n \\n\\n
\\n );\\n}\\n\\nexport default Counter;',\\n 'javascript',\\n 'frontend',\\n 'react,hooks,state',\\n 1,\\n 1),\\n\\n('TypeScript Interface Example',\\n 'Defining a TypeScript interface for type-safe objects.',\\n 'interface User {\\n id: string;\\n email: string;\\n name: string;\\n role: ''admin'' | ''editor'' | ''viewer'';\\n createdAt: Date;\\n}\\n\\nfunction greetUser(user: User): string {\\n return `Hello, ${user.name}!`;\\n}\\n\\nconst user: User = {\\n id: ''123'',\\n email: ''user@example.com'',\\n name: ''John Doe'',\\n role: ''admin'',\\n createdAt: new Date()\\n};\\n\\nconsole.log(greetUser(user));',\\n 'typescript',\\n 'backend',\\n 'typescript,types,interface',\\n 1,\\n 2),\\n\\n('Python List Comprehension',\\n 'Elegant way to create lists in Python using list comprehensions.',\\n '# Basic list comprehension\\nsquares = [x**2 for x in range(10)]\\nprint(squares) # [0, 1, 4, 9, 16, 25, 36, 49, 64, 81]\\n\\n# With condition\\neven_squares = [x**2 for x in range(10) if x % 2 == 0]\\nprint(even_squares) # [0, 4, 16, 36, 64]\\n\\n# Nested list comprehension\\nmatrix = [[i+j for j in range(3)] for i in range(3)]\\nprint(matrix) # [[0, 1, 2], [1, 2, 3], [2, 3, 4]]',\\n 'python',\\n 'general',\\n 'python,lists,comprehension',\\n 1,\\n 3),\\n\\n('SQL Join Example',\\n 'Common SQL JOIN patterns for combining data from multiple tables.',\\n '-- INNER JOIN: Returns only matching rows\\nSELECT users.name, orders.total\\nFROM users\\nINNER JOIN orders ON users.id = orders.user_id;\\n\\n-- LEFT JOIN: Returns all users, even without orders\\nSELECT users.name, orders.total\\nFROM users\\nLEFT JOIN orders ON users.id = orders.user_id;\\n\\n-- Multiple JOINs\\nSELECT\\n users.name,\\n orders.order_date,\\n products.name AS product_name\\nFROM users\\nINNER JOIN orders ON users.id = orders.user_id\\nINNER JOIN order_items ON orders.id = order_items.order_id\\nINNER JOIN products ON order_items.product_id = products.id;',\\n 'sql',\\n 'database',\\n 'sql,joins,queries',\\n 1,\\n 4),\\n\\n('Go Error Handling',\\n 'Idiomatic error handling pattern in Go.',\\n 'package main\\n\\nimport (\\n\\t\\\"errors\\\"\\n\\t\\\"fmt\\\"\\n)\\n\\nfunc divide(a, b float64) (float64, error) {\\n\\tif b == 0 {\\n\\t\\treturn 0, errors.New(\\\"division by zero\\\")\\n\\t}\\n\\treturn a / b, nil\\n}\\n\\nfunc main() {\\n\\tresult, err := divide(10, 2)\\n\\tif err != nil {\\n\\t\\tfmt.Println(\\\"Error:\\\", err)\\n\\t\\treturn\\n\\t}\\n\\tfmt.Printf(\\\"Result: %.2f\\\\n\\\", result)\\n\\n\\t// This will error\\n\\t_, err = divide(10, 0)\\n\\tif err != nil {\\n\\t\\tfmt.Println(\\\"Error:\\\", err)\\n\\t}\\n}',\\n 'go',\\n 'backend',\\n 'go,error-handling,functions',\\n 1,\\n 5);\\n\"\n },\n {\n id: '014',\n name: 'Fix Plugin Registry',\n filename: '014_fix_plugin_registry.sql',\n description: 'Migration 014: Fix Plugin Registry',\n sql: \"-- Fix Plugin Registry\\n-- Migration: 014_fix_plugin_registry\\n-- Description: Add missing plugins and fix plugin name mismatches\\n\\n-- Note: Cannot easily update plugin names as they may be referenced elsewhere\\n-- Instead we'll add the missing plugins with correct names\\n\\n-- Insert missing plugins\\n\\n-- Core Analytics Plugin\\nINSERT OR IGNORE INTO plugins (\\n id, name, display_name, description, version, author, category, icon,\\n status, is_core, permissions, installed_at, last_updated\\n) VALUES (\\n 'core-analytics',\\n 'core-analytics',\\n 'Analytics & Tracking',\\n 'Core analytics tracking and reporting plugin with page views and event tracking',\\n '1.0.0',\\n 'SonicJS Team',\\n 'seo',\\n 'π',\\n 'active',\\n TRUE,\\n '[\\\"view:analytics\\\", \\\"manage:tracking\\\"]',\\n unixepoch(),\\n unixepoch()\\n);\\n\\n-- FAQ Plugin\\nINSERT OR IGNORE INTO plugins (\\n id, name, display_name, description, version, author, category, icon,\\n status, is_core, permissions, installed_at, last_updated\\n) VALUES (\\n 'faq-plugin',\\n 'faq-plugin',\\n 'FAQ Management',\\n 'Frequently Asked Questions management plugin with categories, search, and custom styling',\\n '1.0.0',\\n 'SonicJS',\\n 'content',\\n 'β',\\n 'active',\\n FALSE,\\n '[\\\"manage:faqs\\\"]',\\n unixepoch(),\\n unixepoch()\\n);\\n\\n-- Seed Data Plugin\\nINSERT OR IGNORE INTO plugins (\\n id, name, display_name, description, version, author, category, icon,\\n status, is_core, permissions, installed_at, last_updated\\n) VALUES (\\n 'seed-data',\\n 'seed-data',\\n 'Seed Data Generator',\\n 'Generate realistic example users and content for testing and development',\\n '1.0.0',\\n 'SonicJS Team',\\n 'development',\\n 'π±',\\n 'inactive',\\n FALSE,\\n '[\\\"admin\\\"]',\\n unixepoch(),\\n unixepoch()\\n);\\n\\n-- Database Tools Plugin\\nINSERT OR IGNORE INTO plugins (\\n id, name, display_name, description, version, author, category, icon,\\n status, is_core, permissions, installed_at, last_updated\\n) VALUES (\\n 'database-tools',\\n 'database-tools',\\n 'Database Tools',\\n 'Database management tools including truncate, backup, and validation',\\n '1.0.0',\\n 'SonicJS Team',\\n 'system',\\n 'ποΈ',\\n 'active',\\n FALSE,\\n '[\\\"manage:database\\\", \\\"admin\\\"]',\\n unixepoch(),\\n unixepoch()\\n);\\n\"\n },\n {\n id: '015',\n name: 'Add Remaining Plugins',\n filename: '015_add_remaining_plugins.sql',\n description: 'Migration 015: Add Remaining Plugins',\n sql: \"-- Add Remaining Plugins\\n-- Migration: 015_add_remaining_plugins\\n-- Description: Add all remaining core plugins that were missing from the registry\\n\\n-- Testimonials Plugin (with correct name)\\nINSERT OR IGNORE INTO plugins (\\n id, name, display_name, description, version, author, category, icon,\\n status, is_core, permissions, dependencies, settings, installed_at, last_updated\\n) VALUES (\\n 'testimonials-plugin',\\n 'testimonials-plugin',\\n 'Customer Testimonials',\\n 'Manage customer testimonials and reviews with rating support',\\n '1.0.0',\\n 'SonicJS',\\n 'content',\\n 'β',\\n 'active',\\n FALSE,\\n '[\\\"manage:testimonials\\\"]',\\n '[]',\\n '{\\\"defaultPublished\\\": true, \\\"requireRating\\\": false}',\\n unixepoch(),\\n unixepoch()\\n);\\n\\n-- Code Examples Plugin (with correct name)\\nINSERT OR IGNORE INTO plugins (\\n id, name, display_name, description, version, author, category, icon,\\n status, is_core, permissions, dependencies, settings, installed_at, last_updated\\n) VALUES (\\n 'code-examples-plugin',\\n 'code-examples-plugin',\\n 'Code Examples',\\n 'Manage code snippets and examples with syntax highlighting support',\\n '1.0.0',\\n 'SonicJS',\\n 'content',\\n 'π»',\\n 'active',\\n FALSE,\\n '[\\\"manage:code-examples\\\"]',\\n '[]',\\n '{\\\"defaultPublished\\\": true, \\\"supportedLanguages\\\": [\\\"javascript\\\", \\\"typescript\\\", \\\"python\\\", \\\"go\\\", \\\"rust\\\", \\\"java\\\", \\\"php\\\", \\\"ruby\\\", \\\"sql\\\"]}',\\n unixepoch(),\\n unixepoch()\\n);\\n\\n-- Workflow Plugin (with correct name)\\nINSERT OR IGNORE INTO plugins (\\n id, name, display_name, description, version, author, category, icon,\\n status, is_core, permissions, dependencies, installed_at, last_updated\\n) VALUES (\\n 'workflow-plugin',\\n 'workflow-plugin',\\n 'Workflow Engine',\\n 'Content workflow management with approval chains, scheduling, and automation',\\n '1.0.0',\\n 'SonicJS Team',\\n 'content',\\n 'π',\\n 'active',\\n TRUE,\\n '[\\\"manage:workflows\\\", \\\"approve:content\\\"]',\\n '[]',\\n unixepoch(),\\n unixepoch()\\n);\\n\\n-- Demo Login Plugin (already exists with correct name from migration 007, but let's ensure it's there)\\nINSERT OR IGNORE INTO plugins (\\n id, name, display_name, description, version, author, category, icon,\\n status, is_core, permissions, dependencies, installed_at, last_updated\\n) VALUES (\\n 'demo-login-plugin',\\n 'demo-login-plugin',\\n 'Demo Login Prefill',\\n 'Prefills login form with demo credentials for easy site demonstration',\\n '1.0.0',\\n 'SonicJS',\\n 'demo',\\n 'π―',\\n 'active',\\n FALSE,\\n '[]',\\n '[]',\\n unixepoch(),\\n unixepoch()\\n);\\n\"\n },\n {\n id: '016',\n name: 'Remove Duplicate Cache Plugin',\n filename: '016_remove_duplicate_cache_plugin.sql',\n description: 'Migration 016: Remove Duplicate Cache Plugin',\n sql: \"-- Migration: Remove duplicate cache plugin entry\\n-- Description: Removes the old 'cache' plugin (id: 'cache') that is a duplicate of 'core-cache'\\n-- This fixes the issue where Cache System appears twice in the plugins list\\n-- Created: 2025-10-14\\n\\n-- Remove the old 'cache' plugin entry if it exists\\n-- The correct plugin is 'core-cache' which is managed by plugin-bootstrap.ts\\nDELETE FROM plugins WHERE id = 'cache' AND name = 'cache';\\n\\n-- Clean up any related entries in plugin activity log\\nDELETE FROM plugin_activity_log WHERE plugin_id = 'cache';\\n\\n-- Clean up any related entries in plugin hooks\\nDELETE FROM plugin_hooks WHERE plugin_id = 'cache';\\n\\n-- Clean up any related entries in plugin routes\\nDELETE FROM plugin_routes WHERE plugin_id = 'cache';\\n\"\n },\n {\n id: '017',\n name: 'Auth Configurable Fields',\n filename: '017_auth_configurable_fields.sql',\n description: 'Migration 017: Auth Configurable Fields',\n sql: \"-- Migration: Make authentication fields configurable\\n-- This migration updates the core-auth plugin to support configurable required fields\\n\\n-- The settings will be stored in the plugins table as JSON\\n-- Default settings for core-auth plugin include:\\n-- {\\n-- \\\"requiredFields\\\": {\\n-- \\\"email\\\": { \\\"required\\\": true, \\\"minLength\\\": 5 },\\n-- \\\"password\\\": { \\\"required\\\": true, \\\"minLength\\\": 8 },\\n-- \\\"username\\\": { \\\"required\\\": true, \\\"minLength\\\": 3 },\\n-- \\\"firstName\\\": { \\\"required\\\": true, \\\"minLength\\\": 1 },\\n-- \\\"lastName\\\": { \\\"required\\\": true, \\\"minLength\\\": 1 }\\n-- },\\n-- \\\"validation\\\": {\\n-- \\\"emailFormat\\\": true,\\n-- \\\"allowDuplicateUsernames\\\": false\\n-- }\\n-- }\\n\\n-- Update core-auth plugin settings with configurable field requirements\\nUPDATE plugins\\nSET settings = json_object(\\n 'requiredFields', json_object(\\n 'email', json_object('required', 1, 'minLength', 5, 'label', 'Email', 'type', 'email'),\\n 'password', json_object('required', 1, 'minLength', 8, 'label', 'Password', 'type', 'password'),\\n 'username', json_object('required', 1, 'minLength', 3, 'label', 'Username', 'type', 'text'),\\n 'firstName', json_object('required', 1, 'minLength', 1, 'label', 'First Name', 'type', 'text'),\\n 'lastName', json_object('required', 1, 'minLength', 1, 'label', 'Last Name', 'type', 'text')\\n ),\\n 'validation', json_object(\\n 'emailFormat', 1,\\n 'allowDuplicateUsernames', 0,\\n 'passwordRequirements', json_object(\\n 'requireUppercase', 0,\\n 'requireLowercase', 0,\\n 'requireNumbers', 0,\\n 'requireSpecialChars', 0\\n )\\n ),\\n 'registration', json_object(\\n 'enabled', 1,\\n 'requireEmailVerification', 0,\\n 'defaultRole', 'viewer'\\n )\\n)\\nWHERE id = 'core-auth';\\n\\n-- If core-auth plugin doesn't exist, this migration will be handled by bootstrap\\n-- No need to insert here as plugin bootstrap handles initial plugin creation\\n\"\n },\n {\n id: '018',\n name: 'Settings Table',\n filename: '018_settings_table.sql',\n description: 'Migration 018: Settings Table',\n sql: \"-- Create settings table for storing application settings\\nCREATE TABLE IF NOT EXISTS settings (\\n id TEXT PRIMARY KEY,\\n category TEXT NOT NULL, -- 'general', 'appearance', 'security', etc.\\n key TEXT NOT NULL,\\n value TEXT NOT NULL, -- JSON value\\n created_at INTEGER NOT NULL,\\n updated_at INTEGER NOT NULL,\\n UNIQUE(category, key)\\n);\\n\\n-- Insert default general settings\\nINSERT OR IGNORE INTO settings (id, category, key, value, created_at, updated_at)\\nVALUES\\n (lower(hex(randomblob(16))), 'general', 'siteName', '\\\"SonicJS AI\\\"', unixepoch() * 1000, unixepoch() * 1000),\\n (lower(hex(randomblob(16))), 'general', 'siteDescription', '\\\"A modern headless CMS powered by AI\\\"', unixepoch() * 1000, unixepoch() * 1000),\\n (lower(hex(randomblob(16))), 'general', 'timezone', '\\\"UTC\\\"', unixepoch() * 1000, unixepoch() * 1000),\\n (lower(hex(randomblob(16))), 'general', 'language', '\\\"en\\\"', unixepoch() * 1000, unixepoch() * 1000),\\n (lower(hex(randomblob(16))), 'general', 'maintenanceMode', 'false', unixepoch() * 1000, unixepoch() * 1000);\\n\\n-- Create index for faster lookups\\nCREATE INDEX IF NOT EXISTS idx_settings_category ON settings(category);\\nCREATE INDEX IF NOT EXISTS idx_settings_category_key ON settings(category, key);\\n\"\n },\n {\n id: '019',\n name: 'Remove Blog Posts Collection',\n filename: '019_remove_blog_posts_collection.sql',\n description: 'Migration 019: Remove Blog Posts Collection',\n sql: \"-- Migration: Remove blog_posts from database-managed collections\\n-- Description: Remove blog-posts-collection from the database so it can be managed by code-based collection\\n-- Created: 2025-11-04\\n\\n-- Delete content associated with blog-posts-collection\\nDELETE FROM content WHERE collection_id = 'blog-posts-collection';\\n\\n-- Delete content fields for blog-posts-collection\\nDELETE FROM content_fields WHERE collection_id = 'blog-posts-collection';\\n\\n-- Delete the blog-posts collection itself\\nDELETE FROM collections WHERE id = 'blog-posts-collection';\\n\\n-- The blog-posts collection will now be managed by the code-based collection\\n-- in src/collections/blog-posts.collection.ts\\n\"\n },\n {\n id: '020',\n name: 'Add Email Plugin',\n filename: '020_add_email_plugin.sql',\n description: 'Migration 020: Add Email Plugin',\n sql: \"-- Add Email Plugin\\n-- Migration: 020_add_email_plugin\\n-- Description: Add email plugin for transactional emails via Resend\\n\\nINSERT OR IGNORE INTO plugins (\\n id, name, display_name, description, version, author, category, icon,\\n status, is_core, permissions, installed_at, last_updated\\n) VALUES (\\n 'email',\\n 'email',\\n 'Email',\\n 'Send transactional emails using Resend',\\n '1.0.0-beta.1',\\n 'SonicJS Team',\\n 'utilities',\\n 'π§',\\n 'inactive',\\n TRUE,\\n '[\\\"email:manage\\\", \\\"email:send\\\", \\\"email:view-logs\\\"]',\\n unixepoch(),\\n unixepoch()\\n);\\n\"\n },\n {\n id: '021',\n name: 'Add Magic Link Auth Plugin',\n filename: '021_add_magic_link_auth_plugin.sql',\n description: 'Migration 021: Add Magic Link Auth Plugin',\n sql: \"-- Add Magic Link Authentication Plugin\\n-- Migration: 021_add_magic_link_auth_plugin\\n-- Description: Add magic link authentication plugin for passwordless login\\n\\n-- Create magic_links table\\nCREATE TABLE IF NOT EXISTS magic_links (\\n id TEXT PRIMARY KEY,\\n user_email TEXT NOT NULL,\\n token TEXT NOT NULL UNIQUE,\\n expires_at INTEGER NOT NULL,\\n used INTEGER DEFAULT 0,\\n used_at INTEGER,\\n ip_address TEXT,\\n user_agent TEXT,\\n created_at INTEGER NOT NULL\\n);\\n\\n-- Create indexes for performance\\nCREATE INDEX IF NOT EXISTS idx_magic_links_token ON magic_links(token);\\nCREATE INDEX IF NOT EXISTS idx_magic_links_email ON magic_links(user_email);\\nCREATE INDEX IF NOT EXISTS idx_magic_links_expires ON magic_links(expires_at);\\n\\n-- Register the plugin\\nINSERT OR IGNORE INTO plugins (\\n id, name, display_name, description, version, author, category, icon,\\n status, is_core, permissions, dependencies, installed_at, last_updated\\n) VALUES (\\n 'magic-link-auth',\\n 'magic-link-auth',\\n 'Magic Link Authentication',\\n 'Passwordless authentication via email magic links. Users receive a secure one-time link to sign in without entering a password.',\\n '1.0.0',\\n 'SonicJS Team',\\n 'security',\\n 'π',\\n 'inactive',\\n FALSE,\\n '[\\\"auth:manage\\\", \\\"auth:magic-link\\\"]',\\n '[\\\"email\\\"]',\\n unixepoch(),\\n unixepoch()\\n);\\n\"\n },\n {\n id: '022',\n name: 'Add Tinymce Plugin',\n filename: '022_add_tinymce_plugin.sql',\n description: 'Migration 022: Add Tinymce Plugin',\n sql: \"-- Add TinyMCE Rich Text Editor Plugin\\n-- Migration: 022_add_tinymce_plugin\\n-- Description: Add TinyMCE plugin for WYSIWYG rich text editing\\n\\n-- Register the plugin (active by default since it replaces hardcoded TinyMCE)\\nINSERT OR IGNORE INTO plugins (\\n id, name, display_name, description, version, author, category, icon,\\n status, is_core, permissions, dependencies, settings, installed_at, last_updated\\n) VALUES (\\n 'tinymce-plugin',\\n 'tinymce-plugin',\\n 'TinyMCE Rich Text Editor',\\n 'Powerful WYSIWYG rich text editor for content creation. Provides a full-featured editor with formatting, media embedding, and customizable toolbars for richtext fields.',\\n '1.0.0',\\n 'SonicJS Team',\\n 'editor',\\n 'βοΈ',\\n 'active',\\n FALSE,\\n '[]',\\n '[]',\\n '{\\\"apiKey\\\":\\\"no-api-key\\\",\\\"defaultHeight\\\":300,\\\"defaultToolbar\\\":\\\"full\\\",\\\"skin\\\":\\\"oxide-dark\\\"}',\\n unixepoch(),\\n unixepoch()\\n);\\n\"\n },\n {\n id: '023',\n name: 'Add Easy Mdx Plugin',\n filename: '023_add_easy_mdx_plugin.sql',\n description: 'Migration 023: Add Easy Mdx Plugin',\n sql: \"-- Add EasyMDE Markdown Editor Plugin\\n-- Migration: 023_add_easy_mdx_plugin\\n-- Description: Add EasyMDE plugin for lightweight markdown editing\\n\\n-- Register the plugin (active by default)\\nINSERT OR IGNORE INTO plugins (\\n id, name, display_name, description, version, author, category, icon,\\n status, is_core, permissions, dependencies, settings, installed_at, last_updated\\n) VALUES (\\n 'easy-mdx',\\n 'easy-mdx',\\n 'EasyMDE Markdown Editor',\\n 'Lightweight markdown editor with live preview. Provides a simple and efficient editor with markdown support for richtext fields.',\\n '1.0.0',\\n 'SonicJS Team',\\n 'editor',\\n 'π',\\n 'active',\\n FALSE,\\n '[]',\\n '[]',\\n '{\\\"defaultHeight\\\":400,\\\"theme\\\":\\\"dark\\\",\\\"toolbar\\\":\\\"full\\\",\\\"placeholder\\\":\\\"Start writing your content...\\\"}',\\n unixepoch(),\\n unixepoch()\\n);\\n\"\n },\n {\n id: '024',\n name: 'Add Quill Editor Plugin',\n filename: '024_add_quill_editor_plugin.sql',\n description: 'Migration 024: Add Quill Editor Plugin',\n sql: \"-- Add Quill Rich Text Editor Plugin\\n-- Migration: 024_add_quill_editor_plugin\\n-- Description: Add Quill plugin for modern rich text editing\\n\\n-- Register the plugin (active by default)\\nINSERT OR IGNORE INTO plugins (\\n id, name, display_name, description, version, author, category, icon,\\n status, is_core, permissions, dependencies, settings, installed_at, last_updated\\n) VALUES (\\n 'quill-editor',\\n 'quill-editor',\\n 'Quill Rich Text Editor',\\n 'Modern rich text editor for content creation. Provides a clean, intuitive WYSIWYG editor with customizable toolbars for richtext fields.',\\n '1.0.0',\\n 'SonicJS Team',\\n 'editor',\\n 'βοΈ',\\n 'active',\\n FALSE,\\n '[]',\\n '[]',\\n '{\\\"theme\\\":\\\"snow\\\",\\\"defaultHeight\\\":300,\\\"defaultToolbar\\\":\\\"full\\\",\\\"placeholder\\\":\\\"Start writing your content...\\\"}',\\n unixepoch(),\\n unixepoch()\\n);\\n\"\n },\n {\n id: '025',\n name: 'Add Easymde Plugin',\n filename: '025_add_easymde_plugin.sql',\n description: 'Migration 025: Add Easymde Plugin',\n sql: \"-- Add EasyMDE Rich Text Editor Plugin\\n-- Migration: 025_add_easymde_plugin\\n-- Description: Add EasyMDE plugin for markdown-based rich text editing\\n\\n-- Register the plugin (inactive by default, replacing MDXEditor)\\nINSERT OR IGNORE INTO plugins (\\n id, name, display_name, description, version, author, category, icon,\\n status, is_core, permissions, dependencies, settings, installed_at, last_updated\\n) VALUES (\\n 'easymde-editor',\\n 'easymde-editor',\\n 'EasyMDE Editor',\\n 'Lightweight markdown editor for content creation. Simple, elegant WYSIWYG markdown editor with live preview, toolbar, and dark mode support for richtext fields.',\\n '1.0.0',\\n 'SonicJS Team',\\n 'editor',\\n 'βοΈ',\\n 'inactive',\\n TRUE,\\n '[]',\\n '[]',\\n '{\\\"theme\\\":\\\"dark\\\",\\\"defaultHeight\\\":300,\\\"toolbar\\\":\\\"full\\\",\\\"spellChecker\\\":false,\\\"placeholder\\\":\\\"Start writing your content...\\\"}',\\n unixepoch(),\\n unixepoch()\\n);\\n\"\n },\n {\n id: '026',\n name: 'Add Otp Login',\n filename: '026_add_otp_login.sql',\n description: 'Migration 026: Add Otp Login',\n sql: \"-- Add OTP Login Plugin\\n-- Migration: 021_add_otp_login\\n-- Description: Add OTP login plugin for passwordless authentication via email codes\\n\\n-- Create table for OTP codes\\nCREATE TABLE IF NOT EXISTS otp_codes (\\n id TEXT PRIMARY KEY,\\n user_email TEXT NOT NULL,\\n code TEXT NOT NULL,\\n expires_at INTEGER NOT NULL,\\n used INTEGER DEFAULT 0,\\n used_at INTEGER,\\n ip_address TEXT,\\n user_agent TEXT,\\n attempts INTEGER DEFAULT 0,\\n created_at INTEGER NOT NULL\\n);\\n\\n-- Create indexes for performance\\nCREATE INDEX IF NOT EXISTS idx_otp_email_code ON otp_codes(user_email, code);\\nCREATE INDEX IF NOT EXISTS idx_otp_expires ON otp_codes(expires_at);\\nCREATE INDEX IF NOT EXISTS idx_otp_used ON otp_codes(used);\\n\\n-- Add plugin record\\nINSERT OR IGNORE INTO plugins (\\n id, name, display_name, description, version, author, category, icon,\\n status, is_core, permissions, installed_at, last_updated\\n) VALUES (\\n 'otp-login',\\n 'otp-login',\\n 'OTP Login',\\n 'Passwordless authentication via email one-time codes',\\n '1.0.0-beta.1',\\n 'SonicJS Team',\\n 'security',\\n 'π’',\\n 'inactive',\\n TRUE,\\n '[\\\"otp:manage\\\", \\\"otp:request\\\", \\\"otp:verify\\\"]',\\n unixepoch(),\\n unixepoch()\\n);\\n\"\n },\n {\n id: '027',\n name: 'Fix Slug Field Type',\n filename: '027_fix_slug_field_type.sql',\n description: 'Migration 027: Fix Slug Field Type',\n sql: \"-- Migration: Fix slug field type\\n-- Description: Update slug fields to use 'slug' field type instead of 'text' for proper auto-generation\\n-- Created: 2026-01-10\\n\\n-- Update pages collection slug field to use 'slug' field type\\nUPDATE content_fields \\nSET field_type = 'slug'\\nWHERE field_name = 'slug' AND collection_id = 'pages-collection';\\n\\n-- Update blog posts slug field if it exists\\nUPDATE content_fields \\nSET field_type = 'slug'\\nWHERE field_name = 'slug' AND collection_id = 'blog-posts-collection';\\n\\n-- Update news slug field if it exists\\nUPDATE content_fields \\nSET field_type = 'slug'\\nWHERE field_name = 'slug' AND collection_id = 'news-collection';\\n\"\n },\n {\n id: '028',\n name: 'Fix Slug Field Type In Schemas',\n filename: '028_fix_slug_field_type_in_schemas.sql',\n description: 'Migration 028: Fix Slug Field Type In Schemas',\n sql: \"-- Migration: Fix slug field type in collection schemas\\n-- Description: Update slug fields in collection schemas to use 'slug' type instead of 'string'\\n-- Created: 2026-01-10\\n\\n-- Update pages-collection schema\\nUPDATE collections \\nSET schema = REPLACE(\\n schema,\\n '\\\"slug\\\":{\\\"type\\\":\\\"string\\\"',\\n '\\\"slug\\\":{\\\"type\\\":\\\"slug\\\"'\\n)\\nWHERE id = 'pages-collection' AND schema LIKE '%\\\"slug\\\":{\\\"type\\\":\\\"string\\\"%';\\n\\n-- Update blog-posts-collection schema if it exists\\nUPDATE collections \\nSET schema = REPLACE(\\n schema,\\n '\\\"slug\\\":{\\\"type\\\":\\\"string\\\"',\\n '\\\"slug\\\":{\\\"type\\\":\\\"slug\\\"'\\n)\\nWHERE id = 'blog-posts-collection' AND schema LIKE '%\\\"slug\\\":{\\\"type\\\":\\\"string\\\"%';\\n\\n-- Update news-collection schema if it exists\\nUPDATE collections \\nSET schema = REPLACE(\\n schema,\\n '\\\"slug\\\":{\\\"type\\\":\\\"string\\\"',\\n '\\\"slug\\\":{\\\"type\\\":\\\"slug\\\"'\\n)\\nWHERE id = 'news-collection' AND schema LIKE '%\\\"slug\\\":{\\\"type\\\":\\\"string\\\"%';\\n\"\n },\n {\n id: '029',\n name: 'Add Forms System',\n filename: '029_add_forms_system.sql',\n description: 'Migration 029: Add Forms System',\n sql: \"-- Migration: 029_add_forms_system.sql\\n-- Description: Add Form.io integration for advanced form building\\n-- Date: January 23, 2026\\n-- Phase: 1 - Database Schema\\n\\n-- =====================================================\\n-- Table: forms\\n-- Description: Stores form definitions and configuration\\n-- =====================================================\\n\\nCREATE TABLE IF NOT EXISTS forms (\\n id TEXT PRIMARY KEY,\\n name TEXT NOT NULL UNIQUE, -- Machine name (e.g., \\\"contact-form\\\")\\n display_name TEXT NOT NULL, -- Human name (e.g., \\\"Contact Form\\\")\\n description TEXT, -- Optional description\\n category TEXT DEFAULT 'general', -- Form category (contact, survey, registration, etc.)\\n \\n -- Form.io schema (JSON)\\n formio_schema TEXT NOT NULL, -- Complete Form.io JSON schema\\n \\n -- Settings\\n settings TEXT, -- JSON: {\\n -- emailNotifications: true,\\n -- notifyEmail: \\\"admin@example.com\\\",\\n -- successMessage: \\\"Thank you!\\\",\\n -- redirectUrl: \\\"/thank-you\\\",\\n -- allowAnonymous: true,\\n -- requireAuth: false,\\n -- maxSubmissions: null,\\n -- submitButtonText: \\\"Submit\\\",\\n -- saveProgress: true,\\n -- webhookUrl: null\\n -- }\\n \\n -- Status & Management\\n is_active INTEGER DEFAULT 1, -- Active/inactive flag\\n is_public INTEGER DEFAULT 1, -- Public (anyone) vs private (auth required)\\n managed INTEGER DEFAULT 0, -- Code-managed (like collections)\\n \\n -- Metadata\\n icon TEXT, -- Optional icon for admin UI\\n color TEXT, -- Optional color (hex) for admin UI\\n tags TEXT, -- JSON array of tags\\n \\n -- Stats\\n submission_count INTEGER DEFAULT 0, -- Total submissions received\\n view_count INTEGER DEFAULT 0, -- Form views (optional tracking)\\n \\n -- Ownership\\n created_by TEXT REFERENCES users(id), -- User who created the form\\n updated_by TEXT REFERENCES users(id), -- User who last updated\\n \\n -- Timestamps\\n created_at INTEGER NOT NULL,\\n updated_at INTEGER NOT NULL\\n);\\n\\n-- Indexes for forms\\nCREATE INDEX IF NOT EXISTS idx_forms_name ON forms(name);\\nCREATE INDEX IF NOT EXISTS idx_forms_category ON forms(category);\\nCREATE INDEX IF NOT EXISTS idx_forms_active ON forms(is_active);\\nCREATE INDEX IF NOT EXISTS idx_forms_public ON forms(is_public);\\nCREATE INDEX IF NOT EXISTS idx_forms_created_by ON forms(created_by);\\n\\n-- =====================================================\\n-- Table: form_submissions\\n-- Description: Stores submitted form data\\n-- =====================================================\\n\\nCREATE TABLE IF NOT EXISTS form_submissions (\\n id TEXT PRIMARY KEY,\\n form_id TEXT NOT NULL REFERENCES forms(id) ON DELETE CASCADE,\\n \\n -- Submission data\\n submission_data TEXT NOT NULL, -- JSON: The actual form data submitted\\n \\n -- Submission metadata\\n status TEXT DEFAULT 'pending', -- pending, reviewed, approved, rejected, spam\\n submission_number INTEGER, -- Sequential number per form\\n \\n -- User information (if authenticated)\\n user_id TEXT REFERENCES users(id), -- Submitter user ID (if logged in)\\n user_email TEXT, -- Email from form (or user account)\\n \\n -- Tracking information\\n ip_address TEXT, -- IP address of submitter\\n user_agent TEXT, -- Browser user agent\\n referrer TEXT, -- Page that referred to form\\n utm_source TEXT, -- UTM tracking params\\n utm_medium TEXT,\\n utm_campaign TEXT,\\n \\n -- Review/Processing\\n reviewed_by TEXT REFERENCES users(id), -- Admin who reviewed\\n reviewed_at INTEGER, -- Review timestamp\\n review_notes TEXT, -- Admin notes\\n \\n -- Flags\\n is_spam INTEGER DEFAULT 0, -- Spam flag\\n is_archived INTEGER DEFAULT 0, -- Archived flag\\n \\n -- Timestamps\\n submitted_at INTEGER NOT NULL,\\n updated_at INTEGER NOT NULL\\n);\\n\\n-- Indexes for submissions\\nCREATE INDEX IF NOT EXISTS idx_form_submissions_form_id ON form_submissions(form_id);\\nCREATE INDEX IF NOT EXISTS idx_form_submissions_status ON form_submissions(status);\\nCREATE INDEX IF NOT EXISTS idx_form_submissions_user_id ON form_submissions(user_id);\\nCREATE INDEX IF NOT EXISTS idx_form_submissions_email ON form_submissions(user_email);\\nCREATE INDEX IF NOT EXISTS idx_form_submissions_submitted_at ON form_submissions(submitted_at);\\nCREATE INDEX IF NOT EXISTS idx_form_submissions_spam ON form_submissions(is_spam);\\n\\n-- Trigger to auto-increment submission_number per form\\nCREATE TRIGGER IF NOT EXISTS set_submission_number\\nAFTER INSERT ON form_submissions\\nBEGIN\\n UPDATE form_submissions \\n SET submission_number = (\\n SELECT COUNT(*) \\n FROM form_submissions \\n WHERE form_id = NEW.form_id \\n AND id <= NEW.id\\n )\\n WHERE id = NEW.id;\\nEND;\\n\\n-- Trigger to update form submission_count\\nCREATE TRIGGER IF NOT EXISTS increment_form_submission_count\\nAFTER INSERT ON form_submissions\\nBEGIN\\n UPDATE forms \\n SET submission_count = submission_count + 1,\\n updated_at = unixepoch() * 1000\\n WHERE id = NEW.form_id;\\nEND;\\n\\n-- =====================================================\\n-- Table: form_files (Optional)\\n-- Description: Link form submissions to uploaded files\\n-- =====================================================\\n\\nCREATE TABLE IF NOT EXISTS form_files (\\n id TEXT PRIMARY KEY,\\n submission_id TEXT NOT NULL REFERENCES form_submissions(id) ON DELETE CASCADE,\\n media_id TEXT NOT NULL REFERENCES media(id) ON DELETE CASCADE,\\n field_name TEXT NOT NULL, -- Form field that uploaded this file\\n uploaded_at INTEGER NOT NULL\\n);\\n\\n-- Indexes for form files\\nCREATE INDEX IF NOT EXISTS idx_form_files_submission ON form_files(submission_id);\\nCREATE INDEX IF NOT EXISTS idx_form_files_media ON form_files(media_id);\\n\\n-- =====================================================\\n-- Sample Data: Create a default contact form\\n-- =====================================================\\n\\nINSERT OR IGNORE INTO forms (\\n id,\\n name,\\n display_name,\\n description,\\n category,\\n formio_schema,\\n settings,\\n is_active,\\n is_public,\\n created_at,\\n updated_at\\n) VALUES (\\n 'default-contact-form',\\n 'contact',\\n 'Contact Form',\\n 'A simple contact form for getting in touch',\\n 'contact',\\n '{\\\"components\\\":[]}',\\n '{\\\"emailNotifications\\\":false,\\\"successMessage\\\":\\\"Thank you for your submission!\\\",\\\"submitButtonText\\\":\\\"Submit\\\",\\\"requireAuth\\\":false}',\\n 1,\\n 1,\\n unixepoch() * 1000,\\n unixepoch() * 1000\\n);\\n\"\n },\n {\n id: '030',\n name: 'Add Turnstile To Forms',\n filename: '030_add_turnstile_to_forms.sql',\n description: 'Migration 030: Add Turnstile To Forms',\n sql: \"-- Add Turnstile configuration to forms table\\n-- This allows per-form Turnstile settings with global fallback\\n\\n-- Add columns (D1 may not support CHECK constraints in ALTER TABLE)\\nALTER TABLE forms ADD COLUMN turnstile_enabled INTEGER DEFAULT 0;\\nALTER TABLE forms ADD COLUMN turnstile_settings TEXT;\\n\\n-- Set default to inherit global settings for existing forms\\nUPDATE forms \\nSET turnstile_settings = '{\\\"inherit\\\":true}' \\nWHERE turnstile_settings IS NULL;\\n\\n-- Add index for faster lookups\\nCREATE INDEX IF NOT EXISTS idx_forms_turnstile ON forms(turnstile_enabled);\\n\"\n },\n {\n id: '031',\n name: 'Ai Search Plugin',\n filename: '031_ai_search_plugin.sql',\n description: 'Migration 031: Ai Search Plugin',\n sql: \"-- AI Search plugin settings\\nCREATE TABLE IF NOT EXISTS ai_search_settings (\\n id INTEGER PRIMARY KEY AUTOINCREMENT,\\n enabled BOOLEAN DEFAULT 0,\\n ai_mode_enabled BOOLEAN DEFAULT 1,\\n selected_collections TEXT, -- JSON array of collection IDs to index\\n dismissed_collections TEXT, -- JSON array of collection IDs user chose not to index\\n autocomplete_enabled BOOLEAN DEFAULT 1,\\n cache_duration INTEGER DEFAULT 1, -- hours\\n results_limit INTEGER DEFAULT 20,\\n index_media BOOLEAN DEFAULT 0,\\n index_status TEXT, -- JSON object with status per collection\\n last_indexed_at INTEGER,\\n created_at INTEGER DEFAULT (strftime('%s', 'now') * 1000),\\n updated_at INTEGER DEFAULT (strftime('%s', 'now') * 1000)\\n);\\n\\n-- Search history/analytics\\nCREATE TABLE IF NOT EXISTS ai_search_history (\\n id INTEGER PRIMARY KEY AUTOINCREMENT,\\n query TEXT NOT NULL,\\n mode TEXT, -- 'ai' or 'keyword'\\n results_count INTEGER,\\n user_id INTEGER,\\n created_at INTEGER DEFAULT (strftime('%s', 'now') * 1000)\\n);\\n\\n-- Index metadata tracking (per collection)\\nCREATE TABLE IF NOT EXISTS ai_search_index_meta (\\n id INTEGER PRIMARY KEY AUTOINCREMENT,\\n collection_id INTEGER NOT NULL,\\n collection_name TEXT NOT NULL, -- Cache collection name for display\\n total_items INTEGER DEFAULT 0,\\n indexed_items INTEGER DEFAULT 0,\\n last_sync_at INTEGER,\\n status TEXT DEFAULT 'pending', -- 'pending', 'indexing', 'completed', 'error'\\n error_message TEXT,\\n UNIQUE(collection_id)\\n);\\n\\n-- Indexes for performance\\nCREATE INDEX IF NOT EXISTS idx_ai_search_history_created_at ON ai_search_history(created_at);\\nCREATE INDEX IF NOT EXISTS idx_ai_search_history_mode ON ai_search_history(mode);\\nCREATE INDEX IF NOT EXISTS idx_ai_search_index_meta_collection_id ON ai_search_index_meta(collection_id);\\nCREATE INDEX IF NOT EXISTS idx_ai_search_index_meta_status ON ai_search_index_meta(status);\\n\"\n },\n {\n id: '032',\n name: 'Form Content Integration',\n filename: '032_form_content_integration.sql',\n description: 'Migration 032: Form Content Integration',\n sql: \"-- Migration 032: Form-Content Integration\\n-- Adds bridge columns to link forms to collections and submissions to content items\\n\\n-- Add source_type and source_id to collections for form-derived collections\\nALTER TABLE collections ADD COLUMN source_type TEXT DEFAULT 'user';\\nALTER TABLE collections ADD COLUMN source_id TEXT;\\n\\n-- Index for efficient lookup of form-derived collections\\nCREATE INDEX IF NOT EXISTS idx_collections_source ON collections(source_type, source_id);\\n\\n-- Add content_id to form_submissions for linking to content items\\nALTER TABLE form_submissions ADD COLUMN content_id TEXT REFERENCES content(id);\\n\\n-- Index for efficient lookup by content_id\\nCREATE INDEX IF NOT EXISTS idx_form_submissions_content_id ON form_submissions(content_id);\\n\\n-- Create system user for anonymous form submissions\\nINSERT OR IGNORE INTO users (id, email, username, first_name, last_name, password_hash, role, is_active, created_at, updated_at)\\nVALUES ('system-form-submission', 'system-forms@sonicjs.internal', 'system-forms', 'Form', 'Submission', NULL, 'viewer', 0, strftime('%s','now') * 1000, strftime('%s','now') * 1000);\\n\"\n },\n {\n id: '033',\n name: 'Fts5 Fulltext Search',\n filename: '033_fts5_fulltext_search.sql',\n description: 'Migration 033: Fts5 Fulltext Search',\n sql: \"-- Migration 033: FTS5 Full-Text Search for AI Search Plugin\\n--\\n-- Creates FTS5 virtual table for content full-text search with:\\n-- - Porter stemming (running/runs/ran -> run)\\n-- - Unicode support with diacritics/accent folding (cafe matches cafe)\\n-- - BM25 ranking with field boosting (title > slug > body)\\n--\\n-- Tokenizer: porter wraps unicode61 (porter MUST come first as it's a wrapper)\\n-- - porter: Applies Porter stemming algorithm to output of underlying tokenizer\\n-- - unicode61: Unicode-aware tokenization with ASCII folding\\n-- - remove_diacritics 2: Remove diacritics from ALL Unicode characters (level 2 = broadest)\\n--\\n-- Column order: Indexed columns first for cleaner bm25() weights\\n\\nCREATE VIRTUAL TABLE IF NOT EXISTS content_fts USING fts5(\\n title, -- column 0: Indexed (weight 5x at query time)\\n slug, -- column 1: Indexed (weight 2x at query time)\\n body, -- column 2: Main content extracted from JSON (weight 1x)\\n content_id UNINDEXED, -- column 3: Original content ID for JOINs\\n collection_id UNINDEXED, -- column 4: Collection ID for filtering\\n tokenize='porter unicode61 remove_diacritics 2'\\n);\\n\\n-- Sync tracking table for indexing status\\nCREATE TABLE IF NOT EXISTS content_fts_sync (\\n content_id TEXT PRIMARY KEY,\\n collection_id TEXT NOT NULL,\\n indexed_at INTEGER NOT NULL,\\n status TEXT DEFAULT 'indexed'\\n);\\n\\nCREATE INDEX IF NOT EXISTS idx_content_fts_sync_collection\\n ON content_fts_sync(collection_id);\\n\\nCREATE INDEX IF NOT EXISTS idx_content_fts_sync_status\\n ON content_fts_sync(status);\\n\"\n }\n]\n\n// Map for quick lookup by ID\nexport const migrationsByIdMap = new MapCount: {count}
\\n \\n\\n
\\n );\\n}\\n\\nexport default Counter;',\\n 'javascript',\\n 'frontend',\\n 'react,hooks,state',\\n 1,\\n 1),\\n\\n('TypeScript Interface Example',\\n 'Defining a TypeScript interface for type-safe objects.',\\n 'interface User {\\n id: string;\\n email: string;\\n name: string;\\n role: ''admin'' | ''editor'' | ''viewer'';\\n createdAt: Date;\\n}\\n\\nfunction greetUser(user: User): string {\\n return `Hello, ${user.name}!`;\\n}\\n\\nconst user: User = {\\n id: ''123'',\\n email: ''user@example.com'',\\n name: ''John Doe'',\\n role: ''admin'',\\n createdAt: new Date()\\n};\\n\\nconsole.log(greetUser(user));',\\n 'typescript',\\n 'backend',\\n 'typescript,types,interface',\\n 1,\\n 2),\\n\\n('Python List Comprehension',\\n 'Elegant way to create lists in Python using list comprehensions.',\\n '# Basic list comprehension\\nsquares = [x**2 for x in range(10)]\\nprint(squares) # [0, 1, 4, 9, 16, 25, 36, 49, 64, 81]\\n\\n# With condition\\neven_squares = [x**2 for x in range(10) if x % 2 == 0]\\nprint(even_squares) # [0, 4, 16, 36, 64]\\n\\n# Nested list comprehension\\nmatrix = [[i+j for j in range(3)] for i in range(3)]\\nprint(matrix) # [[0, 1, 2], [1, 2, 3], [2, 3, 4]]',\\n 'python',\\n 'general',\\n 'python,lists,comprehension',\\n 1,\\n 3),\\n\\n('SQL Join Example',\\n 'Common SQL JOIN patterns for combining data from multiple tables.',\\n '-- INNER JOIN: Returns only matching rows\\nSELECT users.name, orders.total\\nFROM users\\nINNER JOIN orders ON users.id = orders.user_id;\\n\\n-- LEFT JOIN: Returns all users, even without orders\\nSELECT users.name, orders.total\\nFROM users\\nLEFT JOIN orders ON users.id = orders.user_id;\\n\\n-- Multiple JOINs\\nSELECT\\n users.name,\\n orders.order_date,\\n products.name AS product_name\\nFROM users\\nINNER JOIN orders ON users.id = orders.user_id\\nINNER JOIN order_items ON orders.id = order_items.order_id\\nINNER JOIN products ON order_items.product_id = products.id;',\\n 'sql',\\n 'database',\\n 'sql,joins,queries',\\n 1,\\n 4),\\n\\n('Go Error Handling',\\n 'Idiomatic error handling pattern in Go.',\\n 'package main\\n\\nimport (\\n\\t\\\"errors\\\"\\n\\t\\\"fmt\\\"\\n)\\n\\nfunc divide(a, b float64) (float64, error) {\\n\\tif b == 0 {\\n\\t\\treturn 0, errors.New(\\\"division by zero\\\")\\n\\t}\\n\\treturn a / b, nil\\n}\\n\\nfunc main() {\\n\\tresult, err := divide(10, 2)\\n\\tif err != nil {\\n\\t\\tfmt.Println(\\\"Error:\\\", err)\\n\\t\\treturn\\n\\t}\\n\\tfmt.Printf(\\\"Result: %.2f\\\\n\\\", result)\\n\\n\\t// This will error\\n\\t_, err = divide(10, 0)\\n\\tif err != nil {\\n\\t\\tfmt.Println(\\\"Error:\\\", err)\\n\\t}\\n}',\\n 'go',\\n 'backend',\\n 'go,error-handling,functions',\\n 1,\\n 5);\\n\"\n },\n {\n id: '014',\n name: 'Fix Plugin Registry',\n filename: '014_fix_plugin_registry.sql',\n description: 'Migration 014: Fix Plugin Registry',\n sql: \"-- Fix Plugin Registry\\n-- Migration: 014_fix_plugin_registry\\n-- Description: Add missing plugins and fix plugin name mismatches\\n\\n-- Note: Cannot easily update plugin names as they may be referenced elsewhere\\n-- Instead we'll add the missing plugins with correct names\\n\\n-- Insert missing plugins\\n\\n-- Core Analytics Plugin\\nINSERT OR IGNORE INTO plugins (\\n id, name, display_name, description, version, author, category, icon,\\n status, is_core, permissions, installed_at, last_updated\\n) VALUES (\\n 'core-analytics',\\n 'core-analytics',\\n 'Analytics & Tracking',\\n 'Core analytics tracking and reporting plugin with page views and event tracking',\\n '1.0.0',\\n 'SonicJS Team',\\n 'seo',\\n 'π',\\n 'active',\\n TRUE,\\n '[\\\"view:analytics\\\", \\\"manage:tracking\\\"]',\\n unixepoch(),\\n unixepoch()\\n);\\n\\n-- FAQ Plugin\\nINSERT OR IGNORE INTO plugins (\\n id, name, display_name, description, version, author, category, icon,\\n status, is_core, permissions, installed_at, last_updated\\n) VALUES (\\n 'faq-plugin',\\n 'faq-plugin',\\n 'FAQ Management',\\n 'Frequently Asked Questions management plugin with categories, search, and custom styling',\\n '1.0.0',\\n 'SonicJS',\\n 'content',\\n 'β',\\n 'active',\\n FALSE,\\n '[\\\"manage:faqs\\\"]',\\n unixepoch(),\\n unixepoch()\\n);\\n\\n-- Seed Data Plugin\\nINSERT OR IGNORE INTO plugins (\\n id, name, display_name, description, version, author, category, icon,\\n status, is_core, permissions, installed_at, last_updated\\n) VALUES (\\n 'seed-data',\\n 'seed-data',\\n 'Seed Data Generator',\\n 'Generate realistic example users and content for testing and development',\\n '1.0.0',\\n 'SonicJS Team',\\n 'development',\\n 'π±',\\n 'inactive',\\n FALSE,\\n '[\\\"admin\\\"]',\\n unixepoch(),\\n unixepoch()\\n);\\n\\n-- Database Tools Plugin\\nINSERT OR IGNORE INTO plugins (\\n id, name, display_name, description, version, author, category, icon,\\n status, is_core, permissions, installed_at, last_updated\\n) VALUES (\\n 'database-tools',\\n 'database-tools',\\n 'Database Tools',\\n 'Database management tools including truncate, backup, and validation',\\n '1.0.0',\\n 'SonicJS Team',\\n 'system',\\n 'ποΈ',\\n 'active',\\n FALSE,\\n '[\\\"manage:database\\\", \\\"admin\\\"]',\\n unixepoch(),\\n unixepoch()\\n);\\n\"\n },\n {\n id: '015',\n name: 'Add Remaining Plugins',\n filename: '015_add_remaining_plugins.sql',\n description: 'Migration 015: Add Remaining Plugins',\n sql: \"-- Add Remaining Plugins\\n-- Migration: 015_add_remaining_plugins\\n-- Description: Add all remaining core plugins that were missing from the registry\\n\\n-- Testimonials Plugin (with correct name)\\nINSERT OR IGNORE INTO plugins (\\n id, name, display_name, description, version, author, category, icon,\\n status, is_core, permissions, dependencies, settings, installed_at, last_updated\\n) VALUES (\\n 'testimonials-plugin',\\n 'testimonials-plugin',\\n 'Customer Testimonials',\\n 'Manage customer testimonials and reviews with rating support',\\n '1.0.0',\\n 'SonicJS',\\n 'content',\\n 'β',\\n 'active',\\n FALSE,\\n '[\\\"manage:testimonials\\\"]',\\n '[]',\\n '{\\\"defaultPublished\\\": true, \\\"requireRating\\\": false}',\\n unixepoch(),\\n unixepoch()\\n);\\n\\n-- Code Examples Plugin (with correct name)\\nINSERT OR IGNORE INTO plugins (\\n id, name, display_name, description, version, author, category, icon,\\n status, is_core, permissions, dependencies, settings, installed_at, last_updated\\n) VALUES (\\n 'code-examples-plugin',\\n 'code-examples-plugin',\\n 'Code Examples',\\n 'Manage code snippets and examples with syntax highlighting support',\\n '1.0.0',\\n 'SonicJS',\\n 'content',\\n 'π»',\\n 'active',\\n FALSE,\\n '[\\\"manage:code-examples\\\"]',\\n '[]',\\n '{\\\"defaultPublished\\\": true, \\\"supportedLanguages\\\": [\\\"javascript\\\", \\\"typescript\\\", \\\"python\\\", \\\"go\\\", \\\"rust\\\", \\\"java\\\", \\\"php\\\", \\\"ruby\\\", \\\"sql\\\"]}',\\n unixepoch(),\\n unixepoch()\\n);\\n\\n-- Workflow Plugin (with correct name)\\nINSERT OR IGNORE INTO plugins (\\n id, name, display_name, description, version, author, category, icon,\\n status, is_core, permissions, dependencies, installed_at, last_updated\\n) VALUES (\\n 'workflow-plugin',\\n 'workflow-plugin',\\n 'Workflow Engine',\\n 'Content workflow management with approval chains, scheduling, and automation',\\n '1.0.0',\\n 'SonicJS Team',\\n 'content',\\n 'π',\\n 'active',\\n TRUE,\\n '[\\\"manage:workflows\\\", \\\"approve:content\\\"]',\\n '[]',\\n unixepoch(),\\n unixepoch()\\n);\\n\\n-- Demo Login Plugin (already exists with correct name from migration 007, but let's ensure it's there)\\nINSERT OR IGNORE INTO plugins (\\n id, name, display_name, description, version, author, category, icon,\\n status, is_core, permissions, dependencies, installed_at, last_updated\\n) VALUES (\\n 'demo-login-plugin',\\n 'demo-login-plugin',\\n 'Demo Login Prefill',\\n 'Prefills login form with demo credentials for easy site demonstration',\\n '1.0.0',\\n 'SonicJS',\\n 'demo',\\n 'π―',\\n 'active',\\n FALSE,\\n '[]',\\n '[]',\\n unixepoch(),\\n unixepoch()\\n);\\n\"\n },\n {\n id: '016',\n name: 'Remove Duplicate Cache Plugin',\n filename: '016_remove_duplicate_cache_plugin.sql',\n description: 'Migration 016: Remove Duplicate Cache Plugin',\n sql: \"-- Migration: Remove duplicate cache plugin entry\\n-- Description: Removes the old 'cache' plugin (id: 'cache') that is a duplicate of 'core-cache'\\n-- This fixes the issue where Cache System appears twice in the plugins list\\n-- Created: 2025-10-14\\n\\n-- Remove the old 'cache' plugin entry if it exists\\n-- The correct plugin is 'core-cache' which is managed by plugin-bootstrap.ts\\nDELETE FROM plugins WHERE id = 'cache' AND name = 'cache';\\n\\n-- Clean up any related entries in plugin activity log\\nDELETE FROM plugin_activity_log WHERE plugin_id = 'cache';\\n\\n-- Clean up any related entries in plugin hooks\\nDELETE FROM plugin_hooks WHERE plugin_id = 'cache';\\n\\n-- Clean up any related entries in plugin routes\\nDELETE FROM plugin_routes WHERE plugin_id = 'cache';\\n\"\n },\n {\n id: '017',\n name: 'Auth Configurable Fields',\n filename: '017_auth_configurable_fields.sql',\n description: 'Migration 017: Auth Configurable Fields',\n sql: \"-- Migration: Make authentication fields configurable\\n-- This migration updates the core-auth plugin to support configurable required fields\\n\\n-- The settings will be stored in the plugins table as JSON\\n-- Default settings for core-auth plugin include:\\n-- {\\n-- \\\"requiredFields\\\": {\\n-- \\\"email\\\": { \\\"required\\\": true, \\\"minLength\\\": 5 },\\n-- \\\"password\\\": { \\\"required\\\": true, \\\"minLength\\\": 8 },\\n-- \\\"username\\\": { \\\"required\\\": true, \\\"minLength\\\": 3 },\\n-- \\\"firstName\\\": { \\\"required\\\": true, \\\"minLength\\\": 1 },\\n-- \\\"lastName\\\": { \\\"required\\\": true, \\\"minLength\\\": 1 }\\n-- },\\n-- \\\"validation\\\": {\\n-- \\\"emailFormat\\\": true,\\n-- \\\"allowDuplicateUsernames\\\": false\\n-- }\\n-- }\\n\\n-- Update core-auth plugin settings with configurable field requirements\\nUPDATE plugins\\nSET settings = json_object(\\n 'requiredFields', json_object(\\n 'email', json_object('required', 1, 'minLength', 5, 'label', 'Email', 'type', 'email'),\\n 'password', json_object('required', 1, 'minLength', 8, 'label', 'Password', 'type', 'password'),\\n 'username', json_object('required', 1, 'minLength', 3, 'label', 'Username', 'type', 'text'),\\n 'firstName', json_object('required', 1, 'minLength', 1, 'label', 'First Name', 'type', 'text'),\\n 'lastName', json_object('required', 1, 'minLength', 1, 'label', 'Last Name', 'type', 'text')\\n ),\\n 'validation', json_object(\\n 'emailFormat', 1,\\n 'allowDuplicateUsernames', 0,\\n 'passwordRequirements', json_object(\\n 'requireUppercase', 0,\\n 'requireLowercase', 0,\\n 'requireNumbers', 0,\\n 'requireSpecialChars', 0\\n )\\n ),\\n 'registration', json_object(\\n 'enabled', 1,\\n 'requireEmailVerification', 0,\\n 'defaultRole', 'viewer'\\n )\\n)\\nWHERE id = 'core-auth';\\n\\n-- If core-auth plugin doesn't exist, this migration will be handled by bootstrap\\n-- No need to insert here as plugin bootstrap handles initial plugin creation\\n\"\n },\n {\n id: '018',\n name: 'Settings Table',\n filename: '018_settings_table.sql',\n description: 'Migration 018: Settings Table',\n sql: \"-- Create settings table for storing application settings\\nCREATE TABLE IF NOT EXISTS settings (\\n id TEXT PRIMARY KEY,\\n category TEXT NOT NULL, -- 'general', 'appearance', 'security', etc.\\n key TEXT NOT NULL,\\n value TEXT NOT NULL, -- JSON value\\n created_at INTEGER NOT NULL,\\n updated_at INTEGER NOT NULL,\\n UNIQUE(category, key)\\n);\\n\\n-- Insert default general settings\\nINSERT OR IGNORE INTO settings (id, category, key, value, created_at, updated_at)\\nVALUES\\n (lower(hex(randomblob(16))), 'general', 'siteName', '\\\"SonicJS AI\\\"', unixepoch() * 1000, unixepoch() * 1000),\\n (lower(hex(randomblob(16))), 'general', 'siteDescription', '\\\"A modern headless CMS powered by AI\\\"', unixepoch() * 1000, unixepoch() * 1000),\\n (lower(hex(randomblob(16))), 'general', 'timezone', '\\\"UTC\\\"', unixepoch() * 1000, unixepoch() * 1000),\\n (lower(hex(randomblob(16))), 'general', 'language', '\\\"en\\\"', unixepoch() * 1000, unixepoch() * 1000),\\n (lower(hex(randomblob(16))), 'general', 'maintenanceMode', 'false', unixepoch() * 1000, unixepoch() * 1000);\\n\\n-- Create index for faster lookups\\nCREATE INDEX IF NOT EXISTS idx_settings_category ON settings(category);\\nCREATE INDEX IF NOT EXISTS idx_settings_category_key ON settings(category, key);\\n\"\n },\n {\n id: '019',\n name: 'Remove Blog Posts Collection',\n filename: '019_remove_blog_posts_collection.sql',\n description: 'Migration 019: Remove Blog Posts Collection',\n sql: \"-- Migration: Remove blog_posts from database-managed collections\\n-- Description: Remove blog-posts-collection from the database so it can be managed by code-based collection\\n-- Created: 2025-11-04\\n\\n-- Delete content associated with blog-posts-collection\\nDELETE FROM content WHERE collection_id = 'blog-posts-collection';\\n\\n-- Delete content fields for blog-posts-collection\\nDELETE FROM content_fields WHERE collection_id = 'blog-posts-collection';\\n\\n-- Delete the blog-posts collection itself\\nDELETE FROM collections WHERE id = 'blog-posts-collection';\\n\\n-- The blog-posts collection will now be managed by the code-based collection\\n-- in src/collections/blog-posts.collection.ts\\n\"\n },\n {\n id: '020',\n name: 'Add Email Plugin',\n filename: '020_add_email_plugin.sql',\n description: 'Migration 020: Add Email Plugin',\n sql: \"-- Add Email Plugin\\n-- Migration: 020_add_email_plugin\\n-- Description: Add email plugin for transactional emails via Resend\\n\\nINSERT OR IGNORE INTO plugins (\\n id, name, display_name, description, version, author, category, icon,\\n status, is_core, permissions, installed_at, last_updated\\n) VALUES (\\n 'email',\\n 'email',\\n 'Email',\\n 'Send transactional emails using Resend',\\n '1.0.0-beta.1',\\n 'SonicJS Team',\\n 'utilities',\\n 'π§',\\n 'inactive',\\n TRUE,\\n '[\\\"email:manage\\\", \\\"email:send\\\", \\\"email:view-logs\\\"]',\\n unixepoch(),\\n unixepoch()\\n);\\n\"\n },\n {\n id: '021',\n name: 'Add Magic Link Auth Plugin',\n filename: '021_add_magic_link_auth_plugin.sql',\n description: 'Migration 021: Add Magic Link Auth Plugin',\n sql: \"-- Add Magic Link Authentication Plugin\\n-- Migration: 021_add_magic_link_auth_plugin\\n-- Description: Add magic link authentication plugin for passwordless login\\n\\n-- Create magic_links table\\nCREATE TABLE IF NOT EXISTS magic_links (\\n id TEXT PRIMARY KEY,\\n user_email TEXT NOT NULL,\\n token TEXT NOT NULL UNIQUE,\\n expires_at INTEGER NOT NULL,\\n used INTEGER DEFAULT 0,\\n used_at INTEGER,\\n ip_address TEXT,\\n user_agent TEXT,\\n created_at INTEGER NOT NULL\\n);\\n\\n-- Create indexes for performance\\nCREATE INDEX IF NOT EXISTS idx_magic_links_token ON magic_links(token);\\nCREATE INDEX IF NOT EXISTS idx_magic_links_email ON magic_links(user_email);\\nCREATE INDEX IF NOT EXISTS idx_magic_links_expires ON magic_links(expires_at);\\n\\n-- Register the plugin\\nINSERT OR IGNORE INTO plugins (\\n id, name, display_name, description, version, author, category, icon,\\n status, is_core, permissions, dependencies, installed_at, last_updated\\n) VALUES (\\n 'magic-link-auth',\\n 'magic-link-auth',\\n 'Magic Link Authentication',\\n 'Passwordless authentication via email magic links. Users receive a secure one-time link to sign in without entering a password.',\\n '1.0.0',\\n 'SonicJS Team',\\n 'security',\\n 'π',\\n 'inactive',\\n FALSE,\\n '[\\\"auth:manage\\\", \\\"auth:magic-link\\\"]',\\n '[\\\"email\\\"]',\\n unixepoch(),\\n unixepoch()\\n);\\n\"\n },\n {\n id: '022',\n name: 'Add Tinymce Plugin',\n filename: '022_add_tinymce_plugin.sql',\n description: 'Migration 022: Add Tinymce Plugin',\n sql: \"-- Add TinyMCE Rich Text Editor Plugin\\n-- Migration: 022_add_tinymce_plugin\\n-- Description: Add TinyMCE plugin for WYSIWYG rich text editing\\n\\n-- Register the plugin (active by default since it replaces hardcoded TinyMCE)\\nINSERT OR IGNORE INTO plugins (\\n id, name, display_name, description, version, author, category, icon,\\n status, is_core, permissions, dependencies, settings, installed_at, last_updated\\n) VALUES (\\n 'tinymce-plugin',\\n 'tinymce-plugin',\\n 'TinyMCE Rich Text Editor',\\n 'Powerful WYSIWYG rich text editor for content creation. Provides a full-featured editor with formatting, media embedding, and customizable toolbars for richtext fields.',\\n '1.0.0',\\n 'SonicJS Team',\\n 'editor',\\n 'βοΈ',\\n 'active',\\n FALSE,\\n '[]',\\n '[]',\\n '{\\\"apiKey\\\":\\\"no-api-key\\\",\\\"defaultHeight\\\":300,\\\"defaultToolbar\\\":\\\"full\\\",\\\"skin\\\":\\\"oxide-dark\\\"}',\\n unixepoch(),\\n unixepoch()\\n);\\n\"\n },\n {\n id: '023',\n name: 'Add Easy Mdx Plugin',\n filename: '023_add_easy_mdx_plugin.sql',\n description: 'Migration 023: Add Easy Mdx Plugin',\n sql: \"-- Add EasyMDE Markdown Editor Plugin\\n-- Migration: 023_add_easy_mdx_plugin\\n-- Description: Add EasyMDE plugin for lightweight markdown editing\\n\\n-- Register the plugin (active by default)\\nINSERT OR IGNORE INTO plugins (\\n id, name, display_name, description, version, author, category, icon,\\n status, is_core, permissions, dependencies, settings, installed_at, last_updated\\n) VALUES (\\n 'easy-mdx',\\n 'easy-mdx',\\n 'EasyMDE Markdown Editor',\\n 'Lightweight markdown editor with live preview. Provides a simple and efficient editor with markdown support for richtext fields.',\\n '1.0.0',\\n 'SonicJS Team',\\n 'editor',\\n 'π',\\n 'active',\\n FALSE,\\n '[]',\\n '[]',\\n '{\\\"defaultHeight\\\":400,\\\"theme\\\":\\\"dark\\\",\\\"toolbar\\\":\\\"full\\\",\\\"placeholder\\\":\\\"Start writing your content...\\\"}',\\n unixepoch(),\\n unixepoch()\\n);\\n\"\n },\n {\n id: '024',\n name: 'Add Quill Editor Plugin',\n filename: '024_add_quill_editor_plugin.sql',\n description: 'Migration 024: Add Quill Editor Plugin',\n sql: \"-- Add Quill Rich Text Editor Plugin\\n-- Migration: 024_add_quill_editor_plugin\\n-- Description: Add Quill plugin for modern rich text editing\\n\\n-- Register the plugin (active by default)\\nINSERT OR IGNORE INTO plugins (\\n id, name, display_name, description, version, author, category, icon,\\n status, is_core, permissions, dependencies, settings, installed_at, last_updated\\n) VALUES (\\n 'quill-editor',\\n 'quill-editor',\\n 'Quill Rich Text Editor',\\n 'Modern rich text editor for content creation. Provides a clean, intuitive WYSIWYG editor with customizable toolbars for richtext fields.',\\n '1.0.0',\\n 'SonicJS Team',\\n 'editor',\\n 'βοΈ',\\n 'active',\\n FALSE,\\n '[]',\\n '[]',\\n '{\\\"theme\\\":\\\"snow\\\",\\\"defaultHeight\\\":300,\\\"defaultToolbar\\\":\\\"full\\\",\\\"placeholder\\\":\\\"Start writing your content...\\\"}',\\n unixepoch(),\\n unixepoch()\\n);\\n\"\n },\n {\n id: '025',\n name: 'Add Easymde Plugin',\n filename: '025_add_easymde_plugin.sql',\n description: 'Migration 025: Add Easymde Plugin',\n sql: \"-- Add EasyMDE Rich Text Editor Plugin\\n-- Migration: 025_add_easymde_plugin\\n-- Description: Add EasyMDE plugin for markdown-based rich text editing\\n\\n-- Register the plugin (inactive by default, replacing MDXEditor)\\nINSERT OR IGNORE INTO plugins (\\n id, name, display_name, description, version, author, category, icon,\\n status, is_core, permissions, dependencies, settings, installed_at, last_updated\\n) VALUES (\\n 'easymde-editor',\\n 'easymde-editor',\\n 'EasyMDE Editor',\\n 'Lightweight markdown editor for content creation. Simple, elegant WYSIWYG markdown editor with live preview, toolbar, and dark mode support for richtext fields.',\\n '1.0.0',\\n 'SonicJS Team',\\n 'editor',\\n 'βοΈ',\\n 'inactive',\\n TRUE,\\n '[]',\\n '[]',\\n '{\\\"theme\\\":\\\"dark\\\",\\\"defaultHeight\\\":300,\\\"toolbar\\\":\\\"full\\\",\\\"spellChecker\\\":false,\\\"placeholder\\\":\\\"Start writing your content...\\\"}',\\n unixepoch(),\\n unixepoch()\\n);\\n\"\n },\n {\n id: '026',\n name: 'Add Otp Login',\n filename: '026_add_otp_login.sql',\n description: 'Migration 026: Add Otp Login',\n sql: \"-- Add OTP Login Plugin\\n-- Migration: 021_add_otp_login\\n-- Description: Add OTP login plugin for passwordless authentication via email codes\\n\\n-- Create table for OTP codes\\nCREATE TABLE IF NOT EXISTS otp_codes (\\n id TEXT PRIMARY KEY,\\n user_email TEXT NOT NULL,\\n code TEXT NOT NULL,\\n expires_at INTEGER NOT NULL,\\n used INTEGER DEFAULT 0,\\n used_at INTEGER,\\n ip_address TEXT,\\n user_agent TEXT,\\n attempts INTEGER DEFAULT 0,\\n created_at INTEGER NOT NULL\\n);\\n\\n-- Create indexes for performance\\nCREATE INDEX IF NOT EXISTS idx_otp_email_code ON otp_codes(user_email, code);\\nCREATE INDEX IF NOT EXISTS idx_otp_expires ON otp_codes(expires_at);\\nCREATE INDEX IF NOT EXISTS idx_otp_used ON otp_codes(used);\\n\\n-- Add plugin record\\nINSERT OR IGNORE INTO plugins (\\n id, name, display_name, description, version, author, category, icon,\\n status, is_core, permissions, installed_at, last_updated\\n) VALUES (\\n 'otp-login',\\n 'otp-login',\\n 'OTP Login',\\n 'Passwordless authentication via email one-time codes',\\n '1.0.0-beta.1',\\n 'SonicJS Team',\\n 'security',\\n 'π’',\\n 'inactive',\\n TRUE,\\n '[\\\"otp:manage\\\", \\\"otp:request\\\", \\\"otp:verify\\\"]',\\n unixepoch(),\\n unixepoch()\\n);\\n\"\n },\n {\n id: '027',\n name: 'Fix Slug Field Type',\n filename: '027_fix_slug_field_type.sql',\n description: 'Migration 027: Fix Slug Field Type',\n sql: \"-- Migration: Fix slug field type\\n-- Description: Update slug fields to use 'slug' field type instead of 'text' for proper auto-generation\\n-- Created: 2026-01-10\\n\\n-- Update pages collection slug field to use 'slug' field type\\nUPDATE content_fields \\nSET field_type = 'slug'\\nWHERE field_name = 'slug' AND collection_id = 'pages-collection';\\n\\n-- Update blog posts slug field if it exists\\nUPDATE content_fields \\nSET field_type = 'slug'\\nWHERE field_name = 'slug' AND collection_id = 'blog-posts-collection';\\n\\n-- Update news slug field if it exists\\nUPDATE content_fields \\nSET field_type = 'slug'\\nWHERE field_name = 'slug' AND collection_id = 'news-collection';\\n\"\n },\n {\n id: '028',\n name: 'Fix Slug Field Type In Schemas',\n filename: '028_fix_slug_field_type_in_schemas.sql',\n description: 'Migration 028: Fix Slug Field Type In Schemas',\n sql: \"-- Migration: Fix slug field type in collection schemas\\n-- Description: Update slug fields in collection schemas to use 'slug' type instead of 'string'\\n-- Created: 2026-01-10\\n\\n-- Update pages-collection schema\\nUPDATE collections \\nSET schema = REPLACE(\\n schema,\\n '\\\"slug\\\":{\\\"type\\\":\\\"string\\\"',\\n '\\\"slug\\\":{\\\"type\\\":\\\"slug\\\"'\\n)\\nWHERE id = 'pages-collection' AND schema LIKE '%\\\"slug\\\":{\\\"type\\\":\\\"string\\\"%';\\n\\n-- Update blog-posts-collection schema if it exists\\nUPDATE collections \\nSET schema = REPLACE(\\n schema,\\n '\\\"slug\\\":{\\\"type\\\":\\\"string\\\"',\\n '\\\"slug\\\":{\\\"type\\\":\\\"slug\\\"'\\n)\\nWHERE id = 'blog-posts-collection' AND schema LIKE '%\\\"slug\\\":{\\\"type\\\":\\\"string\\\"%';\\n\\n-- Update news-collection schema if it exists\\nUPDATE collections \\nSET schema = REPLACE(\\n schema,\\n '\\\"slug\\\":{\\\"type\\\":\\\"string\\\"',\\n '\\\"slug\\\":{\\\"type\\\":\\\"slug\\\"'\\n)\\nWHERE id = 'news-collection' AND schema LIKE '%\\\"slug\\\":{\\\"type\\\":\\\"string\\\"%';\\n\"\n },\n {\n id: '029',\n name: 'Add Forms System',\n filename: '029_add_forms_system.sql',\n description: 'Migration 029: Add Forms System',\n sql: \"-- Migration: 029_add_forms_system.sql\\n-- Description: Add Form.io integration for advanced form building\\n-- Date: January 23, 2026\\n-- Phase: 1 - Database Schema\\n\\n-- =====================================================\\n-- Table: forms\\n-- Description: Stores form definitions and configuration\\n-- =====================================================\\n\\nCREATE TABLE IF NOT EXISTS forms (\\n id TEXT PRIMARY KEY,\\n name TEXT NOT NULL UNIQUE, -- Machine name (e.g., \\\"contact-form\\\")\\n display_name TEXT NOT NULL, -- Human name (e.g., \\\"Contact Form\\\")\\n description TEXT, -- Optional description\\n category TEXT DEFAULT 'general', -- Form category (contact, survey, registration, etc.)\\n \\n -- Form.io schema (JSON)\\n formio_schema TEXT NOT NULL, -- Complete Form.io JSON schema\\n \\n -- Settings\\n settings TEXT, -- JSON: {\\n -- emailNotifications: true,\\n -- notifyEmail: \\\"admin@example.com\\\",\\n -- successMessage: \\\"Thank you!\\\",\\n -- redirectUrl: \\\"/thank-you\\\",\\n -- allowAnonymous: true,\\n -- requireAuth: false,\\n -- maxSubmissions: null,\\n -- submitButtonText: \\\"Submit\\\",\\n -- saveProgress: true,\\n -- webhookUrl: null\\n -- }\\n \\n -- Status & Management\\n is_active INTEGER DEFAULT 1, -- Active/inactive flag\\n is_public INTEGER DEFAULT 1, -- Public (anyone) vs private (auth required)\\n managed INTEGER DEFAULT 0, -- Code-managed (like collections)\\n \\n -- Metadata\\n icon TEXT, -- Optional icon for admin UI\\n color TEXT, -- Optional color (hex) for admin UI\\n tags TEXT, -- JSON array of tags\\n \\n -- Stats\\n submission_count INTEGER DEFAULT 0, -- Total submissions received\\n view_count INTEGER DEFAULT 0, -- Form views (optional tracking)\\n \\n -- Ownership\\n created_by TEXT REFERENCES users(id), -- User who created the form\\n updated_by TEXT REFERENCES users(id), -- User who last updated\\n \\n -- Timestamps\\n created_at INTEGER NOT NULL,\\n updated_at INTEGER NOT NULL\\n);\\n\\n-- Indexes for forms\\nCREATE INDEX IF NOT EXISTS idx_forms_name ON forms(name);\\nCREATE INDEX IF NOT EXISTS idx_forms_category ON forms(category);\\nCREATE INDEX IF NOT EXISTS idx_forms_active ON forms(is_active);\\nCREATE INDEX IF NOT EXISTS idx_forms_public ON forms(is_public);\\nCREATE INDEX IF NOT EXISTS idx_forms_created_by ON forms(created_by);\\n\\n-- =====================================================\\n-- Table: form_submissions\\n-- Description: Stores submitted form data\\n-- =====================================================\\n\\nCREATE TABLE IF NOT EXISTS form_submissions (\\n id TEXT PRIMARY KEY,\\n form_id TEXT NOT NULL REFERENCES forms(id) ON DELETE CASCADE,\\n \\n -- Submission data\\n submission_data TEXT NOT NULL, -- JSON: The actual form data submitted\\n \\n -- Submission metadata\\n status TEXT DEFAULT 'pending', -- pending, reviewed, approved, rejected, spam\\n submission_number INTEGER, -- Sequential number per form\\n \\n -- User information (if authenticated)\\n user_id TEXT REFERENCES users(id), -- Submitter user ID (if logged in)\\n user_email TEXT, -- Email from form (or user account)\\n \\n -- Tracking information\\n ip_address TEXT, -- IP address of submitter\\n user_agent TEXT, -- Browser user agent\\n referrer TEXT, -- Page that referred to form\\n utm_source TEXT, -- UTM tracking params\\n utm_medium TEXT,\\n utm_campaign TEXT,\\n \\n -- Review/Processing\\n reviewed_by TEXT REFERENCES users(id), -- Admin who reviewed\\n reviewed_at INTEGER, -- Review timestamp\\n review_notes TEXT, -- Admin notes\\n \\n -- Flags\\n is_spam INTEGER DEFAULT 0, -- Spam flag\\n is_archived INTEGER DEFAULT 0, -- Archived flag\\n \\n -- Timestamps\\n submitted_at INTEGER NOT NULL,\\n updated_at INTEGER NOT NULL\\n);\\n\\n-- Indexes for submissions\\nCREATE INDEX IF NOT EXISTS idx_form_submissions_form_id ON form_submissions(form_id);\\nCREATE INDEX IF NOT EXISTS idx_form_submissions_status ON form_submissions(status);\\nCREATE INDEX IF NOT EXISTS idx_form_submissions_user_id ON form_submissions(user_id);\\nCREATE INDEX IF NOT EXISTS idx_form_submissions_email ON form_submissions(user_email);\\nCREATE INDEX IF NOT EXISTS idx_form_submissions_submitted_at ON form_submissions(submitted_at);\\nCREATE INDEX IF NOT EXISTS idx_form_submissions_spam ON form_submissions(is_spam);\\n\\n-- Trigger to auto-increment submission_number per form\\nCREATE TRIGGER IF NOT EXISTS set_submission_number\\nAFTER INSERT ON form_submissions\\nBEGIN\\n UPDATE form_submissions \\n SET submission_number = (\\n SELECT COUNT(*) \\n FROM form_submissions \\n WHERE form_id = NEW.form_id \\n AND id <= NEW.id\\n )\\n WHERE id = NEW.id;\\nEND;\\n\\n-- Trigger to update form submission_count\\nCREATE TRIGGER IF NOT EXISTS increment_form_submission_count\\nAFTER INSERT ON form_submissions\\nBEGIN\\n UPDATE forms \\n SET submission_count = submission_count + 1,\\n updated_at = unixepoch() * 1000\\n WHERE id = NEW.form_id;\\nEND;\\n\\n-- =====================================================\\n-- Table: form_files (Optional)\\n-- Description: Link form submissions to uploaded files\\n-- =====================================================\\n\\nCREATE TABLE IF NOT EXISTS form_files (\\n id TEXT PRIMARY KEY,\\n submission_id TEXT NOT NULL REFERENCES form_submissions(id) ON DELETE CASCADE,\\n media_id TEXT NOT NULL REFERENCES media(id) ON DELETE CASCADE,\\n field_name TEXT NOT NULL, -- Form field that uploaded this file\\n uploaded_at INTEGER NOT NULL\\n);\\n\\n-- Indexes for form files\\nCREATE INDEX IF NOT EXISTS idx_form_files_submission ON form_files(submission_id);\\nCREATE INDEX IF NOT EXISTS idx_form_files_media ON form_files(media_id);\\n\\n-- =====================================================\\n-- Sample Data: Create a default contact form\\n-- =====================================================\\n\\nINSERT OR IGNORE INTO forms (\\n id,\\n name,\\n display_name,\\n description,\\n category,\\n formio_schema,\\n settings,\\n is_active,\\n is_public,\\n created_at,\\n updated_at\\n) VALUES (\\n 'default-contact-form',\\n 'contact',\\n 'Contact Form',\\n 'A simple contact form for getting in touch',\\n 'contact',\\n '{\\\"components\\\":[]}',\\n '{\\\"emailNotifications\\\":false,\\\"successMessage\\\":\\\"Thank you for your submission!\\\",\\\"submitButtonText\\\":\\\"Submit\\\",\\\"requireAuth\\\":false}',\\n 1,\\n 1,\\n unixepoch() * 1000,\\n unixepoch() * 1000\\n);\\n\"\n },\n {\n id: '030',\n name: 'Add Turnstile To Forms',\n filename: '030_add_turnstile_to_forms.sql',\n description: 'Migration 030: Add Turnstile To Forms',\n sql: \"-- Add Turnstile configuration to forms table\\n-- This allows per-form Turnstile settings with global fallback\\n\\n-- Add columns (D1 may not support CHECK constraints in ALTER TABLE)\\nALTER TABLE forms ADD COLUMN turnstile_enabled INTEGER DEFAULT 0;\\nALTER TABLE forms ADD COLUMN turnstile_settings TEXT;\\n\\n-- Set default to inherit global settings for existing forms\\nUPDATE forms \\nSET turnstile_settings = '{\\\"inherit\\\":true}' \\nWHERE turnstile_settings IS NULL;\\n\\n-- Add index for faster lookups\\nCREATE INDEX IF NOT EXISTS idx_forms_turnstile ON forms(turnstile_enabled);\\n\"\n },\n {\n id: '031',\n name: 'Ai Search Plugin',\n filename: '031_ai_search_plugin.sql',\n description: 'Migration 031: Ai Search Plugin',\n sql: \"-- AI Search plugin settings\\nCREATE TABLE IF NOT EXISTS ai_search_settings (\\n id INTEGER PRIMARY KEY AUTOINCREMENT,\\n enabled BOOLEAN DEFAULT 0,\\n ai_mode_enabled BOOLEAN DEFAULT 1,\\n selected_collections TEXT, -- JSON array of collection IDs to index\\n dismissed_collections TEXT, -- JSON array of collection IDs user chose not to index\\n autocomplete_enabled BOOLEAN DEFAULT 1,\\n cache_duration INTEGER DEFAULT 1, -- hours\\n results_limit INTEGER DEFAULT 20,\\n index_media BOOLEAN DEFAULT 0,\\n index_status TEXT, -- JSON object with status per collection\\n last_indexed_at INTEGER,\\n created_at INTEGER DEFAULT (strftime('%s', 'now') * 1000),\\n updated_at INTEGER DEFAULT (strftime('%s', 'now') * 1000)\\n);\\n\\n-- Search history/analytics\\nCREATE TABLE IF NOT EXISTS ai_search_history (\\n id INTEGER PRIMARY KEY AUTOINCREMENT,\\n query TEXT NOT NULL,\\n mode TEXT, -- 'ai' or 'keyword'\\n results_count INTEGER,\\n user_id INTEGER,\\n created_at INTEGER DEFAULT (strftime('%s', 'now') * 1000)\\n);\\n\\n-- Index metadata tracking (per collection)\\nCREATE TABLE IF NOT EXISTS ai_search_index_meta (\\n id INTEGER PRIMARY KEY AUTOINCREMENT,\\n collection_id INTEGER NOT NULL,\\n collection_name TEXT NOT NULL, -- Cache collection name for display\\n total_items INTEGER DEFAULT 0,\\n indexed_items INTEGER DEFAULT 0,\\n last_sync_at INTEGER,\\n status TEXT DEFAULT 'pending', -- 'pending', 'indexing', 'completed', 'error'\\n error_message TEXT,\\n UNIQUE(collection_id)\\n);\\n\\n-- Indexes for performance\\nCREATE INDEX IF NOT EXISTS idx_ai_search_history_created_at ON ai_search_history(created_at);\\nCREATE INDEX IF NOT EXISTS idx_ai_search_history_mode ON ai_search_history(mode);\\nCREATE INDEX IF NOT EXISTS idx_ai_search_index_meta_collection_id ON ai_search_index_meta(collection_id);\\nCREATE INDEX IF NOT EXISTS idx_ai_search_index_meta_status ON ai_search_index_meta(status);\\n\"\n },\n {\n id: '032',\n name: 'Form Content Integration',\n filename: '032_form_content_integration.sql',\n description: 'Migration 032: Form Content Integration',\n sql: \"-- Migration 032: Form-Content Integration\\n-- Adds bridge columns to link forms to collections and submissions to content items\\n\\n-- Add source_type and source_id to collections for form-derived collections\\nALTER TABLE collections ADD COLUMN source_type TEXT DEFAULT 'user';\\nALTER TABLE collections ADD COLUMN source_id TEXT;\\n\\n-- Index for efficient lookup of form-derived collections\\nCREATE INDEX IF NOT EXISTS idx_collections_source ON collections(source_type, source_id);\\n\\n-- Add content_id to form_submissions for linking to content items\\nALTER TABLE form_submissions ADD COLUMN content_id TEXT REFERENCES content(id);\\n\\n-- Index for efficient lookup by content_id\\nCREATE INDEX IF NOT EXISTS idx_form_submissions_content_id ON form_submissions(content_id);\\n\\n-- Create system user for anonymous form submissions\\nINSERT OR IGNORE INTO users (id, email, username, first_name, last_name, password_hash, role, is_active, created_at, updated_at)\\nVALUES ('system-form-submission', 'system-forms@sonicjs.internal', 'system-forms', 'Form', 'Submission', NULL, 'viewer', 0, strftime('%s','now') * 1000, strftime('%s','now') * 1000);\\n\"\n },\n {\n id: '033',\n name: 'Fts5 Fulltext Search',\n filename: '033_fts5_fulltext_search.sql',\n description: 'Migration 033: Fts5 Fulltext Search',\n sql: \"-- Migration 033: FTS5 Full-Text Search for AI Search Plugin\\n--\\n-- Creates FTS5 virtual table for content full-text search with:\\n-- - Porter stemming (running/runs/ran -> run)\\n-- - Unicode support with diacritics/accent folding (cafe matches cafe)\\n-- - BM25 ranking with field boosting (title > slug > body)\\n--\\n-- Tokenizer: porter wraps unicode61 (porter MUST come first as it's a wrapper)\\n-- - porter: Applies Porter stemming algorithm to output of underlying tokenizer\\n-- - unicode61: Unicode-aware tokenization with ASCII folding\\n-- - remove_diacritics 2: Remove diacritics from ALL Unicode characters (level 2 = broadest)\\n--\\n-- Column order: Indexed columns first for cleaner bm25() weights\\n\\nCREATE VIRTUAL TABLE IF NOT EXISTS content_fts USING fts5(\\n title, -- column 0: Indexed (weight 5x at query time)\\n slug, -- column 1: Indexed (weight 2x at query time)\\n body, -- column 2: Main content extracted from JSON (weight 1x)\\n content_id UNINDEXED, -- column 3: Original content ID for JOINs\\n collection_id UNINDEXED, -- column 4: Collection ID for filtering\\n tokenize='porter unicode61 remove_diacritics 2'\\n);\\n\\n-- Sync tracking table for indexing status\\nCREATE TABLE IF NOT EXISTS content_fts_sync (\\n content_id TEXT PRIMARY KEY,\\n collection_id TEXT NOT NULL,\\n indexed_at INTEGER NOT NULL,\\n status TEXT DEFAULT 'indexed'\\n);\\n\\nCREATE INDEX IF NOT EXISTS idx_content_fts_sync_collection\\n ON content_fts_sync(collection_id);\\n\\nCREATE INDEX IF NOT EXISTS idx_content_fts_sync_status\\n ON content_fts_sync(status);\\n\"\n }\n]\n\n// Map for quick lookup by ID\nexport const migrationsByIdMap = new MapCount: {count}
\\n \\n\n \n
\n
\n