@locusai/locus-pm2 0.22.13

package/dist/index.cjs

@@ -0,0 +1,142 @@
+var __defProp = Object.defineProperty;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+function __accessProp(key) {
+  return this[key];
+}
+var __toCommonJS = (from) => {
+  var entry = (__moduleCache ??= new WeakMap).get(from), desc;
+  if (entry)
+    return entry;
+  entry = __defProp({}, "__esModule", { value: true });
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (var key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(entry, key))
+        __defProp(entry, key, {
+          get: __accessProp.bind(from, key),
+          enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable
+        });
+  }
+  __moduleCache.set(from, entry);
+  return entry;
+};
+var __moduleCache;
+var __returnValue = (v) => v;
+function __exportSetter(name, newValue) {
+  this[name] = __returnValue.bind(null, newValue);
+}
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, {
+      get: all[name],
+      enumerable: true,
+      configurable: true,
+      set: __exportSetter.bind(all, name)
+    });
+};
+
+// src/index.ts
+var exports_src = {};
+__export(exports_src, {
+  resolvePackageScript: () => resolvePackageScript,
+  pm2Stop: () => pm2Stop,
+  pm2Status: () => pm2Status,
+  pm2Start: () => pm2Start,
+  pm2Restart: () => pm2Restart,
+  pm2Logs: () => pm2Logs,
+  pm2Delete: () => pm2Delete
+});
+module.exports = __toCommonJS(exports_src);
+
+// src/pm2.ts
+var import_node_child_process = require("node:child_process");
+var import_node_path = require("node:path");
+var import_node_url = require("node:url");
+function getPm2Bin() {
+  try {
+    const result = import_node_child_process.execSync("which pm2", {
+      encoding: "utf-8",
+      stdio: ["pipe", "pipe", "pipe"]
+    }).trim();
+    if (result)
+      return result;
+  } catch {}
+  return "npx pm2";
+}
+function pm2Exec(args) {
+  const pm2 = getPm2Bin();
+  try {
+    return import_node_child_process.execSync(`${pm2} ${args}`, {
+      encoding: "utf-8",
+      stdio: ["pipe", "pipe", "pipe"],
+      env: process.env
+    });
+  } catch (error) {
+    const err = error;
+    throw new Error(err.stderr?.trim() || err.message || "PM2 command failed");
+  }
+}
+function pm2Start(config) {
+  const { processName, scriptPath, scriptArgs = [] } = config;
+  const pm2 = getPm2Bin();
+  try {
+    const list = pm2Exec("jlist");
+    const processes = JSON.parse(list);
+    const existing = processes.find((p) => p.name === processName);
+    if (existing) {
+      pm2Exec(`restart ${processName}`);
+      return `Restarted ${processName}`;
+    }
+  } catch {}
+  const argsStr = scriptArgs.length > 0 ? ` -- ${scriptArgs.join(" ")}` : "";
+  import_node_child_process.execSync(`${pm2} start ${JSON.stringify(scriptPath)} --name ${processName}${argsStr}`, {
+    encoding: "utf-8",
+    stdio: "inherit",
+    env: process.env
+  });
+  return `Started ${processName}`;
+}
+function pm2Stop(config) {
+  pm2Exec(`stop ${config.processName}`);
+  return `Stopped ${config.processName}`;
+}
+function pm2Restart(config) {
+  pm2Exec(`restart ${config.processName}`);
+  return `Restarted ${config.processName}`;
+}
+function pm2Delete(config) {
+  pm2Exec(`delete ${config.processName}`);
+  return `Deleted ${config.processName}`;
+}
+function pm2Status(config) {
+  try {
+    const list = pm2Exec("jlist");
+    const processes = JSON.parse(list);
+    const proc = processes.find((p) => p.name === config.processName);
+    if (!proc)
+      return null;
+    return {
+      name: config.processName,
+      status: proc.pm2_env?.status ?? "unknown",
+      pid: proc.pid ?? null,
+      uptime: proc.pm2_env?.pm_uptime ?? null,
+      memory: proc.monit?.memory ?? null,
+      restarts: proc.pm2_env?.restart_time ?? 0
+    };
+  } catch {
+    return null;
+  }
+}
+function pm2Logs(config, lines = 50) {
+  try {
+    return pm2Exec(`logs ${config.processName} --nostream --lines ${lines}`);
+  } catch {
+    return "No logs available.";
+  }
+}
+function resolvePackageScript(importMetaUrl, binName) {
+  const currentFile = import_node_url.fileURLToPath(importMetaUrl);
+  const packageRoot = import_node_path.dirname(import_node_path.dirname(currentFile));
+  return import_node_path.join(packageRoot, "bin", `${binName}.js`);
+}

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+export type { Pm2Config, Pm2Status } from "./pm2.js";
+export { pm2Delete, pm2Logs, pm2Restart, pm2Start, pm2Status, pm2Stop, resolvePackageScript, } from "./pm2.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AACrD,OAAO,EACL,SAAS,EACT,OAAO,EACP,UAAU,EACV,QAAQ,EACR,SAAS,EACT,OAAO,EACP,oBAAoB,GACrB,MAAM,UAAU,CAAC"}

