ysk-omni 1.0.0

package/dist/services/pm2.service.d.ts

@@ -0,0 +1,207 @@
+import type { Pm2RuntimeConfig } from '../interfaces/pm2-runtime-config.interface';
+import type { RunnerMode } from '../interfaces/runner-mode.type';
+export declare class Pm2Service {
+    isEnabled(): boolean;
+    getConfig(): Pm2RuntimeConfig;
+    saveConfig(input: Partial<Pm2RuntimeConfig> | Record<string, unknown>): Pm2RuntimeConfig;
+    /** Env files that may hold PORT for this install (project + ysk-omni home). */
+    private envFilesForPort;
+    /**
+     * Persist listen port to .env (and soft-update CORS_ORIGINS host:port).
+     * Takes effect after restart / runner switch.
+     */
+    updateListenPort(port: number): {
+        port: number;
+        previous: number;
+        files: string[];
+        defaultPort: number;
+    };
+    resetConfig(): Pm2RuntimeConfig;
+    status(): Promise<{
+        enabled: boolean;
+        available: boolean;
+        message: string;
+        messageKey: string;
+        messageParams: {};
+        app: null;
+        appName: string;
+        port: number;
+        runner: RunnerMode;
+        omni: {
+            running: boolean;
+            pid: number | null;
+            pidFile: string;
+        };
+        config: Pm2RuntimeConfig;
+        portHolders: {
+            pids: number[];
+            omniPid: number | null;
+            omniRunning: boolean;
+        };
+        lastError?: undefined;
+    } | {
+        enabled: boolean;
+        available: boolean;
+        message: string;
+        messageKey: string;
+        messageParams: Record<string, string | number>;
+        app: null;
+        appName: string;
+        port: number;
+        runner: RunnerMode;
+        omni: {
+            running: boolean;
+            pid: number | null;
+            pidFile: string;
+        };
+        config: Pm2RuntimeConfig;
+        portHolders: {
+            pids: number[];
+            omniPid: number | null;
+            omniRunning: boolean;
+        };
+        lastError: string;
+    } | {
+        enabled: boolean;
+        available: boolean;
+        message: string;
+        messageKey: string;
+        messageParams: Record<string, string | number>;
+        appName: string;
+        app: {
+            name: unknown;
+            pm_id: unknown;
+            pid: number | null;
+            status: string;
+            restarts: number;
+            uptime: {} | null;
+            memory: number | null;
+            cpu: number | null;
+            exec_mode: {};
+            instances: {};
+            max_memory_restart: {};
+            watch: {};
+            autorestart: {};
+        };
+        port: number;
+        runner: RunnerMode;
+        omni: {
+            running: boolean;
+            pid: number | null;
+            pidFile: string;
+        };
+        config: Pm2RuntimeConfig;
+        portHolders: {
+            pids: number[];
+            omniPid: number | null;
+            omniRunning: boolean;
+        };
+        lastError: string;
+    }>;
+    private inferRunner;
+    start(): Promise<{
+        notes: string;
+        stdout: string;
+        stderr: string;
+    }>;
+    stop(): Promise<{
+        stdout: string;
+        stderr: string;
+    }>;
+    restart(): Promise<{
+        notes: string;
+        stdout: string;
+        stderr: string;
+    }>;
+    reload(): Promise<{
+        stdout: string;
+        stderr: string;
+    }>;
+    /**
+     * Apply saved config: rewrite runtime json; if PM2 app is online, schedule
+     * a clean restart so the HTTP response can finish first.
+     */
+    applyConfig(input?: Partial<Pm2RuntimeConfig> | Record<string, unknown>, opts?: {
+        restart?: boolean;
+        port?: number;
+    }): Promise<{
+        config: Pm2RuntimeConfig;
+        applied: boolean;
+        restarted: boolean;
+        scheduled: {
+            scheduled: true;
+            mode: "ysk-omni" | "pm2";
+            port: number;
+            /** Admin SPA localizes via this key — do not display English `message` raw */
+            messageKey: string;
+            messageParams: {
+                port: number;
+            };
+            message: string;
+        } | null;
+        port: number;
+        portChange: {
+            port: number;
+            previous: number;
+            files: string[];
+            defaultPort: number;
+        } | null;
+        defaultPort: number;
+    }>;
+    /**
+     * Switch active runner. Schedules work so HTTP can respond first when
+     * the current process will be killed.
+     */
+    scheduleSwitch(mode: 'pm2' | 'ysk-omni', options?: {
+        home?: string;
+        port?: number;
+    }): {
+        scheduled: true;
+        mode: "ysk-omni" | "pm2";
+        port: number;
+        /** Admin SPA localizes via this key — do not display English `message` raw */
+        messageKey: string;
+        messageParams: {
+            port: number;
+        };
+        message: string;
+    };
+    /**
+     * Stop PM2 app if present (used by ysk-omni stop).
+     */
+    stopPm2IfRunning(): Promise<string[]>;
+    logs(lines?: number): Promise<{
+        stdout: string;
+        stderr: string;
+        files: {
+            label: string;
+            path: string;
+            size: number;
+            exists: boolean;
+        }[];
+        autoTrimmed: {
+            path: string;
+            removed: number;
+        }[];
+        maxBytes: number;
+        keepBytes: number;
+    }>;
+    /**
+     * Truncate managed log files (pm2-error/out + ysk-omni logs).
+     * Safe while process is running (open FD keeps writing from offset 0 after truncate on most Unix).
+     */
+    clearLogs(opts?: {
+        which?: 'all' | 'error' | 'out';
+    }): Promise<{
+        cleared: Array<{
+            label: string;
+            path: string;
+            previousSize: number;
+        }>;
+        maxBytes: number;
+    }>;
+    freeEverything(port?: number): Promise<string[]>;
+}
+export declare const pm2Service: Pm2Service;
+export { PM2_APP_NAME_DEFAULT as PM2_APP_NAME } from './pm2-config';
+//# sourceMappingURL=pm2.service.d.ts.map

