@trebired/code-server-kit 0.1.0

package/CHANGELOG.md

@@ -0,0 +1,5 @@
+# Changelog
+
+## 0.1.0
+
+- Initial release

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) Trebired
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,159 @@
+# @trebired/code-server-kit
+
+Framework-agnostic `code-server` launch planning for Node.js applications.
+
+`@trebired/code-server-kit` gives your app a small, typed layer for finding an installed `code-server`, building a stable launch command, waiting for readiness, and optionally spawning the process without leaking `code-server` package layout details into product code.
+
+The package stays in one lane:
+
+- resolve the installed `code-server` package root and launch entrypoint
+- build standard `code-server` CLI args for host-managed sessions
+- expose the launch command and args for your own sandbox or supervisor
+- optionally spawn the process and capture stdout and stderr
+- wait for the TCP port to become ready with timeout and early-exit handling
+
+It does not try to be a `code-server` fork, a sandbox manager, a container runtime, or a product layer with app-specific routes and filesystem rules.
+
+## Install
+
+Runtime target: Node.js 22+ on Linux first.
+
+```sh
+npm install @trebired/code-server-kit code-server
+```
+
+## Quick Start
+
+```ts
+import {
+  createCodeServerLaunch,
+  launchCodeServerProcess,
+  resolveCodeServerInstallation,
+  waitForCodeServerReady,
+} from "@trebired/code-server-kit";
+
+const installation = resolveCodeServerInstallation({
+  resolveFrom: process.cwd(),
+});
+
+const launch = await createCodeServerLaunch({
+  installation,
+  dataRoot: "/srv/code-server/session-42",
+  host: "127.0.0.1",
+  port: 8080,
+  trustedOrigins: [
+    "https://app.example.com",
+  ],
+  workspacePath: "/srv/workspaces/demo",
+});
+
+const processHandle = await launchCodeServerProcess({
+  plan: launch,
+  stdout(text) {
+    process.stdout.write(text);
+  },
+  stderr(text) {
+    process.stderr.write(text);
+  },
+});
+
+await waitForCodeServerReady({
+  host: launch.host,
+  port: launch.port,
+  process: processHandle,
+  timeoutMs: 30_000,
+});
+```
+
+## Public API
+
+### `resolveCodeServerInstallation(options?)`
+
+Resolves the installed `code-server` package from a caller-controlled starting path and returns:
+
+- `packageRoot`
+- `packageJsonPath`
+- `entryPoint`
+- `entryKind`
+- `supportRoot`
+- `version`
+
+### `createCodeServerLaunch(options)`
+
+Builds a stable launch plan and returns:
+
+- `command`
+- `args`
+- `codeServerPackageRoot`
+- `supportRoot`
+- `userDataDir`
+- `extensionsDir`
+- `bindAddr`
+- `host`
+- `port`
+- `workspacePath`
+
+If you pass `dataRoot`, the package derives:
+
+- `${dataRoot}/user-data`
+- `${dataRoot}/extensions`
+
+If you omit `port` or pass `0`, the package allocates a free TCP port first.
+
+### `waitForCodeServerReady(options)`
+
+Polls the target TCP port until it accepts connections or fails with:
+
+- `CodeServerProcessExitedBeforeReadyError`
+- `CodeServerStartupTimeoutError`
+
+### `launchCodeServerProcess(options)`
+
+Starts the resolved command directly with `stdout` and `stderr` hooks and returns a typed handle with:
+
+- `child`
+- `pid`
+- `exit`
+- `kill()`
+- `getStdout()`
+- `getStderr()`
+
+## Launch Modes
+
+`createCodeServerLaunch()` supports two concrete launch modes:
+
+- `node`, which runs `node <entrypoint> ...`
+- `direct`, which runs the resolved entrypoint directly when it is executable
+
+`auto` is the default. It prefers `node` for JS entry files and `direct` for non-JS executables.
+
+## Standard CLI Args
+
+The launch plan always includes:
+
+- `--auth none`
+- `--bind-addr`
+- `--disable-telemetry`
+- `--disable-update-check`
+- `--disable-workspace-trust`
+- `--disable-getting-started-override`
+- `--user-data-dir`
+- `--extensions-dir`
+
+Trusted origins are appended with repeated `--trusted-origins` flags, and `workspacePath` is appended as the positional workspace/folder target when provided.
+
+## Dependency vs Peer Dependency for `code-server`
+
+For an application, prefer a regular `dependency` on `code-server` when you want one installed runtime and want `@trebired/code-server-kit` to resolve the same package reliably every time.
+
+For a wrapper library on top of this package, prefer a `peerDependency` on `code-server` when the host application must choose the exact `code-server` version and install location itself. In that setup, document that `code-server` must still be resolvable from the host application's dependency tree, and pass `resolveFrom` when you need to anchor resolution to the host side explicitly.
+
+## Error Types
+
+The package exposes structured errors for the failure modes that usually matter in integration code:
+
+- `CodeServerBinaryNotFoundError`
+- `CodeServerPackageResolutionError`
+- `CodeServerPortAllocationError`
+- `CodeServerProcessExitedBeforeReadyError`
+- `CodeServerStartupTimeoutError`

package/dist/errors.d.ts

