radix-cms 0.1.0 → 1.0.0

package/dist/routes/index.js

@@ -0,0 +1,218 @@
+"use strict";
+/**************************************************************************************************
+* RadixCMS
+*
+* DESCRIPTION: public page routing and theme rendering.
+*
+* 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 });
+const express_1 = require("express");
+const path_1 = __importDefault(require("path"));
+const fs_1 = __importDefault(require("fs"));
+const ejs_1 = __importDefault(require("ejs"));
+const db_1 = __importDefault(require("../config/db")); // Adjust path if your database module lives elsewhere
+const router = (0, express_1.Router)();
+// Hierarchy mapping for page access checks
+const ROLE_HIERARCHY = {
+    'Administrator': 5,
+    'Manager': 4,
+    'Editor': 3,
+    'Registered': 2,
+    'Unregistered': 1
+};
+/*
+* resolveThemePath
+*
+* PURPOSE:
+* Resolves a theme directory or legacy top-level theme file and falls back to
+* the default theme when the requested template is unavailable.
+*
+* PARAMETERS:
+* templateName (string): Requested theme or template name.
+*
+* RETURNS:
+* Returns the EJS view path and the selected theme name.
+*/
+function resolveThemePath(templateName) {
+    const sanitizedName = templateName?.trim().toLowerCase().replace(/[^a-z0-9_-]/g, '') || 'default';
+    const themesDir = path_1.default.join(__dirname, '../../views/themes');
+    const themeDirectory = path_1.default.join(themesDir, sanitizedName);
+    const themeFile = path_1.default.join(themesDir, `${sanitizedName}.ejs`);
+    if (fs_1.default.existsSync(path_1.default.join(themeDirectory, 'index.ejs'))) {
+        return {
+            view: `themes/${sanitizedName}/index`,
+            currentTheme: sanitizedName
+        };
+    }
+    if (fs_1.default.existsSync(themeFile)) {
+        return {
+            view: `themes/${sanitizedName}`,
+            currentTheme: sanitizedName
+        };
+    }
+    return {
+        view: 'themes/default/index',
+        currentTheme: 'default'
+    };
+}
+/*
+* getStaticPageTheme
+*
+* PURPOSE:
+* Reads an optional theme directive from a static EJS page.
+*
+* PARAMETERS:
+* staticPageSource (string): Static page source to inspect.
+*
+* RETURNS:
+* Returns the requested theme name, or undefined when no directive exists.
+*/
+function getStaticPageTheme(staticPageSource) {
+    const directive = staticPageSource.match(/<%#\s*(?:theme|layout)\s*:\s*([a-z0-9_-]+)\s*%>/i);
+    return directive?.[1];
+}
+/*
+* getStaticPageMinimumRole
+*
+* PURPOSE:
+* Reads and normalizes the minimum role directive from a static EJS page.
+*
+* PARAMETERS:
+* staticPageSource (string): Static page source to inspect.
+*
+* RETURNS:
+* Returns the minimum role or Unregistered when no directive exists.
+*/
+function getStaticPageMinimumRole(staticPageSource) {
+    const directive = staticPageSource.match(/<%#\s*minRole\s*:\s*(Administrator|Manager|Editor|Registered|Unregistered)\s*%>/i);
+    const role = directive?.[1];
+    return Object.keys(ROLE_HIERARCHY).find(roleName => roleName.toLowerCase() === role?.toLowerCase()) || 'Unregistered';
+}
+/*
+* renderPageBySlug
+*
+* PURPOSE:
+* Loads a page by slug, checks publication and role restrictions, and renders
+* the selected static or database-backed theme.
+*
+* PARAMETERS:
+* slug (string): Page slug used for lookup.
+* req (Request): Express request containing session information.
+* res (Response): Express response used to render or redirect.
+*
+* RETURNS:
+* Returns a promise that resolves after the response has been handled.
+*/
+async function renderPageBySlug(slug, req, res) {
+    try {
+        const [pages] = await db_1.default.execute('SELECT * FROM pages WHERE slug = ?', [slug]);
+        const page = pages[0];
+        const user = req.session?.user;
+        // Static page files provide content, while a matching DB row can select its theme.
+        const staticPagePath = path_1.default.join(__dirname, '../../views/pages', `${slug}.ejs`);
+        if (fs_1.default.existsSync(staticPagePath)) {
+            const staticPageSource = await fs_1.default.promises.readFile(staticPagePath, 'utf8');
+            const userRole = user?.role || 'Unregistered';
+            const requiredRole = getStaticPageMinimumRole(staticPageSource);
+            const userLevel = ROLE_HIERARCHY[userRole] || ROLE_HIERARCHY['Unregistered'];
+            const requiredLevel = ROLE_HIERARCHY[requiredRole] || ROLE_HIERARCHY['Unregistered'];
+            if (userLevel < requiredLevel) {
+                if (!user) {
+                    res.redirect(`/admin/login?redirect=/${slug}`);
+                }
+                else {
+                    res.status(403).render('defaults/403', {
+                        message: 'Insufficient permissions to view this page.'
+                    });
+                }
+                return;
+            }
+            const content = await ejs_1.default.renderFile(staticPagePath, {
+                title: page?.title || slug.charAt(0).toUpperCase() + slug.slice(1),
+                page,
+                user
+            });
+            const staticTheme = getStaticPageTheme(staticPageSource);
+            const { view: themeView, currentTheme } = resolveThemePath(staticTheme || page?.template_name);
+            res.render(themeView, {
+                ...page,
+                page,
+                user,
+                currentTheme,
+                title: page?.title || slug.charAt(0).toUpperCase() + slug.slice(1),
+                content,
+                siteName: process.env.APP_NAME || 'Radix',
+                appVersion: process.env.APP_VERSION || '0.11.0'
+            });
+            return;
+        }
+        if (pages.length === 0) {
+            res.status(404).render('defaults/404');
+            return;
+        }
+        const userRole = user ? user.role : 'Unregistered';
+        // 1. Status & Scheduled Publish Check
+        const isPublished = page.status === 'Published';
+        const isPastPublishDate = new Date(page.publish_at) <= new Date();
+        const isStaff = (ROLE_HIERARCHY[userRole] || 1) >= ROLE_HIERARCHY['Editor'];
+        if ((!isPublished || !isPastPublishDate) && !isStaff) {
+            res.status(404).render('defaults/404');
+            return;
+        }
+        // 2. Minimum Role Access Verification
+        const requiredLevel = ROLE_HIERARCHY[page.min_role] || 1;
+        const userLevel = ROLE_HIERARCHY[userRole] || 1;
+        if (userLevel < requiredLevel) {
+            if (!user) {
+                res.redirect(`/admin/login?redirect=/${slug}`);
+            }
+            else {
+                res.status(403).render('defaults/403', {
+                    message: 'Insufficient permissions to view this page.'
+                });
+            }
+            return;
+        }
+        // 3. Resolve Dynamic Theme Template Path
+        const { view: themeView, currentTheme } = resolveThemePath(page.template_name);
+        // 4. Render Page
+        res.render(themeView, {
+            ...page,
+            page,
+            user,
+            currentTheme,
+            title: page.title,
+            content: page.content || '',
+            siteName: process.env.APP_NAME || 'Radix',
+            appVersion: process.env.APP_VERSION || '0.11.0'
+        });
+    }
+    catch (err) {
+        console.error(`[Radix Public Route Error - /${slug}]:`, err);
+        res.status(500).render('defaults/500');
+    }
+}
+// GET / - Render Homepage (slug: 'home')
+router.get('/', async (req, res) => {
+    await renderPageBySlug('home', req, res);
+});
+// GET /:slug - Dynamic Public Catch-All Route
+router.get('/:slug', async (req, res) => {
+    const slug = req.params.slug;
+    if (!slug) {
+        res.status(404).render('defaults/404');
+        return;
+    }
+    // Skip reserved routes / static assets if mounted at app root
+    const reservedSlugs = ['admin', 'uploads', 'favicon.ico', 'css', 'js'];
+    if (reservedSlugs.includes(slug)) {
+        return;
+    }
+    await renderPageBySlug(slug, req, res);
+});
+exports.default = router;

package/dist/sql/radix.sql

@@ -0,0 +1,118 @@
+/*
+SQLyog Community v13.2.1 (64 bit)
+MySQL - 10.9.1-MariaDB : Database - radix
+*********************************************************************
+*/
+
+/*!40101 SET NAMES utf8 */;
+
+/*!40101 SET SQL_MODE=''*/;
+
+/*!40014 SET @OLD_UNIQUE_CHECKS=@@UNIQUE_CHECKS, UNIQUE_CHECKS=0 */;
+/*!40014 SET @OLD_FOREIGN_KEY_CHECKS=@@FOREIGN_KEY_CHECKS, FOREIGN_KEY_CHECKS=0 */;
+/*!40101 SET @OLD_SQL_MODE=@@SQL_MODE, SQL_MODE='NO_AUTO_VALUE_ON_ZERO' */;
+/*!40111 SET @OLD_SQL_NOTES=@@SQL_NOTES, SQL_NOTES=0 */;
+CREATE DATABASE /*!32312 IF NOT EXISTS*/`radix` /*!40100 DEFAULT CHARACTER SET latin1 */;
+
+USE `radix`;
+
+/*Table structure for table `pages` */
+
+DROP TABLE IF EXISTS `pages`;
+
+CREATE TABLE `pages` (
+  `id` int(11) NOT NULL AUTO_INCREMENT,
+  `title` varchar(255) NOT NULL,
+  `slug` varchar(255) NOT NULL,
+  `content` text NOT NULL,
+  `template_name` varchar(50) DEFAULT 'default',
+  `created_at` timestamp NOT NULL DEFAULT current_timestamp(),
+  `status` enum('Published','Pending Review','Draft','Archived','Deleted') NOT NULL DEFAULT 'Draft',
+  `min_role` enum('Administrator','Manager','Editor','Registered','Unregistered') NOT NULL DEFAULT 'Unregistered',
+  `publish_at` datetime NOT NULL DEFAULT current_timestamp(),
+  PRIMARY KEY (`id`),
+  UNIQUE KEY `slug` (`slug`)
+) ENGINE=InnoDB AUTO_INCREMENT=8 DEFAULT CHARSET=latin1;
+
+/*Data for the table `pages` */
+
+insert  into `pages`(`id`,`title`,`slug`,`content`,`template_name`,`created_at`,`status`,`min_role`,`publish_at`) values 
+(1,'Welcome Home','home','<h1>Hello World!</h1><p>Welcome to my lightweight Node.js CMS.</p>','default','2026-06-26 15:16:12','Published','Unregistered','2026-08-06 15:45:00'),
+(2,'About Us','about','<h1>About Our System</h1>\r\n<p>This page is completely dynamic.</p>\r\n<h2>This is a test.</h2>','default','2026-06-26 15:16:12','Published','Unregistered','2026-08-05 17:27:00');
+
+/*Table structure for table `plugins` */
+
+DROP TABLE IF EXISTS `plugins`;
+
+CREATE TABLE `plugins` (
+  `id` int(11) NOT NULL AUTO_INCREMENT,
+  `folder_name` varchar(150) NOT NULL,
+  `is_active` tinyint(1) DEFAULT 0,
+  `updated_at` timestamp NOT NULL DEFAULT current_timestamp() ON UPDATE current_timestamp(),
+  PRIMARY KEY (`id`),
+  UNIQUE KEY `folder_name` (`folder_name`)
+) ENGINE=InnoDB DEFAULT CHARSET=latin1;
+
+/*Data for the table `plugins` */
+
+/*Table structure for table `schema_meta` */
+
+DROP TABLE IF EXISTS `schema_meta`;
+
+CREATE TABLE `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;
+
+/*Data for the table `schema_meta` */
+
+insert  into `schema_meta`(`key_name`,`value_text`,`updated_at`) values 
+('db_initialized','1','2026-08-27 08:47:08'),
+('schema_version','1.0.0','2026-08-27 08:47:08');
+
+/*Table structure for table `settings` */
+
+DROP TABLE IF EXISTS `settings`;
+
+CREATE TABLE `settings` (
+  `setting_key` varchar(100) NOT NULL,
+  `setting_value` text DEFAULT NULL,
+  PRIMARY KEY (`setting_key`)
+) ENGINE=InnoDB DEFAULT CHARSET=latin1;
+
+/*Data for the table `settings` */
+
+insert  into `settings`(`setting_key`,`setting_value`) values 
+('app_name','Radix'),
+('app_version','0.11.0'),
+('mail_from','noreply-bc@astleygilbert.com'),
+('mail_host','192.168.11.10'),
+('mail_pass',''),
+('mail_port','25'),
+('mail_secure','0'),
+('mail_user',''),
+('site_logo','');
+
+/*Table structure for table `users` */
+
+DROP TABLE IF EXISTS `users`;
+
+CREATE TABLE `users` (
+  `id` int(11) NOT NULL AUTO_INCREMENT,
+  `username` varchar(100) NOT NULL,
+  `password` varchar(255) DEFAULT NULL,
+  `full_name` varchar(255) DEFAULT NULL,
+  `password_hash` varchar(255) NOT NULL,
+  `email` varchar(255) DEFAULT NULL,
+  `role` enum('Administrator','Manager','Editor','Registered','Unregistered') NOT NULL DEFAULT 'Registered',
+  `created_at` timestamp NOT NULL DEFAULT current_timestamp(),
+  PRIMARY KEY (`id`),
+  UNIQUE KEY `username` (`username`)
+) ENGINE=InnoDB AUTO_INCREMENT=3 DEFAULT CHARSET=latin1;
+
+/*!40101 SET SQL_MODE=@OLD_SQL_MODE */;
+/*!40014 SET FOREIGN_KEY_CHECKS=@OLD_FOREIGN_KEY_CHECKS */;
+/*!40014 SET UNIQUE_CHECKS=@OLD_UNIQUE_CHECKS */;
+/*!40111 SET SQL_NOTES=@OLD_SQL_NOTES */;

package/dist/types/plugin.js

@@ -0,0 +1,10 @@
+"use strict";
+/**************************************************************************************************
+* RadixCMS
+*
+* DESCRIPTION: plugin interfaces and extension contracts.
+*
+* Copyright (C) 2026 Ultra Spark Software <salve@ultraspark.net>
+* SPDX-License-Identifier: GPL-3.0-or-later
+**************************************************************************************************/
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/utils/PluginManager.js

@@ -0,0 +1,112 @@
+"use strict";
+/**************************************************************************************************
+* RadixCMS
+*
+* DESCRIPTION: plugin discovery, loading, and lifecycle management.
+*
+* Copyright (C) 2026 Ultra Spark Software <salve@ultraspark.net>
+* SPDX-License-Identifier: GPL-3.0-or-later
+**************************************************************************************************/
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.pluginManager = exports.PluginManager = void 0;
+const fs_1 = __importDefault(require("fs"));
+const path_1 = __importDefault(require("path"));
+const db_1 = __importDefault(require("../config/db"));
+class PluginManager {
+    hooks = new Map();
+    filters = new Map();
+    // Register an Action Listener
+    registerHook(event, callback) {
+        if (!this.hooks.has(event))
+            this.hooks.set(event, []);
+        this.hooks.get(event).push(callback);
+    }
+    // Trigger an Action
+    async triggerHook(event, payload) {
+        const callbacks = this.hooks.get(event) || [];
+        for (const cb of callbacks) {
+            await cb(payload);
+        }
+    }
+    // Register a Filter
+    registerFilter(filterName, callback) {
+        if (!this.filters.has(filterName))
+            this.filters.set(filterName, []);
+        this.filters.get(filterName).push(callback);
+    }
+    // Apply Filters to Data sequentially
+    async applyFilter(filterName, initialData) {
+        const callbacks = this.filters.get(filterName) || [];
+        let currentData = initialData;
+        for (const cb of callbacks) {
+            currentData = await cb(currentData);
+        }
+        return currentData;
+    }
+    // Scan and Load Plugins
+    async loadPlugins(router) {
+        const pluginsDir = path_1.default.join(__dirname, '../../plugins');
+        if (!fs_1.default.existsSync(pluginsDir))
+            return;
+        const folders = fs_1.default.readdirSync(pluginsDir);
+        for (const folder of folders) {
+            const pluginPath = path_1.default.join(pluginsDir, folder, 'index.ts');
+            if (fs_1.default.existsSync(pluginPath)) {
+                try {
+                    // Dynamic import for Node/TypeScript
+                    const pluginModule = await Promise.resolve(`${pluginPath}`).then(s => __importStar(require(s)));
+                    const plugin = pluginModule.default;
+                    const ctx = {
+                        router,
+                        registerHook: this.registerHook.bind(this),
+                        registerFilter: this.registerFilter.bind(this),
+                        db: db_1.default
+                    };
+                    await plugin.init(ctx);
+                    console.log(`[Radix Plugin Loaded]: ${plugin.name} v${plugin.version}`);
+                }
+                catch (err) {
+                    console.error(`[Radix Plugin Error] Failed to load ${folder}:`, err);
+                }
+            }
+        }
+    }
+}
+exports.PluginManager = PluginManager;
+exports.pluginManager = new PluginManager();

package/dist/utils/settings.js

@@ -0,0 +1,80 @@
+"use strict";
+/**************************************************************************************************
+* RadixCMS
+*
+* DESCRIPTION: application settings retrieval and cache management.
+*
+* 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.getSettings = getSettings;
+exports.getSetting = getSetting;
+exports.clearSettingsCache = clearSettingsCache;
+const db_1 = __importDefault(require("../config/db"));
+let cachedSettings = null;
+/*
+* getSettings
+*
+* PURPOSE:
+* Fetches all global site settings and caches them as a key-value object.
+*
+* PARAMETERS:
+* forceRefresh (boolean): Reloads settings from the database when true.
+*
+* RETURNS:
+* Returns a promise containing the settings keyed by setting name.
+*/
+async function getSettings(forceRefresh = false) {
+    if (cachedSettings && !forceRefresh) {
+        return cachedSettings;
+    }
+    try {
+        const [rows] = await db_1.default.execute('SELECT * FROM settings');
+        const settings = {};
+        rows.forEach(row => {
+            settings[row.setting_key] = row.setting_value || '';
+        });
+        cachedSettings = settings;
+        return settings;
+    }
+    catch (err) {
+        console.error('[Radix Settings Helper Error]:', err);
+        return cachedSettings || {};
+    }
+}
+/*
+* getSetting
+*
+* PURPOSE:
+* Fetches one global setting by key and supplies a fallback when it is absent.
+*
+* PARAMETERS:
+* key (string): Setting name to retrieve.
+* defaultValue (string): Value returned when the setting does not exist.
+*
+* RETURNS:
+* Returns a promise containing the setting value.
+*/
+async function getSetting(key, defaultValue = '') {
+    const settings = await getSettings();
+    return settings[key] !== undefined ? settings[key] : defaultValue;
+}
+/*
+* clearSettingsCache
+*
+* PURPOSE:
+* Invalidates the in-memory settings cache after settings are changed.
+*
+* PARAMETERS:
+* None.
+*
+* RETURNS:
+* Returns void.
+*/
+function clearSettingsCache() {
+    cachedSettings = null;
+}

package/dist/utils/themeScanner.js

@@ -0,0 +1,33 @@
+"use strict";
+/**************************************************************************************************
+* RadixCMS
+*
+* DESCRIPTION: discovery of available public themes.
+*
+* 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.getAvailableTemplates = getAvailableTemplates;
+const fs_1 = __importDefault(require("fs"));
+const path_1 = __importDefault(require("path"));
+function getAvailableTemplates() {
+    // Adjust relative path based on compiled structure in /dist vs /src
+    const themesDir = path_1.default.join(__dirname, '../../views/themes');
+    if (!fs_1.default.existsSync(themesDir)) {
+        return ['default'];
+    }
+    // Read all folders and files inside /views/themes
+    const entries = fs_1.default.readdirSync(themesDir, { withFileTypes: true });
+    const themes = entries
+        .filter(entry => entry.isDirectory() || entry.name.endsWith('.ejs'))
+        .map(entry => entry.name.replace('.ejs', '').toLowerCase());
+    // Ensure 'default' is always in the list
+    if (!themes.includes('default')) {
+        themes.unshift('default');
+    }
+    return Array.from(new Set(themes));
+}

package/dist/utils/versionCheck.js

@@ -0,0 +1,74 @@
+"use strict";
+/**************************************************************************************************
+* RadixCMS
+*
+* DESCRIPTION: application version lookup and update checking.
+*
+* Copyright (C) 2026 Ultra Spark Software <salve@ultraspark.net>
+* SPDX-License-Identifier: GPL-3.0-or-later
+**************************************************************************************************/
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.checkForUpdates = checkForUpdates;
+const settings_1 = require("./settings");
+/*
+* checkForUpdates
+*
+* PURPOSE:
+* Retrieves the configured remote version and compares it with the installed
+* application version.
+*
+* PARAMETERS:
+* None.
+*
+* RETURNS:
+* Returns a promise containing version details, update status, and any error.
+*/
+async function checkForUpdates() {
+    // Fetch the version setting asynchronously from DB (cached after 1st run)
+    const settings = await (0, settings_1.getSettings)();
+    // const currentVersion = settings['app_version'] || '0.0.0';
+    const currentVersion = process.env.APP_VERSION || '0.0.0';
+    const ENDPOINT = settings['update_url'] || 'https://vault.ultraspark.net/radix/version.json';
+    try {
+        const response = await fetch(ENDPOINT, { signal: AbortSignal.timeout(5000) });
+        if (!response.ok) {
+            throw new Error(`Server returned status code ${response.status}`);
+        }
+        const data = (await response.json());
+        const app = data.Application;
+        const remoteVersion = `${app.MajorVersion}.${app.MinorVersion}.${app.UpdateVersion}`;
+        const hasUpdate = compareSemVer(remoteVersion, currentVersion) > 0;
+        return {
+            currentVersion,
+            remoteVersion,
+            hasUpdate,
+            details: app,
+            error: null
+        };
+    }
+    catch (err) {
+        return {
+            currentVersion,
+            remoteVersion: null,
+            hasUpdate: false,
+            details: null,
+            error: `Failed to retrieve update status: ${err.message}`
+        };
+    }
+}
+/*
+* compareSemVer
+*
+* PURPOSE:
+* Compares two semantic version strings using numeric ordering.
+*
+* PARAMETERS:
+* v1 (string): First version to compare.
+* v2 (string): Second version to compare.
+*
+* RETURNS:
+* Returns a negative number, zero, or positive number according to the comparison.
+*/
+function compareSemVer(v1, v2) {
+    return v1.localeCompare(v2, undefined, { numeric: true, sensitivity: 'base' });
+}