package/dist/services/pm2.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pm2.service.d.ts","sourceRoot":"","sources":["../../src/services/pm2.service.ts"],"names":[],"mappings":"AAgBA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,4CAA4C,CAAC;AACnF,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,gCAAgC,CAAC;AAmNjE,qBAAa,UAAU;IACrB,SAAS,IAAI,OAAO;IAIpB,SAAS,IAAI,gBAAgB;IAI7B,UAAU,CAAC,KAAK,EAAE,OAAO,CAAC,gBAAgB,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,gBAAgB;IAKxF,+EAA+E;IAC/E,OAAO,CAAC,eAAe;IAgBvB;;;OAGG;IACH,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG;QAC9B,IAAI,EAAE,MAAM,CAAC;QACb,QAAQ,EAAE,MAAM,CAAC;QACjB,KAAK,EAAE,MAAM,EAAE,CAAC;QAChB,WAAW,EAAE,MAAM,CAAC;KACrB;IAkED,WAAW,IAAI,gBAAgB;IAUzB,MAAM;;;;;;;;;gBAsBqC,UAAU;;;;;;;;kBArMrD,MAAM,EAAE;qBACL,MAAM,GAAG,IAAI;yBACT,OAAO;;;;;;;;;;;;gBAiQ+B,UAAU;;;;;;;;kBAnQvD,MAAM,EAAE;qBACL,MAAM,GAAG,IAAI;yBACT,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;gBA4TT,UAAU;;;;;;;;kBA9Tf,MAAM,EAAE;qBACL,MAAM,GAAG,IAAI;yBACT,OAAO;;;;IAsVpB,OAAO,CAAC,WAAW;IAeb,KAAK;;gBAvd4C,MAAM;gBAAU,MAAM;;IAkfvE,IAAI;gBAlf6C,MAAM;gBAAU,MAAM;;IA4fvE,OAAO;;gBA5f0C,MAAM;gBAAU,MAAM;;IA4hBvE,MAAM;gBA5hB2C,MAAM;gBAAU,MAAM;;IAiiB7E;;;OAGG;IACG,WAAW,CACf,KAAK,CAAC,EAAE,OAAO,CAAC,gBAAgB,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC3D,IAAI,CAAC,EAAE;QAAE,OAAO,CAAC,EAAE,OAAO,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE;;;;;;;;YAyHzC,8EAA8E;;;;;;;;;kBAjd1E,MAAM;sBACF,MAAM;mBACT,MAAM,EAAE;yBACF,MAAM;;;;IA6ZrB;;;OAGG;IACH,cAAc,CAAC,IAAI,EAAE,KAAK,GAAG,UAAU,EAAE,OAAO,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE;;;;QA6C/E,8EAA8E;;;;;;;IAYlF;;OAEG;IACG,gBAAgB,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;IAKrC,IAAI,CAAC,KAAK,SAAM;;;;mBAKX,MAAM;kBACP,MAAM;kBACN,MAAM;oBACJ,OAAO;;;kBAnmBe,MAAM;qBAAW,MAAM;;;;;IA6pBzD;;;OAGG;IACG,SAAS,CAAC,IAAI,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,KAAK,GAAG,OAAO,GAAG,KAAK,CAAA;KAAE,GAAG,OAAO,CAAC;QACnE,OAAO,EAAE,KAAK,CAAC;YAAE,KAAK,EAAE,MAAM,CAAC;YAAC,IAAI,EAAE,MAAM,CAAC;YAAC,YAAY,EAAE,MAAM,CAAA;SAAE,CAAC,CAAC;QACtE,QAAQ,EAAE,MAAM,CAAC;KAClB,CAAC;IA6CI,cAAc,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;CAQvD;AAED,eAAO,MAAM,UAAU,YAAmB,CAAC;AAE3C,OAAO,EAAE,oBAAoB,IAAI,YAAY,EAAE,MAAM,cAAc,CAAC"}