@ebowwa/pkg-ops 0.1.9

package/src/service-manager.ts

@@ -0,0 +1,216 @@
+/**
+ * Service management using @ebowwa/installations.
+ *
+ * Wraps systemd operations for package operations.
+ *
+ * @example
+ * ```typescript
+ * import { ServiceManager } from "@ebowwa/pkg-ops/service-manager";
+ *
+ * const manager = new ServiceManager();
+ *
+ * // Start a service
+ * await manager.start("stack");
+ *
+ * // Check status
+ * const status = await manager.status("stack");
+ * console.log(status.active ? "Running" : "Stopped");
+ *
+ * // View logs
+ * const logs = await manager.logs("stack", { lines: 50 });
+ * ```
+ */
+
+import {
+  startService,
+  stopService,
+  restartService,
+  getServiceStatus,
+  enableService,
+  disableService,
+  serviceExists,
+  getServiceLogs,
+  type ServiceStatus,
+} from "@ebowwa/installations/systemd";
+
+import type { SudoOptions } from "@ebowwa/installations";
+
+// Re-export ServiceStatus for other modules
+export type { ServiceStatus } from "@ebowwa/installations/systemd";
+
+// ---------------------------------------------------------------------------
+// Types
+// ---------------------------------------------------------------------------
+
+export interface ServiceInfo {
+  /** Service name (without .service suffix) */
+  name: string;
+  /** Whether the service exists */
+  exists: boolean;
+  /** Service status */
+  status: ServiceStatus;
+  /** Associated package (if known) */
+  package?: string;
+}
+
+export interface ServiceLogsOptions {
+  /** Number of lines to show (default: 100) */
+  lines?: number;
+  /** Show logs since timestamp */
+  since?: string;
+}
+
+// ---------------------------------------------------------------------------
+// Service Manager Class
+// ---------------------------------------------------------------------------
+
+/**
+ * Manages systemd services for packages.
+ */
+export class ServiceManager {
+  private sudoOptions: SudoOptions;
+
+  constructor(sudoOptions?: SudoOptions) {
+    this.sudoOptions = sudoOptions ?? { context: { type: "local" } };
+  }
+
+  /**
+   * Start a service.
+   */
+  async start(name: string): Promise<{ success: boolean; message: string }> {
+    const result = await startService(name, this.sudoOptions);
+    return {
+      success: result.ok,
+      message: result.ok ? `Service ${name} started` : result.stderr || result.stdout,
+    };
+  }
+
+  /**
+   * Stop a service.
+   */
+  async stop(name: string): Promise<{ success: boolean; message: string }> {
+    const result = await stopService(name, this.sudoOptions);
+    return {
+      success: result.ok,
+      message: result.ok ? `Service ${name} stopped` : result.stderr || result.stdout,
+    };
+  }
+
+  /**
+   * Restart a service.
+   */
+  async restart(name: string): Promise<{ success: boolean; message: string }> {
+    const result = await restartService(name, this.sudoOptions);
+    return {
+      success: result.ok,
+      message: result.ok ? `Service ${name} restarted` : result.stderr || result.stdout,
+    };
+  }
+
+  /**
+   * Get service status.
+   */
+  async status(name: string): Promise<ServiceStatus> {
+    return getServiceStatus(name, this.sudoOptions);
+  }
+
+  /**
+   * Enable a service to start on boot.
+   */
+  async enable(name: string): Promise<{ success: boolean; message: string }> {
+    const result = await enableService(name, this.sudoOptions);
+    return {
+      success: result.ok,
+      message: result.ok ? `Service ${name} enabled` : result.stderr || result.stdout,
+    };
+  }
+
+  /**
+   * Disable a service from starting on boot.
+   */
+  async disable(name: string): Promise<{ success: boolean; message: string }> {
+    const result = await disableService(name, this.sudoOptions);
+    return {
+      success: result.ok,
+      message: result.ok ? `Service ${name} disabled` : result.stderr || result.stdout,
+    };
+  }
+
+  /**
+   * Check if a service exists.
+   */
+  async exists(name: string): Promise<boolean> {
+    return serviceExists(name, this.sudoOptions);
+  }
+
+  /**
+   * Get service logs.
+   */
+  async logs(name: string, options?: ServiceLogsOptions): Promise<string> {
+    return getServiceLogs(name, {
+      ...this.sudoOptions,
+      lines: options?.lines ?? 100,
+      since: options?.since,
+    });
+  }
+
+  /**
+   * Get comprehensive service info.
+   */
+  async info(name: string): Promise<ServiceInfo> {
+    const [existsResult, statusResult] = await Promise.all([
+      this.exists(name),
+      this.status(name),
+    ]);
+
+    return {
+      name,
+      exists: existsResult,
+      status: statusResult,
+    };
+  }
+
+  /**
+   * Check if a service is healthy (running and active).
+   */
+  async isHealthy(name: string): Promise<boolean> {
+    const status = await this.status(name);
+    return status.active && status.subState === "running";
+  }
+
+  /**
+   * Wait for a service to become healthy.
+   */
+  async waitForHealthy(
+    name: string,
+    options?: { timeout?: number; interval?: number }
+  ): Promise<boolean> {
+    const timeout = options?.timeout ?? 30000;
+    const interval = options?.interval ?? 1000;
+    const start = Date.now();
+
+    while (Date.now() - start < timeout) {
+      const healthy = await this.isHealthy(name);
+      if (healthy) return true;
+      await new Promise((resolve) => setTimeout(resolve, interval));
+    }
+
+    return false;
+  }
+}
+
+// ---------------------------------------------------------------------------
+// Singleton Instance
+// ---------------------------------------------------------------------------
+
+let defaultManager: ServiceManager | null = null;
+
+/**
+ * Get the default service manager instance.
+ */
+export function getServiceManager(): ServiceManager {
+  if (!defaultManager) {
+    defaultManager = new ServiceManager();
+  }
+  return defaultManager;
+}