@kyro-cms/admin 0.1.6 → 0.1.8

package/README.md

@@ -4,7 +4,8 @@ Admin dashboard for Kyro CMS — a React-based admin interface built with Astro.
 
 ## Features
 
-- **Authentication** — JWT-based login/logout with SQLite auth backend
+- **Multi-Database Support** — SQLite, PostgreSQL, MySQL, MongoDB
+- **Authentication** — JWT-based login/logout with auto-selecting auth adapter
 - **Collection Management** — Create, edit, and manage content collections
 - **User Management** — Manage users, roles, and permissions
 - **Settings** — Configure CMS settings, globals, and plugins
@@ -34,6 +35,9 @@ npm run preview
 
 # Type check
 npm run check
+
+# Run tests
+npm run test:run
 ```
 
 ### Integration with Kyro CMS
@@ -78,9 +82,85 @@ The admin dashboard is designed to work alongside a Kyro CMS project. In your As
    });
    ```
 
+## Database Configuration
+
+The admin supports multiple database backends. The auth system automatically uses the same database as your content data.
+
+### SQLite (Default)
+
+```bash
+# No configuration needed - uses ./data/kyro.db
+DB_TYPE=sqlite
+```
+
+### PostgreSQL
+
+```bash
+DB_TYPE=postgres
+DB_HOST=localhost
+DB_PORT=5432
+DB_NAME=kyro
+DB_USER=admin
+DB_PASSWORD=secret
+# Or use connection string
+DB_CONNECTION_STRING=postgresql://admin:secret@localhost:5432/kyro
+```
+
+### MySQL
+
+```bash
+DB_TYPE=mysql
+DB_HOST=localhost
+DB_PORT=3306
+DB_NAME=kyro
+DB_USER=root
+DB_PASSWORD=secret
+```
+
+### MongoDB
+
+```bash
+DB_TYPE=mongodb
+DB_HOST=localhost
+DB_PORT=27017
+DB_NAME=kyro
+# Or use connection string
+DB_CONNECTION_STRING=mongodb://admin:secret@localhost:27017/kyro
+```
+
+### Connection Pooling
+
+For PostgreSQL and MySQL, configure connection pool:
+
+```bash
+DB_POOL_MIN=5
+DB_POOL_MAX=20
+```
+
+### Environment Variables
+
+| Variable                  | Description                                   | Default                   |
+| ------------------------- | --------------------------------------------- | ------------------------- |
+| `DB_TYPE`                 | Database type (sqlite/postgres/mysql/mongodb) | `sqlite`                  |
+| `DB_CONNECTION_STRING`    | Full connection URI                           | -                         |
+| `DB_HOST`                 | Database host                                 | `localhost`               |
+| `DB_PORT`                 | Database port                                 | 5432/3306/27017           |
+| `DB_NAME`                 | Database name                                 | `kyro`                    |
+| `DB_USER`                 | Database username                             | -                         |
+| `DB_PASSWORD`             | Database password                             | -                         |
+| `DB_POOL_MIN`             | Minimum pool connections                      | 5                         |
+| `DB_POOL_MAX`             | Maximum pool connections                      | 20                        |
+| `JWT_SECRET`              | Secret for signing JWT tokens                 | `change-me-in-production` |
+| `JWT_EXPIRES_IN`          | Token expiration time                         | `24h`                     |
+| `KYRO_ALLOW_REGISTRATION` | Allow public registration                     | `true`                    |
+
 ## Authentication
 
-The admin uses SQLite for auth by default (stored at `./data/auth.db`). No Redis or external services required.
+Auth is automatically handled by the adapter matching your `DB_TYPE`:
+
+- **SQLite** → Uses SQLiteAuthAdapter (local file-based)
+- **Postgres** → Uses PostgresAuthAdapter (same DB)
+- **MongoDB** → Uses MongoDBAuthAdapter (same DB)
 
 ### Creating Your First Admin User
 
@@ -89,15 +169,6 @@ The admin uses SQLite for auth by default (stored at `./data/auth.db`). No Redis
 3. Register with your email and password
 4. The first user automatically gets the `super_admin` role
 
