@bytespell/shella 0.1.18 → 0.2.0

package/dist/src/api.js

@@ -0,0 +1,201 @@
+import express from 'express';
+import { logger } from './logger.js';
+import { pluginManager } from './plugin-manager.js';
+import { registry } from './registry.js';
+import { DAEMON_PORT } from './types.js';
+const app = express();
+app.use(express.json());
+// CORS middleware - allow all origins
+app.use((_req, res, next) => {
+    res.setHeader('Access-Control-Allow-Origin', '*');
+    res.setHeader('Access-Control-Allow-Methods', 'GET, POST, PUT, DELETE, OPTIONS');
+    res.setHeader('Access-Control-Allow-Headers', 'Content-Type, Authorization');
+    next();
+});
+// Handle preflight requests
+app.options('*', (_req, res) => {
+    res.sendStatus(204);
+});
+// Request logging middleware
+app.use((req, _res, next) => {
+    logger.debug({ method: req.method, path: req.path }, 'API request');
+    next();
+});
+// Health check
+app.get('/health', (_req, res) => {
+    res.json({
+        status: 'ok',
+        pid: process.pid,
+        uptime: process.uptime(),
+    });
+});
+// List all plugins
+app.get('/plugins', (_req, res) => {
+    const plugins = pluginManager.getAllPlugins();
+    res.json({ plugins });
+});
+// Get single plugin
+app.get('/plugins/:name', (req, res) => {
+    const { name } = req.params;
+    const plugin = pluginManager.getPlugin(name ?? '');
+    if (plugin === undefined) {
+        res.status(404).json({ error: 'Plugin not found' });
+        return;
+    }
+    res.json(plugin);
+});
+// Start a new plugin instance
+// Dev mode is default when devCommand is configured. Use ?dev=false to force production mode.
+app.post('/plugins/:name/start', (req, res) => {
+    const { name } = req.params;
+    // Dev mode defaults to true, can be disabled with ?dev=false
+    const devMode = req.query.dev !== 'false';
+    pluginManager
+        .startPlugin(name ?? '', devMode)
+        .then((instance) => {
+        if (instance !== null) {
+            res.json({ success: true, instance });
+        }
+        else {
+            const error = devMode
+                ? 'Failed to start plugin in dev mode (check devCommand in package.json)'
+                : 'Failed to start plugin instance';
+            res.status(500).json({ success: false, error });
+        }
+    })
+        .catch((err) => {
+        logger.error({ err, plugin: name, devMode }, 'Error starting plugin');
+        res.status(500).json({ success: false, error: 'Internal error' });
+    });
+});
+// Stop a specific plugin instance
+app.post('/plugins/:name/instances/:instanceId/stop', (req, res) => {
+    const { name, instanceId } = req.params;
+    pluginManager
+        .stopInstance(name ?? '', instanceId ?? '')
+        .then((success) => {
+        if (success) {
+            res.json({ success: true });
+        }
+        else {
+            res.status(404).json({ success: false, error: 'Instance not found' });
+        }
+    })
+        .catch((err) => {
+        logger.error({ err, plugin: name, instanceId }, 'Error stopping instance');
+        res.status(500).json({ success: false, error: 'Internal error' });
+    });
+});
+// Get registry data
+app.get('/registry', (_req, res) => {
+    res.json(registry.getData());
+});
+// Layout validation helpers
+function isValidPanelNode(value) {
+    if (typeof value !== 'object' || value === null) {
+        return false;
+    }
+    const node = value;
+    if (typeof node.id !== 'string') {
+        return false;
+    }
+    if (node.type === 'leaf') {
+        // Optional pluginName and instanceId must be strings if present
+        if (node.pluginName !== undefined && typeof node.pluginName !== 'string') {
+            return false;
+        }
+        if (node.instanceId !== undefined && typeof node.instanceId !== 'string') {
+            return false;
+        }
+        return true;
+    }
+    if (node.type === 'split') {
+        if (node.direction !== 'horizontal' && node.direction !== 'vertical') {
+            return false;
+        }
+        if (!Array.isArray(node.children) || node.children.length !== 2) {
+            return false;
+        }
+        if (!Array.isArray(node.sizes) || node.sizes.length !== 2) {
+            return false;
+        }
+        if (typeof node.sizes[0] !== 'number' ||
+            typeof node.sizes[1] !== 'number' ||
+            !Number.isFinite(node.sizes[0]) ||
+            !Number.isFinite(node.sizes[1])) {
+            return false;
+        }
+        // Recursively validate children
+        return isValidPanelNode(node.children[0]) && isValidPanelNode(node.children[1]);
+    }
+    return false;
+}
+function isValidLayout(value) {
+    if (typeof value !== 'object' || value === null) {
+        return false;
+    }
+    const layout = value;
+    if (layout.version !== 1) {
+        return false;
+    }
+    if (layout.root === null) {
+        return true;
+    }
+    return isValidPanelNode(layout.root);
+}
+// Get layout
+app.get('/layout', (_req, res) => {
+    res.json({ layout: registry.getLayout() });
+});
+// Update layout
+app.put('/layout', (req, res) => {
+    const body = req.body;
+    if (!isValidLayout(body.layout)) {
+        res.status(400).json({ error: 'Invalid layout' });
+        return;
+    }
+    registry.setLayout(body.layout);
+    registry
+        .save()
+        .then(() => {
+        res.json({ success: true });
+    })
+        .catch((err) => {
+        logger.error({ err }, 'Error saving layout');
+        res.status(500).json({ success: false, error: 'Failed to save layout' });
+    });
+});
+// Error handling middleware
+app.use((err, _req, res, _next) => {
+    logger.error({ err }, 'Unhandled API error');
+    res.status(500).json({ error: 'Internal server error' });
+});
+let server = null;
+export function startApi() {
+    return new Promise((resolve, reject) => {
+        server = app.listen(DAEMON_PORT, '127.0.0.1', () => {
+            logger.info({ port: DAEMON_PORT }, 'API server started');
+            resolve();
+        });
+        server.on('error', (err) => {
+            if (err.code === 'EADDRINUSE') {
+                logger.error({ port: DAEMON_PORT }, 'Port already in use - daemon may already be running');
+            }
+            reject(err);
+        });
+    });
+}
+export function stopApi() {
+    return new Promise((resolve) => {
+        if (server !== null) {
+            server.close(() => {
+                logger.info('API server stopped');
+                resolve();
+            });
+        }
+        else {
+            resolve();
+        }
+    });
+}
+//# sourceMappingURL=api.js.map

