@sonicjs-cms/core 3.0.0-beta.2 → 3.0.0-beta.21

package/README.md

@@ -14,7 +14,7 @@
 To create a new SonicJS project, use:
 
 ```bash
-npx create-sonicjs my-app
+npx create-sonicjs@latest my-app
 ```
 
 This is the recommended way to get started with SonicJS. It sets up everything you need with a single command.
@@ -28,9 +28,9 @@ This is the recommended way to get started with SonicJS. It sets up everything y
 - 🔒 **Type-Safe**: Full TypeScript support with comprehensive type definitions
 - 🔌 **Plugin System**: Extensible architecture with hooks and middleware
 - ⚡ **Three-Tier Caching**: Memory, KV, and database layers for optimal performance
-- 🎨 **Admin Interface**: Beautiful glass morphism design system
-- 🔐 **Authentication**: JWT-based auth with role-based permissions
-- 📝 **Content Management**: Dynamic collections with versioning and workflows
+- 🎨 **Admin Interface**: Glass-morphism design system
+- 🔐 **Authentication**: Better Auth with session management and role-based permissions
+- 📝 **Content Management**: Document-model collections with versioning
 - 🖼️ **Media Management**: R2 storage with automatic optimization
 - 🌐 **REST API**: Auto-generated endpoints for all collections
 
@@ -54,22 +54,24 @@ npm install wrangler drizzle-kit  # For development
 
 ## 🚀 Quick Start
 
-### 1. Create Your Application
+### 1. Register Collections and Create Your Application
 
 ```typescript
 // src/index.ts
-import { createSonicJSApp } from '@sonicjs-cms/core'
+import {
+  createSonicJSApp,
+  registerCollections,
+} from '@sonicjs-cms/core'
 import type { SonicJSConfig } from '@sonicjs-cms/core'
+import blogPostsCollection from './collections/blog-posts.collection'
+
+// Register code-defined collections before creating the app
+registerCollections([blogPostsCollection])
 
 const config: SonicJSConfig = {
-  collections: {
-    directory: './src/collections',
-    autoSync: true
-  },
   plugins: {
-    directory: './src/plugins',
-    autoLoad: false
-  }
+    register: [/* your plugins here */],
+  },
 }
 
 export default createSonicJSApp(config)
@@ -77,13 +79,16 @@ export default createSonicJSApp(config)
 
 ### 2. Define Collections
 
+Collections are TypeScript config objects — no database table required.
+
 ```typescript
 // src/collections/blog-posts.collection.ts
 import type { CollectionConfig } from '@sonicjs-cms/core'
 
 export default {
-  name: 'blog-posts',
-  displayName: 'Blog Posts',
+  name: 'blog_post',
+  displayName: 'Blog Post',
+  slug: 'blog-posts',
   description: 'Manage your blog posts',
 
   schema: {
@@ -93,26 +98,23 @@ export default {
         type: 'string',
         title: 'Title',
         required: true,
-        maxLength: 200
+        maxLength: 200,
       },
       content: {
-        type: 'markdown',
+        type: 'lexical',
         title: 'Content',
-        required: true
+        required: true,
       },
       publishedAt: {
         type: 'datetime',
-        title: 'Published Date'
+        title: 'Published Date',
       },
-      status: {
-        type: 'select',
-        title: 'Status',
-        enum: ['draft', 'published', 'archived'],
-        default: 'draft'
-      }
     },
-    required: ['title', 'content']
-  }
+    required: ['title', 'content'],
+  },
+
+  managed: true,
+  isActive: true,
 } satisfies CollectionConfig
 ```
 
@@ -131,7 +133,7 @@ database_id = "your-database-id"
 migrations_dir = "./node_modules/@sonicjs-cms/core/migrations"
 
 [[r2_buckets]]
-binding = "BUCKET"
+binding = "MEDIA_BUCKET"
 bucket_name = "my-sonicjs-media"
 ```
 
@@ -152,7 +154,7 @@ Visit `http://localhost:8787/admin` to access the admin interface.
 ### Main Application
 
 ```typescript
-import { createSonicJSApp } from '@sonicjs-cms/core'
+import { createSonicJSApp, registerCollections } from '@sonicjs-cms/core'
 import type { SonicJSConfig, SonicJSApp, Bindings, Variables } from '@sonicjs-cms/core'
 ```
 
