ysk-server-core 1.0.0

package/dist/hosting/runtime.d.ts

@@ -0,0 +1,163 @@
+/**
+ * Multi-version hosting runtime selection contracts.
+ * Process apps: node | python | go | rust | java | kotlin | bun
+ * PHP-FPM: php · Static files: static
+ */
+export type RuntimeKind = 'node' | 'php' | 'python' | 'go' | 'rust' | 'java' | 'kotlin' | 'bun';
+export type ProjectRuntimeKind = 'node' | 'php' | 'static' | 'python' | 'go' | 'rust' | 'java' | 'kotlin' | 'bun';
+export type RuntimeManager = 'nvm' | 'fnm' | 'nodesource' | 'sury-php' | 'ondrej-php' | 'deadsnakes' | 'go-official' | 'rustup' | 'openjdk-apt' | 'kotlin-official' | 'bun-official' | 'system';
+export interface RuntimeSelection {
+    kind: RuntimeKind;
+    version: string;
+    /** Absolute path hint for binary on target host */
+    binaryPath: string;
+    manager: RuntimeManager;
+}
+/**
+ * @deprecated NOT a source of truth for installable versions.
+ * Installable pins come from version-discovery (upstream APIs).
+ * Kept only so older tests/imports compile; values are empty.
+ */
+export declare const NODE_SUPPORTED: readonly string[];
+export declare const PHP_SUPPORTED: readonly string[];
+export declare const PYTHON_SUPPORTED: readonly string[];
+export declare const GO_SUPPORTED: readonly string[];
+/** @deprecated removed — use go.dev live list via pickLatestGoDownloadVersion(available) */
+export declare const GO_LAST_KNOWN_PATCH: Record<string, string>;
+export declare const RUST_SUPPORTED: readonly string[];
+export declare const JAVA_SUPPORTED: readonly string[];
+export declare const KOTLIN_SUPPORTED: readonly string[];
+export declare const BUN_SUPPORTED: readonly string[];
+export declare function isProcessRuntime(runtime: string): boolean;
+export declare function isHostingRuntime(value: string): value is ProjectRuntimeKind;
+/** Default version string per runtime when client omits runtimeVersion. */
+export declare function defaultRuntimeVersion(runtime: ProjectRuntimeKind | string): string;
+/**
+ * Normalize / repair stored runtimeVersion.
+ * Accepts any shape-valid version from discovery — does NOT clamp to a hardcoded list.
+ * Fixes historical bug: PHP projects incorrectly defaulted to Node "20".
+ */
+export declare function normalizeRuntimeVersion(runtime: ProjectRuntimeKind | string, version?: string | null): string;
+export declare function selectNodeRuntime(version: string): RuntimeSelection;
+export declare function selectPhpRuntime(version: string): RuntimeSelection;
+export declare function selectPythonRuntime(version: string): RuntimeSelection;
+export declare function selectGoRuntime(version: string): RuntimeSelection;
+/**
+ * go.dev/dl only ships full patch tarballs (go1.21.13.linux-amd64.tar.gz).
+ * Resolve minor "1.21" to newest matching patch from **live** go.dev version list.
+ * When `available` is empty, returns full version if already x.y.z, else minor+".0"
+ * (caller should re-fetch go.dev — no hardcoded patch table).
+ */
+export declare function pickLatestGoDownloadVersion(panelVersion: string, available: string[]): string;
+/**
+ * @deprecated No hardcoded patch map — kept empty for older install scripts.
+ * Prefer live go.dev list in runtime-probe.
+ */
+export declare function goLastKnownPatchShellCase(): string;
+export declare function selectRustRuntime(version: string): RuntimeSelection;
+export declare function selectJavaRuntime(version: string): RuntimeSelection;
+export declare function selectKotlinRuntime(version: string): RuntimeSelection;
+export declare function selectBunRuntime(version: string): RuntimeSelection;
+export declare function selectRuntime(kind: RuntimeKind, version: string): RuntimeSelection;
+/**
+ * Generate PM2 / systemd unit skeleton for a Node project.
+ */
+export declare function renderNodeProcessUnit(opts: {
+    projectName: string;
+    linuxUser: string;
+    appDir: string;
+    nodeBinary: string;
+    entry: string;
+    port: number;
+    memoryMax?: string;
+    cpuQuotaPercent?: number;
+    limitNOFILE?: number;
+    /** Extra env (e.g. panel runtime tuning → NODE_OPTIONS) */
+    env?: Record<string, string>;
+}): string;
+/** Quote ExecStart tokens that contain spaces/meta (systemd argv split). */
+export declare function shellQuoteUnitArg(s: string): string;
+/** Generic process unit for node/python/go/rust — runs as project Linux user. */
+export declare function renderProcessUnit(opts: {
+    projectName: string;
+    linuxUser: string;
+    appDir: string;
+    /** Project home for ReadWritePaths (defaults to parent of appDir) */
+    homeDir?: string;
+    execStart: string;
+    port: number;
+    env?: Record<string, string>;
+    memoryMax?: string;
+    cpuQuotaPercent?: number;
+    limitNOFILE?: number;
+    tasksMax?: number;
+    /** Harden unit (default true) */
+    harden?: boolean;
+}): string;
+/**
+ * Shell env + cargo build for project isolation.
+ * Uses YSK managed CARGO_HOME/RUSTUP_HOME and RUSTUP_TOOLCHAIN so cargo never
+ * requires a per-user `rustup default` (project users have empty ~/.rustup).
+ *
+ * IMPORTANT:
+ * - Must NOT join discovery with bare `&&` after a successful `command -v cargo`
+ *   (that short-circuits the rest of the chain).
+ * - Must NOT `.join('; ')` across `then` / `elif` / `fi` lines — that becomes
+ *   `then;` which is a bash syntax error (create/goLive failed with
+ *   "syntax error near unexpected token `;'").
+ */
+export declare function rustCargoBuildShell(version?: string): string;
+/**
+ * Default ExecStart / build hints per process runtime.
+ */
+export declare function defaultProcessCommands(runtime: ProjectRuntimeKind | string, opts: {
+    version?: string;
+    entry?: string;
+    port?: number;
+    cargoName?: string;
+}): {
+    build?: string;
+    execStart: string;
+    entry: string;
+};
+/** Detect a reasonable jar / hello source under appDir (Maven/Gradle/hello layouts). */
+export declare function detectJavaEntry(appDir: string): string | undefined;
+/** Detect Bun/TS entry under appDir. */
+export declare function detectBunEntry(appDir: string): string | undefined;
+/** Apache backend bind for PHP (Nginx owns public :80/:443). */
+export declare function apacheBackendBind(): string;
+/** Apache backend port (default 8080). */
+export declare function apacheBackendPort(): number;
+/** Upstream URL Nginx uses to reach Apache PHP backend. */
+export declare function apacheBackendUpstream(): string;
+/**
+ * Render Apache VirtualHost for PHP via PHP-FPM (proxy_fcgi).
+ * Listens on backend bind:port only — not public :80 (Nginx terminates public HTTP/S).
+ */
+export declare function renderPhpVhost(opts: {
+    domain: string;
+    /** Extra ServerAlias names (space-separated or array) */
+    serverAliases?: string | string[];
+    docRoot: string;
+    phpVersion: string;
+    poolName: string;
+    /** Override backend listen (default YSK_APACHE_BACKEND_*) */
+    bind?: string;
+    port?: number;
+}): string;
+/**
+ * Installable version lists are empty by design — clients must use
+ * GET /api/v1/system/software/versions (dynamic discovery).
+ * Probe still finds *installed* pins via host scan (runtime-probe).
+ */
+export declare function listSupportedRuntimes(): {
+    node: string[];
+    php: string[];
+    python: string[];
+    go: string[];
+    rust: string[];
+    java: string[];
+    kotlin: string[];
+    bun: string[];
+};
+//# sourceMappingURL=runtime.d.ts.map

package/dist/hosting/runtime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime.d.ts","sourceRoot":"","sources":["../../src/hosting/runtime.ts"],"names":[],"mappings":"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"}