package/dist/src/api.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"api.js","sourceRoot":"","sources":["../../src/api.ts"],"names":[],"mappings":"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"}

package/dist/src/index.d.ts

@@ -0,0 +1,2 @@
+export declare function start(): Promise<void>;
+//# sourceMappingURL=index.d.ts.map

package/dist/src/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAwDA,wBAAsB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAiC3C"}

package/dist/src/index.js

@@ -0,0 +1,70 @@
+import { logger } from './logger.js';
+import { startApi, stopApi } from './api.js';
+import { pluginManager } from './plugin-manager.js';
+import { pluginWatcher } from './watcher.js';
+import { registry } from './registry.js';
+import { portAllocator } from './port-allocator.js';
+import { DAEMON_PORT } from './types.js';
+let isShuttingDown = false;
+async function checkExistingDaemon() {
+    try {
+        const response = await fetch(`http://127.0.0.1:${DAEMON_PORT}/health`);
+        return response.ok;
+    }
+    catch {
+        return false;
+    }
+}
+async function shutdown(signal) {
+    if (isShuttingDown) {
+        return;
+    }
+    isShuttingDown = true;
+    logger.info({ signal }, 'Shutting down daemon');
+    // Stop watcher first to prevent new plugins from starting
+    pluginWatcher.stop();
+    // Kill all plugins synchronously first to ensure they're terminated
+    pluginManager.killAllPluginsSync();
+    // Then wait for graceful shutdown
+    await pluginManager.stopAllPlugins();
+    // Stop API server
+    await stopApi();
+    // Clean up registry
+    await registry.cleanup();
+    // Clear port allocator
+    portAllocator.clear();
+    logger.info('Daemon shutdown complete');
+    process.exit(0);
+}
+// Synchronous cleanup on exit (fallback)
+process.on('exit', () => {
+    if (!isShuttingDown) {
+        pluginManager.killAllPluginsSync();
+    }
+});
+export async function start() {
+    logger.info({ pid: process.pid }, 'Starting shella-plugin-daemon');
+    // Check if daemon is already running
+    const existingDaemon = await checkExistingDaemon();
+    if (existingDaemon) {
+        logger.error('Daemon is already running');
+        process.exit(1);
+    }
+    // Ensure directories exist (plugins and state)
+    await registry.ensureDirectories();
+    // Load existing registry (if any)
+    await registry.load();
+    // Start API server
+    await startApi();
+    // Discover and start all plugins
+    await pluginManager.startAllPlugins();
+    // Save registry after startup
+    await registry.save();
+    // Start watching for plugin changes
+    await pluginWatcher.start();
+    // Register shutdown handlers
+    process.on('SIGTERM', () => void shutdown('SIGTERM'));
+    process.on('SIGINT', () => void shutdown('SIGINT'));
+    logger.info('Daemon started successfully');
+}
+//# sourceMappingURL=index.js.map

