taleem-kernel 1.0.0 → 1.0.1

package/bin/cli.js

@@ -0,0 +1,49 @@
+#!/usr/bin/env node
+
+import fs from "fs";
+import path from "path";
+import { fileURLToPath } from "url";
+
+const command = process.argv[2];
+
+const kernelSchemaPath = path.resolve(
+	path.dirname(fileURLToPath(import.meta.url)),
+	"../prisma/schema.prisma"
+);
+
+const appSchemaPath = path.resolve(
+	process.cwd(),
+	"prisma/schema.prisma"
+);
+
+if (command === "schema-check") {
+	const kernelSchema = fs.readFileSync(kernelSchemaPath, "utf8");
+	const appSchema = fs.readFileSync(appSchemaPath, "utf8");
+
+	if (kernelSchema !== appSchema) {
+		console.error("❌ Taleem Prisma schema mismatch.");
+		console.error(`Kernel: ${kernelSchemaPath}`);
+		console.error(`App:    ${appSchemaPath}`);
+		console.error("Run: npx taleem-kernel schema-update");
+		process.exit(1);
+	}
+
+	console.log("✓ Taleem Prisma schema is up to date.");
+	process.exit(0);
+}
+
+if (command === "schema-update") {
+	fs.copyFileSync(kernelSchemaPath, appSchemaPath);
+
+	console.log("✓ Taleem Prisma schema updated.");
+	console.log(`Source: ${kernelSchemaPath}`);
+	console.log(`Target: ${appSchemaPath}`);
+	process.exit(0);
+}
+
+console.log("Usage: npx taleem-kernel <command>");
+console.log("");
+console.log("Commands:");
+console.log("  schema-check   Check Prisma schema");
+console.log("  schema-update  Update Prisma schema");
+process.exit(1);

package/bin/schema-check.js

@@ -0,0 +1,20 @@
+import fs from "fs";
+import path from "path";
+import { fileURLToPath } from "url";
+
+const kernelSchema = fs.readFileSync(
+	path.resolve(path.dirname(fileURLToPath(import.meta.url)), "../prisma/schema.prisma"),
+	"utf8"
+);
+
+const appSchema = fs.readFileSync(
+	path.resolve(process.cwd(), "prisma/schema.prisma"),
+	"utf8"
+);
+
+if (kernelSchema !== appSchema) {
+	console.error("❌ Taleem Prisma schema mismatch.");
+	process.exit(1);
+}
+
+console.log("✓ Taleem Prisma schema is up to date.");

package/bin/schema-update.js

@@ -0,0 +1,2 @@
+fs.copyFileSync(kernelSchemaPath, appSchemaPath);
+console.log("✓ Taleem Prisma schema updated.");

package/package.json