@@ -0,0 +1,25 @@
+type CodeServerKitErrorCode = "binary_not_found" | "package_resolution_failed" | "port_allocation_failed" | "process_exited_before_ready" | "startup_timeout";
+declare class CodeServerKitError extends Error {
+    code: CodeServerKitErrorCode | string;
+    details: Record<string, unknown>;
+    constructor(code: CodeServerKitErrorCode | string, message: string, details?: Record<string, unknown>);
+}
+declare class CodeServerBinaryNotFoundError extends CodeServerKitError {
+    constructor(message: string, details?: Record<string, unknown>);
+}
+declare class CodeServerPackageResolutionError extends CodeServerKitError {
+    constructor(message: string, details?: Record<string, unknown>);
+}
+declare class CodeServerPortAllocationError extends CodeServerKitError {
+    constructor(message: string, details?: Record<string, unknown>);
+}
+declare class CodeServerProcessExitedBeforeReadyError extends CodeServerKitError {
+    constructor(message: string, details?: Record<string, unknown>);
+}
+declare class CodeServerStartupTimeoutError extends CodeServerKitError {
+    constructor(message: string, details?: Record<string, unknown>);
+}
+declare function isCodeServerKitError(value: unknown): value is CodeServerKitError;
+export { CodeServerBinaryNotFoundError, CodeServerKitError, CodeServerPackageResolutionError, CodeServerPortAllocationError, CodeServerProcessExitedBeforeReadyError, CodeServerStartupTimeoutError, isCodeServerKitError, };
+export type { CodeServerKitErrorCode };
+//# sourceMappingURL=errors.d.ts.map

package/dist/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA,KAAK,sBAAsB,GACvB,kBAAkB,GAClB,2BAA2B,GAC3B,wBAAwB,GACxB,6BAA6B,GAC7B,iBAAiB,CAAC;AAEtB,cAAM,kBAAmB,SAAQ,KAAK;IACpC,IAAI,EAAE,sBAAsB,GAAG,MAAM,CAAC;IACtC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;gBAErB,IAAI,EAAE,sBAAsB,GAAG,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM;CAM1G;AAED,cAAM,6BAA8B,SAAQ,kBAAkB;gBAChD,OAAO,EAAE,MAAM,EAAE,OAAO,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM;CAInE;AAED,cAAM,gCAAiC,SAAQ,kBAAkB;gBACnD,OAAO,EAAE,MAAM,EAAE,OAAO,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM;CAInE;AAED,cAAM,6BAA8B,SAAQ,kBAAkB;gBAChD,OAAO,EAAE,MAAM,EAAE,OAAO,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM;CAInE;AAED,cAAM,uCAAwC,SAAQ,kBAAkB;gBAC1D,OAAO,EAAE,MAAM,EAAE,OAAO,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM;CAInE;AAED,cAAM,6BAA8B,SAAQ,kBAAkB;gBAChD,OAAO,EAAE,MAAM,EAAE,OAAO,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM;CAInE;AAED,iBAAS,oBAAoB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,kBAAkB,CAEzE;AAED,OAAO,EACL,6BAA6B,EAC7B,kBAAkB,EAClB,gCAAgC,EAChC,6BAA6B,EAC7B,uCAAuC,EACvC,6BAA6B,EAC7B,oBAAoB,GACrB,CAAC;AACF,YAAY,EAAE,sBAAsB,EAAE,CAAC"}

package/dist/errors.js

@@ -0,0 +1,43 @@
+class CodeServerKitError extends Error {
+    constructor(code, message, details = {}) {
+        super(message);
+        this.name = "CodeServerKitError";
+        this.code = code;
+        this.details = details;
+    }
+}
+class CodeServerBinaryNotFoundError extends CodeServerKitError {
+    constructor(message, details = {}) {
+        super("binary_not_found", message, details);
+        this.name = "CodeServerBinaryNotFoundError";
+    }
+}
+class CodeServerPackageResolutionError extends CodeServerKitError {
+    constructor(message, details = {}) {
+        super("package_resolution_failed", message, details);
+        this.name = "CodeServerPackageResolutionError";
+    }
+}
+class CodeServerPortAllocationError extends CodeServerKitError {
+    constructor(message, details = {}) {
+        super("port_allocation_failed", message, details);
+        this.name = "CodeServerPortAllocationError";
+    }
+}
+class CodeServerProcessExitedBeforeReadyError extends CodeServerKitError {
+    constructor(message, details = {}) {
+        super("process_exited_before_ready", message, details);
+        this.name = "CodeServerProcessExitedBeforeReadyError";
+    }
+}
+class CodeServerStartupTimeoutError extends CodeServerKitError {
+    constructor(message, details = {}) {
+        super("startup_timeout", message, details);
+        this.name = "CodeServerStartupTimeoutError";
+    }
+}
+function isCodeServerKitError(value) {
+    return value instanceof CodeServerKitError;
+}
+export { CodeServerBinaryNotFoundError, CodeServerKitError, CodeServerPackageResolutionError, CodeServerPortAllocationError, CodeServerProcessExitedBeforeReadyError, CodeServerStartupTimeoutError, isCodeServerKitError, };
+//# sourceMappingURL=errors.js.map

