@ebowwa/pkg-ops 0.1.16 → 0.1.18

package/src/index.ts

@@ -85,9 +85,18 @@ async function handleInstall(args: string[]): Promise<void> {
         console.log(`  Previous version: ${result.previousVersion}`);
       }
 
-      // Update config
+      // Update config (add version to versions map)
+      const existingConfig = getPackageConfig(name);
       updatePackageConfig(name, {
         version: result.version,
+        versions: {
+          ...existingConfig?.versions,
+          [result.version]: {
+            installedAt: new Date().toISOString(),
+            distSizeBytes: null,
+            fileCount: null,
+          },
+        },
         service: name.replace("@ebowwa/", ""),
       });
 
@@ -139,9 +148,18 @@ async function handleUpdate(args: string[]): Promise<void> {
         console.log(`  Previous version: ${result.previousVersion}`);
       }
 
-      // Update config
+      // Update config (add version to versions map)
+      const existingConfig = getPackageConfig(packageName);
       updatePackageConfig(packageName, {
         version: result.version,
+        versions: {
+          ...existingConfig?.versions,
+          [result.version]: {
+            installedAt: new Date().toISOString(),
+            distSizeBytes: null,
+            fileCount: null,
+          },
+        },
         service: packageName.replace("@ebowwa/", ""),
       });
 
@@ -487,6 +505,7 @@ async function handleConfigSet(args: string[]): Promise<void> {
 
   const config = getPackageConfig(packageName) ?? {
     version: "latest",
+    versions: {},
   };
 
   // Handle different value types
@@ -686,6 +705,230 @@ async function handleSizes(_args: string[]): Promise<void> {
   }
 }
 