package/dist/index.js

@@ -0,0 +1,100 @@
+// src/pm2.ts
+import { execSync } from "node:child_process";
+import { dirname, join } from "node:path";
+import { fileURLToPath } from "node:url";
+function getPm2Bin() {
+  try {
+    const result = execSync("which pm2", {
+      encoding: "utf-8",
+      stdio: ["pipe", "pipe", "pipe"]
+    }).trim();
+    if (result)
+      return result;
+  } catch {}
+  return "npx pm2";
+}
+function pm2Exec(args) {
+  const pm2 = getPm2Bin();
+  try {
+    return execSync(`${pm2} ${args}`, {
+      encoding: "utf-8",
+      stdio: ["pipe", "pipe", "pipe"],
+      env: process.env
+    });
+  } catch (error) {
+    const err = error;
+    throw new Error(err.stderr?.trim() || err.message || "PM2 command failed");
+  }
+}
+function pm2Start(config) {
+  const { processName, scriptPath, scriptArgs = [] } = config;
+  const pm2 = getPm2Bin();
+  try {
+    const list = pm2Exec("jlist");
+    const processes = JSON.parse(list);
+    const existing = processes.find((p) => p.name === processName);
+    if (existing) {
+      pm2Exec(`restart ${processName}`);
+      return `Restarted ${processName}`;
+    }
+  } catch {}
+  const argsStr = scriptArgs.length > 0 ? ` -- ${scriptArgs.join(" ")}` : "";
+  execSync(`${pm2} start ${JSON.stringify(scriptPath)} --name ${processName}${argsStr}`, {
+    encoding: "utf-8",
+    stdio: "inherit",
+    env: process.env
+  });
+  return `Started ${processName}`;
+}
+function pm2Stop(config) {
+  pm2Exec(`stop ${config.processName}`);
+  return `Stopped ${config.processName}`;
+}
+function pm2Restart(config) {
+  pm2Exec(`restart ${config.processName}`);
+  return `Restarted ${config.processName}`;
+}
+function pm2Delete(config) {
+  pm2Exec(`delete ${config.processName}`);
+  return `Deleted ${config.processName}`;
+}
+function pm2Status(config) {
+  try {
+    const list = pm2Exec("jlist");
+    const processes = JSON.parse(list);
+    const proc = processes.find((p) => p.name === config.processName);
+    if (!proc)
+      return null;
+    return {
+      name: config.processName,
+      status: proc.pm2_env?.status ?? "unknown",
+      pid: proc.pid ?? null,
+      uptime: proc.pm2_env?.pm_uptime ?? null,
+      memory: proc.monit?.memory ?? null,
+      restarts: proc.pm2_env?.restart_time ?? 0
+    };
+  } catch {
+    return null;
+  }
+}
+function pm2Logs(config, lines = 50) {
+  try {
+    return pm2Exec(`logs ${config.processName} --nostream --lines ${lines}`);
+  } catch {
+    return "No logs available.";
+  }
+}
+function resolvePackageScript(importMetaUrl, binName) {
+  const currentFile = fileURLToPath(importMetaUrl);
+  const packageRoot = dirname(dirname(currentFile));
+  return join(packageRoot, "bin", `${binName}.js`);
+}
+export {
+  resolvePackageScript,
+  pm2Stop,
+  pm2Status,
+  pm2Start,
+  pm2Restart,
+  pm2Logs,
+  pm2Delete
+};