-### Environment Variables
-
-| Variable                  | Description                                | Default                   |
-| ------------------------- | ------------------------------------------ | ------------------------- |
-| `JWT_SECRET`              | Secret for signing JWT tokens              | `change-me-in-production` |
-| `JWT_EXPIRES_IN`          | Token expiration time                      | `24h`                     |
-| `KYRO_AUTH_DB_PATH`       | Path to auth SQLite database               | `./data/auth.db`          |
-| `KYRO_ALLOW_REGISTRATION` | Allow public registration after first user | `true`                    |
-
 ### Auth API Endpoints
 
 | Endpoint             | Method | Description                  |
@@ -114,58 +185,85 @@ The admin uses SQLite for auth by default (stored at `./data/auth.db`). No Redis
 ```
 admin/
 ├── src/
-│   ├── components/     # React UI components
-│   ├── pages/          # Astro pages + API routes
-│   │   └── api/        # REST API endpoints
-│   │       └── auth/   # Authentication endpoints
-│   ├── collections/    # Auth collection config
-│   └── middleware.ts   # Auth middleware
-├── public/             # Static assets
-└── astro.config.mjs    # Astro configuration
+│   ├── lib/
+│   │   ├── db/              # Database adapters
+│   │   │   ├── adapter.ts   # DatabaseAdapter interface
+│   │   │   ├── index.ts     # Factory & config
+│   │   │   ├── sqlite-adapter.ts
+│   │   │   ├── postgres-adapter.ts
+│   │   │   ├── mysql-adapter.ts
+│   │   │   ├── mongodb-adapter.ts
+│   │   │   └── mongodb-auth-adapter.ts
+│   │   ├── auth/            # Auth adapter
+│   │   │   └── sqlite-adapter.ts
+│   │   ├── dataStore.ts     # Content data wrapper
+│   │   └── config.ts        # Collection/global config
+│   ├── components/          # React UI components
+│   ├── pages/               # Astro pages + API routes
+│   │   └── api/             # REST API endpoints
+│   │       └── auth/        # Authentication endpoints
+│   └── collections/          # Auth collection config
+├── test/                    # Vitest tests
+├── public/                  # Static assets
+└── astro.config.mjs         # Astro configuration
+```
+
+## Adapter Architecture
+
+```
+┌─────────────────────────────────────────────────────────────┐
+│                    Application Code                         │
+└─────────────────────────┬───────────────────────────────────┘
+                          │
+                          ▼
+┌─────────────────────────────────────────────────────────────┐
+│                   dataStore.ts (Wrapper)                   │
+└─────────────────────────┬───────────────────────────────────┘
+                          │
+                          ▼
+┌─────────────────────────────────────────────────────────────┐
+│              db/index.ts (Factory/Registry)                 │
+│  - Reads DB_TYPE from env                                   │
+│  - Lazy-loads appropriate adapter                          │
+│  - Auto-selects matching auth adapter                      │
+└─────────────────────────┬───────────────────────────────────┘
+                          │
+                          ▼
+┌─────────────────────────────────────────────────────────────┐
+│        adapter.ts (DatabaseAdapter Interface)               │
+│  - find, findById, create, update, delete                  │
+│  - findGlobal, updateGlobal, seedGlobal                     │
+│  - seed, isSeeded, count                                    │
+└─────────────────────────┬───────────────────────────────────┘
+                          │
+    ┌─────────────────────┼─────────────────────┐
+    ▼                     ▼                     ▼
+┌─────────┐         ┌─────────┐         ┌─────────┐
+│ SQLite  │         │   PG    │         │  MySQL  │
+└─────────┘         └─────────┘         └─────────┘
+                              ┌─────────┐
+                              │ MongoDB │
+                              └─────────┘
 ```
 
 ## Security
 
-- **Password Hashing** — bcryptjs with 12 salt rounds
+- **Password Hashing** — bcryptjs with 10 salt rounds
 - **JWT Tokens** — Signed tokens with configurable expiration
-- **Session Management** — Server-side session tracking via SQLite
+- **Session Management** — Server-side session tracking via DB adapter
 - **Middleware Protection** — All non-auth routes require valid JWT
-- **Password Policy** — Minimum 12 characters with complexity requirements
+- **Password Policy** — Minimum 8 characters
 
-## Scalability
-
-### Default Setup (Single Instance)
-
-SQLite auth adapter handles everything in a single `./data/auth.db` file. Perfect for:
-
-- Development
-- Small to medium projects
-- Single-server deployments
-
-### Multi-Instance / Horizontal Scaling
-
-When running multiple Kyro CMS instances behind a load balancer, configure:
+## Testing
 
 ```bash
-# Shared auth database path (mounted volume, NFS, etc.)
-KYRO_AUTH_DB_PATH=/shared/data/auth.db
+# Run all tests
+npm run test:run
 
-# Enable write-ahead logging for concurrent access
-# (automatically enabled by SQLiteAuthAdapter)
+# Run tests with watch mode
+npm run test
 ```
 