+// ---------------------------------------------------------------------------
+// Multi-Version Commands
+// ---------------------------------------------------------------------------
+
+async function handleVersions(args: string[]): Promise<void> {
+  if (args.length === 0) {
+    console.error("Usage: pkg-ops versions <package>");
+    process.exit(1);
+  }
+
+  const packageName = args[0];
+
+  if (!isValidPackageName(packageName)) {
+    console.error(`Invalid package name. Only @ebowwa/* packages are supported.`);
+    process.exit(1);
+  }
+
+  try {
+    const bridge = await startBridge();
+    const versions = await bridge.listVersions(packageName);
+    await stopBridge();
+
+    if (versions.length === 0) {
+      console.log(`No versions of ${packageName} installed.`);
+      return;
+    }
+
+    console.log(`Installed versions for ${packageName}:\n`);
+
+    // Sort versions descending (newest first)
+    const sorted = [...versions].sort((a, b) => b.installedAt.localeCompare(a.installedAt));
+
+    for (const v of sorted) {
+      const active = v.active ? " [ACTIVE]" : "";
+      const size = v.distSizeBytes ? ` (${(v.distSizeBytes / 1024).toFixed(1)} KB)` : "";
+      const date = new Date(v.installedAt).toLocaleString();
+      console.log(`  ${v.version}${active}${size}`);
+      console.log(`    Installed: ${date}`);
+      if (v.fileCount) {
+        console.log(`    Files: ${v.fileCount}`);
+      }
+    }
+
+    console.log(`\nTotal: ${versions.length} version(s)`);
+  } catch (error) {
+    console.error("Failed to list versions:", error);
+    process.exit(1);
+  } finally {
+    await stopBridge();
+  }
+}
+
+async function handleSwitch(args: string[]): Promise<void> {
+  if (args.length === 0) {
+    console.error("Usage: pkg-ops switch <package>@<version>");
+    process.exit(1);
+  }
+
+  const spec = args[0];
+  const { name, version } = parsePackageSpec(spec);
+
+  if (!isValidPackageName(name)) {
+    console.error(`Invalid package name. Only @ebowwa/* packages are supported.`);
+    process.exit(1);
+  }
+
+  if (!version || version === "latest") {
+    console.error("Error: Must specify a version to switch to (e.g., @ebowwa/stack@0.7.12)");
+    process.exit(1);
+  }
+
+  console.log(`Switching ${name} to version ${version}...`);
+
+  try {
+    const bridge = await startBridge();
+    const result = await bridge.switchVersion(name, version);
+
+    if (result.success) {
+      console.log(`Switched ${name} from ${result.fromVersion} to ${result.toVersion}`);
+
+      // Restart service if running
+      const sm = getServiceManager();
+      const config = getPackageConfig(name);
+      if (config?.service) {
+        const status = await sm.status(config.service);
+        if (status.active) {
+          await sm.restart(config.service);
+          console.log(`  Service ${config.service} restarted`);
+        }
+      }
+    } else {
+      console.error(`Switch failed: ${result.message}`);
+      process.exit(1);
+    }
+  } catch (error) {
+    console.error("Switch failed:", error);
+    process.exit(1);
+  } finally {
+    await stopBridge();
+  }
+}
+
+async function handlePrune(args: string[]): Promise<void> {
+  if (args.length === 0) {
+    console.error("Usage: pkg-ops prune <package> [--keep N]");
+    process.exit(1);
+  }
+
+  const packageName = args[0];
+  const keepIndex = args.indexOf("--keep");
+  const keepCount = keepIndex >= 0 && args[keepIndex + 1]
+    ? parseInt(args[keepIndex + 1], 10)
+    : 2; // Default: keep 2 versions
+
+  if (!isValidPackageName(packageName)) {
+    console.error(`Invalid package name. Only @ebowwa/* packages are supported.`);
+    process.exit(1);
+  }
+
+  console.log(`Pruning ${packageName}, keeping ${keepCount} most recent version(s)...`);
+
+  try {
+    const bridge = await startBridge();
+    const result = await bridge.pruneVersions(packageName, keepCount);
+    await stopBridge();
+
+    if (result.success) {
+      if (result.removedVersions.length === 0) {
+        console.log(`No versions to remove (only ${result.keptVersions.length} installed).`);
+      } else {
+        console.log(`Removed ${result.removedVersions.length} version(s):`);
+        for (const v of result.removedVersions) {
+          console.log(`  - ${v}`);
+        }
+        console.log(`Freed: ${(result.freedBytes / 1024).toFixed(1)} KB`);
+        console.log(`Kept: ${result.keptVersions.join(", ")}`);
+      }
+    } else {
+      console.error(`Prune failed: ${result.message}`);
+      process.exit(1);
+    }
+  } catch (error) {
+    console.error("Prune failed:", error);
+    process.exit(1);
+  } finally {
+    await stopBridge();
+  }
+}
+
+async function handleRemoveVersion(args: string[]): Promise<void> {
+  if (args.length === 0) {
+    console.error("Usage: pkg-ops remove-version <package>@<version>");
+    process.exit(1);
+  }
+
+  const spec = args[0];
+  const { name, version } = parsePackageSpec(spec);
+
+  if (!isValidPackageName(name)) {
+    console.error(`Invalid package name. Only @ebowwa/* packages are supported.`);
+    process.exit(1);
+  }
+
+  if (!version || version === "latest") {
+    console.error("Error: Must specify a version to remove (e.g., @ebowwa/stack@0.7.12)");
+    process.exit(1);
+  }
+
+  // Check if trying to remove active version
+  const config = getPackageConfig(name);
+  if (config?.version === version) {
+    console.error(`Error: Cannot remove active version ${version}. Switch to another version first.`);
+    process.exit(1);
+  }
+
+  console.log(`Removing ${name}@${version}...`);
+
+  try {
+    const bridge = await startBridge();
+    const result = await bridge.removeVersion(name, version);
+    await stopBridge();
+
+    if (result.success) {
+      console.log(`Removed ${name}@${version}`);
+    } else {
+      console.error(`Remove failed: ${result.message}`);
+      process.exit(1);
+    }
+  } catch (error) {
+    console.error("Remove failed:", error);
+    process.exit(1);
+  } finally {
+    await stopBridge();
+  }
+}
+
+async function handleMultiVersionList(_args: string[]): Promise<void> {
+  try {
+    const bridge = await startBridge();
+    const packages = await bridge.getMultiVersionPackages();
+    await stopBridge();
+
+    if (packages.length === 0) {
+      console.log("No packages with multiple versions installed.");
+      return;
+    }
+
+    console.log("Packages with multiple versions:\n");
+
+    for (const pkg of packages) {
+      console.log(`  ${pkg.packageName}:`);
+      console.log(`    Active: ${pkg.activeVersion}`);
+      console.log(`    Total: ${pkg.totalVersions} version(s)`);
+      console.log(`    Versions: ${pkg.versions.join(", ")}`);
+      console.log("");
+    }
+  } catch (error) {
+    console.error("Failed to list multi-version packages:", error);
+    process.exit(1);
+  } finally {
+    await stopBridge();
+  }
+}
+
 // ---------------------------------------------------------------------------
 // CLI Entry Point
 // ---------------------------------------------------------------------------