package/dist/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAOA,MAAM,kBAAmB,SAAQ,KAAK;IAIpC,YAAY,IAAqC,EAAE,OAAe,EAAE,UAAmC,EAAE;QACvG,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,oBAAoB,CAAC;QACjC,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;IACzB,CAAC;CACF;AAED,MAAM,6BAA8B,SAAQ,kBAAkB;IAC5D,YAAY,OAAe,EAAE,UAAmC,EAAE;QAChE,KAAK,CAAC,kBAAkB,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;QAC5C,IAAI,CAAC,IAAI,GAAG,+BAA+B,CAAC;IAC9C,CAAC;CACF;AAED,MAAM,gCAAiC,SAAQ,kBAAkB;IAC/D,YAAY,OAAe,EAAE,UAAmC,EAAE;QAChE,KAAK,CAAC,2BAA2B,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;QACrD,IAAI,CAAC,IAAI,GAAG,kCAAkC,CAAC;IACjD,CAAC;CACF;AAED,MAAM,6BAA8B,SAAQ,kBAAkB;IAC5D,YAAY,OAAe,EAAE,UAAmC,EAAE;QAChE,KAAK,CAAC,wBAAwB,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;QAClD,IAAI,CAAC,IAAI,GAAG,+BAA+B,CAAC;IAC9C,CAAC;CACF;AAED,MAAM,uCAAwC,SAAQ,kBAAkB;IACtE,YAAY,OAAe,EAAE,UAAmC,EAAE;QAChE,KAAK,CAAC,6BAA6B,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;QACvD,IAAI,CAAC,IAAI,GAAG,yCAAyC,CAAC;IACxD,CAAC;CACF;AAED,MAAM,6BAA8B,SAAQ,kBAAkB;IAC5D,YAAY,OAAe,EAAE,UAAmC,EAAE;QAChE,KAAK,CAAC,iBAAiB,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;QAC3C,IAAI,CAAC,IAAI,GAAG,+BAA+B,CAAC;IAC9C,CAAC;CACF;AAED,SAAS,oBAAoB,CAAC,KAAc;IAC1C,OAAO,KAAK,YAAY,kBAAkB,CAAC;AAC7C,CAAC;AAED,OAAO,EACL,6BAA6B,EAC7B,kBAAkB,EAClB,gCAAgC,EAChC,6BAA6B,EAC7B,uCAAuC,EACvC,6BAA6B,EAC7B,oBAAoB,GACrB,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,7 @@
+export { CodeServerBinaryNotFoundError, CodeServerKitError, CodeServerPackageResolutionError, CodeServerPortAllocationError, CodeServerProcessExitedBeforeReadyError, CodeServerStartupTimeoutError, isCodeServerKitError, } from "./errors.js";
+export { createCodeServerLaunch, launchCodeServerProcess } from "./launch.js";
+export { waitForCodeServerReady } from "./readiness.js";
+export { resolveCodeServerInstallation } from "./resolve.js";
+export type { CodeServerEntryKind, CodeServerInstallation, CodeServerLaunchMode, CodeServerLaunchOptions, CodeServerLaunchPlan, CodeServerProcessExit, CodeServerProcessHandle, CodeServerReadyOptions, CodeServerReadyResult, LaunchCodeServerProcessOptions, ResolveCodeServerInstallationOptions, } from "./types.js";
+export type { CodeServerKitErrorCode } from "./errors.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,OAAO,EACL,6BAA6B,EAC7B,kBAAkB,EAClB,gCAAgC,EAChC,6BAA6B,EAC7B,uCAAuC,EACvC,6BAA6B,EAC7B,oBAAoB,GACrB,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,sBAAsB,EAAE,uBAAuB,EAAE,MAAM,aAAa,CAAC;AAC9E,OAAO,EAAE,sBAAsB,EAAE,MAAM,gBAAgB,CAAC;AACxD,OAAO,EAAE,6BAA6B,EAAE,MAAM,cAAc,CAAC;AAE7D,YAAY,EACV,mBAAmB,EACnB,sBAAsB,EACtB,oBAAoB,EACpB,uBAAuB,EACvB,oBAAoB,EACpB,qBAAqB,EACrB,uBAAuB,EACvB,sBAAsB,EACtB,qBAAqB,EACrB,8BAA8B,EAC9B,oCAAoC,GACrC,MAAM,YAAY,CAAC;AACpB,YAAY,EAAE,sBAAsB,EAAE,MAAM,aAAa,CAAC"}

package/dist/index.js

@@ -0,0 +1,5 @@
+export { CodeServerBinaryNotFoundError, CodeServerKitError, CodeServerPackageResolutionError, CodeServerPortAllocationError, CodeServerProcessExitedBeforeReadyError, CodeServerStartupTimeoutError, isCodeServerKitError, } from "./errors.js";
+export { createCodeServerLaunch, launchCodeServerProcess } from "./launch.js";
+export { waitForCodeServerReady } from "./readiness.js";
+export { resolveCodeServerInstallation } from "./resolve.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,6BAA6B,EAC7B,kBAAkB,EAClB,gCAAgC,EAChC,6BAA6B,EAC7B,uCAAuC,EACvC,6BAA6B,EAC7B,oBAAoB,GACrB,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,sBAAsB,EAAE,uBAAuB,EAAE,MAAM,aAAa,CAAC;AAC9E,OAAO,EAAE,sBAAsB,EAAE,MAAM,gBAAgB,CAAC;AACxD,OAAO,EAAE,6BAA6B,EAAE,MAAM,cAAc,CAAC"}

