hagiscript-sdk 0.2.9-dev.1780142424.1.dedbfb7

package/dist/src/runtime/pm2-manager.d.ts

@@ -0,0 +1,102 @@
+import type { CommandRunner } from "./command-launch.js";
+import { type LoadedRuntimeManifest, type RuntimeComponentDefinition } from "./runtime-manifest.js";
+import { type ResolvedRuntimePaths } from "./runtime-paths.js";
+export declare const supportedPm2Services: readonly ["server", "omniroute", "code-server"];
+export type ManagedPm2ServiceName = (typeof supportedPm2Services)[number];
+export type ManagedPm2Action = "start" | "stop" | "restart" | "status" | "delete";
+export type ManagedPm2Status = "online" | "stopped" | "errored" | "missing" | "unknown";
+export interface ManagedPm2CommandOptions {
+    manifestPath?: string;
+    runtimeRoot?: string;
+    service: ManagedPm2ServiceName;
+    action: ManagedPm2Action;
+    componentRootOverride?: string;
+    nameIdentifierValue?: string;
+    environmentOverrides?: Record<string, string | undefined>;
+    runner?: CommandRunner;
+}
+type ManagedPm2LaunchStrategy = "node-script" | "native-wrapper" | "released-service";
+export interface ResolvedManagedPm2ServiceDefinition {
+    service: ManagedPm2ServiceName;
+    component: RuntimeComponentDefinition;
+    manifestDir: string;
+    paths: ResolvedRuntimePaths;
+    baseAppName: string;
+    appName: string;
+    nameIdentifierEnv: string;
+    defaultNameIdentifier: string;
+    nameIdentifier: string;
+    cwd: string;
+    script: string;
+    args: string[];
+    env: Record<string, string>;
+    runtimeHome: string;
+    runtimeDataHome: string;
+    componentRoot: string;
+    componentConfigDir: string;
+    pm2Home: string;
+    pm2Binary: string;
+    nodePath: string;
+    launchStrategy: ManagedPm2LaunchStrategy;
+    dotnetPath?: string;
+    runtimeFilesDir?: string;
+    ecosystemPath?: string;
+    envFilePath?: string;
+}
+export interface ManagedPm2CommandResult {
+    service: ManagedPm2ServiceName;
+    action: ManagedPm2Action;
+    baseAppName: string;
+    appName: string;
+    nameIdentifierEnv: string;
+    nameIdentifier: string;
+    cwd: string;
+    script: string;
+    runtimeHome: string;
+    runtimeDataHome: string;
+    pm2Home: string;
+    pm2Binary: string;
+    exists: boolean;
+    status: ManagedPm2Status;
+    pid: number | null;
+    stdout: string;
+    stderr: string;
+    launchStrategy: ManagedPm2LaunchStrategy;
+    dotnetPath?: string;
+    runtimeFilesDir?: string;
+}
+export interface ManagedPm2EnvironmentResult {
+    service: ManagedPm2ServiceName;
+    baseAppName: string;
+    appName: string;
+    nameIdentifierEnv: string;
+    nameIdentifier: string;
+    bootstrapNameIdentifierValue: string;
+    cwd: string;
+    script: string;
+    args: string[];
+    env: NodeJS.ProcessEnv;
+    pathKey: "PATH" | "Path";
+    pathEntries: string[];
+    runtimeHome: string;
+    runtimeDataHome: string;
+    componentRoot: string;
+    componentConfigDir: string;
+    pm2Home: string;
+    pm2Binary: string;
+    nodePath: string;
+    launchStrategy: ManagedPm2LaunchStrategy;
+    dotnetPath?: string;
+    runtimeFilesDir?: string;
+    ecosystemPath?: string;
+    envFilePath?: string;
+}
+export declare class ManagedPm2Error extends Error {
+    constructor(message: string, options?: ErrorOptions);
+}
+export declare function runManagedPm2Command(options: ManagedPm2CommandOptions): Promise<ManagedPm2CommandResult>;
+export declare function resolveManagedPm2Environment(options: Omit<ManagedPm2CommandOptions, "action" | "runner">): Promise<ManagedPm2EnvironmentResult>;
+export declare function resolveManagedPm2ServiceDefinition(manifest: LoadedRuntimeManifest, paths: ResolvedRuntimePaths, service: ManagedPm2ServiceName, nameIdentifierValue?: string, environmentOverrides?: Record<string, string | undefined>, componentRootOverride?: string): Promise<ResolvedManagedPm2ServiceDefinition>;
+export declare function renderManagedPm2StatusText(result: ManagedPm2CommandResult): string;
+export declare function renderManagedPm2EnvironmentText(result: ManagedPm2EnvironmentResult): string;
+export {};