-### High-Scale Production
-
-For high-traffic deployments with many concurrent users:
-
-1. **Connection Pooling** — SQLite handles concurrent reads well, but writes are serialized. For write-heavy workloads, consider PostgreSQL with the Drizzle auth adapter.
-
-2. **Session Caching** — JWT tokens are self-contained, so session validation doesn't require database reads on every request.
-
-3. **Rate Limiting** — Currently in-memory per instance. For distributed rate limiting, use Redis or a shared SQLite file on fast storage.
-
-4. **Audit Logs** — Stored in SQLite. For high-volume audit logging, consider exporting to a dedicated log store.
-
 ## License
 
 MIT

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kyro-cms/admin",
-  "version": "0.1.6",
+  "version": "0.1.8",
   "private": false,
   "type": "module",
   "description": "Admin dashboard for Kyro CMS",
@@ -20,23 +20,72 @@
     "dev": "astro dev",
     "build": "astro build",
     "preview": "astro preview",
-    "check": "astro check"
+    "check": "astro check",
+    "test": "vitest",
+    "test:run": "vitest run"
   },
   "dependencies": {
     "@astrojs/node": "^9.5.5",
     "@astrojs/react": "^4.2.0",
-    "@kyro-cms/core": "^0.1.6",
+    "@codemirror/lang-cpp": "^6.0.3",
+    "@codemirror/lang-css": "^6.3.1",
+    "@codemirror/lang-html": "^6.4.11",
+    "@codemirror/lang-java": "^6.0.2",
+    "@codemirror/lang-javascript": "^6.2.5",
+    "@codemirror/lang-json": "^6.0.2",
+    "@codemirror/lang-markdown": "^6.5.0",
+    "@codemirror/lang-php": "^6.0.2",
+    "@codemirror/lang-python": "^6.2.1",
+    "@codemirror/lang-rust": "^6.0.2",
+    "@codemirror/lang-sql": "^6.10.0",
+    "@codemirror/state": "^6.6.0",
+    "@codemirror/view": "^6.41.0",
+    "@dnd-kit/core": "^6.3.1",
+    "@dnd-kit/sortable": "^10.0.0",
+    "@dnd-kit/utilities": "^3.2.2",
+    "@graphiql/react": "^0.37.3",
+    "@kyro-cms/core": "workspace:*",
+    "@kyro-cms/utils": "workspace:*",
+    "@platejs/dnd": "^53.0.0",
+    "@portabletext/editor": "^6.6.3",
+    "@portabletext/react": "^6.0.3",
+    "@portabletext/schema": "^2.1.1",
+    "@portabletext/toolbar": "^7.0.26",
+    "@portabletext/types": "^4.0.2",
     "@tailwindcss/vite": "^4.0.0",
+    "@types/pg": "^8.20.0",
+    "@udecode/plate-dnd": "^49.0.0",
+    "@uiw/codemirror-theme-aura": "^4.25.9",
+    "@uiw/codemirror-theme-dracula": "^4.25.9",
+    "@uiw/codemirror-theme-github": "^4.25.9",
+    "@uiw/react-codemirror": "^4.25.9",
     "astro": "^5.4.0",
+    "better-sqlite3": "^11.10.0",
+    "drizzle-orm": "^0.45.2",
+    "graphiql": "^5.2.2",
     "lucide-react": "^0.475.0",
+    "mongodb": "^7.1.1",
+    "mysql2": "^3.21.0",
+    "pg": "^8.20.0",
+    "platejs": "^53.0.0",
     "react": "^19.0.0",
     "react-dom": "^19.0.0",
-    "tailwindcss": "^4.0.0"
+    "react-image-crop": "^11.0.10",
+    "sharp": "^0.34.5",
+    "slate": "^0.124.1",
+    "slate-history": "^0.113.1",
+    "slate-react": "^0.124.0",
+    "tailwindcss": "^4.0.0",
+    "zustand": "^5.0.3"
   },
   "devDependencies": {
     "@types/react": "^19.0.0",
     "@types/react-dom": "^19.0.0",
-    "typescript": "^5.7.0"
+    "dotenv": "^17.4.2",
+    "dotenv-cli": "^11.0.0",
+    "drizzle-kit": "^0.31.10",
+    "typescript": "^5.7.0",
+    "vitest": "^4.1.4"
   },
   "peerDependencies": {
     "@kyro-cms/core": "^0.1.2"

package/src/collections/auth/index.ts

@@ -73,7 +73,7 @@ export const rolesCollection: CollectionConfig = {
       items: { type: "text" },
       label: "Inherits From",
     },
-    { name: "description", type: "textarea" },
+    { name: "description", type: "richtext" },
     {
       name: "permissions",
       type: "array",
@@ -124,7 +124,7 @@ export const auditLogsCollection: CollectionConfig = {
     { name: "ipAddress", type: "text", label: "IP Address" },
     { name: "userAgent", type: "text", label: "User Agent" },
     { name: "success", type: "boolean" },
-    { name: "error", type: "textarea" },
+    { name: "error", type: "richtext" },
     { name: "metadata", type: "json", label: "Metadata" },
     { name: "timestamp", type: "datetime", required: true, readonly: true },
   ],

package/src/collections/portfolio/index.ts

@@ -0,0 +1,343 @@
+import type { CollectionConfig } from "@kyro-cms/core";
+
+export const portfolioCollections: Record<string, CollectionConfig> = {
+  projects: {
+    slug: "projects",
+    label: "Projects",
+    labelPlural: "Projects",
+    singularLabel: "Project",
+    admin: {
+      useAsTitle: "title",
+      defaultColumns: ["title", "featured", "status", "createdAt"],
+      description: "Portfolio projects and case studies",
+    },
+    fields: [
+      {
+        name: "title",
+        type: "text",
+        required: true,
+        label: "Title",
+        admin: { description: "Project title" },
+      },
+      {
+        name: "slug",
+        type: "text",
+        required: true,
+        label: "Slug",
+        admin: { description: "URL-friendly identifier" },
+      },
+      {
+        name: "client",
+        type: "text",
+        label: "Client",
+        admin: { description: "Client name" },
+      },
+      {
+        name: "description",
+        type: "richtext",
+        label: "Description",
+        admin: { description: "Project description" },
+      },
+      {
+        name: "featuredImage",
+        type: "upload",
+        label: "Featured Image",
+        relationTo: "media",
+        admin: { description: "Main project image" },
+      },
+      {
+        name: "gallery",
+        type: "array",
+        label: "Gallery",
+        fields: [
+          {
+            name: "image",
+            type: "upload",
+            label: "Image",
+            relationTo: "media",
+          },
+          {
+            name: "caption",
+            type: "text",
+            label: "Caption",
+          },
+        ],
+        admin: { description: "Additional project images" },
+      },
+      {
+        name: "technologies",
+        type: "array",
+        label: "Technologies",
+        fields: [
+          {
+            name: "name",
+            type: "text",
+            label: "Technology",
+          },
+        ],
+        admin: { description: "Tools and technologies used" },
+      },
+      {
+        name: "link",
+        type: "text",
+        label: "Project URL",
+        admin: { description: "Live project link" },
+      },
+      {
+        name: "github",
+        type: "text",
+        label: "GitHub URL",
+        admin: { description: "Repository link" },
+      },
+      {
+        name: "featured",
+        type: "checkbox",
+        label: "Featured",
+        defaultValue: false,
+        admin: { description: "Show on homepage" },
+      },
+      {
+        name: "status",
+        type: "select",
+        label: "Status",
+        options: [
+          { label: "Draft", value: "draft" },
+          { label: "Published", value: "published" },
+          { label: "Archived", value: "archived" },
+        ],
+        defaultValue: "draft",
+      },
+      {
+        name: "order",
+        type: "number",
+        label: "Display Order",
+        defaultValue: 0,
+        admin: { description: "Sort order" },
+      },
+      {
+        name: "completedAt",
+        type: "date",
+        label: "Completed At",
+        admin: { description: "Project completion date" },
+      },
+    ],
+    timestamps: true,
+  },
+
+  team: {
+    slug: "team",
+    label: "Team Members",
+    labelPlural: "Team Members",
+    singularLabel: "Team Member",
+    admin: {
+      useAsTitle: "name",
+      defaultColumns: ["name", "role", "order", "createdAt"],
+      description: "Team members and staff",
+    },
+    fields: [
+      {
+        name: "name",
+        type: "text",
+        required: true,
+        label: "Name",
+        admin: { description: "Full name" },
+      },
+      {
+        name: "role",
+        type: "text",
+        required: true,
+        label: "Role",
+        admin: { description: "Job title or role" },
+      },
+      {
+        name: "bio",
+        type: "markdown",
+        label: "Bio",
+        admin: { description: "Short biography" },
+      },
+      {
+        name: "photo",
+        type: "upload",
+        label: "Photo",
+        relationTo: "media",
+        admin: { description: "Profile photo" },
+      },
+      {
+        name: "gallery",
+        type: "array",
+        label: "Gallery",
+        fields: [
+          {
+            name: "image",
+            type: "upload",
+            label: "Image",
+            relationTo: "media",
+          },
+          {
+            name: "caption",
+            type: "text",
+            label: "Caption",
+          },
+        ],
+        admin: { description: "Additional photos" },
+      },
+      {
+        name: "email",
+        type: "email",
+        label: "Email",
+        admin: { description: "Contact email" },
+      },
+      {
+        name: "phone",
+        type: "text",
+        label: "Phone",
+        admin: { description: "Contact phone" },
+      },
+      {
+        name: "linkedin",
+        type: "text",
+        label: "LinkedIn",
+        admin: { description: "LinkedIn profile URL" },
+      },
+      {
+        name: "twitter",
+        type: "text",
+        label: "Twitter",
+        admin: { description: "Twitter handle" },
+      },
+      {
+        name: "github",
+        type: "text",
+        label: "GitHub",
+        admin: { description: "GitHub profile URL" },
+      },
+      {
+        name: "website",
+        type: "text",
+        label: "Website",
+        admin: { description: "Personal website" },
+      },
+      {
+        name: "order",
+        type: "number",
+        label: "Display Order",
+        defaultValue: 0,
+        admin: { description: "Sort order" },
+      },
+      {
+        name: "status",
+        type: "select",
+        label: "Status",
+        options: [
+          { label: "Active", value: "active" },
+          { label: "Inactive", value: "inactive" },
+        ],
+        defaultValue: "active",
+      },
+    ],
+    timestamps: true,
+  },
+
+  menus: {
+    slug: "menus",
+    label: "Menus",
+    labelPlural: "Menus",
+    singularLabel: "Menu",
+    admin: {
+      useAsTitle: "name",
+      defaultColumns: ["name", "location", "createdAt"],
+      description: "Navigation menus",
+    },
+    fields: [
+      {
+        name: "name",
+        type: "text",
+        required: true,
+        label: "Name",
+        admin: { description: "Menu name" },
+      },
+      {
+        name: "location",
+        type: "select",
+        label: "Location",
+        required: true,
+        options: [
+          { label: "Header", value: "header" },
+          { label: "Footer", value: "footer" },
+          { label: "Mobile", value: "mobile" },
+          { label: "Sidebar", value: "sidebar" },
+        ],
+        admin: { description: "Where to display this menu" },
+      },
+      {
+        name: "items",
+        type: "array",
+        label: "Menu Items",
+        admin: { description: "Navigation items" },
+        fields: [
+          {
+            name: "label",
+            type: "text",
+            label: "Label",
+          },
+          {
+            name: "url",
+            type: "text",
+            label: "URL",
+            admin: { description: "Link address" },
+          },
+          {
+            name: "target",
+            type: "select",
+            label: "Target",
+            options: [
+              { label: "Same tab", value: "_self" },
+              { label: "New tab", value: "_blank" },
+            ],
+            defaultValue: "_self",
+          },
+          {
+            name: "icon",
+            type: "text",
+            label: "Icon",
+            admin: { description: "Icon name" },
+          },
+          {
+            name: "order",
+            type: "number",
+            label: "Order",
+            defaultValue: 0,
+          },
+          {
+            name: "children",
+            type: "array",
+            label: "Sub-items",
+            fields: [
+              {
+                name: "label",
+                type: "text",
+                label: "Label",
+              },
+              {
+                name: "url",
+                type: "text",
+                label: "URL",
+              },
+              {
+                name: "target",
+                type: "select",
+                label: "Target",
+                options: [
+                  { label: "Same tab", value: "_self" },
+                  { label: "New tab", value: "_blank" },
+                ],
+                defaultValue: "_self",
+              },
+            ],
+          },
+        ],
+      },
+    ],
+    timestamps: true,
+  },
+};