package/dist/launch.d.ts

@@ -0,0 +1,5 @@
+import type { CodeServerLaunchOptions, CodeServerLaunchPlan, CodeServerProcessHandle, LaunchCodeServerProcessOptions } from "./types.js";
+declare function createCodeServerLaunch(options: CodeServerLaunchOptions): Promise<CodeServerLaunchPlan>;
+declare function launchCodeServerProcess(options: LaunchCodeServerProcessOptions): Promise<CodeServerProcessHandle>;
+export { createCodeServerLaunch, launchCodeServerProcess };
+//# sourceMappingURL=launch.d.ts.map

package/dist/launch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"launch.d.ts","sourceRoot":"","sources":["../src/launch.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAEV,uBAAuB,EACvB,oBAAoB,EAEpB,uBAAuB,EACvB,8BAA8B,EAC/B,MAAM,YAAY,CAAC;AAKpB,iBAAe,sBAAsB,CAAC,OAAO,EAAE,uBAAuB,GAAG,OAAO,CAAC,oBAAoB,CAAC,CAkDrG;AAED,iBAAe,uBAAuB,CAAC,OAAO,EAAE,8BAA8B,GAAG,OAAO,CAAC,uBAAuB,CAAC,CA6DhH;AAsOD,OAAO,EAAE,sBAAsB,EAAE,uBAAuB,EAAE,CAAC"}

package/dist/launch.js