package/dist/pm2.d.ts

@@ -0,0 +1,36 @@
+/**
+ * PM2 programmatic wrapper for managing Locus package processes.
+ *
+ * Parameterized by Pm2Config so any platform package (telegram, slack, etc.)
+ * can use the same PM2 lifecycle management.
+ */
+export interface Pm2Config {
+    /** PM2 process name (e.g. "locus-telegram"). */
+    processName: string;
+    /** Absolute path to the script to run, or an import.meta.url to resolve from. */
+    scriptPath: string;
+    /** Extra arguments passed after `--` to the script (e.g. ["bot"]). */
+    scriptArgs?: string[];
+}
+export interface Pm2Status {
+    name: string;
+    status: string;
+    pid: number | null;
+    uptime: number | null;
+    memory: number | null;
+    restarts: number;
+}
+export declare function pm2Start(config: Pm2Config): string;
+export declare function pm2Stop(config: Pm2Config): string;
+export declare function pm2Restart(config: Pm2Config): string;
+export declare function pm2Delete(config: Pm2Config): string;
+export declare function pm2Status(config: Pm2Config): Pm2Status | null;
+export declare function pm2Logs(config: Pm2Config, lines?: number): string;
+/**
+ * Resolve the script path for a Locus package binary.
+ *
+ * Given an `import.meta.url` from the calling package, resolves to
+ * `<packageRoot>/bin/<binName>.js`.
+ */
+export declare function resolvePackageScript(importMetaUrl: string, binName: string): string;
+//# sourceMappingURL=pm2.d.ts.map

package/dist/pm2.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pm2.d.ts","sourceRoot":"","sources":["../src/pm2.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAQH,MAAM,WAAW,SAAS;IACxB,gDAAgD;IAChD,WAAW,EAAE,MAAM,CAAC;IACpB,iFAAiF;IACjF,UAAU,EAAE,MAAM,CAAC;IACnB,sEAAsE;IACtE,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;CACvB;AAED,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IACnB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAoCD,wBAAgB,QAAQ,CAAC,MAAM,EAAE,SAAS,GAAG,MAAM,CA4BlD;AAED,wBAAgB,OAAO,CAAC,MAAM,EAAE,SAAS,GAAG,MAAM,CAGjD;AAED,wBAAgB,UAAU,CAAC,MAAM,EAAE,SAAS,GAAG,MAAM,CAGpD;AAED,wBAAgB,SAAS,CAAC,MAAM,EAAE,SAAS,GAAG,MAAM,CAGnD;AAED,wBAAgB,SAAS,CAAC,MAAM,EAAE,SAAS,GAAG,SAAS,GAAG,IAAI,CA4B7D;AAED,wBAAgB,OAAO,CAAC,MAAM,EAAE,SAAS,EAAE,KAAK,SAAK,GAAG,MAAM,CAM7D;AAID;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAClC,aAAa,EAAE,MAAM,EACrB,OAAO,EAAE,MAAM,GACd,MAAM,CAIR"}

package/package.json

@@ -0,0 +1,46 @@
+{
+  "name": "@locusai/locus-pm2",
+  "version": "0.22.13",
+  "description": "Unified PM2 process management for Locus platform packages",
+  "type": "module",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": {
+        "types": "./dist/index.d.ts",
+        "default": "./dist/index.js"
+      },
+      "require": {
+        "types": "./dist/index.d.ts",
+        "default": "./dist/index.cjs"
+      }
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "bun build ./src/index.ts --outdir ./dist --target node --format esm && bun build ./src/index.ts --outfile ./dist/index.cjs --target node --format cjs && tsc -p tsconfig.build.json --emitDeclarationOnly",
+    "typecheck": "tsc --noEmit",
+    "lint": "biome lint .",
+    "format": "biome format --write .",
+    "clean": "rm -rf dist node_modules"
+  },
+  "dependencies": {
+    "pm2": "^6.0.5"
+  },
+  "devDependencies": {
+    "typescript": "^5.8.3"
+  },
+  "keywords": [
+    "locusai-package",
+    "locus",
+    "pm2"
+  ],
+  "engines": {
+    "node": ">=18"
+  },
+  "license": "MIT"
+}