package/dist/src/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"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"}

package/dist/src/logger.d.ts

@@ -0,0 +1,4 @@
+import pino from 'pino';
+export declare const logger: pino.Logger<never, boolean>;
+export declare function createPluginLogger(pluginName: string): pino.Logger;
+//# sourceMappingURL=logger.d.ts.map

package/dist/src/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../src/logger.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,MAAM,CAAC;AAsBxB,eAAO,MAAM,MAAM,6BAAiB,CAAC;AAErC,wBAAgB,kBAAkB,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC,MAAM,CAElE"}

package/dist/src/logger.js

@@ -0,0 +1,24 @@
+import pino from 'pino';
+const isDev = process.env.NODE_ENV !== 'production';
+const level = process.env.LOG_LEVEL ?? 'info';
+function createLogger() {
+    if (isDev) {
+        return pino({
+            level,
+            transport: {
+                target: 'pino-pretty',
+                options: {
+                    colorize: true,
+                    translateTime: 'SYS:standard',
+                    ignore: 'pid,hostname',
+                },
+            },
+        });
+    }
+    return pino({ level });
+}
+export const logger = createLogger();
+export function createPluginLogger(pluginName) {
+    return logger.child({ plugin: pluginName });
+}
+//# sourceMappingURL=logger.js.map

package/dist/src/logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.js","sourceRoot":"","sources":["../../src/logger.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,MAAM,CAAC;AAExB,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,QAAQ,KAAK,YAAY,CAAC;AACpD,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,SAAS,IAAI,MAAM,CAAC;AAE9C,SAAS,YAAY;IACnB,IAAI,KAAK,EAAE,CAAC;QACV,OAAO,IAAI,CAAC;YACV,KAAK;YACL,SAAS,EAAE;gBACT,MAAM,EAAE,aAAa;gBACrB,OAAO,EAAE;oBACP,QAAQ,EAAE,IAAI;oBACd,aAAa,EAAE,cAAc;oBAC7B,MAAM,EAAE,cAAc;iBACvB;aACF;SACF,CAAC,CAAC;IACL,CAAC;IACD,OAAO,IAAI,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC;AACzB,CAAC;AAED,MAAM,CAAC,MAAM,MAAM,GAAG,YAAY,EAAE,CAAC;AAErC,MAAM,UAAU,kBAAkB,CAAC,UAAkB;IACnD,OAAO,MAAM,CAAC,KAAK,CAAC,EAAE,MAAM,EAAE,UAAU,EAAE,CAAC,CAAC;AAC9C,CAAC"}

package/dist/src/paths.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Directory where plugins are stored
+ * Default: ~/.local/share/shella/plugins
+ * Override: SHELLA_PLUGINS_DIR environment variable
+ */
+export declare const PLUGINS_DIR: string;
+/**
+ * Directory where state files are stored
+ * Default: ~/.local/state/shella
+ */
+export declare const STATE_DIR: string;
+/**
+ * Path to the registry file
+ * Default: ~/.local/state/shella/registry.json
+ */
+export declare const REGISTRY_FILE: string;
+//# sourceMappingURL=paths.d.ts.map

package/dist/src/paths.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"paths.d.ts","sourceRoot":"","sources":["../../src/paths.ts"],"names":[],"mappings":"AAsBA;;;;GAIG;AACH,eAAO,MAAM,WAAW,QAA0E,CAAC;AAEnG;;;GAGG;AACH,eAAO,MAAM,SAAS,QAAmB,CAAC;AAE1C;;;GAGG;AACH,eAAO,MAAM,aAAa,QAAwC,CAAC"}

package/dist/src/paths.js

@@ -0,0 +1,34 @@
+import * as path from 'node:path';
+const HOME = process.env.HOME ?? '';
+/**
+ * XDG Base Directory paths for Shella
+ *
+ * Following the XDG Base Directory Specification:
+ * - XDG_DATA_HOME: User data files (default: ~/.local/share)
+ * - XDG_STATE_HOME: User state data (default: ~/.local/state)
+ *
+ * Plugins directory can be overridden with SHELLA_PLUGINS_DIR env var.
+ */
+// XDG defaults
+const XDG_DATA_HOME = process.env.XDG_DATA_HOME ?? path.join(HOME, '.local', 'share');
+const XDG_STATE_HOME = process.env.XDG_STATE_HOME ?? path.join(HOME, '.local', 'state');
+// Shella directories
+const SHELLA_DATA_DIR = path.join(XDG_DATA_HOME, 'shella');
+const SHELLA_STATE_DIR = path.join(XDG_STATE_HOME, 'shella');
+/**
+ * Directory where plugins are stored
+ * Default: ~/.local/share/shella/plugins
+ * Override: SHELLA_PLUGINS_DIR environment variable
+ */
+export const PLUGINS_DIR = process.env.SHELLA_PLUGINS_DIR ?? path.join(SHELLA_DATA_DIR, 'plugins');
+/**
+ * Directory where state files are stored
+ * Default: ~/.local/state/shella
+ */
+export const STATE_DIR = SHELLA_STATE_DIR;
+/**
+ * Path to the registry file
+ * Default: ~/.local/state/shella/registry.json
+ */
+export const REGISTRY_FILE = path.join(STATE_DIR, 'registry.json');
+//# sourceMappingURL=paths.js.map