@@ -0,0 +1,292 @@
+import { spawn } from "node:child_process";
+import fs from "node:fs";
+import net from "node:net";
+import path from "node:path";
+import { CodeServerBinaryNotFoundError, CodeServerPortAllocationError, } from "./errors.js";
+import { resolveCodeServerInstallation } from "./resolve.js";
+const DEFAULT_BIND_HOST = "127.0.0.1";
+const DIRECT_LAUNCH_ACCESS = fs.constants.X_OK;
+async function createCodeServerLaunch(options) {
+    const installation = options.installation ?? resolveCodeServerInstallation({
+        resolveFrom: options.resolveFrom,
+    });
+    const launchMode = normalizeLaunchMode(options.launchMode, installation);
+    const { extensionsDir, userDataDir } = resolveLaunchDirectories(options);
+    const binding = await resolveLaunchBinding(options);
+    const workspacePath = options.workspacePath ? path.resolve(options.workspacePath) : null;
+    const trustedOrigins = normalizeTrustedOrigins(options.trustedOrigins);
+    const cliArgs = buildCodeServerArgs({
+        bindAddr: binding.bindAddr,
+        extensionsDir,
+        trustedOrigins,
+        userDataDir,
+        workspacePath,
+    });
+    if (launchMode === "direct") {
+        assertDirectLaunchAvailable(installation.entryPoint);
+    }
+    return launchMode === "node"
+        ? {
+            args: [installation.entryPoint, ...cliArgs],
+            bindAddr: binding.bindAddr,
+            codeServerPackageRoot: installation.packageRoot,
+            command: normalizeNodeCommand(options.nodeCommand),
+            entryPoint: installation.entryPoint,
+            extensionsDir,
+            host: binding.host,
+            launchMode,
+            port: binding.port,
+            supportRoot: installation.supportRoot,
+            userDataDir,
+            workspacePath,
+        }
+        : {
+            args: cliArgs,
+            bindAddr: binding.bindAddr,
+            codeServerPackageRoot: installation.packageRoot,
+            command: installation.entryPoint,
+            entryPoint: installation.entryPoint,
+            extensionsDir,
+            host: binding.host,
+            launchMode,
+            port: binding.port,
+            supportRoot: installation.supportRoot,
+            userDataDir,
+            workspacePath,
+        };
+}
+async function launchCodeServerProcess(options) {
+    const plan = options.plan;
+    const stdoutChunks = [];
+    const stderrChunks = [];
+    const child = spawn(plan.command, plan.args, {
+        cwd: options.cwd,
+        env: options.env ? { ...process.env, ...options.env } : process.env,
+        stdio: ["ignore", "pipe", "pipe"],
+    });
+    child.stdout?.on("data", (chunk) => {
+        const text = String(chunk);
+        stdoutChunks.push(text);
+        options.stdout?.(text);
+    });
+    child.stderr?.on("data", (chunk) => {
+        const text = String(chunk);
+        stderrChunks.push(text);
+        options.stderr?.(text);
+    });
+    const exit = new Promise((resolve) => {
+        child.once("close", (code, signal) => {
+            resolve({
+                code,
+                signal: typeof signal === "string" ? signal : null,
+            });
+        });
+    });
+    await new Promise((resolve, reject) => {
+        child.once("spawn", () => resolve());
+        child.once("error", (error) => reject(wrapSpawnError(error, plan)));
+    });
+    return {
+        args: [...plan.args],
+        bindAddr: plan.bindAddr,
+        child,
+        codeServerPackageRoot: plan.codeServerPackageRoot,
+        command: plan.command,
+        exit,
+        extensionsDir: plan.extensionsDir,
+        getStderr() {
+            return stderrChunks.join("");
+        },
+        getStdout() {
+            return stdoutChunks.join("");
+        },
+        host: plan.host,
+        kill(signal) {
+            return child.kill(signal);
+        },
+        launchMode: plan.launchMode,
+        pid: child.pid,
+        port: plan.port,
+        supportRoot: plan.supportRoot,
+        userDataDir: plan.userDataDir,
+        workspacePath: plan.workspacePath,
+    };
+}
+function buildCodeServerArgs(options) {
+    const args = [
+        "--auth",
+        "none",
+        "--bind-addr",
+        options.bindAddr,
+        "--disable-telemetry",
+        "--disable-update-check",
+        "--disable-workspace-trust",
+        "--disable-getting-started-override",
+        "--user-data-dir",
+        options.userDataDir,
+        "--extensions-dir",
+        options.extensionsDir,
+    ];
+    for (const origin of options.trustedOrigins) {
+        args.push("--trusted-origins", origin);
+    }
+    if (options.workspacePath) {
+        args.push(options.workspacePath);
+    }
+    return args;
+}
+function resolveLaunchDirectories(options) {
+    const dataRoot = options.dataRoot ? path.resolve(options.dataRoot) : null;
+    const userDataDir = options.userDataDir
+        ? path.resolve(options.userDataDir)
+        : dataRoot
+            ? path.join(dataRoot, "user-data")
+            : null;
+    const extensionsDir = options.extensionsDir
+        ? path.resolve(options.extensionsDir)
+        : dataRoot
+            ? path.join(dataRoot, "extensions")
+            : null;
+    if (!userDataDir || !extensionsDir) {
+        throw new TypeError("createCodeServerLaunch requires userDataDir and extensionsDir, or a shared dataRoot.");
+    }
+    return {
+        extensionsDir,
+        userDataDir,
+    };
+}
+async function resolveLaunchBinding(options) {
+    if (options.bindAddr && (options.host || options.port !== undefined)) {
+        throw new TypeError("Pass either bindAddr or host/port to createCodeServerLaunch, not both.");
+    }
+    if (options.bindAddr) {
+        const parsed = parseBindAddr(options.bindAddr);
+        const port = parsed.port === 0 ? await allocatePort(parsed.host) : parsed.port;
+        return {
+            bindAddr: formatBindAddr(parsed.host, port),
+            host: parsed.host,
+            port,
+        };
+    }
+    const host = normalizeHost(options.host);
+    const port = options.port == null || options.port === 0
+        ? await allocatePort(host)
+        : normalizePort(options.port);
+    return {
+        bindAddr: formatBindAddr(host, port),
+        host,
+        port,
+    };
+}
+function normalizeLaunchMode(requested, installation) {
+    if (requested === "direct" || requested === "node") {
+        return requested;
+    }
+    return installation.entryKind === "executable" ? "direct" : "node";
+}
+function normalizeTrustedOrigins(value) {
+    const normalized = [];
+    for (const origin of value ?? []) {
+        if (typeof origin !== "string")
+            continue;
+        const trimmed = origin.trim();
+        if (!trimmed || normalized.includes(trimmed))
+            continue;
+        normalized.push(trimmed);
+    }
+    return normalized;
+}
+function normalizeNodeCommand(value) {
+    const normalized = typeof value === "string" ? value.trim() : "";
+    return normalized || process.execPath;
+}
+function normalizeHost(value) {
+    const normalized = typeof value === "string" ? value.trim() : "";
+    return normalized || DEFAULT_BIND_HOST;
+}
+function normalizePort(value) {
+    if (!Number.isInteger(value) || value < 0 || value > 65535) {
+        throw new TypeError("Port must be an integer between 0 and 65535.");
+    }
+    return value;
+}
+function parseBindAddr(bindAddr) {
+    const normalized = bindAddr.trim();
+    const ipv6Match = /^\[(.+)\]:(\d+)$/.exec(normalized);
+    if (ipv6Match) {
+        return {
+            host: ipv6Match[1],
+            port: normalizePort(Number(ipv6Match[2])),
+        };
+    }
+    const lastColonIndex = normalized.lastIndexOf(":");
+    if (lastColonIndex <= 0) {
+        throw new TypeError("bindAddr must use host:port or [host]:port format.");
+    }
+    return {
+        host: normalized.slice(0, lastColonIndex),
+        port: normalizePort(Number(normalized.slice(lastColonIndex + 1))),
+    };
+}
+function formatBindAddr(host, port) {
+    return host.includes(":")
+        ? `[${host}]:${port}`
+        : `${host}:${port}`;
+}
+async function allocatePort(host) {
+    return await new Promise((resolve, reject) => {
+        const server = net.createServer();
+        server.once("error", (error) => {
+            reject(new CodeServerPortAllocationError("Could not allocate a code-server TCP port.", {
+                cause: error instanceof Error ? error.message : String(error),
+                host,
+            }));
+        });
+        server.listen(0, host, () => {
+            const address = server.address();
+            if (!address || typeof address === "string") {
+                server.close();
+                reject(new CodeServerPortAllocationError("Could not determine the allocated code-server TCP port.", {
+                    host,
+                }));
+                return;
+            }
+            server.close((error) => {
+                if (error) {
+                    reject(new CodeServerPortAllocationError("Could not release the allocated code-server TCP port.", {
+                        cause: error.message,
+                        host,
+                        port: address.port,
+                    }));
+                    return;
+                }
+                resolve(address.port);
+            });
+        });
+    });
+}
+function assertDirectLaunchAvailable(entryPoint) {
+    try {
+        fs.accessSync(entryPoint, DIRECT_LAUNCH_ACCESS);
+    }
+    catch (error) {
+        throw new CodeServerBinaryNotFoundError("Resolved code-server entrypoint is not directly executable.", {
+            cause: error instanceof Error ? error.message : String(error),
+            entryPoint,
+        });
+    }
+}
+function wrapSpawnError(error, plan) {
+    const errorCode = typeof error === "object" && error && "code" in error
+        ? String(error.code)
+        : null;
+    if (errorCode === "ENOENT") {
+        return new CodeServerBinaryNotFoundError("Could not launch the resolved code-server command.", {
+            args: plan.args,
+            command: plan.command,
+        });
+    }
+    return error instanceof Error ? error : new Error(String(error));
+}
+export { createCodeServerLaunch, launchCodeServerProcess };
+//# sourceMappingURL=launch.js.map

