unitup 0.1.4 → 0.2.0

package/src/runtimes/native.js

@@ -1,14 +1,15 @@
-import path from 'node:path';
 import fs from 'node:fs';
+import path from 'node:path';
 
 export async function createNativeAdapter(opts = {}) {
+  const baseDir = opts.cwd || process.cwd();
   const targetPath = opts.script || opts.command;
 
   if (!targetPath) {
     throw new Error('Native executable path is required.');
   }
 
-  const absPath = path.resolve(process.cwd(), targetPath);
+  const absPath = path.resolve(baseDir, targetPath);
 
   if (!fs.existsSync(absPath)) {
     throw new Error(`Executable file does not exist: ${absPath}`);
@@ -22,9 +23,7 @@ export async function createNativeAdapter(opts = {}) {
   try {
     fs.accessSync(absPath, fs.constants.X_OK);
   } catch {
-    throw new Error(
-      `The executable is not runnable.\n\nRun:\n  chmod +x ${absPath}`
-    );
+    throw new Error(`The executable is not runnable.\n\nRun:\n  chmod +x ${absPath}`);
   }
 
   const scriptArgs = Array.isArray(opts.args) ? opts.args : [];

package/src/runtimes/node.js

@@ -1,13 +1,14 @@
-import path from 'node:path';
 import fs from 'node:fs';
+import path from 'node:path';
 import { findRuntimeExecutable, getBinaryVersion } from './common.js';
 
 export async function createNodeAdapter(opts = {}) {
+  const baseDir = opts.cwd || process.cwd();
   const customPath = opts.command || opts.nodePath;
   let execPath = null;
 
   if (customPath) {
-    const absPath = path.resolve(process.cwd(), customPath);
+    const absPath = path.resolve(baseDir, customPath);
     if (fs.existsSync(absPath)) {
       try {
         fs.accessSync(absPath, fs.constants.X_OK);
@@ -38,7 +39,7 @@ export async function createNodeAdapter(opts = {}) {
   }
 
   const version = await getBinaryVersion(execPath, '-v');
-  const scriptPath = opts.script ? path.resolve(process.cwd(), opts.script) : null;
+  const scriptPath = opts.script ? path.resolve(baseDir, opts.script) : null;
   const runtimeArgs = Array.isArray(opts.runtimeArgs) ? opts.runtimeArgs : [];
   const scriptArgs = Array.isArray(opts.args) ? opts.args : [];
 

package/src/runtimes/php.js

@@ -1,13 +1,14 @@
-import path from 'node:path';
 import fs from 'node:fs';
+import path from 'node:path';
 import { findRuntimeExecutable, getBinaryVersion } from './common.js';
 
 export async function createPhpAdapter(opts = {}) {
+  const baseDir = opts.cwd || process.cwd();
   const customPath = opts.command;
   let execPath = null;
 
   if (customPath) {
-    const absPath = path.resolve(process.cwd(), customPath);
+    const absPath = path.resolve(baseDir, customPath);
     if (fs.existsSync(absPath)) {
       try {
         fs.accessSync(absPath, fs.constants.X_OK);
@@ -27,7 +28,7 @@ export async function createPhpAdapter(opts = {}) {
   }
 
   const version = await getBinaryVersion(execPath, '-v');
-  const scriptPath = opts.script ? path.resolve(process.cwd(), opts.script) : null;
+  const scriptPath = opts.script ? path.resolve(baseDir, opts.script) : null;
   const runtimeArgs = Array.isArray(opts.runtimeArgs) ? opts.runtimeArgs : [];
   const scriptArgs = Array.isArray(opts.args) ? opts.args : [];
 

package/src/runtimes/python.js

@@ -1,13 +1,14 @@
-import path from 'node:path';
 import fs from 'node:fs';
+import path from 'node:path';
 import { findRuntimeExecutable, getBinaryVersion } from './common.js';
 
 export async function createPythonAdapter(opts = {}) {
+  const baseDir = opts.cwd || process.cwd();
   const customPath = opts.command;
   let execPath = null;
 
   if (customPath) {
-    const absPath = path.resolve(process.cwd(), customPath);
+    const absPath = path.resolve(baseDir, customPath);
     if (fs.existsSync(absPath)) {
       try {
         fs.accessSync(absPath, fs.constants.X_OK);
@@ -27,7 +28,7 @@ export async function createPythonAdapter(opts = {}) {
   }
 
   const version = await getBinaryVersion(execPath, '--version');
-  const scriptPath = opts.script ? path.resolve(process.cwd(), opts.script) : null;
+  const scriptPath = opts.script ? path.resolve(baseDir, opts.script) : null;
   const runtimeArgs = Array.isArray(opts.runtimeArgs) ? opts.runtimeArgs : [];
   const scriptArgs = Array.isArray(opts.args) ? opts.args : [];
 

package/src/runtimes/ruby.js

@@ -1,13 +1,14 @@
-import path from 'node:path';
 import fs from 'node:fs';
+import path from 'node:path';
 import { findRuntimeExecutable, getBinaryVersion } from './common.js';
 
 export async function createRubyAdapter(opts = {}) {
+  const baseDir = opts.cwd || process.cwd();
   const customPath = opts.command;
   let execPath = null;
 
   if (customPath) {
-    const absPath = path.resolve(process.cwd(), customPath);
+    const absPath = path.resolve(baseDir, customPath);
     if (fs.existsSync(absPath)) {
       try {
         fs.accessSync(absPath, fs.constants.X_OK);
@@ -27,7 +28,7 @@ export async function createRubyAdapter(opts = {}) {
   }
 
   const version = await getBinaryVersion(execPath, '-v');
-  const scriptPath = opts.script ? path.resolve(process.cwd(), opts.script) : null;
+  const scriptPath = opts.script ? path.resolve(baseDir, opts.script) : null;
   const runtimeArgs = Array.isArray(opts.runtimeArgs) ? opts.runtimeArgs : [];
   const scriptArgs = Array.isArray(opts.args) ? opts.args : [];
 

package/src/runtimes/shell.js

@@ -1,13 +1,14 @@
-import path from 'node:path';
 import fs from 'node:fs';
+import path from 'node:path';
 import { findRuntimeExecutable, getBinaryVersion } from './common.js';
 
 export async function createShellAdapter(opts = {}) {
+  const baseDir = opts.cwd || process.cwd();
   const customPath = opts.command;
   let execPath = null;
 
   if (customPath) {
-    const absPath = path.resolve(process.cwd(), customPath);
+    const absPath = path.resolve(baseDir, customPath);
     if (fs.existsSync(absPath)) {
       try {
         fs.accessSync(absPath, fs.constants.X_OK);
@@ -27,7 +28,7 @@ export async function createShellAdapter(opts = {}) {
   }
 
   const version = await getBinaryVersion(execPath, '--version');
-  const scriptPath = opts.script ? path.resolve(process.cwd(), opts.script) : null;
+  const scriptPath = opts.script ? path.resolve(baseDir, opts.script) : null;
   const runtimeArgs = Array.isArray(opts.runtimeArgs) ? opts.runtimeArgs : [];
   const scriptArgs = Array.isArray(opts.args) ? opts.args : [];
 

package/src/schedule.js

@@ -1,31 +1,31 @@
-import path from 'node:path';
 import fs from 'node:fs';
 import os from 'node:os';
+import path from 'node:path';
+import { detectRuntime, resolveRuntimeConfig } from './runtimes/index.js';
+import { runCommand } from './systemd.js';
 import {
-  sanitizeServiceName,
-  getUnitFilename,
+  deleteScheduleUnitFiles,
+  getTimerPath,
+  getUnitPath,
+  getUserUnitDir,
+  timerFileExists,
+  unitFileExists,
+  writeScheduleUnitFiles
+} from './unit.js';
+import {
+  deleteScheduleMetadata,
+  formatFutureTime,
+  formatRelativeTime,
+  getSchedulesDir,
   getTimerFilename,
+  getUnitFilename,
+  readScheduleMetadata,
   resolveAbsolutePath,
   resolveWorkingDirectory,
-  validateDuration,
-  formatFutureTime,
-  formatRelativeTime,
+  sanitizeServiceName,
   saveScheduleMetadata,
-  readScheduleMetadata,
-  deleteScheduleMetadata,
-  getSchedulesDir
+  validateDuration
 } from './utils.js';
-import {
-  getUserUnitDir,
-  getUnitPath,
-  getTimerPath,
-  timerFileExists,
-  unitFileExists,
-  writeScheduleUnitFiles,
-  deleteScheduleUnitFiles
-} from './unit.js';
-import { runCommand } from './systemd.js';
-import { detectRuntime, resolveRuntimeConfig } from './runtimes/index.js';
 
 /**
  * Validates a systemd calendar expression using systemd-analyze if available.
@@ -53,7 +53,10 @@ export async function validateCalendar(expression) {
     }
     // If systemd-analyze binary is missing
     if (res.code === 127 || (res.stderr && res.stderr.includes('not found'))) {
-      return { valid: true, warning: 'systemd-analyze is not available; calendar expression could not be fully validated by systemd.' };
+      return {
+        valid: true,
+        warning: 'systemd-analyze is not available; calendar expression could not be fully validated by systemd.'
+      };
     }
   } catch (err) {
     if (err.message && err.message.startsWith('Invalid calendar expression')) {
@@ -360,7 +363,7 @@ export async function getScheduleStatus(name) {
   }
 
   // Parse NextElapse timestamp
-  let rawNext = timerProps.NextElapseUSecRealtime || timerProps.NextElapseUSec;
+  const rawNext = timerProps.NextElapseUSecRealtime || timerProps.NextElapseUSec;
   let nextRun = 'n/a';
 
   if (rawNext && rawNext !== '0' && rawNext !== '18446744073709551615') {
@@ -370,7 +373,11 @@ export async function getScheduleStatus(name) {
     } else {
       nextRun = formatFutureTime(rawNext);
     }
-  } else if (timerProps.NextElapseUSecMonotonic && timerProps.NextElapseUSecMonotonic !== '0' && timerProps.NextElapseUSecMonotonic !== '18446744073709551615') {
+  } else if (
+    timerProps.NextElapseUSecMonotonic &&
+    timerProps.NextElapseUSecMonotonic !== '0' &&
+    timerProps.NextElapseUSecMonotonic !== '18446744073709551615'
+  ) {
     const monoNum = Number(timerProps.NextElapseUSecMonotonic);
     if (!isNaN(monoNum) && monoNum > 0) {
       const currentMonoUSec = os.uptime() * 1000000;
@@ -385,7 +392,7 @@ export async function getScheduleStatus(name) {
   }
 
   // Parse LastTrigger timestamp
-  let rawLast = timerProps.LastTriggerUSec;
+  const rawLast = timerProps.LastTriggerUSec;
   let lastRun = 'never';
   if (rawLast && rawLast !== '0' && rawLast !== 'n/a') {
     const num = Number(rawLast);

package/src/service/config.js

@@ -0,0 +1,55 @@
+import fs from 'node:fs';
+import path from 'node:path';
+import {
+  findProjectConfig,
+  getConfigFilepath,
+  getUnitupDir,
+  readGlobalConfig,
+  readProjectConfig,
+  saveGlobalConfig,
+  saveProjectConfig
+} from '../utils.js';
+
+export {
+  findProjectConfig,
+  readProjectConfig,
+  saveProjectConfig,
+  readGlobalConfig,
+  saveGlobalConfig,
+  getConfigFilepath,
+  getUnitupDir
+};
+
+/**
+ * Merges raw CLI options with any found project configuration.
+ *
+ * @param {object} opts
+ * @returns {object} Merged options
+ */
+export function mergeConfigWithOptions(opts = {}) {
+  const targetCwd = opts.cwd ? path.resolve(process.cwd(), opts.cwd) : process.cwd();
+  const configPath = opts.config ? path.resolve(targetCwd, opts.config) : findProjectConfig(targetCwd);
+  const projectCfg = configPath ? readProjectConfig(configPath) : null;
+
+  if (!projectCfg) {
+    return { ...opts, cwd: targetCwd };
+  }
+
+  return {
+    name: opts.name || projectCfg.name,
+    group: opts.group || projectCfg.group || 'default',
+    script: opts.script || projectCfg.script,
+    command: opts.command || projectCfg.command,
+    runtime: opts.runtime || projectCfg.runtime,
+    runtimeArgs: opts.runtimeArgs && opts.runtimeArgs.length > 0 ? opts.runtimeArgs : projectCfg.runtimeArgs || [],
+    args: opts.args && opts.args.length > 0 ? opts.args : projectCfg.args || [],
+    envFile: opts.envFile || projectCfg.envFile,
+    restart: opts.restart && opts.restart !== 'on-failure' ? opts.restart : projectCfg.restart || 'on-failure',
+    memoryHigh: opts.memoryHigh || projectCfg?.resources?.memoryHigh || projectCfg?.memoryHigh || '',
+    memoryMax: opts.memoryMax || projectCfg?.resources?.memoryMax || projectCfg?.memoryMax || '',
+    memorySwapMax: opts.memorySwapMax || projectCfg?.resources?.memorySwapMax || projectCfg?.memorySwapMax || '',
+    ...opts,
+    env: { ...(projectCfg.env || {}), ...(opts.env || {}) },
+    cwd: targetCwd
+  };
+}

package/src/service/manager.js

@@ -0,0 +1,233 @@
+import { getAdapter } from '../platform/index.js';
+import { readAppMetadata, readScheduleMetadata, sanitizeServiceName } from '../utils.js';
+import { mergeConfigWithOptions } from './config.js';
+import { normalizeServiceConfig } from './normalize.js';
+
+/**
+ * ServiceManager orchestrates service operations across platforms.
+ */
+export class ServiceManager {
+  /**
+   * @param {object} [opts]
+   * @param {string} [opts.platform]
+   * @param {import('../platform/base.js').ServiceAdapter} [opts.adapter]
+   */
+  constructor(opts = {}) {
+    this.platformName = opts.platform;
+    this._adapter = opts.adapter;
+  }
+
+  get adapter() {
+    return this._adapter || getAdapter(this.platformName);
+  }
+
+  /**
+   * Gets the platform capabilities.
+   */
+  get capabilities() {
+    return this.adapter.capabilities;
+  }
+
+  /**
+   * Generates the native service file/config from options (dry-run mode).
+   *
+   * @param {object} rawOpts
+   * @returns {Promise<string|object>}
+   */
+  async generate(rawOpts = {}) {
+    const merged = mergeConfigWithOptions(rawOpts);
+    const normalized = await normalizeServiceConfig(merged);
+    return this.adapter.generateService(normalized);
+  }
+
+  /**
+   * Installs/registers a service.
+   *
+   * @param {object} rawOpts
+   * @returns {Promise<object>}
+   */
+  async install(rawOpts = {}) {
+    const merged = mergeConfigWithOptions(rawOpts);
+    const normalized = await normalizeServiceConfig(merged);
+    return this.adapter.install(normalized, {
+      force: !!rawOpts.force,
+      start: !!rawOpts.start,
+      system: !!rawOpts.system
+    });
+  }
+
+  /**
+   * Uninstalls/removes a service.
+   *
+   * @param {string} name
+   * @param {object} [options]
+   * @returns {Promise<boolean>}
+   */
+  async uninstall(name, options = {}) {
+    if (name && typeof name === 'string' && name.startsWith('@')) {
+      const all = await this.list({ group: name });
+      if (all.length === 0) {
+        throw new Error(`No services found in group "${name}".`);
+      }
+      for (const item of all) {
+        await this.uninstall(item.name, options);
+      }
+      return true;
+    }
+    return this.adapter.uninstall(name, options);
+  }
+
+  /**
+   * Starts a service.
+   *
+   * @param {string} name
+   * @param {object} [options]
+   * @returns {Promise<boolean>}
+   */
+  async start(name, options = {}) {
+    if (name && typeof name === 'string' && name.startsWith('@')) {
+      const all = await this.list({ group: name });
+      if (all.length === 0) {
+        throw new Error(`No services found in group "${name}".`);
+      }
+      for (const item of all) {
+        await this.start(item.name, options);
+      }
+      return true;
+    }
+    return this.adapter.start(name, options);
+  }
+
+  /**
+   * Stops a service.
+   *
+   * @param {string} name
+   * @param {object} [options]
+   * @returns {Promise<boolean>}
+   */
+  async stop(name, options = {}) {
+    if (name && typeof name === 'string' && name.startsWith('@')) {
+      const all = await this.list({ group: name });
+      if (all.length === 0) {
+        throw new Error(`No services found in group "${name}".`);
+      }
+      for (const item of all) {
+        await this.stop(item.name, options);
+      }
+      return true;
+    }
+    return this.adapter.stop(name, options);
+  }
+
+  /**
+   * Restarts a service.
+   *
+   * @param {string} name
+   * @param {object} [options]
+   * @returns {Promise<boolean>}
+   */
+  async restart(name, options = {}) {
+    if (name && typeof name === 'string' && name.startsWith('@')) {
+      const all = await this.list({ group: name });
+      if (all.length === 0) {
+        throw new Error(`No services found in group "${name}".`);
+      }
+      for (const item of all) {
+        await this.restart(item.name, options);
+      }
+      return true;
+    }
+    return this.adapter.restart(name, options);
+  }
+
+  /**
+   * Enables a service for automatic startup.
+   *
+   * @param {string} name
+   * @param {object} [options]
+   * @returns {Promise<boolean>}
+   */
+  async enable(name, options = {}) {
+    return this.adapter.enable(name, options);
+  }
+
+  /**
+   * Disables automatic startup for a service.
+   *
+   * @param {string} name
+   * @param {object} [options]
+   * @returns {Promise<boolean>}
+   */
+  async disable(name, options = {}) {
+    return this.adapter.disable(name, options);
+  }
+
+  /**
+   * Gets normalized status for a service.
+   *
+   * @param {string} name
+   * @param {object} [options]
+   * @returns {Promise<object>}
+   */
+  async status(name, options = {}) {
+    return this.adapter.status(name, options);
+  }
+
+  /**
+   * Inspects detailed configuration and runtime info for a service.
+   *
+   * @param {string} name
+   * @param {object} [options]
+   * @returns {Promise<object>}
+   */
+  async inspect(name, options = {}) {
+    return this.adapter.inspect(name, options);
+  }
+
+  /**
+   * Retrieves or streams logs for a service.
+   *
+   * @param {string} name
+   * @param {object} [options]
+   * @returns {Promise<any>}
+   */
+  async logs(name, options = {}) {
+    return this.adapter.logs(name, options);
+  }
+
+  /**
+   * Lists all services.
+   *
+   * @param {object} [options]
+   * @returns {Promise<Array<object>>}
+   */
+  async list(options = {}) {
+    return this.adapter.list(options);
+  }
+
+  /**
+   * Lists failed services.
+   *
+   * @param {object} [options]
+   * @returns {Promise<Array<object>>}
+   */
+  async failures(options = {}) {
+    return this.adapter.failures(options);
+  }
+
+  /**
+   * Checks if a service is installed.
+   *
+   * @param {string} name
+   * @param {object} [options]
+   * @returns {Promise<boolean>|boolean}
+   */
+  isInstalled(name, options = {}) {
+    return this.adapter.isInstalled(name, options);
+  }
+}
+
+/**
+ * Default global ServiceManager instance.
+ */
+export const defaultManager = new ServiceManager();