@@ -1,15 +1,23 @@
 {
   "name": "taleem-kernel",
-  "version": "1.0.0",
+  "version": "1.0.1",
   "description": "Taleem data and business-logic kernel. HTTP is only an adapter.",
   "type": "module",
   "main": "./src/ServerKernel.js",
   "exports": {
     ".": "./src/ServerKernel.js"
   },
+  "bin": {
+    "taleem-kernel": "./bin/cli.js"
+  },
   "scripts": {
     "test": "vitest run"
   },
+  "files": [
+    "src",
+    "prisma",
+    "bin"
+  ],
   "dependencies": {
     "@prisma/client": "^6.19.3",
     "bcrypt": "^6.0.0",

package/prisma/migrations/20260823124519_core/migration.sql

@@ -0,0 +1,118 @@
+-- CreateTable
+CREATE TABLE "Course" (
+    "slug" TEXT NOT NULL,
+    "title" TEXT NOT NULL,
+    "description" TEXT,
+    "thumbnail" TEXT,
+    "access" TEXT NOT NULL DEFAULT 'OPEN',
+    "price" INTEGER NOT NULL DEFAULT 0,
+    "groupings" TEXT NOT NULL DEFAULT '[]'
+);
+
+-- CreateTable
+CREATE TABLE "User" (
+    "id" INTEGER NOT NULL PRIMARY KEY AUTOINCREMENT,
+    "email" TEXT NOT NULL,
+    "password" TEXT NOT NULL,
+    "name" TEXT,
+    "role" TEXT NOT NULL DEFAULT 'student',
+    "resource" TEXT,
+    "createdAt" DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP
+);
+
+-- CreateTable
+CREATE TABLE "Admin" (
+    "id" INTEGER NOT NULL PRIMARY KEY AUTOINCREMENT,
+    "email" TEXT NOT NULL,
+    "password" TEXT NOT NULL,
+    "courseSlugs" TEXT NOT NULL DEFAULT '[]',
+    "role" TEXT NOT NULL DEFAULT 'ADMIN',
+    "isActive" BOOLEAN NOT NULL DEFAULT true,
+    "createdAt" DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP,
+    "updatedAt" DATETIME NOT NULL
+);
+
+-- CreateTable
+CREATE TABLE "Library" (
+    "slug" TEXT NOT NULL PRIMARY KEY,
+    "title" TEXT NOT NULL,
+    "description" TEXT,
+    "thumbnail" TEXT,
+    "type" TEXT NOT NULL,
+    "body" TEXT,
+    "courseSlug" TEXT NOT NULL,
+    "groupSlug" TEXT NOT NULL,
+    "sortOrder" INTEGER NOT NULL DEFAULT 0,
+    "allowCommunication" BOOLEAN NOT NULL DEFAULT true,
+    "meta" TEXT,
+    "createdAt" DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP,
+    "updatedAt" DATETIME NOT NULL
+);
+
+-- CreateTable
+CREATE TABLE "Subscription" (
+    "id" INTEGER NOT NULL PRIMARY KEY AUTOINCREMENT,
+    "userId" INTEGER NOT NULL,
+    "courseSlug" TEXT NOT NULL,
+    "startsAt" DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP,
+    "endsAt" DATETIME,
+    "amount" INTEGER,
+    "cancelledAt" DATETIME,
+    CONSTRAINT "Subscription_userId_fkey" FOREIGN KEY ("userId") REFERENCES "User" ("id") ON DELETE RESTRICT ON UPDATE CASCADE
+);
+
+-- CreateTable
+CREATE TABLE "Communication" (
+    "id" INTEGER NOT NULL PRIMARY KEY AUTOINCREMENT,
+    "userId" INTEGER NOT NULL,
+    "librarySlug" TEXT NOT NULL,
+    "type" TEXT NOT NULL,
+    "meta" TEXT,
+    "message" TEXT NOT NULL,
+    "authorResponse" TEXT,
+    "isPublic" BOOLEAN NOT NULL DEFAULT false,
+    "readAt" DATETIME,
+    "createdAt" DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP,
+    "updatedAt" DATETIME NOT NULL,
+    CONSTRAINT "Communication_userId_fkey" FOREIGN KEY ("userId") REFERENCES "User" ("id") ON DELETE RESTRICT ON UPDATE CASCADE
+);
+
+-- CreateTable
+CREATE TABLE "Svg" (
+    "slug" TEXT NOT NULL PRIMARY KEY,
+    "title" TEXT NOT NULL,
+    "body" TEXT NOT NULL,
+    "tags" TEXT NOT NULL DEFAULT '[]',
+    "createdAt" DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP,
+    "updatedAt" DATETIME NOT NULL
+);
+
+-- CreateTable
+CREATE TABLE "Image" (
+    "slug" TEXT NOT NULL PRIMARY KEY,
+    "title" TEXT NOT NULL,
+    "tags" TEXT NOT NULL DEFAULT '[]',
+    "createdAt" DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP,
+    "updatedAt" DATETIME NOT NULL
+);
+
+-- CreateIndex
+CREATE UNIQUE INDEX "Course_slug_key" ON "Course"("slug");
+
+-- CreateIndex
+CREATE UNIQUE INDEX "User_email_key" ON "User"("email");
+
+-- CreateIndex
+CREATE UNIQUE INDEX "Admin_email_key" ON "Admin"("email");
+
+-- CreateIndex
+CREATE INDEX "Subscription_userId_idx" ON "Subscription"("userId");
+
+-- CreateIndex
+CREATE INDEX "Subscription_courseSlug_idx" ON "Subscription"("courseSlug");
+
+-- CreateIndex
+CREATE INDEX "Communication_userId_idx" ON "Communication"("userId");
+
+-- CreateIndex
+CREATE INDEX "Communication_librarySlug_idx" ON "Communication"("librarySlug");

package/prisma/migrations/20260823131911_add_audio/migration.sql

@@ -0,0 +1,8 @@
+-- CreateTable
+CREATE TABLE "Audio" (
+    "slug" TEXT NOT NULL PRIMARY KEY,
+    "title" TEXT NOT NULL,
+    "tags" TEXT NOT NULL DEFAULT '[]',
+    "createdAt" DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP,
+    "updatedAt" DATETIME NOT NULL
+);

package/prisma/migrations/migration_lock.toml

@@ -0,0 +1,3 @@
+# Please do not edit this file manually
+# It should be added in your version-control system (e.g., Git)
+provider = "sqlite"

package/prisma/schema.prisma

@@ -118,4 +118,31 @@ model Svg {
 
   updatedAt DateTime @updatedAt
 
+}
+
+model Image {
+
+  slug      String   @id
+
+  title     String
+
+  tags      String   @default("[]")
+
+  createdAt DateTime @default(now())
+
+  updatedAt DateTime @updatedAt
+
+}
+model Audio  {
+
+  slug      String   @id
+
+  title     String
+
+  tags      String   @default("[]")
+
+  createdAt DateTime @default(now())
+
+  updatedAt DateTime @updatedAt
+
 }

package/readme.md

@@ -1,116 +1,97 @@
+## Taleem Kernel API
 
-# Taleem Server Kernel Constitution
-
-### Purpose
-
-The **serverKernel** is the product. It contains all business logic and data access. HTTP is only an adapter.
+```js
+import kernel from "taleem-kernel";
+```
 
-## Owns
+`taleem-kernel` is the shared DB/domain layer for Taleem applications. It provides Prisma/SQLite access and Taleem-specific modules.
 
-* Database (Prisma)
-* Validation
-* Business rules
-* Authentication
-* Authorization
-* Domain errors
+### Core
 
-## Never owns
+```js
+kernel.db              // Prisma client
+kernel.config          // configuration
+kernel.auth            // authentication/JWT
+kernel.communicationPolicy
+kernel.shutdown()
+```
 
-* Express
-* Routes
-* `req` / `res`
-* HTML pages
-* Cookies
-* Headers
-* Static files
-* URL parsing
+### Modules
+
+```js
+kernel.user
+kernel.admin
+kernel.course
+kernel.library
+kernel.communication
+kernel.subscription
+kernel.svg
+kernel.image
+kernel.audio
+```
 
-## Authentication Boundary
+Each module provides simple DB/domain operations such as:
 
-### HTTP Layer
+```js
+list()
+get(...)
+create(data)
+update(id, data)
+delete(id)
+```
 
-Responsible for:
+with additional module-specific methods such as:
 
-* Reading `Authorization` header
-* Reading cookies
-* Extracting bearer token
-* Passing token to kernel
+```js
+kernel.user.login()
+kernel.user.register()
+kernel.admin.isAdmin()
+kernel.library.listByCourse()
+kernel.communication.listUnanswered()
+kernel.communication.countUserOpenQuestions()
+```
 
-Never verifies anything.
+### Schema
 
-### Kernel
+The kernel owns the **canonical Taleem Prisma/SQLite schema**. Applications using Taleem DB should use the kernel rather than maintaining their own DB layer.
 
-Responsible for:
+```js
+kernel.auth.authenticate(token)
+kernel.user.login(email, password)
+kernel.course.list()
+kernel.library.get(slug)
+kernel.svg.get(slug)
+```
 
-* Verifying JWT
-* Loading user
-* Checking permissions
-* Checking subscriptions
-* Returning authenticated identity
+`kernel.shutdown()` disconnects Prisma when the application exits.
 
-Never reads headers.
+## Schema Management
 
-## Public API Rules
+The kernel provides two CLI commands for maintaining schema compatibility:
 
-Every public method:
+```bash
+npx taleem-kernel schema-check
+npx taleem-kernel schema-update
+```
 
-* validates input
-* validates authentication (if required)
-* enforces authorization
-* throws explicit errors
-* never silently fails
-* never returns ambiguous `null`
+`schema-check` compares the application's `prisma/schema.prisma` with the canonical schema shipped with `taleem-kernel`.
 
-## Error Rules
+`schema-update` copies the kernel's canonical schema into the application's `prisma/schema.prisma`.
 
-Errors are for developers.
+After updating the schema, run the application's normal Prisma migration/generation process as required.
 
-Every error answers:
+## Server Dependencies
 
-1. What failed?
-2. Why?
-3. Which method?
-4. Which object/user/resource?
-5. What should the caller check?
+`taleem-server` should use `taleem-kernel` for all Taleem database access.
 
-Example:
+The server provides the HTTP/API layer on top of the kernel:
 
 ```text
-AuthenticationError
-Method : library.get()
-Reason : JWT expired
-User   : 31
-Token  : valid format, expired at 2026-07-27T09:10Z
+    "@prisma/client": "^6.19.3",
+    "bcrypt": "^6.0.0",
+    "dotenv": "^17.4.2",
+    "jsonwebtoken": "^9.0.3",
+    "zod": "^4.4.3"
 ```
 
-## Story Rule
-
-Every feature must be explainable as a story.
-
-```
-HTTP
-↓
-Extract token
-↓
-Kernel
-↓
-Authenticate
-↓
-Authorize
-↓
-Business logic
-↓
-Return result
-↓
-HTTP formats response
-```
-
-No business logic is allowed before entering the kernel.
-
----
-
-I would add one final principle because it will save you from years of debugging:
-
-> **The kernel trusts nothing and explains everything.**
-
-That one sentence should be visible at the top of the `serverKernel` folder. It captures the philosophy you've been moving toward: every input is validated, every decision is explicit, and every failure tells you exactly why it happened.
+The server should **not maintain its own Taleem Prisma models or DB modules**.

package/src/ServerKernel.js

@@ -1,9 +1,8 @@
-///home/bilal-tariq/00--TALEEM/taleem-server-prod/src/serverKernel/ServerKernel.js
-import { PrismaClient } from "@prisma/client";
+// src/serverKernel/ServerKernel.js
 
+import { PrismaClient } from "@prisma/client";
 import Config from "./Config.js";
 import Auth from "./Auth.js";
-import Logger from "./Logger.js";
 import CommunicationPolicy from "./CommunicationPolicy.js";
 import User from "./modules/User.js";
 import Admin from "./modules/Admin.js";
@@ -16,122 +15,25 @@ import Audio from "./modules/Audio.js";
 import Svg from "./modules/Svg.js";
 
 class ServerKernel {
-
 	constructor() {
-
-		this.logger = new Logger();
-
-		this.logger.info("========================================");
-		this.logger.info("Starting Taleem Server Kernel");
-		this.logger.info("========================================");
-
-		try {
-
-			// --------------------------------------------------
-			// Core
-			// --------------------------------------------------
-
-			this.config = this.initialize("Config", () => new Config());
-
-			this.db = this.initialize("Prisma", () => new PrismaClient());
-
-			this.auth = this.initialize("Auth", () => new Auth(this));
-
-			this.communicationPolicy =
-				this.initialize(
-					"CommunicationPolicy",
-					() => new CommunicationPolicy(this)
-				);
-
-			// --------------------------------------------------
-			// Modules
-			// --------------------------------------------------
-this.user = this.initialize("User", () => new User(this));
-this.admin = this.initialize("Admin", () => new Admin(this));
-this.library = this.initialize("Library", () => new Library(this));
-this.course = this.initialize("Course", () => new Course(this));
-this.image = this.initialize("Image", () => new Image(this));
-this.audio = this.initialize("Audio", () => new Audio(this));
-this.svg = this.initialize("Svg", () => new Svg(this));
-this.communication = this.initialize("Communication", () => new Communication(this));
-this.subscription = this.initialize("Subscription", () => new Subscription(this));
-
-this.logger.info("Server Kernel started successfully.");
-
-		}
-		catch (error) {
-
-			this.logger.error(error.message);
-
-			throw error;
-
-		}
-
-	}
-
-	initialize(name, factory) {
-
-		this.logger.info(`Initializing ${name}...`);
-
-		try {
-
-			const instance = factory();
-
-			this.logger.info(`${name} initialized.`);
-
-			return instance;
-
-		}
-		catch (error) {
-
-			throw new Error(
-				[
-					"",
-					"========================================",
-					"SERVER KERNEL INITIALIZATION FAILED",
-					"----------------------------------------",
-					`Component : ${name}`,
-					`Reason    : ${error.message}`,
-					"",
-					"Server Kernel startup aborted.",
-					"========================================"
-				].join("\n")
-			);
-
-		}
-
+		this.config = new Config();
+		this.db = new PrismaClient();
+		this.auth = new Auth(this);
+		this.communicationPolicy = new CommunicationPolicy(this);
+		this.user = new User(this);
+		this.admin = new Admin(this);
+		this.library = new Library(this);
+		this.course = new Course(this);
+		this.image = new Image(this);
+		this.audio = new Audio(this);
+		this.svg = new Svg(this);
+		this.communication = new Communication(this);
+		this.subscription = new Subscription(this);
 	}
 
 	async shutdown() {
-
-		this.logger.info("Shutting down Server Kernel...");
-
-		try {
-
-			await this.db.$disconnect();
-
-			this.logger.info("Database disconnected.");
-
-			this.logger.info("Server Kernel shutdown complete.");
-
-		}
-		catch (error) {
-
-			throw new Error(
-				[
-					"",
-					"========================================",
-					"SERVER KERNEL SHUTDOWN FAILED",
-					"----------------------------------------",
-					`Reason : ${error.message}`,
-					"========================================"
-				].join("\n")
-			);
-
-		}
-
+		await this.db.$disconnect();
 	}
-
 }
 
 const kernel = new ServerKernel();

package/src/modules/Admin.js

@@ -1,3 +1,5 @@
+// src/serverKernel/modules/Admin.js
+
 import bcrypt from "bcrypt";
 
 export default class Admin {
@@ -10,15 +12,11 @@ export default class Admin {
 	}
 
 	async get(email) {
-		return this.kernel.db.admin.findUnique({
-			where: { email }
-		});
+		return this.kernel.db.admin.findUnique({ where: { email } });
 	}
 
 	async login(email, password) {
-		const admin = await this.kernel.db.admin.findUnique({
-			where: { email }
-		});
+		const admin = await this.get(email);
 		if (!admin) throw new Error(`Admin.login(): Admin '${email}' not found.`);
 		if (!admin.isActive) throw new Error(`Admin.login(): Admin '${email}' is inactive.`);
 
@@ -29,29 +27,25 @@ export default class Admin {
 	}
 
 	async create(data) {
-		if (data.password) data.password = await bcrypt.hash(data.password, 10);
-		return this.kernel.db.admin.create({ data });
+		const createData = { ...data };
+		if (createData.password) createData.password = await bcrypt.hash(createData.password, 10);
+		return this.kernel.db.admin.create({ data: createData });
 	}
 
 	async update(email, data) {
-		if (data.password) data.password = await bcrypt.hash(data.password, 10);
-		return this.kernel.db.admin.update({
-			where: { email },
-			data
-		});
+		const updateData = { ...data };
+		if (updateData.password) updateData.password = await bcrypt.hash(updateData.password, 10);
+		return this.kernel.db.admin.update({ where: { email }, data: updateData });
 	}
 
 	async delete(email) {
-		return this.kernel.db.admin.delete({
-			where: { email }
-		});
+		return this.kernel.db.admin.delete({ where: { email } });
 	}
 
 	async isAdmin(email, courseSlug) {
-	const admin = await this.get(email);
-	if (!admin) return false;
-
-	const courseSlugs = JSON.parse(admin.courseSlugs || "[]");
-	return courseSlugs.includes(courseSlug);
-}
+		const admin = await this.get(email);
+		if (!admin) return false;
+		const courseSlugs = JSON.parse(admin.courseSlugs || "[]");
+		return courseSlugs.includes(courseSlug);
+	}
 }

package/src/modules/Audio.js

@@ -1,49 +1,27 @@
 // src/serverKernel/modules/Audio.js
 
 export default class Audio {
-
-	constructor(kernel) {
-		this.kernel = kernel;
-	}
-
-	// --------------------------------------------------
-	// Queries
-	// --------------------------------------------------
+	constructor(kernel) { this.kernel = kernel; }
 
 	async list() {
-
 		return this.kernel.db.audio.findMany({
-
-			orderBy: {
-				createdAt: "desc"
-			}
-
+			orderBy: { createdAt: "desc" }
 		});
-
 	}
 
-	async get(id) {
-
-		return this.kernel.db.audio.findUnique({
-
-			where: { id }
-
-		});
-
+	async get(slug) {
+		return this.kernel.db.audio.findUnique({ where: { slug } });
 	}
 
-	// --------------------------------------------------
-	// Create
-	// --------------------------------------------------
-
 	async create(data) {
+		return this.kernel.db.audio.create({ data });
+	}
 
-		return this.kernel.db.audio.create({
-
-			data
-
-		});
-
+	async update(slug, data) {
+		return this.kernel.db.audio.update({ where: { slug }, data });
 	}
 
+	async delete(slug) {
+		return this.kernel.db.audio.delete({ where: { slug } });
+	}
 }

package/src/modules/Image.js

@@ -1,48 +1,27 @@
+// src/serverKernel/modules/Image.js
 
 export default class Image {
-
-	constructor(kernel) {
-		this.kernel = kernel;
-	}
-
-	// --------------------------------------------------
-	// Queries
-	// --------------------------------------------------
+	constructor(kernel) { this.kernel = kernel; }
 
 	async list() {
-
 		return this.kernel.db.image.findMany({
-
-			orderBy: {
-				createdAt: "desc"
-			}
-
+			orderBy: { createdAt: "desc" }
 		});
-
 	}
 
-	async get(id) {
-
-		return this.kernel.db.image.findUnique({
-
-			where: { id }
-
-		});
-
+	async get(slug) {
+		return this.kernel.db.image.findUnique({ where: { slug } });
 	}
 
-	// --------------------------------------------------
-	// Create
-	// --------------------------------------------------
-
 	async create(data) {
+		return this.kernel.db.image.create({ data });
+	}
 
-		return this.kernel.db.image.create({
-
-			data
-
-		});
-
+	async update(slug, data) {
+		return this.kernel.db.image.update({ where: { slug }, data });
 	}
 
+	async delete(slug) {
+		return this.kernel.db.image.delete({ where: { slug } });
+	}
 }

package/src/modules/Svg.js

@@ -1,11 +1,19 @@
+// src/serverKernel/modules/Svg.js
+
 export default class Svg {
+	constructor(kernel) { this.kernel = kernel; }
+
+	async list() {
+		return this.kernel.db.svg.findMany({
+			orderBy: { title: "asc" }
+		});
+	}
 
-	constructor(kernel) {
-		this.kernel = kernel;
+	async get(slug) {
+		return this.kernel.db.svg.findUnique({ where: { slug } });
 	}
 
 	async create(data) {
-
 		return this.kernel.db.svg.create({
 			data: {
 				slug: data.slug,
@@ -14,29 +22,9 @@ export default class Svg {
 				tags: data.tags ?? "[]"
 			}
 		});
-
-	}
-
-	async get(slug) {
-
-		return this.kernel.db.svg.findUnique({
-			where: { slug }
-		});
-
-	}
-
-	async list() {
-
-		return this.kernel.db.svg.findMany({
-			orderBy: {
-				title: "asc"
-			}
-		});
-
 	}
 
 	async update(slug, data) {
-
 		return this.kernel.db.svg.update({
 			where: { slug },
 			data: {
@@ -45,15 +33,9 @@ export default class Svg {
 				tags: data.tags
 			}
 		});
-
 	}
 
 	async delete(slug) {
-
-		return this.kernel.db.svg.delete({
-			where: { slug }
-		});
-
+		return this.kernel.db.svg.delete({ where: { slug } });
 	}
-
 }

package/src/modules/User.js

@@ -3,115 +3,56 @@
 import bcrypt from "bcrypt";
 
 export default class User {
-
 	constructor(kernel) {
 		this.kernel = kernel;
 	}
 
-	// --------------------------------------------------
 	// Queries
-	// --------------------------------------------------
 
 	async list() {
-
 		return this.kernel.db.user.findMany();
-
 	}
 
 	async get(id) {
-
-		return this.kernel.db.user.findUnique({
-			where: { id }
-		});
-
+		return this.kernel.db.user.findUnique({ where: { id } });
 	}
 
 	async getByEmail(email) {
-
-		return this.kernel.db.user.findUnique({
-			where: { email }
-		});
-
+		return this.kernel.db.user.findUnique({ where: { email } });
 	}
 
 	async emailToId(email) {
-
-	const user = await this.getByEmail(email);
-
-	if (!user) {
-		throw new Error(`User '${email}' not found.`);
+		const user = await this.getByEmail(email);
+		if (!user) throw new Error(`User '${email}' not found.`);
+		return user.id;
 	}
 
-	return user.id;
-
-}
-	// --------------------------------------------------
 	// Authentication
-	// --------------------------------------------------
 
 	async register(data) {
-
 		const password = await bcrypt.hash(data.password, 10);
-
-		return this.kernel.db.user.create({
-
-			data: {
-				...data,
-				password
-			}
-
-		});
-
+		return this.kernel.db.user.create({ data: { ...data, password } });
 	}
 
 	async login(email, password) {
-
 		const user = await this.getByEmail(email);
-
-		if (!user) {
-			throw new Error(`User.login(): User '${email}' not found.`);
-		}
+		if (!user) throw new Error(`User.login(): User '${email}' not found.`);
 
 		const ok = await bcrypt.compare(password, user.password);
-
-		if (!ok) {
-			throw new Error(`User.login(): Invalid password.`);
-		}
+		if (!ok) throw new Error(`User.login(): Invalid password.`);
 
 		return this.kernel.auth.createUserToken(user);
-
 	}
 
-	// --------------------------------------------------
 	// CRUD
-	// --------------------------------------------------
 
 	async update(id, data) {
-
-		if (data.password) {
-
-			data.password = await bcrypt.hash(data.password, 10);
-
-		}
-
-		return this.kernel.db.user.update({
-
-			where: { id },
-
-			data
-
-		});
-
+		const updateData = { ...data };
+		if (updateData.password) updateData.password = await bcrypt.hash(updateData.password, 10);
+		return this.kernel.db.user.update({ where: { id }, data: updateData });
 	}
 
 	async delete(id) {
-
-		return this.kernel.db.user.delete({
-
-			where: { id }
-
-		});
-
+		return this.kernel.db.user.delete({ where: { id } });
 	}
-
 }

package/.env

@@ -1,5 +0,0 @@
-
-JWT_SECRET=change_this_to_a_long_random_secret
-DATABASE_URL="file:./dev.db"
-
-SERVER_URL=https://taleem.help/api

package/src/Logger.js

@@ -1,33 +0,0 @@
-// src/serverKernel/Logger.js
-
-export default class Logger {
-
-	info(...args) {
-
-		console.log("[INFO]", ...args);
-
-	}
-
-	warn(...args) {
-
-		console.warn("[WARN]", ...args);
-
-	}
-
-	error(...args) {
-
-		console.error("[ERROR]", ...args);
-
-	}
-
-	debug(...args) {
-
-		if (process.env.NODE_ENV !== "production") {
-
-			console.log("[DEBUG]", ...args);
-
-		}
-
-	}
-
-}

package/tests/admin.test.js

@@ -1,52 +0,0 @@
-import { describe, it, expect, afterAll } from "vitest";
-import kernel from "../src/ServerKernel.js";
-
-const email = "bilal@taleem.help";
-
-describe("Admin", () => {
-	it("gets admin by email", async () => {
-		const admin = await kernel.admin.get(email);
-
-		expect(admin).toBeTruthy();
-		expect(admin.email).toBe(email);
-		expect(admin.isActive).toBe(true);
-	});
-
-	it("lists active admins", async () => {
-		const admins = await kernel.admin.list({ isActive: true });
-
-		expect(Array.isArray(admins)).toBe(true);
-		expect(admins.some(admin => admin.email === email)).toBe(true);
-	});
-
-	it("checks course authorization", async () => {
-		expect(
-			await kernel.admin.isAdmin(email, "fbise9math")
-		).toBe(true);
-
-		expect(
-			await kernel.admin.isAdmin(email, "blog")
-		).toBe(true);
-
-		expect(
-			await kernel.admin.isAdmin(email, "fbise9mathQuickRef")
-		).toBe(true);
-
-		expect(
-			await kernel.admin.isAdmin(email, "does-not-exist")
-		).toBe(false);
-	});
-
-	it("returns false for an unknown admin", async () => {
-		expect(
-			await kernel.admin.isAdmin(
-				"unknown@example.com",
-				"fbise9math"
-			)
-		).toBe(false);
-	});
-
-	afterAll(async () => {
-		await kernel.shutdown();
-	});
-});

package/tests/course.test.js

@@ -1,68 +0,0 @@
-import { describe, it, expect, afterAll } from "vitest";
-import kernel from "../src/ServerKernel.js";
-
-describe("Course", () => {
-	let testSlug;
-
-	it("lists courses", async () => {
-		const courses = await kernel.course.list();
-		expect(Array.isArray(courses)).toBe(true);
-	});
-
-	it("gets a course by slug", async () => {
-		const courses = await kernel.course.list();
-		expect(courses.length).toBeGreaterThan(0);
-
-		const course = await kernel.course.get(courses[0].slug);
-
-		expect(course).toBeTruthy();
-		expect(course.slug).toBe(courses[0].slug);
-	});
-
-	it("filters courses by access", async () => {
-		const courses = await kernel.course.list({ access: "OPEN" });
-
-		expect(Array.isArray(courses)).toBe(true);
-
-		for (const course of courses) {
-			expect(course.access).toBe("OPEN");
-		}
-	});
-
-	it("creates, updates and deletes a course", async () => {
-		testSlug = "__kernel-test-course__";
-
-		await kernel.course.create({
-			slug: testSlug,
-			title: "Kernel Test Course",
-			description: "Temporary test course",
-			access: "OPEN"
-		});
-
-		let course = await kernel.course.get(testSlug);
-		expect(course).toBeTruthy();
-		expect(course.title).toBe("Kernel Test Course");
-
-		await kernel.course.update(testSlug, {
-			title: "Updated Kernel Test Course"
-		});
-
-		course = await kernel.course.get(testSlug);
-		expect(course.title).toBe("Updated Kernel Test Course");
-
-		await kernel.course.delete(testSlug);
-
-		course = await kernel.course.get(testSlug);
-		expect(course).toBeNull();
-
-		testSlug = null;
-	});
-
-	afterAll(async () => {
-		if (testSlug) {
-			await kernel.course.delete(testSlug).catch(() => {});
-		}
-
-		await kernel.shutdown();
-	});
-});

package/tests/kernel.test.js

@@ -1,12 +0,0 @@
-import { describe, it, expect, afterAll } from "vitest";
-import kernel from "../src/ServerKernel.js";
-
-describe("Taleem Kernel", () => {
-	it("starts and connects to Prisma", async () => {
-		await expect(kernel.db.$queryRaw`SELECT 1`).resolves.toBeDefined();
-	});
-
-	afterAll(async () => {
-		await kernel.shutdown();
-	});
-});

package/tests/library.test.js

@@ -1,23 +0,0 @@
-import { describe, it, expect, afterAll } from "vitest";
-import kernel from "../src/ServerKernel.js";
-
-describe("Library", () => {
-	it("lists library content", async () => {
-		const items = await kernel.library.list();
-		expect(Array.isArray(items)).toBe(true);
-	});
-
-	it("gets a library item by slug", async () => {
-		const items = await kernel.library.list();
-		expect(items.length).toBeGreaterThan(0);
-
-		const item = await kernel.library.get(items[0].slug);
-
-		expect(item).toBeTruthy();
-		expect(item.slug).toBe(items[0].slug);
-	});
-
-	afterAll(async () => {
-		await kernel.shutdown();
-	});
-});