package/dist/launch.js.map

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

package/dist/readiness.d.ts

@@ -0,0 +1,4 @@
+import type { CodeServerReadyOptions, CodeServerReadyResult } from "./types.js";
+declare function waitForCodeServerReady(options: CodeServerReadyOptions): Promise<CodeServerReadyResult>;
+export { waitForCodeServerReady };
+//# sourceMappingURL=readiness.d.ts.map

package/dist/readiness.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"readiness.d.ts","sourceRoot":"","sources":["../src/readiness.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAyB,sBAAsB,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC;AAOvG,iBAAe,sBAAsB,CAAC,OAAO,EAAE,sBAAsB,GAAG,OAAO,CAAC,qBAAqB,CAAC,CA8CrG;AAiED,OAAO,EAAE,sBAAsB,EAAE,CAAC"}

package/dist/readiness.js

@@ -0,0 +1,97 @@
+import net from "node:net";
+import { CodeServerProcessExitedBeforeReadyError, CodeServerStartupTimeoutError, } from "./errors.js";
+const DEFAULT_READY_HOST = "127.0.0.1";
+const DEFAULT_READY_RETRY_INTERVAL_MS = 100;
+const DEFAULT_READY_TIMEOUT_MS = 30000;
+const CONNECT_ATTEMPT_TIMEOUT_MS = 400;
+async function waitForCodeServerReady(options) {
+    const host = normalizeReadyHost(options.host);
+    const port = normalizeReadyPort(options.port);
+    const retryIntervalMs = normalizePositiveDuration(options.retryIntervalMs, DEFAULT_READY_RETRY_INTERVAL_MS);
+    const timeoutMs = normalizePositiveDuration(options.timeoutMs, DEFAULT_READY_TIMEOUT_MS);
+    const startedAt = Date.now();
+    let exitResult = null;
+    if (options.process) {
+        void options.process.exit.then((result) => {
+            exitResult = result;
+        });
+    }
+    while (Date.now() - startedAt < timeoutMs) {
+        if (exitResult) {
+            throw createExitedBeforeReadyError(host, port, exitResult, options.process);
+        }
+        const remainingMs = timeoutMs - (Date.now() - startedAt);
+        const connected = await canConnect(host, port, Math.min(CONNECT_ATTEMPT_TIMEOUT_MS, remainingMs));
+        if (connected) {
+            return {
+                elapsedMs: Date.now() - startedAt,
+                host,
+                port,
+            };
+        }
+        if (exitResult) {
+            throw createExitedBeforeReadyError(host, port, exitResult, options.process);
+        }
+        await sleep(Math.min(retryIntervalMs, Math.max(remainingMs, 0)));
+    }
+    throw new CodeServerStartupTimeoutError("Timed out waiting for code-server to accept TCP connections.", {
+        host,
+        port,
+        stderr: options.process?.getStderr(),
+        stdout: options.process?.getStdout(),
+        timeoutMs,
+    });
+}
+async function canConnect(host, port, timeoutMs) {
+    return await new Promise((resolve) => {
+        const socket = net.connect({
+            host,
+            port,
+        });
+        let settled = false;
+        const finish = (value) => {
+            if (settled)
+                return;
+            settled = true;
+            socket.destroy();
+            resolve(value);
+        };
+        socket.setTimeout(Math.max(timeoutMs, 1));
+        socket.once("connect", () => finish(true));
+        socket.once("error", () => finish(false));
+        socket.once("timeout", () => finish(false));
+    });
+}
+function createExitedBeforeReadyError(host, port, exitResult, process) {
+    return new CodeServerProcessExitedBeforeReadyError("code-server exited before the TCP port became ready.", {
+        code: exitResult.code,
+        host,
+        port,
+        signal: exitResult.signal,
+        stderr: process?.getStderr(),
+        stdout: process?.getStdout(),
+    });
+}
+function normalizeReadyHost(value) {
+    const normalized = typeof value === "string" ? value.trim() : "";
+    return normalized || DEFAULT_READY_HOST;
+}
+function normalizeReadyPort(value) {
+    if (!Number.isInteger(value) || value < 1 || value > 65535) {
+        throw new TypeError("waitForCodeServerReady requires a TCP port between 1 and 65535.");
+    }
+    return value;
+}
+function normalizePositiveDuration(value, fallback) {
+    if (value == null)
+        return fallback;
+    if (!Number.isFinite(value) || value <= 0) {
+        throw new TypeError("Readiness durations must be greater than zero.");
+    }
+    return Math.floor(value);
+}
+function sleep(durationMs) {
+    return new Promise((resolve) => setTimeout(resolve, durationMs));
+}
+export { waitForCodeServerReady };
+//# sourceMappingURL=readiness.js.map