@@ -697,6 +940,12 @@ const commands: Command[] = [
   { name: "update-all", description: "Update all managed packages", usage: "pkg-ops update-all", handler: handleUpdateAll },
   { name: "list", description: "List installed packages", usage: "pkg-ops list", handler: handleList },
   { name: "rollback", description: "Rollback a package to previous version", usage: "pkg-ops rollback <package>", handler: handleRollback },
+  // Multi-version management
+  { name: "versions", description: "List all installed versions of a package", usage: "pkg-ops versions <package>", handler: handleVersions },
+  { name: "switch", description: "Switch to a specific installed version", usage: "pkg-ops switch <package>@<version>", handler: handleSwitch },
+  { name: "prune", description: "Remove old versions, keeping N most recent", usage: "pkg-ops prune <package> [--keep N]", handler: handlePrune },
+  { name: "remove-version", description: "Remove a specific version", usage: "pkg-ops remove-version <package>@<version>", handler: handleRemoveVersion },
+  { name: "multi", description: "List packages with multiple versions", usage: "pkg-ops multi", handler: handleMultiVersionList },
   // Service management
   { name: "start", description: "Start a systemd service", usage: "pkg-ops service start <name>", handler: handleServiceStart },
   { name: "stop", description: "Stop a systemd service", usage: "pkg-ops service stop <name>", handler: handleServiceStop },
@@ -747,6 +996,13 @@ Package Management:
   list                           List installed packages
   rollback <package>            Rollback a package to previous version
 
+Multi-Version Management:
+  versions <package>            List all installed versions
+  switch <package>@<version>    Switch to a specific version
+  prune <package> [--keep N]    Remove old versions (default: keep 2)
+  remove-version <pkg>@<ver>    Remove a specific version
+  multi                          List packages with multiple versions
+
 Service Management:
   service start <name>          Start a systemd service
   service stop <name>           Stop a systemd service
@@ -853,8 +1109,77 @@ async function main(): Promise<void> {
   await command.handler(commandArgs);
 }
 
-// Run CLI
-main().catch((error) => {
-  console.error("Fatal error:", error);
-  process.exit(1);
-});
+// Run CLI only when executed directly (not when imported)
+if (import.meta.main) {
+  main().catch((error) => {
+    console.error("Fatal error:", error);
+    process.exit(1);
+  });
+}
+
+// ---------------------------------------------------------------------------
+// Re-exports for library usage
+// ---------------------------------------------------------------------------
+
+export {
+  loadConfig,
+  saveConfig,
+  parsePackageSpec,
+  isValidPackageName,
+  getPackageConfig,
+  updatePackageConfig,
+  removePackageConfig,
+  listManagedPackages,
+  getConfigPath,
+  ensureConfigDir,
+  type PackageConfig,
+  type PkgOpsConfig,
+} from "./config.js";
+
+export {
+  ServiceManager,
+  getServiceManager,
+  type ServiceInfo,
+  type ServiceLogsOptions,
+} from "./service-manager.js";
+
+export {
+  RustBridge,
+  startBridge,
+  stopBridge,
+  getBridge,
+  type InstallResult,
+  type PackageInfo,
+  type RollbackResult,
+  type VerifyResult,
+  type AuditResult,
+  type BundleSize,
+  type InstalledPackageInfo,
+  type VersionInfo,
+  type SwitchResult,
+  type PruneResult,
+} from "./bridge.js";
+
+// Multi-version config helpers
+export {
+  getInstalledVersions,
+  isVersionInstalled,
+  getActiveVersion,
+  addPackageVersion,
+  removePackageVersion,
+  setActiveVersion,
+  getVersionCount,
+  getPackagesWithMultipleVersions,
+  type VersionMetadata,
+} from "./config.js";
+
+export {
+  startHealthServer,
+  stopHealthServer,
+  getHealthServer,
+  HealthServer,
+  type HealthCheckResult,
+  type ServiceHealth,
+  type SystemHealth,
+} from "./health-server.js";
+

package/src/types.ts

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