package/dist/src/paths.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"paths.js","sourceRoot":"","sources":["../../src/paths.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAElC,MAAM,IAAI,GAAG,OAAO,CAAC,GAAG,CAAC,IAAI,IAAI,EAAE,CAAC;AAEpC;;;;;;;;GAQG;AAEH,eAAe;AACf,MAAM,aAAa,GAAG,OAAO,CAAC,GAAG,CAAC,aAAa,IAAI,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,QAAQ,EAAE,OAAO,CAAC,CAAC;AACtF,MAAM,cAAc,GAAG,OAAO,CAAC,GAAG,CAAC,cAAc,IAAI,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,QAAQ,EAAE,OAAO,CAAC,CAAC;AAExF,qBAAqB;AACrB,MAAM,eAAe,GAAG,IAAI,CAAC,IAAI,CAAC,aAAa,EAAE,QAAQ,CAAC,CAAC;AAC3D,MAAM,gBAAgB,GAAG,IAAI,CAAC,IAAI,CAAC,cAAc,EAAE,QAAQ,CAAC,CAAC;AAE7D;;;;GAIG;AACH,MAAM,CAAC,MAAM,WAAW,GAAG,OAAO,CAAC,GAAG,CAAC,kBAAkB,IAAI,IAAI,CAAC,IAAI,CAAC,eAAe,EAAE,SAAS,CAAC,CAAC;AAEnG;;;GAGG;AACH,MAAM,CAAC,MAAM,SAAS,GAAG,gBAAgB,CAAC;AAE1C;;;GAGG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,eAAe,CAAC,CAAC"}

package/dist/src/plugin-manager.d.ts

@@ -0,0 +1,24 @@
+import type { PluginInfo, PluginInstance } from './types.js';
+export declare class PluginManager {
+    private plugins;
+    discoverPlugins(): Promise<string[]>;
+    private readPackageJson;
+    private needsInstall;
+    private runNpmInstall;
+    private updateInstanceStatus;
+    private ensurePluginExists;
+    startPlugin(name: string, devMode?: boolean): Promise<PluginInstance | null>;
+    private handlePluginExit;
+    stopInstance(name: string, instanceId: string): Promise<boolean>;
+    stopAllInstances(name: string): Promise<void>;
+    getPlugin(name: string): PluginInfo | undefined;
+    getAllPlugins(): PluginInfo[];
+    startAllPlugins(): Promise<void>;
+    stopAllPlugins(): Promise<void>;
+    killAllPluginsSync(): void;
+    handleNewPlugin(name: string): Promise<void>;
+    refreshPluginMetadata(name: string): Promise<void>;
+    handleRemovedPlugin(name: string): Promise<void>;
+}
+export declare const pluginManager: PluginManager;
+//# sourceMappingURL=plugin-manager.d.ts.map

package/dist/src/plugin-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin-manager.d.ts","sourceRoot":"","sources":["../../src/plugin-manager.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAEV,UAAU,EACV,cAAc,EAGf,MAAM,YAAY,CAAC;AAEpB,qBAAa,aAAa;IACxB,OAAO,CAAC,OAAO,CAAyC;IAElD,eAAe,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;YA6B5B,eAAe;YASf,YAAY;IAkB1B,OAAO,CAAC,aAAa;IAkBrB,OAAO,CAAC,oBAAoB;YAuBd,kBAAkB;IAyC1B,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,UAAO,GAAG,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC;IAmH/E,OAAO,CAAC,gBAAgB;IAkClB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAqDhE,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAUnD,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,UAAU,GAAG,SAAS;IAI/C,aAAa,IAAI,UAAU,EAAE;IAIvB,eAAe,IAAI,OAAO,CAAC,IAAI,CAAC;IAShC,cAAc,IAAI,OAAO,CAAC,IAAI,CAAC;IAUrC,kBAAkB,IAAI,IAAI;IAepB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAK5C,qBAAqB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAiClD,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAOvD;AAED,eAAO,MAAM,aAAa,eAAsB,CAAC"}