package/dist/readiness.js.map

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

package/dist/resolve.d.ts

@@ -0,0 +1,4 @@
+import type { CodeServerInstallation, ResolveCodeServerInstallationOptions } from "./types.js";
+declare function resolveCodeServerInstallation(options?: ResolveCodeServerInstallationOptions): CodeServerInstallation;
+export { resolveCodeServerInstallation };
+//# sourceMappingURL=resolve.d.ts.map

package/dist/resolve.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve.d.ts","sourceRoot":"","sources":["../src/resolve.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAuB,sBAAsB,EAAE,oCAAoC,EAAE,MAAM,YAAY,CAAC;AAQpH,iBAAS,6BAA6B,CAAC,OAAO,GAAE,oCAAyC,GAAG,sBAAsB,CAuBjH;AAsGD,OAAO,EAAE,6BAA6B,EAAE,CAAC"}

package/dist/resolve.js

@@ -0,0 +1,120 @@
+import fs from "node:fs";
+import path from "node:path";
+import { createRequire } from "node:module";
+import { CodeServerBinaryNotFoundError, CodeServerPackageResolutionError } from "./errors.js";
+function resolveCodeServerInstallation(options = {}) {
+    const packageJsonPath = resolveCodeServerPackageJsonPath(options.resolveFrom);
+    const packageRoot = path.dirname(packageJsonPath);
+    const packageJson = readCodeServerPackageJson(packageJsonPath);
+    const entryRelativePath = resolveEntryRelativePath(packageJson);
+    const entryPoint = path.resolve(packageRoot, entryRelativePath);
+    if (!isFile(entryPoint)) {
+        throw new CodeServerBinaryNotFoundError("Resolved code-server entrypoint was not found.", {
+            entryPoint,
+            packageJsonPath,
+            packageRoot,
+        });
+    }
+    return {
+        entryKind: detectEntryKind(entryPoint),
+        entryPoint,
+        packageJsonPath,
+        packageRoot,
+        supportRoot: resolveSupportRoot(packageRoot),
+        version: typeof packageJson.version === "string" ? packageJson.version : undefined,
+    };
+}
+function resolveCodeServerPackageJsonPath(resolveFrom) {
+    const anchorPath = createResolutionAnchor(resolveFrom);
+    const requireFrom = createRequire(anchorPath);
+    try {
+        return requireFrom.resolve("code-server/package.json");
+    }
+    catch (error) {
+        throw new CodeServerPackageResolutionError("Could not resolve the installed code-server package.", {
+            cause: error instanceof Error ? error.message : String(error),
+            resolveFrom: resolveFrom ? path.resolve(resolveFrom) : process.cwd(),
+        });
+    }
+}
+function createResolutionAnchor(resolveFrom) {
+    const resolved = path.resolve(resolveFrom ?? process.cwd());
+    try {
+        const stats = fs.statSync(resolved);
+        return stats.isDirectory()
+            ? path.join(resolved, "__code_server_kit__.js")
+            : resolved;
+    }
+    catch {
+        return path.extname(resolved)
+            ? resolved
+            : path.join(resolved, "__code_server_kit__.js");
+    }
+}
+function readCodeServerPackageJson(packageJsonPath) {
+    try {
+        return JSON.parse(fs.readFileSync(packageJsonPath, "utf8"));
+    }
+    catch (error) {
+        throw new CodeServerPackageResolutionError("Could not read the resolved code-server package metadata.", {
+            cause: error instanceof Error ? error.message : String(error),
+            packageJsonPath,
+        });
+    }
+}
+function resolveEntryRelativePath(packageJson) {
+    if (typeof packageJson.bin === "string" && packageJson.bin.trim()) {
+        return packageJson.bin;
+    }
+    if (packageJson.bin && typeof packageJson.bin === "object") {
+        const binPath = packageJson.bin["code-server"];
+        if (typeof binPath === "string" && binPath.trim()) {
+            return binPath;
+        }
+    }
+    if (typeof packageJson.main === "string" && packageJson.main.trim()) {
+        return packageJson.main;
+    }
+    throw new CodeServerPackageResolutionError("The installed code-server package does not expose a launch entrypoint.", {});
+}
+function detectEntryKind(entryPoint) {
+    const extension = path.extname(entryPoint).toLowerCase();
+    if (extension === ".cjs" || extension === ".js" || extension === ".mjs") {
+        return "node_script";
+    }
+    try {
+        const handle = fs.openSync(entryPoint, "r");
+        const buffer = Buffer.alloc(128);
+        const length = fs.readSync(handle, buffer, 0, buffer.length, 0);
+        fs.closeSync(handle);
+        const header = buffer.toString("utf8", 0, length);
+        return header.startsWith("#!") && header.includes("node")
+            ? "node_script"
+            : "executable";
+    }
+    catch {
+        return "executable";
+    }
+}
+function resolveSupportRoot(packageRoot) {
+    const supportRoot = path.join(packageRoot, "lib", "vscode");
+    return isDirectory(supportRoot) ? supportRoot : null;
+}
+function isDirectory(value) {
+    try {
+        return fs.statSync(value).isDirectory();
+    }
+    catch {
+        return false;
+    }
+}
+function isFile(value) {
+    try {
+        return fs.statSync(value).isFile();
+    }
+    catch {
+        return false;
+    }
+}
+export { resolveCodeServerInstallation };
+//# sourceMappingURL=resolve.js.map

