@ebowwa/pkg-ops 0.1.16 → 0.1.18

package/dist/types.d.ts

@@ -0,0 +1,204 @@
+/**
+ * Type definitions for PkgOps multi-version support.
+ *
+ * @module @ebowwa/pkg-ops/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 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[];
+}
+/**
+ * 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;
+}
+/**
+ * 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;
+    };
+}
+/**
+ * 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;
+    }>;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ebowwa/pkg-ops",
-  "version": "0.1.16",
+  "version": "0.1.18",
   "type": "module",
   "description": "Package operations CLI - installs @ebowwa/* npm packages and manages systemd services",
   "bin": {

package/src/bridge.ts

@@ -88,6 +88,44 @@ export interface InstalledPackageInfo {
   version: string;
   distSizeBytes: number | null;
   installedAt: string | null;
+  /** Total number of installed versions */
+  totalVersions?: number;
+  /** All installed versions */
+  versions?: VersionInfo[];
+}
+
+/**
+ * Version information for a package.
+ */
+export interface VersionInfo {
+  version: string;
+  installedAt: string;
+  distSizeBytes: number | null;
+  fileCount: number | null;
+  active: boolean;
+}
+
+/**
+ * Result of switching versions.
+ */
+export interface SwitchResult {
+  success: boolean;
+  packageName: string;
+  fromVersion: string;
+  toVersion: string;
+  message: string;
+}
+
+/**
+ * Result of pruning old versions.
+ */
+export interface PruneResult {
+  success: boolean;
+  packageName: string;
+  removedVersions: string[];
+  keptVersions: string[];
+  freedBytes: number;
+  message: string;
 }
 
 interface JsonRpcRequest {
@@ -281,6 +319,55 @@ export class RustBridge {
     return this.sendRequest("installedInfo", {}) as Promise<InstalledPackageInfo[]>;
   }
 
+  // ---------------------------------------------------------------------------
+  // Multi-Version Methods
+  // ---------------------------------------------------------------------------
+
+  /**
+   * List all installed versions of a package.
+   */
+  async listVersions(packageName: string): Promise<VersionInfo[]> {
+    return this.sendRequest("listVersions", { packageName }) as Promise<VersionInfo[]>;
+  }
+
+  /**
+   * Switch to a specific installed version.
+   */
+  async switchVersion(packageName: string, version: string): Promise<SwitchResult> {
+    return this.sendRequest("switchVersion", { packageName, version }) as Promise<SwitchResult>;
+  }
+
+  /**
+   * Remove old versions, keeping only the N most recent.
+   */
+  async pruneVersions(packageName: string, keepCount: number): Promise<PruneResult> {
+    return this.sendRequest("pruneVersions", { packageName, keepCount }) as Promise<PruneResult>;
+  }
+
+  /**
+   * Remove a specific version.
+   */
+  async removeVersion(packageName: string, version: string): Promise<{ success: boolean; message: string }> {
+    return this.sendRequest("removeVersion", { packageName, version }) as Promise<{ success: boolean; message: string }>;
+  }
+
+  /**
+   * Get packages with multiple versions installed.
+   */
+  async getMultiVersionPackages(): Promise<Array<{
+    packageName: string;
+    activeVersion: string;
+    totalVersions: number;
+    versions: string[];
+  }>> {
+    return this.sendRequest("getMultiVersionPackages", {}) as Promise<Array<{
+      packageName: string;
+      activeVersion: string;
+      totalVersions: number;
+      versions: string[];
+    }>>;
+  }
+
   // ---------------------------------------------------------------------------
   // Private Methods
   // ---------------------------------------------------------------------------

package/src/config.ts

@@ -23,9 +23,23 @@ import { dirname } from "node:path";
 // Types
 // ---------------------------------------------------------------------------
 
+/**
+ * Metadata for a single 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 dist */
+  fileCount: number | null;
+}
+
 export interface PackageConfig {
-  /** Package version (semver or "latest") */
+  /** Currently active version (semver) */
   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 */
@@ -190,3 +204,161 @@ export function parsePackageSpec(spec: string): { name: string; version: string
 
   return { name, version };
 }
+
+// ---------------------------------------------------------------------------
+// Multi-Version Helper Functions
+// ---------------------------------------------------------------------------
+
+/**
+ * Get all installed versions for a package.
+ */
+export function getInstalledVersions(packageName: string): VersionMetadata[] {
+  const config = loadConfig();
+  const pkgConfig = config.packages[packageName];
+  if (!pkgConfig?.versions) {
+    return [];
+  }
+  return Object.entries(pkgConfig.versions).map(([version, meta]) => ({
+    version,
+    ...meta,
+  }));
+}
+
+/**
+ * Check if a specific version is installed.
+ */
+export function isVersionInstalled(packageName: string, version: string): boolean {
+  const config = loadConfig();
+  const pkgConfig = config.packages[packageName];
+  return !!(pkgConfig?.versions?.[version]);
+}
+
+/**
+ * Get the active version for a package.
+ */
+export function getActiveVersion(packageName: string): string | null {
+  const config = loadConfig();
+  const pkgConfig = config.packages[packageName];
+  return pkgConfig?.version ?? null;
+}
+
+/**
+ * Add a new version to the package config.
+ */
+export function addPackageVersion(
+  packageName: string,
+  version: string,
+  metadata: Omit<VersionMetadata, "installedAt"> & { installedAt?: string }
+): void {
+  const config = loadConfig();
+
+  if (!config.packages[packageName]) {
+    config.packages[packageName] = {
+      version,
+      versions: {},
+      service: packageName.replace("@ebowwa/", ""),
+      autoStart: true,
+    };
+  }
+
+  config.packages[packageName].versions[version] = {
+    installedAt: metadata.installedAt ?? new Date().toISOString(),
+    distSizeBytes: metadata.distSizeBytes ?? null,
+    fileCount: metadata.fileCount ?? null,
+  };
+
+  saveConfig(config);
+}
+
+/**
+ * Remove a version from the package config.
+ * Returns true if the version was removed, false if it didn't exist.
+ */
+export function removePackageVersion(packageName: string, version: string): boolean {
+  const config = loadConfig();
+  const pkgConfig = config.packages[packageName];
+
+  if (!pkgConfig?.versions?.[version]) {
+    return false;
+  }
+
+  delete pkgConfig.versions[version];
+
+  // If removing the active version, switch to the most recent remaining version
+  if (pkgConfig.version === version) {
+    const remainingVersions = Object.keys(pkgConfig.versions).sort((a, b) => {
+      // Sort by installedAt descending (most recent first)
+      const aTime = pkgConfig.versions[a]?.installedAt ?? "";
+      const bTime = pkgConfig.versions[b]?.installedAt ?? "";
+      return bTime.localeCompare(aTime);
+    });
+
+    if (remainingVersions.length > 0) {
+      pkgConfig.version = remainingVersions[0];
+    } else {
+      // No versions left, remove the package entirely
+      delete config.packages[packageName];
+    }
+  }
+
+  saveConfig(config);
+  return true;
+}
+
+/**
+ * Set the active version for a package.
+ * Returns true if successful, false if version not installed.
+ */
+export function setActiveVersion(packageName: string, version: string): boolean {
+  const config = loadConfig();
+  const pkgConfig = config.packages[packageName];
+
+  if (!pkgConfig?.versions?.[version]) {
+    return false;
+  }
+
+  pkgConfig.version = version;
+  saveConfig(config);
+  return true;
+}
+
+/**
+ * Get the count of installed versions for a package.
+ */
+export function getVersionCount(packageName: string): number {
+  const config = loadConfig();
+  const pkgConfig = config.packages[packageName];
+  return Object.keys(pkgConfig?.versions ?? {}).length;
+}
+
+/**
+ * Get packages with multiple versions installed.
+ */
+export function getPackagesWithMultipleVersions(): Array<{
+  name: string;
+  activeVersion: string;
+  totalVersions: number;
+  versions: string[];
+}> {
+  const config = loadConfig();
+  const result: Array<{
+    name: string;
+    activeVersion: string;
+    totalVersions: number;
+    versions: string[];
+  }> = [];
+
+  for (const [name, pkgConfig] of Object.entries(config.packages)) {
+    const versions = Object.keys(pkgConfig.versions ?? {});
+    if (versions.length > 1) {
+      result.push({
+        name,
+        activeVersion: pkgConfig.version,
+        totalVersions: versions.length,
+        versions: versions.sort((a, b) => b.localeCompare(a, undefined, { numeric: true })),
+      });
+    }
+  }
+
+  return result;
+}