radix-cms 0.1.0 → 1.0.0

package/dist/init/dbInit.js

@@ -0,0 +1,132 @@
+"use strict";
+/**************************************************************************************************
+* RadixCMS
+*
+* DESCRIPTION: legacy database initialization helpers.
+*
+* Copyright (C) 2026 Ultra Spark Software <salve@ultraspark.net>
+* SPDX-License-Identifier: GPL-3.0-or-later
+**************************************************************************************************/
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.installDatabase = installDatabase;
+exports.initDatabase = initDatabase;
+const promise_1 = __importDefault(require("mysql2/promise"));
+const fs_1 = __importDefault(require("fs"));
+const path_1 = __importDefault(require("path"));
+const dotenv_1 = __importDefault(require("dotenv"));
+// Load default env (installer may re-load a different .env later)
+dotenv_1.default.config();
+const schemaVersion = '1.0.0';
+function stripSeedData(sql) {
+    return sql
+        .replace(/\/\*Data for the table.*?\*\/\s*/gis, '')
+        .replace(/insert\s+into\s+`?[\w-]+`?\s*\([^;]*?\)\s*values\s*[\s\S]*?;/gi, '');
+}
+async function ensureSchemaMarker(conn, dbName) {
+    const escapedDbName = dbName.replace(/`/g, '``');
+    await conn.query(`USE \`${escapedDbName}\``);
+    await conn.query(`
    CREATE TABLE IF NOT EXISTS schema_meta (
      key_name VARCHAR(100) NOT NULL,
      value_text VARCHAR(255) NOT NULL,
      updated_at TIMESTAMP NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP,
      PRIMARY KEY (key_name)
    ) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4;
  `);
+    await conn.query(`INSERT INTO schema_meta (key_name, value_text)
     VALUES ('db_initialized', '1'), ('schema_version', ?)
     ON DUPLICATE KEY UPDATE value_text = VALUES(value_text), updated_at = CURRENT_TIMESTAMP`, [schemaVersion]);
+}
+/**
+ * Install database using explicit connection settings and a database name.
+ * If schemaSql is not provided the bundled SQL file will be used.
+ */
+async function installDatabase(connectionConfig, dbName, schemaSql) {
+    const sqlPath = path_1.default.join(__dirname, '../sql/radix.sql');
+    if (!schemaSql) {
+        if (!fs_1.default.existsSync(sqlPath)) {
+            throw new Error(`SQL file not found at ${sqlPath}`);
+        }
+        const rawSql = fs_1.default.readFileSync(sqlPath, 'utf8');
+        schemaSql = stripSeedData(rawSql);
+    }
+    connectionConfig = {
+        ...connectionConfig,
+        multipleStatements: true,
+        connectTimeout: connectionConfig.connectTimeout || 5000
+    };
+    let conn;
+    try {
+        conn = await promise_1.default.createConnection(connectionConfig);
+        const [rows] = await conn.query('SELECT SCHEMA_NAME FROM INFORMATION_SCHEMA.SCHEMATA WHERE SCHEMA_NAME = ?', [dbName]);
+        if (rows.length > 0) {
+            const dbConn = await promise_1.default.createConnection({ ...connectionConfig, database: dbName });
+            try {
+                await ensureSchemaMarker(dbConn, dbName);
+                console.log(`Database "${dbName}" already exists. Schema marker ensured.`);
+            }
+            finally {
+                await dbConn.end();
+            }
+            return;
+        }
+        await conn.query(schemaSql);
+        await ensureSchemaMarker(conn, dbName);
+        console.log(`Created database "${dbName}" and applied schema.`);
+    }
+    finally {
+        if (conn) {
+            try {
+                await conn.end();
+            }
+            catch (e) { /* ignore */ }
+        }
+    }
+}
+/**
+ * Initialize DB using environment variables. Reads process.env at call time so callers
+ * that re-load dotenv (e.g. installer) will be honored.
+ */
+async function initDatabase() {
+    const sqlPath = path_1.default.join(__dirname, '../sql/radix.sql');
+    if (!fs_1.default.existsSync(sqlPath)) {
+        console.warn(`SQL file not found at ${sqlPath}, skipping DB initialization.`);
+        return;
+    }
+    const rawSql = fs_1.default.readFileSync(sqlPath, 'utf8');
+    const schemaSql = stripSeedData(rawSql);
+    const databaseName = process.env.DB_NAME || 'radix';
+    const connectionConfig = {
+        host: process.env.DB_HOST || '127.0.0.1',
+        user: process.env.DB_USER,
+        password: process.env.DB_PASSWORD,
+        port: Number(process.env.DB_PORT) || 3306,
+        multipleStatements: true,
+        connectTimeout: 5000
+    };
+    let conn;
+    try {
+        conn = await promise_1.default.createConnection(connectionConfig);
+        const [rows] = await conn.query('SELECT SCHEMA_NAME FROM INFORMATION_SCHEMA.SCHEMATA WHERE SCHEMA_NAME = ?', [databaseName]);
+        if (rows.length > 0) {
+            const dbConn = await promise_1.default.createConnection({ ...connectionConfig, database: databaseName });
+            try {
+                await ensureSchemaMarker(dbConn, databaseName);
+                console.log(`Database "${databaseName}" already exists. Schema marker is ready.`);
+            }
+            finally {
+                await dbConn.end();
+            }
+            return;
+        }
+        console.log(`Database "${databaseName}" not found. Creating empty schema from ${sqlPath}`);
+        await conn.query(schemaSql);
+        await ensureSchemaMarker(conn, databaseName);
+        console.log('Database initialization finished.');
+    }
+    catch (err) {
+        console.error('Failed to initialize database:', err);
+    }
+    finally {
+        if (conn) {
+            try {
+                await conn.end();
+            }
+            catch (e) { /* ignore */ }
+        }
+    }
+}