package/dist/resolve.js.map

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

package/dist/types.d.ts

@@ -0,0 +1,86 @@
+import type { ChildProcess } from "node:child_process";
+type CodeServerEntryKind = "node_script" | "executable";
+type CodeServerLaunchMode = "auto" | "direct" | "node";
+type CodeServerInstallation = {
+    entryKind: CodeServerEntryKind;
+    entryPoint: string;
+    packageJsonPath: string;
+    packageRoot: string;
+    supportRoot: string | null;
+    version?: string;
+};
+type ResolveCodeServerInstallationOptions = {
+    resolveFrom?: string;
+};
+type CodeServerLaunchOptions = {
+    bindAddr?: string;
+    dataRoot?: string;
+    extensionsDir?: string;
+    host?: string;
+    installation?: CodeServerInstallation;
+    launchMode?: CodeServerLaunchMode;
+    nodeCommand?: string;
+    port?: number;
+    resolveFrom?: string;
+    trustedOrigins?: string[];
+    userDataDir?: string;
+    workspacePath?: string;
+};
+type CodeServerLaunchPlan = {
+    args: string[];
+    bindAddr: string;
+    codeServerPackageRoot: string;
+    command: string;
+    entryPoint: string;
+    extensionsDir: string;
+    host: string;
+    launchMode: Exclude<CodeServerLaunchMode, "auto">;
+    port: number;
+    supportRoot: string | null;
+    userDataDir: string;
+    workspacePath: string | null;
+};
+type CodeServerProcessExit = {
+    code: number | null;
+    signal: NodeJS.Signals | null;
+};
+type CodeServerProcessHandle = {
+    args: string[];
+    bindAddr: string;
+    child: ChildProcess;
+    codeServerPackageRoot: string;
+    command: string;
+    exit: Promise<CodeServerProcessExit>;
+    extensionsDir: string;
+    getStderr(): string;
+    getStdout(): string;
+    host: string;
+    kill(signal?: NodeJS.Signals | number): boolean;
+    launchMode: Exclude<CodeServerLaunchMode, "auto">;
+    pid: number | undefined;
+    port: number;
+    supportRoot: string | null;
+    userDataDir: string;
+    workspacePath: string | null;
+};
+type CodeServerReadyOptions = {
+    host?: string;
+    port: number;
+    process?: CodeServerProcessHandle;
+    retryIntervalMs?: number;
+    timeoutMs?: number;
+};
+type CodeServerReadyResult = {
+    elapsedMs: number;
+    host: string;
+    port: number;
+};
+type LaunchCodeServerProcessOptions = {
+    cwd?: string;
+    env?: NodeJS.ProcessEnv;
+    plan: CodeServerLaunchPlan;
+    stderr?(text: string): void;
+    stdout?(text: string): void;
+};
+export type { CodeServerEntryKind, CodeServerInstallation, CodeServerLaunchMode, CodeServerLaunchOptions, CodeServerLaunchPlan, CodeServerProcessExit, CodeServerProcessHandle, CodeServerReadyOptions, CodeServerReadyResult, LaunchCodeServerProcessOptions, ResolveCodeServerInstallationOptions, };
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

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

package/dist/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}

package/package.json

@@ -0,0 +1,58 @@
+{
+  "name": "@trebired/code-server-kit",
+  "version": "0.1.0",
+  "description": "Framework-agnostic code-server launch kit for Node.js apps with installation resolution, launch planning, readiness checks, and process helpers.",
+  "license": "MIT",
+  "keywords": [
+    "code-server",
+    "node",
+    "launcher",
+    "backend",
+    "integration"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/Trebired/code-server-kit"
+  },
+  "bugs": {
+    "url": "https://github.com/Trebired/code-server-kit/issues"
+  },
+  "homepage": "https://github.com/Trebired/code-server-kit#readme",
+  "type": "module",
+  "engines": {
+    "node": ">=22"
+  },
+  "private": false,
+  "publishConfig": {
+    "access": "public"
+  },
+  "packageManager": "bun@1.3.12",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "CHANGELOG.md",
+    "LICENSE",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "rm -rf dist && tsc -p tsconfig.build.json",
+    "prepublishOnly": "bun run typecheck && bun test && bun run build",
+    "test": "bun test",
+    "typecheck": "tsc --noEmit"
+  },
+  "dependencies": {
+    "code-server": "^4.117.0"
+  },
+  "devDependencies": {
+    "@types/bun": "^1.3.4",
+    "@types/node": "^24.10.1",
+    "typescript": "^6.0.2"
+  }
+}