@sonicjs-cms/core 2.19.0 → 3.0.0-beta.10

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
 ```
 
@@ -309,7 +308,8 @@ const logger = new Logger({ category: 'custom', level: 'info' })
 logger.info('Application started')
 
 const migrationService = new MigrationService(db)
-await migrationService.runAllMigrations()
+const status = await migrationService.getMigrationStatus()
+await migrationService.ensureSchemaCompatibility()
 ```
 
 ## 🏗️ Architecture
@@ -400,24 +400,24 @@ migrations/*.sql → scripts/generate-migrations.ts → src/db/migrations-bundle
 The `generate-migrations.ts` script:
 - Reads all `.sql` files from `migrations/`
 - Generates `src/db/migrations-bundle.ts` with embedded SQL
-- Provides `getMigrationSQLById()` for runtime access
+- Lets `MigrationService` compare bundled migrations against D1's `d1_migrations` status
 
-**Important**: Always rebuild after modifying migration files. The `.sql` files are not used at runtime.
+**Important**: Cloudflare D1/Wrangler is the migration runner and `d1_migrations` is the canonical tracking table. Run migrations with `wrangler d1 migrations apply`; SonicJS only reports status and runs idempotent compatibility repairs at bootstrap.
 
 ## 🔄 Versioning
 
 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
@@ -466,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-layout-catalyst.template-UMTIN66R.js.map → admin-documents-form.template-DDSH6ROU.js.map}

@@ -1 +1 @@
-{"version":3,"sources":[],"names":[],"mappings":"","file":"admin-layout-catalyst.template-UMTIN66R.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-HFD37TY5.cjs.map → admin-documents-form.template-LSZKGA5J.cjs.map}

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

package/dist/{filter-bar.template-DlVYMk-T.d.cts → 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.ts → 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-KDHKVLXR.cjs.map

@@ -0,0 +1 @@
+{"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-layout-catalyst.template-YQ4EMF2J.js.map

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