package/dist/init/dbInit2.js

@@ -0,0 +1,234 @@
+"use strict";
+/**************************************************************************************************
+* RadixCMS
+*
+* DESCRIPTION: database schema installation and initialization.
+*
+* Copyright (C) 2026 Ultra Spark Software <salve@ultraspark.net>
+* SPDX-License-Identifier: GPL-3.0-or-later
+**************************************************************************************************/
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.installDatabase = installDatabase;
+exports.initDatabase = initDatabase;
+const promise_1 = __importDefault(require("mysql2/promise"));
+const fs_1 = __importDefault(require("fs"));
+const path_1 = __importDefault(require("path"));
+const dotenv_1 = __importDefault(require("dotenv"));
+// Load default env (installer may re-load a different .env later)
+dotenv_1.default.config();
+const schemaVersion = '1.0.0';
+function stripSeedData(sql) {
+    return sql
+        .replace(/\/\*Data for the table.*?\*\/\s*/gis, '')
+        .replace(/insert\s+into\s+`?[\w-]+`?\s*\([^;]*?\)\s*values\s*[\s\S]*?;/gi, '');
+}
+function normalizeSchemaSql(sql, databaseName) {
+    const safeDbName = databaseName.replace(/`/g, '``');
+    return sql
+        .replace(/CREATE\s+DATABASE\s+(?:\/\*\!32312\s+IF NOT EXISTS\*\/)?`?[A-Za-z0-9_]+`?/gi, `CREATE DATABASE IF NOT EXISTS \`${safeDbName}\``)
+        .replace(/USE\s+`?[A-Za-z0-9_]+`?/gi, `USE \`${safeDbName}\``)
+        .replace(/`radix`/gi, `\`${safeDbName}\``);
+}
+async function ensureSchemaMarker(conn, dbName) {
+    const escapedDbName = dbName.replace(/`/g, '``');
+    await conn.query(`USE \`${escapedDbName}\``);
+    await conn.query(`
+    CREATE TABLE IF NOT EXISTS schema_meta (
+      key_name VARCHAR(100) NOT NULL,
+      value_text VARCHAR(255) NOT NULL,
+      updated_at TIMESTAMP NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP,
+      PRIMARY KEY (key_name)
+    ) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4;
+  `);
+    await conn.query(`INSERT INTO schema_meta (key_name, value_text)
+     VALUES ('db_initialized', '1'), ('schema_version', ?)
+     ON DUPLICATE KEY UPDATE value_text = VALUES(value_text), updated_at = CURRENT_TIMESTAMP`, [schemaVersion]);
+}
+function extractCreateTableStatements(sql) {
+    const out = [];
+    const re = /CREATE\s+TABLE\s+`?([A-Za-z0-9_]+)`?\s*\([\s\S]*?\)[\s\S]*?;/gi;
+    let m;
+    while ((m = re.exec(sql)) !== null) {
+        out.push({ name: m[1], statement: m[0] });
+    }
+    return out;
+}
+async function seedDefaultContent(dbConn, dbName) {
+    const pageRows = [
+        {
+            title: 'Home',
+            slug: 'home',
+            content: '<h1>Hello World!</h1><p>Welcome to my lightweight Node.js CMS.</p>',
+            template_name: 'default',
+            status: 'Published',
+            min_role: 'Unregistered',
+            publish_at: '2026-08-31 00:00:00'
+        },
+        {
+            title: 'About',
+            slug: 'about',
+            content: '<h1>About Our System</h1><p>This page is completely dynamic.</p>',
+            template_name: 'default',
+            status: 'Published',
+            min_role: 'Unregistered',
+            publish_at: '2026-08-31 00:00:00'
+        }
+    ];
+    for (const page of pageRows) {
+        await dbConn.execute(`INSERT INTO pages (title, slug, content, template_name, status, min_role, publish_at)
+       VALUES (?, ?, ?, ?, ?, ?, ?)
+       ON DUPLICATE KEY UPDATE
+         title = VALUES(title),
+         content = VALUES(content),
+         template_name = VALUES(template_name),
+         status = VALUES(status),
+         min_role = VALUES(min_role),
+         publish_at = VALUES(publish_at)`, [page.title, page.slug, page.content, page.template_name, page.status, page.min_role, page.publish_at]);
+    }
+    const defaultSettings = [
+        ['app_name', process.env.APP_NAME || 'Radix'],
+        ['app_version', process.env.APP_VERSION || '0.11.0'],
+        ['site_title', process.env.APP_NAME || 'Radix'],
+        ['search_engine_visibility', '1'],
+        ['mail_from', 'noreply@example.com'],
+        ['mail_host', process.env.MAIL_HOST || ''],
+        ['mail_port', process.env.MAIL_PORT || '25'],
+        ['mail_secure', process.env.MAIL_SECURE || '0'],
+        ['mail_user', process.env.MAIL_USER || ''],
+        ['mail_pass', process.env.MAIL_PASS || ''],
+        ['site_logo', '']
+    ];
+    for (const [key, value] of defaultSettings) {
+        await dbConn.execute('INSERT INTO settings (setting_key, setting_value) VALUES (?, ?) ON DUPLICATE KEY UPDATE setting_value = VALUES(setting_value)', [key, value]);
+    }
+    console.log(`Seeded default content for database "${dbName}".`);
+}
+async function installDatabase(connectionConfig, dbName, schemaSql) {
+    const sqlPath = path_1.default.join(__dirname, '../sql/radix.sql');
+    if (!schemaSql) {
+        if (!fs_1.default.existsSync(sqlPath)) {
+            throw new Error(`SQL file not found at ${sqlPath}`);
+        }
+        const rawSql = fs_1.default.readFileSync(sqlPath, 'utf8');
+        schemaSql = stripSeedData(rawSql);
+    }
+    schemaSql = normalizeSchemaSql(schemaSql, dbName);
+    connectionConfig = {
+        ...connectionConfig,
+        multipleStatements: true,
+        connectTimeout: connectionConfig.connectTimeout || 5000
+    };
+    let conn;
+    try {
+        conn = await promise_1.default.createConnection(connectionConfig);
+        const [rows] = await conn.query('SELECT SCHEMA_NAME FROM INFORMATION_SCHEMA.SCHEMATA WHERE SCHEMA_NAME = ?', [dbName]);
+        if (rows.length > 0) {
+            const dbConn = await promise_1.default.createConnection({ ...connectionConfig, database: dbName });
+            try {
+                await ensureSchemaMarker(dbConn, dbName);
+                console.log(`Database "${dbName}" already exists. Ensuring required tables exist.`);
+                const createTables = extractCreateTableStatements(schemaSql);
+                for (const tbl of createTables) {
+                    const [trows] = await dbConn.query('SELECT TABLE_NAME FROM INFORMATION_SCHEMA.TABLES WHERE TABLE_SCHEMA = ? AND TABLE_NAME = ?', [dbName, tbl.name]);
+                    if (!trows || (Array.isArray(trows) && trows.length === 0)) {
+                        console.log(`Creating missing table: ${tbl.name}`);
+                        await dbConn.query(tbl.statement);
+                    }
+                }
+                await seedDefaultContent(dbConn, dbName);
+                console.log(`Database "${dbName}" checked and missing tables created.`);
+            }
+            finally {
+                await dbConn.end();
+            }
+            return;
+        }
+        await conn.query(schemaSql);
+        await ensureSchemaMarker(conn, dbName);
+        const dbConn = await promise_1.default.createConnection({ ...connectionConfig, database: dbName });
+        try {
+            await seedDefaultContent(dbConn, dbName);
+        }
+        finally {
+            await dbConn.end();
+        }
+        console.log(`Created database "${dbName}" and applied schema.`);
+    }
+    finally {
+        if (conn) {
+            try {
+                await conn.end();
+            }
+            catch (e) { /* ignore */ }
+        }
+    }
+}
+async function initDatabase() {
+    const sqlPath = path_1.default.join(__dirname, '../sql/radix.sql');
+    if (!fs_1.default.existsSync(sqlPath)) {
+        console.warn(`SQL file not found at ${sqlPath}, skipping DB initialization.`);
+        return;
+    }
+    const rawSql = fs_1.default.readFileSync(sqlPath, 'utf8');
+    const schemaSql = normalizeSchemaSql(stripSeedData(rawSql), process.env.DB_NAME || 'radix');
+    const databaseName = process.env.DB_NAME || 'radix';
+    const connectionConfig = {
+        host: process.env.DB_HOST || '127.0.0.1',
+        user: process.env.DB_USER,
+        password: process.env.DB_PASSWORD,
+        port: Number(process.env.DB_PORT) || 3306,
+        multipleStatements: true,
+        connectTimeout: 5000
+    };
+    let conn;
+    try {
+        conn = await promise_1.default.createConnection(connectionConfig);
+        const [rows] = await conn.query('SELECT SCHEMA_NAME FROM INFORMATION_SCHEMA.SCHEMATA WHERE SCHEMA_NAME = ?', [databaseName]);
+        if (rows.length > 0) {
+            const dbConn = await promise_1.default.createConnection({ ...connectionConfig, database: databaseName });
+            try {
+                await ensureSchemaMarker(dbConn, databaseName);
+                console.log(`Database "${databaseName}" already exists. Schema marker is ready.`);
+                const createTables = extractCreateTableStatements(schemaSql);
+                for (const tbl of createTables) {
+                    const [trows] = await dbConn.query('SELECT TABLE_NAME FROM INFORMATION_SCHEMA.TABLES WHERE TABLE_SCHEMA = ? AND TABLE_NAME = ?', [databaseName, tbl.name]);
+                    if (!trows || (Array.isArray(trows) && trows.length === 0)) {
+                        console.log(`Creating missing table: ${tbl.name}`);
+                        await dbConn.query(tbl.statement);
+                    }
+                }
+                await seedDefaultContent(dbConn, databaseName);
+                console.log(`Database "${databaseName}" checked and missing tables created.`);
+            }
+            finally {
+                await dbConn.end();
+            }
+            return;
+        }
+        console.log(`Database "${databaseName}" not found. Creating empty schema from ${sqlPath}`);
+        await conn.query(schemaSql);
+        await ensureSchemaMarker(conn, databaseName);
+        const dbConn = await promise_1.default.createConnection({ ...connectionConfig, database: databaseName });
+        try {
+            await seedDefaultContent(dbConn, databaseName);
+        }
+        finally {
+            await dbConn.end();
+        }
+        console.log('Database initialization finished.');
+    }
+    catch (err) {
+        console.error('Failed to initialize database:', err);
+    }
+    finally {
+        if (conn) {
+            try {
+                await conn.end();
+            }
+            catch (e) { /* ignore */ }
+        }
+    }
+}

