@ebowwa/pkg-ops 0.1.20 → 0.1.22

package/src/service-manager.ts

@@ -1,216 +0,0 @@
-/**
- * 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;
-}

package/src/types.ts

@@ -1,240 +0,0 @@
-/**
- * Type definitions for PkgOps multi-version support.
- *
- * @module @ebowwa/pkg-ops/types
- */
-
-// ---------------------------------------------------------------------------
-// Package Version Types
-// ---------------------------------------------------------------------------
-
-/**
- * Metadata for an installed package version.
- */
-export interface VersionInfo {
-  /** Semver version string */
-  version: string;
-  /** ISO timestamp when this version was installed */
-  installedAt: string;
-  /** Size of the dist directory in bytes */
-  distSizeBytes: number | null;
-  /** Number of files in the dist directory */
-  fileCount: number | null;
-  /** Whether this is the currently active version */
-  active: boolean;
-}
-
-/**
- * Configuration for a managed package with multi-version support.
- */
-export interface PackageConfig {
-  /** Currently active version */
-  version: string;
-  /** All installed versions with metadata */
-  versions: Record<string, VersionMetadata>;
-  /** Associated systemd service name (without .service suffix) */
-  service?: string;
-  /** Whether to auto-start the service after install */
-  autoStart?: boolean;
-  /** Custom environment variables for the service */
-  environment?: Record<string, string>;
-  /** Maximum number of versions to keep (default: 3) */
-  maxVersions?: number;
-}
-
-/**
- * Metadata stored for each installed version.
- */
-export interface VersionMetadata {
-  /** ISO timestamp when this version was installed */
-  installedAt: string;
-  /** Size of the dist directory in bytes */
-  distSizeBytes: number | null;
-  /** Number of files in the dist directory */
-  fileCount: number | null;
-}
-
-// ---------------------------------------------------------------------------
-// Result Types
-// ---------------------------------------------------------------------------
-
-/**
- * Result of listing versions for a package.
- */
-export interface VersionsListResult {
-  packageName: string;
-  versions: VersionInfo[];
-  activeVersion: string;
-  maxVersions: number;
-}
-
-/**
- * Result of switching to a different version.
- */
-export interface SwitchVersionResult {
-  success: boolean;
-  packageName: string;
-  previousVersion: string;
-  newVersion: string;
-  serviceRestarted: boolean;
-  message: string;
-}
-
-/**
- * Result of pruning old versions.
- */
-export interface PruneResult {
-  success: boolean;
-  packageName: string;
-  removedVersions: string[];
-  keptVersions: string[];
-  freedBytes: number;
-  message: string;
-}
-
-/**
- * Result of installing a package (updated for multi-version).
- */
-export interface InstallResult {
-  success: boolean;
-  version: string;
-  previousVersion?: string;
-  /** Whether this was a new version install or reinstall */
-  isNew: boolean;
-  /** Total versions now installed */
-  totalVersions: number;
-  message: string;
-}
-
-/**
- * Result of rolling back a package.
- */
-export interface RollbackResult {
-  success: boolean;
-  previousVersion: string;
-  currentVersion: string;
-  /** Available versions to rollback to */
-  availableVersions: string[];
-  message: string;
-}
-
-/**
- * Package info with version details.
- */
-export interface PackageInfo {
-  name: string;
-  version: string;
-  installed: boolean;
-  service?: string;
-  /** Total installed versions */
-  totalVersions?: number;
-  /** All installed versions */
-  versions?: VersionInfo[];
-}
-
-// ---------------------------------------------------------------------------
-// Config Types
-// ---------------------------------------------------------------------------
-
-/**
- * Main configuration structure.
- */
-export interface PkgOpsConfig {
-  /** Managed packages */
-  packages: Record<string, PackageConfig>;
-  /** Health check HTTP port (default: 8914) */
-  healthPort?: number;
-  /** Working directory for installations (default: /root) */
-  workDir?: string;
-  /** Log level (default: "info") */
-  logLevel?: "debug" | "info" | "warn" | "error";
-  /** Default max versions to keep per package */
-  defaultMaxVersions?: number;
-}
-
-// ---------------------------------------------------------------------------
-// Bridge Types
-// ---------------------------------------------------------------------------
-
-/**
- * JSON-RPC request structure.
- */
-export interface JsonRpcRequest {
-  jsonrpc: "2.0";
-  id: string;
-  method: string;
-  params?: Record<string, unknown>;
-}
-
-/**
- * JSON-RPC response structure.
- */
-export interface JsonRpcResponse {
-  jsonrpc: "2.0";
-  id: string;
-  result?: unknown;
-  error?: {
-    code: number;
-    message: string;
-    data?: unknown;
-  };
-}
-
-// ---------------------------------------------------------------------------
-// Audit/Verify Types
-// ---------------------------------------------------------------------------
-
-/**
- * Vulnerability audit result.
- */
-export interface AuditResult {
-  packageName: string;
-  severity: string;
-  vulnerability: string;
-  description: string;
-}
-
-/**
- * Package verification result.
- */
-export interface VerifyResult {
-  packageName: string;
-  version: string;
-  success: boolean;
-  distExists: boolean;
-  checksum: string | null;
-  message: string;
-}
-
-/**
- * Bundle size info.
- */
-export interface BundleSize {
-  packageName: string;
-  version: string;
-  distSizeBytes: number;
-  fileCount: number;
-}
-
-/**
- * Installed package detailed info.
- */
-export interface InstalledPackageInfo {
-  packageName: string;
-  version: string;
-  distSizeBytes: number | null;
-  installedAt: string | null;
-  totalVersions?: number;
-}
-
-/**
- * Health check result.
- */
-export interface HealthCheckResult {
-  healthy: boolean;
-  services: Array<{
-    name: string;
-    status: string;
-    pid: number;
-  }>;
-}