@@ -161,7 +163,6 @@ import type { SonicJSConfig, SonicJSApp, Bindings, Variables } from '@sonicjs-cm
 ```typescript
 import {
   loadCollectionConfigs,
-  syncCollections,
   MigrationService,
   Logger,
   PluginService
@@ -223,8 +224,8 @@ import {
 import {
   createDb,
   users,
-  collections,
   content,
+  contentVersions,
   media
 } from '@sonicjs-cms/core'
 ```
@@ -272,31 +273,29 @@ customRoutes.get('/api/custom', requireAuth(), async (c) => {
 
 // In your app config
 export default createSonicJSApp({
-  routes: [{ path: '/custom', handler: customRoutes }]
+  plugins: {
+    register: [{ name: 'custom', version: '1.0.0', register: (app) => app.route('/custom', customRoutes) }],
+  },
 })
 ```
 
 ### Custom Plugin
 
 ```typescript
-import type { Plugin } from '@sonicjs-cms/core'
+import type { Plugin, PluginContext } from '@sonicjs-cms/core'
 
 export default {
   name: 'my-plugin',
   version: '1.0.0',
   description: 'My custom plugin',
 
-  async onActivate() {
+  async activate(context: PluginContext) {
     console.log('Plugin activated!')
   },
 
-  hooks: {
-    'content.beforeSave': async (content) => {
-      // Transform content before saving
-      content.metadata = { modified: new Date() }
-      return content
-    }
-  }
+  async install(context: PluginContext) {
+    // Run once on install — migrations, seed data, etc.
+  },
 } satisfies Plugin
 ```
 
@@ -409,16 +408,16 @@ The `generate-migrations.ts` script:
 
 SonicJS follows semantic versioning:
 
-- **v2.x.x** - Current npm package (core extracted)
-- **v1.x.x** - Legacy monolith (deprecated)
+- **v3.x.x** - Current (document model, Better Auth, edge-first)
+- **v2.x.x** - Legacy monolith (deprecated)
 
-**Current Version**: `2.0.0-alpha.1`
+**Current Version**: `3.0.0-beta.9`
 
 ### Upgrade Path
 
 ```bash
-# Install the new package
-npm install @sonicjs-cms/core@2.0.0-alpha.1
+# Install the latest package
+npm install @sonicjs-cms/core@latest
 
 # Run any new migrations
 wrangler d1 migrations apply DB
@@ -467,12 +466,12 @@ MIT © SonicJS Team - See [LICENSE](./LICENSE) for details.
 
 ## 🛡️ Security
 
-- JWT authentication
-- Role-based access control (RBAC)
+- Better Auth (sessions + RBAC)
+- Role-based access control
 - Permission system
 - Secure headers
 - Input sanitization
 
 ---
 
-**Built with ❤️ for the edge** | v2.0.0-alpha.1
+**Built with ❤️ for the edge** | v3.0.0-beta.9

package/dist/admin-documents-form.template-DDSH6ROU.js

@@ -0,0 +1,6 @@
+export { renderDocumentFormPage, renderVersionHistoryFragment } from './chunk-RMRJGMDE.js';
+import './chunk-5V62WT6M.js';
+import './chunk-TQABQWOP.js';
+import './chunk-V4OQ3NZ2.js';
+//# sourceMappingURL=admin-documents-form.template-DDSH6ROU.js.map
+//# sourceMappingURL=admin-documents-form.template-DDSH6ROU.js.map

package/dist/{admin-documents-form.template-NLSI6Z42.js.map → admin-documents-form.template-DDSH6ROU.js.map}

@@ -1 +1 @@
-{"version":3,"sources":[],"names":[],"mappings":"","file":"admin-documents-form.template-NLSI6Z42.js"}
+{"version":3,"sources":[],"names":[],"mappings":"","file":"admin-documents-form.template-DDSH6ROU.js"}

package/dist/admin-documents-form.template-LSZKGA5J.cjs

@@ -0,0 +1,19 @@
+'use strict';
+
+var chunkN32OWET6_cjs = require('./chunk-N32OWET6.cjs');
+require('./chunk-K623Q6WD.cjs');
+require('./chunk-MNWKYY5E.cjs');
+require('./chunk-IGJUBJBW.cjs');
+
+
+
+Object.defineProperty(exports, "renderDocumentFormPage", {
+  enumerable: true,
+  get: function () { return chunkN32OWET6_cjs.renderDocumentFormPage; }
+});
+Object.defineProperty(exports, "renderVersionHistoryFragment", {
+  enumerable: true,
+  get: function () { return chunkN32OWET6_cjs.renderVersionHistoryFragment; }
+});
+//# sourceMappingURL=admin-documents-form.template-LSZKGA5J.cjs.map
+//# sourceMappingURL=admin-documents-form.template-LSZKGA5J.cjs.map

package/dist/{admin-layout-catalyst.template-WHJGSWWD.js.map → admin-documents-form.template-LSZKGA5J.cjs.map}

@@ -1 +1 @@
-{"version":3,"sources":[],"names":[],"mappings":"","file":"admin-layout-catalyst.template-WHJGSWWD.js"}
+{"version":3,"sources":[],"names":[],"mappings":"","file":"admin-documents-form.template-LSZKGA5J.cjs"}

package/dist/{filter-bar.template-DlVYMk-T.d.ts → admin-layout-catalyst.template-DrwDUfsE.d.cts}

@@ -1,3 +1,5 @@
+import { HtmlEscapedString } from 'hono/utils/html';
+
 interface FormField {
     name: string;
     label: string;
@@ -138,4 +140,26 @@ interface FilterBarData {
 }
 declare function renderFilterBar(data: FilterBarData): string;
 
-export { type AlertData as A, type ConfirmationDialogOptions as C, type Filter as F, type PaginationData as P, type TableColumn as T, type FilterBarData as a, type FilterOption as b, type FormData as c, type FormField as d, type TableData as e, renderConfirmationDialog as f, getConfirmationDialogScript as g, renderFilterBar as h, renderForm as i, renderFormField as j, renderPagination as k, renderTable as l, renderAlert as r };
+interface AdminLayoutCatalystData {
+    title: string;
+    pageTitle?: string;
+    currentPath?: string;
+    version?: string;
+    enableExperimentalFeatures?: boolean;
+    user?: {
+        name: string;
+        email: string;
+        role: string;
+    };
+    scripts?: string[];
+    styles?: string[];
+    content: string | HtmlEscapedString;
+    dynamicMenuItems?: Array<{
+        label: string;
+        path: string;
+        icon: string;
+    }>;
+}
+declare function renderAdminLayoutCatalyst(data: AdminLayoutCatalystData): string;
+
+export { type AdminLayoutCatalystData as A, type ConfirmationDialogOptions as C, type Filter as F, type PaginationData as P, type TableColumn as T, type AlertData as a, type FilterBarData as b, type FilterOption as c, type FormData as d, type FormField as e, type TableData as f, getConfirmationDialogScript as g, renderAlert as h, renderConfirmationDialog as i, renderFilterBar as j, renderForm as k, renderFormField as l, renderPagination as m, renderTable as n, renderAdminLayoutCatalyst as r };

package/dist/{filter-bar.template-DlVYMk-T.d.cts → admin-layout-catalyst.template-DrwDUfsE.d.ts}

@@ -1,3 +1,5 @@
+import { HtmlEscapedString } from 'hono/utils/html';
+
 interface FormField {
     name: string;
     label: string;
@@ -138,4 +140,26 @@ interface FilterBarData {
 }
 declare function renderFilterBar(data: FilterBarData): string;
 
-export { type AlertData as A, type ConfirmationDialogOptions as C, type Filter as F, type PaginationData as P, type TableColumn as T, type FilterBarData as a, type FilterOption as b, type FormData as c, type FormField as d, type TableData as e, renderConfirmationDialog as f, getConfirmationDialogScript as g, renderFilterBar as h, renderForm as i, renderFormField as j, renderPagination as k, renderTable as l, renderAlert as r };
+interface AdminLayoutCatalystData {
+    title: string;
+    pageTitle?: string;
+    currentPath?: string;
+    version?: string;
+    enableExperimentalFeatures?: boolean;
+    user?: {
+        name: string;
+        email: string;
+        role: string;
+    };
+    scripts?: string[];
+    styles?: string[];
+    content: string | HtmlEscapedString;
+    dynamicMenuItems?: Array<{
+        label: string;
+        path: string;
+        icon: string;
+    }>;
+}
+declare function renderAdminLayoutCatalyst(data: AdminLayoutCatalystData): string;
+
+export { type AdminLayoutCatalystData as A, type ConfirmationDialogOptions as C, type Filter as F, type PaginationData as P, type TableColumn as T, type AlertData as a, type FilterBarData as b, type FilterOption as c, type FormData as d, type FormField as e, type TableData as f, getConfirmationDialogScript as g, renderAlert as h, renderConfirmationDialog as i, renderFilterBar as j, renderForm as k, renderFormField as l, renderPagination as m, renderTable as n, renderAdminLayoutCatalyst as r };

package/dist/admin-layout-catalyst.template-KDHKVLXR.cjs

@@ -0,0 +1,21 @@
+'use strict';
+
+var chunkK623Q6WD_cjs = require('./chunk-K623Q6WD.cjs');
+require('./chunk-IGJUBJBW.cjs');
+
+chunkK623Q6WD_cjs.init_admin_layout_catalyst_template();
+
+Object.defineProperty(exports, "renderAdminLayoutCatalyst", {
+  enumerable: true,
+  get: function () { return chunkK623Q6WD_cjs.renderAdminLayoutCatalyst; }
+});
+Object.defineProperty(exports, "renderCatalystCheckbox", {
+  enumerable: true,
+  get: function () { return chunkK623Q6WD_cjs.renderCatalystCheckbox; }
+});
+Object.defineProperty(exports, "setBranchLabel", {
+  enumerable: true,
+  get: function () { return chunkK623Q6WD_cjs.setBranchLabel; }
+});
+//# sourceMappingURL=admin-layout-catalyst.template-KDHKVLXR.cjs.map
+//# sourceMappingURL=admin-layout-catalyst.template-KDHKVLXR.cjs.map

package/dist/{admin-layout-catalyst.template-ZK5HD545.cjs.map → admin-layout-catalyst.template-KDHKVLXR.cjs.map}

@@ -1 +1 @@
-{"version":3,"sources":[],"names":[],"mappings":"","file":"admin-layout-catalyst.template-ZK5HD545.cjs"}
+{"version":3,"sources":[],"names":[],"mappings":"","file":"admin-layout-catalyst.template-KDHKVLXR.cjs"}

package/dist/admin-layout-catalyst.template-YQ4EMF2J.js

@@ -0,0 +1,7 @@
+import { init_admin_layout_catalyst_template } from './chunk-5V62WT6M.js';
+export { renderAdminLayoutCatalyst, renderCatalystCheckbox, setBranchLabel } from './chunk-5V62WT6M.js';
+import './chunk-V4OQ3NZ2.js';
+
+init_admin_layout_catalyst_template();
+//# sourceMappingURL=admin-layout-catalyst.template-YQ4EMF2J.js.map
+//# sourceMappingURL=admin-layout-catalyst.template-YQ4EMF2J.js.map

package/dist/{admin-documents-form.template-KN7JF66Q.cjs.map → admin-layout-catalyst.template-YQ4EMF2J.js.map}

@@ -1 +1 @@
-{"version":3,"sources":[],"names":[],"mappings":"","file":"admin-documents-form.template-KN7JF66Q.cjs"}
+{"version":3,"sources":[],"names":[],"mappings":"","file":"admin-layout-catalyst.template-YQ4EMF2J.js"}

package/dist/{app-Bo0X1OWX.d.ts → app-01M0dIwt.d.ts}

@@ -6,7 +6,7 @@ import * as better_call from 'better-call';
 import * as zod_v4_core from 'zod/v4/core';
 import * as zod from 'zod';
 import { z } from 'zod';
-import { i as HookSystemLike, E as EmailProvider } from './types-Dea1eNxU.js';
+import { i as HookSystemLike, E as EmailProvider } from './types-DT7XN5TX.js';
 import { Hono, MiddlewareHandler, Context } from 'hono';
 import { D1Database, KVNamespace, R2Bucket } from '@cloudflare/workers-types';
 

package/dist/{app-Do66yCcV.d.cts → app-aj39TGHB.d.cts}

@@ -6,7 +6,7 @@ import * as better_call from 'better-call';
 import * as zod_v4_core from 'zod/v4/core';
 import * as zod from 'zod';
 import { z } from 'zod';
-import { i as HookSystemLike, E as EmailProvider } from './types-Dea1eNxU.cjs';
+import { i as HookSystemLike, E as EmailProvider } from './types-DT7XN5TX.cjs';
 import { Hono, MiddlewareHandler, Context } from 'hono';
 import { D1Database, KVNamespace, R2Bucket } from '@cloudflare/workers-types';
 

package/dist/{chunk-ZEZ245PW.js → chunk-2XAQTPAE.js}

@@ -1,6 +1,5 @@
 import { getCacheService } from './chunk-K25XHMM3.js';
 import { systemLogs, logConfig } from './chunk-AI663NBO.js';
-import { getTelemetryConfig, sanitizeErrorMessage, sanitizeRoute, generateInstallationId, generateProjectId } from './chunk-X7ZAEI5S.js';
 import { drizzle } from 'drizzle-orm/d1';
 import { inArray, eq, like, gte, lte, and, count, asc, desc } from 'drizzle-orm';
 import { inspectRoutes } from 'hono/dev';
@@ -428,6 +427,7 @@ var SettingsService = class {
   constructor(db) {
     this.db = db;
   }
+  db;
   /**
    * Get settings document for a category (general or security)
    */
@@ -551,238 +551,6 @@ var SettingsService = class {
     return await this.saveSettingsDocument("security", merged);
   }
 };
-
-// src/services/telemetry-service.ts
-var TelemetryService = class {
-  config;
-  identity = null;
-  enabled = true;
-  eventQueue = [];
-  isInitialized = false;
-  constructor(config) {
-    this.config = {
-      ...getTelemetryConfig(),
-      ...config
-    };
-    this.enabled = this.config.enabled;
-  }
-  /**
-   * Initialize the telemetry service
-   */
-  async initialize(identity) {
-    if (!this.enabled) {
-      if (this.config.debug) {
-        console.log("[Telemetry] Disabled via configuration");
-      }
-      return;
-    }
-    try {
-      this.identity = identity;
-      if (this.config.debug) {
-        console.log("[Telemetry] Initialized with installation ID:", identity.installationId);
-      }
-      this.isInitialized = true;
-      await this.flushQueue();
-    } catch (error) {
-      if (this.config.debug) {
-        console.error("[Telemetry] Initialization failed:", error);
-      }
-      this.enabled = false;
-    }
-  }
-  /**
-   * Track a telemetry event
-   */
-  async track(event, properties) {
-    if (!this.enabled) return;
-    try {
-      const sanitizedProps = this.sanitizeProperties(properties);
-      const enrichedProps = {
-        ...sanitizedProps,
-        timestamp: (/* @__PURE__ */ new Date()).toISOString(),
-        version: this.getVersion()
-      };
-      if (!this.isInitialized) {
-        this.eventQueue.push({ event, properties: enrichedProps });
-        if (this.config.debug) {
-          console.log("[Telemetry] Queued event:", event, enrichedProps);
-        }
-        return;
-      }
-      if (this.identity && this.config.host) {
-        const payload = {
-          data: {
-            installation_id: this.identity.installationId,
-            event_type: event,
-            properties: enrichedProps,
-            timestamp: enrichedProps.timestamp
-          }
-        };
-        fetch(`${this.config.host}/v1/events`, {
-          method: "POST",
-          headers: { "Content-Type": "application/json" },
-          body: JSON.stringify(payload)
-        }).catch(() => {
-        });
-        if (this.config.debug) {
-          console.log("[Telemetry] Tracked event:", event, enrichedProps);
-        }
-      } else if (this.config.debug) {
-        console.log("[Telemetry] Event (no endpoint):", event, enrichedProps);
-      }
-    } catch (error) {
-      if (this.config.debug) {
-        console.error("[Telemetry] Failed to track event:", error);
-      }
-    }
-  }
-  /**
-   * Track installation started
-   */
-  async trackInstallationStarted(properties) {
-    await this.track("installation_started", properties);
-  }
-  /**
-   * Track installation completed
-   */
-  async trackInstallationCompleted(properties) {
-    await this.track("installation_completed", properties);
-  }
-  /**
-   * Track installation failed
-   */
-  async trackInstallationFailed(error, properties) {
-    await this.track("installation_failed", {
-      ...properties,
-      errorType: sanitizeErrorMessage(error)
-    });
-  }
-  /**
-   * Track dev server started
-   */
-  async trackDevServerStarted(properties) {
-    await this.track("dev_server_started", properties);
-  }
-  /**
-   * Track page view in admin UI
-   */
-  async trackPageView(route, properties) {
-    await this.track("page_viewed", {
-      ...properties,
-      route: sanitizeRoute(route)
-    });
-  }
-  /**
-   * Track error (sanitized)
-   */
-  async trackError(error, properties) {
-    await this.track("error_occurred", {
-      ...properties,
-      errorType: sanitizeErrorMessage(error)
-    });
-  }
-  /**
-   * Track plugin activation
-   */
-  async trackPluginActivated(properties) {
-    await this.track("plugin_activated", properties);
-  }
-  /**
-   * Track migration run
-   */
-  async trackMigrationRun(properties) {
-    await this.track("migration_run", properties);
-  }
-  /**
-   * Flush queued events
-   */
-  async flushQueue() {
-    if (this.eventQueue.length === 0) return;
-    const queue = [...this.eventQueue];
-    this.eventQueue = [];
-    for (const { event, properties } of queue) {
-      await this.track(event, properties);
-    }
-  }
-  /**
-   * Sanitize properties to ensure no PII
-   */
-  sanitizeProperties(properties) {
-    if (!properties) return {};
-    const sanitized = {};
-    for (const [key, value] of Object.entries(properties)) {
-      if (value === void 0) continue;
-      if (key === "route" && typeof value === "string") {
-        sanitized[key] = sanitizeRoute(value);
-        continue;
-      }
-      if (key.toLowerCase().includes("error") && typeof value === "string") {
-        sanitized[key] = sanitizeErrorMessage(value);
-        continue;
-      }
-      if (typeof value === "string" || typeof value === "number" || typeof value === "boolean") {
-        sanitized[key] = value;
-      }
-    }
-    return sanitized;
-  }
-  /**
-   * Get SonicJS version
-   */
-  getVersion() {
-    try {
-      if (typeof process !== "undefined" && process.env) {
-        return process.env.SONICJS_VERSION || "2.0.0";
-      }
-      return "2.0.0";
-    } catch {
-      return "unknown";
-    }
-  }
-  /**
-   * Shutdown the telemetry service (no-op for fetch-based telemetry)
-   */
-  async shutdown() {
-  }
-  /**
-   * Enable telemetry
-   */
-  enable() {
-    this.enabled = true;
-  }
-  /**
-   * Disable telemetry
-   */
-  disable() {
-    this.enabled = false;
-  }
-  /**
-   * Check if telemetry is enabled
-   */
-  isEnabled() {
-    return this.enabled;
-  }
-};
-var telemetryInstance = null;
-function getTelemetryService(config) {
-  if (!telemetryInstance) {
-    telemetryInstance = new TelemetryService(config);
-  }
-  return telemetryInstance;
-}
-async function initTelemetry(identity, config) {
-  const service = getTelemetryService(config);
-  await service.initialize(identity);
-  return service;
-}
-function createInstallationIdentity(projectName) {
-  const installationId = generateInstallationId();
-  const identity = { installationId };
-  if (projectName) {
-    identity.projectId = generateProjectId(projectName);
-  }
-  return identity;
-}
 var appInstance = null;
 function setAppInstance(app) {
   appInstance = app;
@@ -1128,6 +896,6 @@ function buildRouteList(app) {
   }
 }
 
-export { CACHE_CONFIGS, CATEGORY_INFO, CacheService, Logger, SettingsService, TelemetryService, buildRouteList, createInstallationIdentity, getAppInstance, getCacheService2 as getCacheService, getLogger, getTelemetryService, initLogger, initTelemetry, setAppInstance };
-//# sourceMappingURL=chunk-ZEZ245PW.js.map
-//# sourceMappingURL=chunk-ZEZ245PW.js.map
+export { CACHE_CONFIGS, CATEGORY_INFO, CacheService, Logger, SettingsService, buildRouteList, getAppInstance, getCacheService2 as getCacheService, getLogger, initLogger, setAppInstance };
+//# sourceMappingURL=chunk-2XAQTPAE.js.map
+//# sourceMappingURL=chunk-2XAQTPAE.js.map