about-system 0.0.18 → 0.0.21

package/src/types/internal-types.ts

@@ -0,0 +1,21 @@
+/**
+ * Internal type definitions
+ * @module internal-types
+ */
+
+import type { Cache, CacheEntry } from "../cache/cache";
+import type { IPInfo } from "../utils/network";
+
+/**
+ * Context object passed to info collection functions
+ * @interface InfoContext
+ */
+export interface InfoContext {
+  /** Cache storage */
+  cache: Cache;
+  /** IP information from external API */
+  ipInfo?: IPInfo;
+}
+
+// Re-export cache types for convenience
+export type { Cache, CacheEntry };

package/src/utils/command.ts

@@ -0,0 +1,47 @@
+/**
+ * Command execution utilities
+ * @module command
+ */
+
+import { execSync } from "child_process";
+import { IS_WINDOWS } from "./platform";
+
+/**
+ * Executes a shell command safely with timeout
+ * @param {string} command - Command to execute
+ * @param {object} options - Additional options for execSync
+ * @returns {string} Command output or empty string on error
+ */
+export function execCommand(command: string, options = {}): string {
+  try {
+    const cmd = IS_WINDOWS ? `cmd /c ${command}` : command;
+    return execSync(cmd, {
+      encoding: "utf8",
+      timeout: 10000,
+      stdio: ["pipe", "pipe", "ignore"],
+      ...options,
+    })
+      .toString()
+      .trim();
+  } catch (error) {
+    return "";
+  }
+}
+
+/**
+ * Checks if a command exists in the system PATH
+ * @param {string} command - Command name to check
+ * @returns {boolean} True if command exists
+ */
+export function commandExists(command: string): boolean {
+  try {
+    if (IS_WINDOWS) {
+      execSync(`where ${command}`, { stdio: "ignore" });
+    } else {
+      execSync(`which ${command}`, { stdio: "ignore" });
+    }
+    return true;
+  } catch {
+    return false;
+  }
+}

package/src/utils/network.ts

@@ -0,0 +1,58 @@
+/**
+ * Network utilities for IP information fetching
+ * @module network
+ */
+
+import https from "https";
+import {
+  DEFAULT_IPINFO_TOKEN,
+  DEFAULT_NETWORK_TIMEOUT,
+} from "../cache/cache-config";
+
+/**
+ * IP information from ipinfo.io API
+ * @interface IPInfo
+ */
+export interface IPInfo {
+  /** Public IP address */
+  ip?: string;
+  /** City location */
+  city?: string;
+  /** Reverse DNS hostname */
+  hostname?: string;
+  /** ISP organization string (includes AS number) */
+  org?: string;
+}
+
+/**
+ * Fetches IP geolocation information from ipinfo.io API
+ * @param {string} token - IPInfo.io API token
+ * @param {number} timeout - Request timeout in milliseconds
+ * @returns {Promise<IPInfo>} IP information object or empty object on error
+ */
+export async function fetchIPInfo(
+  token: string = DEFAULT_IPINFO_TOKEN,
+  timeout: number = DEFAULT_NETWORK_TIMEOUT
+): Promise<IPInfo> {
+  return new Promise((resolve) => {
+    const url = `https://ipinfo.io/json${token ? `?token=${token}` : ""}`;
+
+    const req = https.get(url, (res) => {
+      let data = "";
+      res.on("data", (chunk) => (data += chunk));
+      res.on("end", () => {
+        try {
+          resolve(JSON.parse(data));
+        } catch {
+          resolve({});
+        }
+      });
+    });
+
+    req.on("error", () => resolve({}));
+    req.setTimeout(timeout, () => {
+      req.destroy();
+      resolve({});
+    });
+  });
+}

package/src/utils/platform.ts

@@ -0,0 +1,13 @@
+/**
+ * Platform detection utilities
+ * @module platform
+ */
+
+import os from "os";
+
+/**
+ * Platform detection constants
+ */
+export const IS_WINDOWS = os.platform() === "win32";
+export const IS_MAC = os.platform() === "darwin";
+export const IS_LINUX = os.platform() === "linux";