package/dist/middleware/auth.js

@@ -0,0 +1,48 @@
+"use strict";
+/**************************************************************************************************
+* RadixCMS
+*
+* DESCRIPTION: authentication and role-based access middleware.
+*
+* Copyright (C) 2026 Ultra Spark Software <salve@ultraspark.net>
+* SPDX-License-Identifier: GPL-3.0-or-later
+**************************************************************************************************/
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ROLE_HIERARCHY = void 0;
+exports.requireRole = requireRole;
+exports.ROLE_HIERARCHY = [
+    'Unregistered',
+    'Registered',
+    'Editor',
+    'Manager',
+    'Administrator'
+];
+/*
+* requireRole
+*
+* PURPOSE:
+* Creates middleware that permits requests only when the signed-in user's role
+* meets or exceeds the required role.
+*
+* PARAMETERS:
+* requiredRole (UserRole): Minimum role required to access the route.
+*
+* RETURNS:
+* Returns Express middleware that calls next(), redirects to login, or sends
+* an HTTP 403 response.
+*/
+function requireRole(requiredRole) {
+    return (req, res, next) => {
+        const userRole = req.session?.user?.role || 'Unregistered';
+        const userLevel = exports.ROLE_HIERARCHY.indexOf(userRole);
+        const requiredLevel = exports.ROLE_HIERARCHY.indexOf(requiredRole);
+        if (userLevel >= requiredLevel) {
+            return next();
+        }
+        if (userLevel === 0) {
+            res.redirect('/admin/login');
+            return;
+        }
+        res.status(403).send('Forbidden: Insufficient privileges.');
+    };
+}

package/dist/plugins/my-seo-plugin/index.js

@@ -0,0 +1,29 @@
+"use strict";
+/**************************************************************************************************
+* RadixCMS
+*
+* DESCRIPTION: example SEO plugin and plugin lifecycle handlers.
+*
+* Copyright (C) 2026 Ultra Spark Software <salve@ultraspark.net>
+* SPDX-License-Identifier: GPL-3.0-or-later
+**************************************************************************************************/
+Object.defineProperty(exports, "__esModule", { value: true });
+const seoPlugin = {
+    name: 'SEO Meta Generator',
+    version: '1.0.0',
+    init: (ctx) => {
+        // 1. Transform page content before rendering
+        ctx.registerFilter('page:content', (content) => {
+            return `${content}\n<!-- SEO Engine Checked -->`;
+        });
+        // 2. Add an event listener on page creation
+        ctx.registerHook('page:created', (pageData) => {
+            console.log(`[SEO Plugin]: Generating sitemap entry for ${pageData.slug}...`);
+        });
+        // 3. Add custom plugin routes to Express
+        ctx.router.get('/admin/seo-settings', (req, res) => {
+            res.send('SEO Settings Dashboard');
+        });
+    }
+};
+exports.default = seoPlugin;