unitup 0.0.1

package/src/utils.js

@@ -0,0 +1,184 @@
+import path from 'node:path';
+import os from 'node:os';
+
+/**
+ * Sanitizes a service name to ensure it is safe for systemd unit filenames.
+ * - Converts to lowercase.
+ * - Replaces spaces with hyphens.
+ * - Strips any characters outside [a-z0-9_-].
+ * - Prevents path traversal and empty results.
+ *
+ * @param {string} name
+ * @returns {string}
+ */
+export function sanitizeServiceName(name) {
+  if (!name || typeof name !== 'string') {
+    throw new Error('Service name must be a non-empty string.');
+  }
+
+  // Strip leading unitup- if already present to avoid double prefixing
+  let clean = name.trim();
+  if (clean.startsWith('unitup-')) {
+    clean = clean.slice(7);
+  }
+  if (clean.endsWith('.service')) {
+    clean = clean.slice(0, -8);
+  }
+
+  clean = clean
+    .toLowerCase()
+    .replace(/\s+/g, '-')
+    .replace(/[^a-z0-9_-]/g, '')
+    .replace(/-+/g, '-');
+
+  if (!clean) {
+    throw new Error(`Invalid service name "${name}". Name must contain alphanumeric characters.`);
+  }
+
+  return clean;
+}
+
+/**
+ * Returns the full systemd unit filename for a service name.
+ *
+ * @param {string} name
+ * @returns {string}
+ */
+export function getUnitFilename(name) {
+  const safeName = sanitizeServiceName(name);
+  return `unitup-${safeName}.service`;
+}
+
+/**
+ * Extracts the user-friendly service name from a unit filename (e.g., unitup-api.service -> api).
+ *
+ * @param {string} unitFilename
+ * @returns {string}
+ */
+export function getServiceNameFromUnit(unitFilename) {
+  let base = path.basename(unitFilename);
+  if (base.endsWith('.service')) {
+    base = base.slice(0, -8);
+  }
+  if (base.startsWith('unitup-')) {
+    base = base.slice(7);
+  }
+  return base;
+}
+
+/**
+ * Resolves a file path to an absolute path, expanding tilde (~) if present.
+ *
+ * @param {string} filepath
+ * @param {string} [baseDir]
+ * @returns {string}
+ */
+export function resolveAbsolutePath(filepath, baseDir = process.cwd()) {
+  if (!filepath) return '';
+  let p = filepath;
+  if (p.startsWith('~/') || p === '~') {
+    p = path.join(os.homedir(), p.slice(1));
+  }
+  return path.resolve(baseDir, p);
+}
+
+/**
+ * Escapes values for systemd Environment= line entries.
+ * E.g. KEY="val with spaces"
+ *
+ * @param {string} key
+ * @param {string} value
+ * @returns {string}
+ */
+export function formatSystemdEnv(key, value) {
+  // Validate key to be alphanumeric + underscore
+  if (!/^[a-zA-Z_][a-zA-Z0-9_]*$/.test(key)) {
+    throw new Error(`Invalid environment variable key: "${key}"`);
+  }
+  const strVal = String(value);
+  // Systemd environment escaping: quote value if it contains space, quote, or special chars
+  const escaped = strVal.replace(/\\/g, '\\\\').replace(/"/g, '\\"').replace(/\$/g, '$$$$');
+  return `${key}="${escaped}"`;
+}
+
+/**
+ * Escapes an argument for an ExecStart directive in systemd unit file.
+ *
+ * @param {string} arg
+ * @returns {string}
+ */
+export function escapeExecArg(arg) {
+  const str = String(arg);
+  if (!str) return '""';
+  // If argument contains spaces, quotes, or backslashes, wrap in double quotes and escape internal quotes/backslashes
+  if (/[\s"'\\]/.test(str)) {
+    return '"' + str.replace(/\\/g, '\\\\').replace(/"/g, '\\"') + '"';
+  }
+  return str;
+}
+
+/**
+ * Formats a timestamp string into a human readable "X ago" or date string.
+ *
+ * @param {string|number} timestamp
+ * @returns {string}
+ */
+export function formatRelativeTime(timestamp) {
+  if (!timestamp || timestamp === 'n/a' || timestamp === '0') {
+    return 'unknown';
+  }
+  const date = new Date(timestamp);
+  if (isNaN(date.getTime())) {
+    return String(timestamp);
+  }
+  const diffMs = Date.now() - date.getTime();
+  if (diffMs < 0) return 'just now';
+
+  const seconds = Math.floor(diffMs / 1000);
+  if (seconds < 60) return `${seconds} seconds ago`;
+
+  const minutes = Math.floor(seconds / 60);
+  if (minutes < 60) return `${minutes} minute${minutes === 1 ? '' : 's'} ago`;
+
+  const hours = Math.floor(minutes / 60);
+  if (hours < 24) return `${hours} hour${hours === 1 ? '' : 's'} ago`;
+
+  const days = Math.floor(hours / 24);
+  return `${days} day${days === 1 ? '' : 's'} ago`;
+}
+
+/**
+ * Formats data rows into a text table.
+ *
+ * @param {Array<Object>} data
+ * @param {Array<{ key: string, label: string }>} columns
+ * @returns {string}
+ */
+export function formatTable(data, columns) {
+  if (!data || data.length === 0) {
+    return 'No services found.';
+  }
+
+  const widths = columns.map(col => col.label.length);
+
+  for (const row of data) {
+    columns.forEach((col, idx) => {
+      const val = String(row[col.key] ?? '');
+      if (val.length > widths[idx]) {
+        widths[idx] = val.length;
+      }
+    });
+  }
+
+  const headerLine = columns.map((col, idx) => col.label.padEnd(widths[idx])).join('   ');
+  const lines = [headerLine];
+
+  for (const row of data) {
+    const line = columns
+      .map((col, idx) => String(row[col.key] ?? '').padEnd(widths[idx]))
+      .join('   ');
+    lines.push(line);
+  }
+
+  return lines.join('\n');
+}