@trebired/code-server-kit 0.2.0 → 1.0.0

package/dist/diagnostics.js

@@ -0,0 +1,150 @@
+import { isCodeServerKitError } from "./errors.js";
+function collectCodeServerStartupDiagnostics(options = {}) {
+    const normalized = normalizeError(options.error);
+    const category = options.category ?? deriveCategory(normalized.code);
+    const stderrTail = trimTail(options.process?.getStderr?.() ?? "");
+    const stdoutTail = trimTail(options.process?.getStdout?.() ?? "");
+    const journalSummary = trimTail(options.journal ?? "");
+    const details = {
+        ...normalized.details,
+        ...(options.preparationStatus
+            ? {
+                preparationIssues: options.preparationStatus.issues,
+                preparationState: options.preparationStatus.state,
+            }
+            : {}),
+    };
+    const diagnostics = {
+        category,
+        code: normalized.code ?? category,
+        details,
+        journalSummary: journalSummary || undefined,
+        launchStrategy: options.launchStrategy ?? null,
+        stderrTail: stderrTail || undefined,
+        stdoutTail: stdoutTail || undefined,
+        summary: buildSummary(category, normalized.message),
+        watchdogMode: options.watchdogMode ?? options.preparationStatus?.watchdogMode,
+    };
+    if (options.sanitizer) {
+        diagnostics.sanitized = sanitizeCodeServerDiagnostics(diagnostics, options.sanitizer);
+    }
+    return diagnostics;
+}
+function sanitizeCodeServerDiagnostics(diagnostics, options) {
+    const redact = createRedactor(options);
+    return {
+        details: JSON.parse(redact(JSON.stringify(diagnostics.details))),
+        summary: redact(diagnostics.summary),
+    };
+}
+function normalizeCodeServerStartupFailure(error, options = {}) {
+    const normalized = normalizeError(error);
+    const diagnostics = collectCodeServerStartupDiagnostics({
+        ...options,
+        error,
+    });
+    return {
+        ...diagnostics,
+        isCodeServerKitError: normalized.isCodeServerKitError,
+        name: normalized.name,
+    };
+}
+function deriveCategory(code) {
+    switch (code) {
+        case "entrypoint_resolution_failed":
+            return "entrypoint_resolution_failed";
+        case "invalid_configuration":
+            return "invalid_configuration";
+        case "preparation_failed":
+            return "preparation_failed";
+        case "process_exited_before_ready":
+            return "process_exited_before_ready";
+        case "startup_timeout":
+            return "startup_timeout";
+        case "systemd_launch_failed":
+            return "systemd_launch_failed";
+        case "systemd_status_failed":
+        case "systemd_collision":
+            return "systemd_unit_failed";
+        default:
+            if (code?.includes("watchdog") || code?.includes("dependency")) {
+                return "missing_runtime_dependency";
+            }
+            return "unknown";
+    }
+}
+function buildSummary(category, message) {
+    switch (category) {
+        case "entrypoint_resolution_failed":
+            return `Could not resolve the code-server entrypoint. ${message}`;
+        case "invalid_configuration":
+            return `The code-server launch configuration is invalid. ${message}`;
+        case "missing_runtime_dependency":
+            return `A code-server runtime dependency is missing. ${message}`;
+        case "preparation_failed":
+            return `The code-server package could not be prepared. ${message}`;
+        case "process_exited_before_ready":
+            return `code-server exited before it became ready. ${message}`;
+        case "startup_timeout":
+            return `Timed out waiting for code-server to become ready. ${message}`;
+        case "systemd_launch_failed":
+            return `systemd could not launch the code-server unit. ${message}`;
+        case "systemd_unit_failed":
+            return `The code-server systemd unit failed during startup. ${message}`;
+        default:
+            return message;
+    }
+}
+function createRedactor(options) {
+    return (value) => {
+        let next = value;
+        for (const prefix of options.pathPrefixes ?? []) {
+            next = next.split(prefix).join("<redacted-path>");
+        }
+        for (const current of options.values ?? []) {
+            next = next.split(current).join("<redacted>");
+        }
+        if (options.replacer) {
+            next = options.replacer(next);
+        }
+        return next;
+    };
+}
+function normalizeError(error) {
+    if (isCodeServerKitError(error)) {
+        return {
+            code: error.code,
+            details: {
+                ...error.details,
+            },
+            isCodeServerKitError: true,
+            message: error.message,
+            name: error.name,
+        };
+    }
+    if (error instanceof Error) {
+        return {
+            code: typeof error.code === "string"
+                ? String(error.code)
+                : null,
+            details: {},
+            isCodeServerKitError: false,
+            message: error.message,
+            name: error.name,
+        };
+    }
+    return {
+        code: null,
+        details: {},
+        isCodeServerKitError: false,
+        message: String(error),
+        name: "Error",
+    };
+}
+function trimTail(value, limit = 8192) {
+    return value.length > limit
+        ? value.slice(value.length - limit)
+        : value;
+}
+export { collectCodeServerStartupDiagnostics, normalizeCodeServerStartupFailure, sanitizeCodeServerDiagnostics, };
+//# sourceMappingURL=diagnostics.js.map

package/dist/diagnostics.js.map

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

package/dist/errors.d.ts

@@ -1,4 +1,4 @@
-type CodeServerKitErrorCode = "entrypoint_resolution_failed" | "installation_resolution_failed" | "invalid_configuration" | "launch_planning_failed" | "port_allocation_failed" | "process_exited_before_ready" | "startup_probe_failed" | "startup_timeout";
+type CodeServerKitErrorCode = "entrypoint_resolution_failed" | "installation_resolution_failed" | "invalid_configuration" | "launch_planning_failed" | "port_allocation_failed" | "preparation_failed" | "process_exited_before_ready" | "session_lifecycle_failed" | "session_reuse_conflict" | "startup_probe_failed" | "startup_timeout" | "systemd_collision" | "systemd_journal_failed" | "systemd_launch_failed" | "systemd_status_failed";
 declare class CodeServerKitError extends Error {
     code: CodeServerKitErrorCode | string;
     details: Record<string, unknown>;
@@ -19,6 +19,9 @@ declare class CodeServerInvalidConfigurationError extends CodeServerKitError {
 declare class CodeServerPortAllocationError extends CodeServerKitError {
     constructor(message: string, details?: Record<string, unknown>);
 }
+declare class CodeServerPreparationError extends CodeServerKitError {
+    constructor(message: string, details?: Record<string, unknown>);
+}
 declare class CodeServerProcessExitedBeforeReadyError extends CodeServerKitError {
     constructor(message: string, details?: Record<string, unknown>);
 }
@@ -28,6 +31,24 @@ declare class CodeServerStartupTimeoutError extends CodeServerKitError {
 declare class CodeServerStartupProbeError extends CodeServerKitError {
     constructor(message: string, details?: Record<string, unknown>);
 }
+declare class CodeServerSessionLifecycleError extends CodeServerKitError {
+    constructor(message: string, details?: Record<string, unknown>);
+}
+declare class CodeServerSessionReuseConflictError extends CodeServerKitError {
+    constructor(message: string, details?: Record<string, unknown>);
+}
+declare class CodeServerSystemdLaunchError extends CodeServerKitError {
+    constructor(message: string, details?: Record<string, unknown>);
+}
+declare class CodeServerSystemdCollisionError extends CodeServerKitError {
+    constructor(message: string, details?: Record<string, unknown>);
+}
+declare class CodeServerSystemdStatusError extends CodeServerKitError {
+    constructor(message: string, details?: Record<string, unknown>);
+}
+declare class CodeServerSystemdJournalError extends CodeServerKitError {
+    constructor(message: string, details?: Record<string, unknown>);
+}
 declare class CodeServerPackageResolutionError extends CodeServerInstallationResolutionError {
     constructor(message: string, details?: Record<string, unknown>);
 }
@@ -35,6 +56,6 @@ declare class CodeServerBinaryNotFoundError extends CodeServerEntrypointResoluti
     constructor(message: string, details?: Record<string, unknown>);
 }
 declare function isCodeServerKitError(value: unknown): value is CodeServerKitError;
-export { CodeServerBinaryNotFoundError, CodeServerEntrypointResolutionError, CodeServerInstallationResolutionError, CodeServerInvalidConfigurationError, CodeServerKitError, CodeServerLaunchPlanningError, CodeServerPackageResolutionError, CodeServerPortAllocationError, CodeServerProcessExitedBeforeReadyError, CodeServerStartupProbeError, CodeServerStartupTimeoutError, isCodeServerKitError, };
+export { CodeServerBinaryNotFoundError, CodeServerEntrypointResolutionError, CodeServerInstallationResolutionError, CodeServerInvalidConfigurationError, CodeServerKitError, CodeServerLaunchPlanningError, CodeServerPackageResolutionError, CodeServerPortAllocationError, CodeServerPreparationError, CodeServerProcessExitedBeforeReadyError, CodeServerSessionLifecycleError, CodeServerSessionReuseConflictError, CodeServerStartupProbeError, CodeServerStartupTimeoutError, CodeServerSystemdCollisionError, CodeServerSystemdJournalError, CodeServerSystemdLaunchError, CodeServerSystemdStatusError, isCodeServerKitError, };
 export type { CodeServerKitErrorCode };
 //# sourceMappingURL=errors.d.ts.map

package/dist/errors.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA,KAAK,sBAAsB,GACvB,8BAA8B,GAC9B,gCAAgC,GAChC,uBAAuB,GACvB,wBAAwB,GACxB,wBAAwB,GACxB,6BAA6B,GAC7B,sBAAsB,GACtB,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,qCAAsC,SAAQ,kBAAkB;gBACxD,OAAO,EAAE,MAAM,EAAE,OAAO,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM;CAInE;AAED,cAAM,mCAAoC,SAAQ,kBAAkB;gBACtD,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,mCAAoC,SAAQ,kBAAkB;gBACtD,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,cAAM,2BAA4B,SAAQ,kBAAkB;gBAC9C,OAAO,EAAE,MAAM,EAAE,OAAO,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM;CAInE;AAED,cAAM,gCAAiC,SAAQ,qCAAqC;gBACtE,OAAO,EAAE,MAAM,EAAE,OAAO,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM;CAInE;AAED,cAAM,6BAA8B,SAAQ,mCAAmC;gBACjE,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,mCAAmC,EACnC,qCAAqC,EACrC,mCAAmC,EACnC,kBAAkB,EAClB,6BAA6B,EAC7B,gCAAgC,EAChC,6BAA6B,EAC7B,uCAAuC,EACvC,2BAA2B,EAC3B,6BAA6B,EAC7B,oBAAoB,GACrB,CAAC;AACF,YAAY,EAAE,sBAAsB,EAAE,CAAC"}
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"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"}

package/dist/errors.js

@@ -36,6 +36,12 @@ class CodeServerPortAllocationError extends CodeServerKitError {
         this.name = "CodeServerPortAllocationError";
     }
 }
+class CodeServerPreparationError extends CodeServerKitError {
+    constructor(message, details = {}) {
+        super("preparation_failed", message, details);
+        this.name = "CodeServerPreparationError";
+    }
+}
 class CodeServerProcessExitedBeforeReadyError extends CodeServerKitError {
     constructor(message, details = {}) {
         super("process_exited_before_ready", message, details);
@@ -54,6 +60,42 @@ class CodeServerStartupProbeError extends CodeServerKitError {
         this.name = "CodeServerStartupProbeError";
     }
 }
+class CodeServerSessionLifecycleError extends CodeServerKitError {
+    constructor(message, details = {}) {
+        super("session_lifecycle_failed", message, details);
+        this.name = "CodeServerSessionLifecycleError";
+    }
+}
+class CodeServerSessionReuseConflictError extends CodeServerKitError {
+    constructor(message, details = {}) {
+        super("session_reuse_conflict", message, details);
+        this.name = "CodeServerSessionReuseConflictError";
+    }
+}
+class CodeServerSystemdLaunchError extends CodeServerKitError {
+    constructor(message, details = {}) {
+        super("systemd_launch_failed", message, details);
+        this.name = "CodeServerSystemdLaunchError";
+    }
+}
+class CodeServerSystemdCollisionError extends CodeServerKitError {
+    constructor(message, details = {}) {
+        super("systemd_collision", message, details);
+        this.name = "CodeServerSystemdCollisionError";
+    }
+}
+class CodeServerSystemdStatusError extends CodeServerKitError {
+    constructor(message, details = {}) {
+        super("systemd_status_failed", message, details);
+        this.name = "CodeServerSystemdStatusError";
+    }
+}
+class CodeServerSystemdJournalError extends CodeServerKitError {
+    constructor(message, details = {}) {
+        super("systemd_journal_failed", message, details);
+        this.name = "CodeServerSystemdJournalError";
+    }
+}
 class CodeServerPackageResolutionError extends CodeServerInstallationResolutionError {
     constructor(message, details = {}) {
         super(message, details);
@@ -69,5 +111,5 @@ class CodeServerBinaryNotFoundError extends CodeServerEntrypointResolutionError
 function isCodeServerKitError(value) {
     return value instanceof CodeServerKitError;
 }
-export { CodeServerBinaryNotFoundError, CodeServerEntrypointResolutionError, CodeServerInstallationResolutionError, CodeServerInvalidConfigurationError, CodeServerKitError, CodeServerLaunchPlanningError, CodeServerPackageResolutionError, CodeServerPortAllocationError, CodeServerProcessExitedBeforeReadyError, CodeServerStartupProbeError, CodeServerStartupTimeoutError, isCodeServerKitError, };
+export { CodeServerBinaryNotFoundError, CodeServerEntrypointResolutionError, CodeServerInstallationResolutionError, CodeServerInvalidConfigurationError, CodeServerKitError, CodeServerLaunchPlanningError, CodeServerPackageResolutionError, CodeServerPortAllocationError, CodeServerPreparationError, CodeServerProcessExitedBeforeReadyError, CodeServerSessionLifecycleError, CodeServerSessionReuseConflictError, CodeServerStartupProbeError, CodeServerStartupTimeoutError, CodeServerSystemdCollisionError, CodeServerSystemdJournalError, CodeServerSystemdLaunchError, CodeServerSystemdStatusError, isCodeServerKitError, };
 //# sourceMappingURL=errors.js.map

package/dist/errors.js.map

@@ -1 +1 @@
-{"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAiBA,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,qCAAsC,SAAQ,kBAAkB;IACpE,YAAY,OAAe,EAAE,UAAmC,EAAE;QAChE,KAAK,CAAC,gCAAgC,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;QAC1D,IAAI,CAAC,IAAI,GAAG,uCAAuC,CAAC;IACtD,CAAC;CACF;AAED,MAAM,mCAAoC,SAAQ,kBAAkB;IAClE,YAAY,OAAe,EAAE,UAAmC,EAAE;QAChE,KAAK,CAAC,8BAA8B,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;QACxD,IAAI,CAAC,IAAI,GAAG,qCAAqC,CAAC;IACpD,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,mCAAoC,SAAQ,kBAAkB;IAClE,YAAY,OAAe,EAAE,UAAmC,EAAE;QAChE,KAAK,CAAC,uBAAuB,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;QACjD,IAAI,CAAC,IAAI,GAAG,qCAAqC,CAAC;IACpD,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,0BAA2B,SAAQ,kBAAkB;IACzD,YAAY,OAAe,EAAE,UAAmC,EAAE;QAChE,KAAK,CAAC,oBAAoB,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;QAC9C,IAAI,CAAC,IAAI,GAAG,4BAA4B,CAAC;IAC3C,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,MAAM,2BAA4B,SAAQ,kBAAkB;IAC1D,YAAY,OAAe,EAAE,UAAmC,EAAE;QAChE,KAAK,CAAC,sBAAsB,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;QAChD,IAAI,CAAC,IAAI,GAAG,6BAA6B,CAAC;IAC5C,CAAC;CACF;AAED,MAAM,+BAAgC,SAAQ,kBAAkB;IAC9D,YAAY,OAAe,EAAE,UAAmC,EAAE;QAChE,KAAK,CAAC,0BAA0B,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;QACpD,IAAI,CAAC,IAAI,GAAG,iCAAiC,CAAC;IAChD,CAAC;CACF;AAED,MAAM,mCAAoC,SAAQ,kBAAkB;IAClE,YAAY,OAAe,EAAE,UAAmC,EAAE;QAChE,KAAK,CAAC,wBAAwB,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;QAClD,IAAI,CAAC,IAAI,GAAG,qCAAqC,CAAC;IACpD,CAAC;CACF;AAED,MAAM,4BAA6B,SAAQ,kBAAkB;IAC3D,YAAY,OAAe,EAAE,UAAmC,EAAE;QAChE,KAAK,CAAC,uBAAuB,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;QACjD,IAAI,CAAC,IAAI,GAAG,8BAA8B,CAAC;IAC7C,CAAC;CACF;AAED,MAAM,+BAAgC,SAAQ,kBAAkB;IAC9D,YAAY,OAAe,EAAE,UAAmC,EAAE;QAChE,KAAK,CAAC,mBAAmB,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;QAC7C,IAAI,CAAC,IAAI,GAAG,iCAAiC,CAAC;IAChD,CAAC;CACF;AAED,MAAM,4BAA6B,SAAQ,kBAAkB;IAC3D,YAAY,OAAe,EAAE,UAAmC,EAAE;QAChE,KAAK,CAAC,uBAAuB,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;QACjD,IAAI,CAAC,IAAI,GAAG,8BAA8B,CAAC;IAC7C,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,gCAAiC,SAAQ,qCAAqC;IAClF,YAAY,OAAe,EAAE,UAAmC,EAAE;QAChE,KAAK,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;QACxB,IAAI,CAAC,IAAI,GAAG,kCAAkC,CAAC;IACjD,CAAC;CACF;AAED,MAAM,6BAA8B,SAAQ,mCAAmC;IAC7E,YAAY,OAAe,EAAE,UAAmC,EAAE;QAChE,KAAK,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;QACxB,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,mCAAmC,EACnC,qCAAqC,EACrC,mCAAmC,EACnC,kBAAkB,EAClB,6BAA6B,EAC7B,gCAAgC,EAChC,6BAA6B,EAC7B,0BAA0B,EAC1B,uCAAuC,EACvC,+BAA+B,EAC/B,mCAAmC,EACnC,2BAA2B,EAC3B,6BAA6B,EAC7B,+BAA+B,EAC/B,6BAA6B,EAC7B,4BAA4B,EAC5B,4BAA4B,EAC5B,oBAAoB,GACrB,CAAC"}

package/dist/index.d.ts

@@ -1,11 +1,16 @@
-export { CodeServerBinaryNotFoundError, CodeServerEntrypointResolutionError, CodeServerInstallationResolutionError, CodeServerInvalidConfigurationError, CodeServerKitError, CodeServerLaunchPlanningError, CodeServerPackageResolutionError, CodeServerPortAllocationError, CodeServerProcessExitedBeforeReadyError, CodeServerStartupProbeError, CodeServerStartupTimeoutError, isCodeServerKitError, } from "./errors.js";
+export { CodeServerBinaryNotFoundError, CodeServerEntrypointResolutionError, CodeServerInstallationResolutionError, CodeServerInvalidConfigurationError, CodeServerKitError, CodeServerLaunchPlanningError, CodeServerPackageResolutionError, CodeServerPortAllocationError, CodeServerPreparationError, CodeServerProcessExitedBeforeReadyError, CodeServerSessionLifecycleError, CodeServerSessionReuseConflictError, CodeServerStartupProbeError, CodeServerStartupTimeoutError, CodeServerSystemdCollisionError, CodeServerSystemdJournalError, CodeServerSystemdLaunchError, CodeServerSystemdStatusError, isCodeServerKitError, } from "./errors.js";
+export { collectCodeServerStartupDiagnostics, normalizeCodeServerStartupFailure, sanitizeCodeServerDiagnostics, } from "./diagnostics.js";
 export { launchCodeServerProcess } from "./launch.js";
-export { allocatePort, buildCodeServerArgs, buildCodeServerLaunchSpec, createCodeServerLaunch, createCodeServerLaunchPlan, normalizeTrustedOrigins, } from "./plan.js";
-export { DEFAULT_CODE_SERVER_PROFILE_ITEMS, DEFAULT_CODE_SERVER_PROFILE_PATHS, createCodeServerProfileSyncPlan, resolveCodeServerProfilePathMap, syncCodeServerProfile, } from "./profile.js";
-export { buildForwardedHeaders, isCodeServerHtmlResponse, normalizeTrustedOrigin, } from "./proxy.js";
+export { logPackageInitialized, resolveLogger } from "./logging.js";
+export { allocatePort, buildCodeServerArgs, buildCodeServerLaunchSpec, createCodeServerIntegrationPlan, createCodeServerLaunch, createCodeServerLaunchPlan, normalizeTrustedOrigins, } from "./plan.js";
+export { ensureCodeServerPrepared, getCodeServerPreparationStatus, } from "./preparation.js";
+export { DEFAULT_CODE_SERVER_PROFILE_ITEMS, DEFAULT_CODE_SERVER_PROFILE_PATHS, createCodeServerProfileSyncPlan, persistCodeServerProfileIfChanged, readCodeServerProfileSignature, readCodeServerProfileSnapshot, resolveCodeServerProfilePathMap, syncCodeServerProfile, } from "./profile.js";
+export { buildCodeServerWebSocketHeaders, buildForwardedHeaders, classifyCodeServerProxyFailure, isCodeServerHtmlResponse, normalizeTrustedOrigin, } from "./proxy.js";
 export { waitForCodeServerReady } from "./readiness.js";
 export { resolveCodeServerInstallation } from "./resolve.js";
-export { buildPathBindings, createCodeServerLaunchSpec, formatCodeServerCommand, normalizeCodeServerStartupFailure, } from "./spec.js";
-export type { BuildForwardedHeadersOptions, CodeServerEntryKind, CodeServerHtmlResponseOptions, CodeServerInstallation, CodeServerLaunchMode, CodeServerLaunchOptions, CodeServerLaunchPlan, CodeServerLaunchSpec, CodeServerPathAccessMode, CodeServerPathBinding, CodeServerProcessExit, CodeServerProcessHandle, CodeServerProfileEntryKind, CodeServerProfileItem, CodeServerProfilePathMap, CodeServerProfileSkipReason, CodeServerProfileSyncEntry, CodeServerProfileSyncPlan, CodeServerProfileSyncResult, CodeServerReadyFailure, CodeServerReadyFailureProbe, CodeServerReadyOptions, CodeServerReadyResult, CreateCodeServerLaunchPlanOptions, CreateCodeServerProfileSyncPlanOptions, LaunchCodeServerProcessOptions, NormalizedCodeServerStartupFailure, ResolveCodeServerInstallationOptions, SyncCodeServerProfileOptions, } from "./types.js";
+export { createCodeServerSessionManager, getCodeServerSessionStatus, readCodeServerSessionDiagnostics, restartCodeServerSession, startCodeServerSession, stopCodeServerSession, } from "./session.js";
+export { buildPathBindings, createCodeServerLaunchSpec, formatCodeServerCommand, } from "./spec.js";
+export { buildDefaultCodeServerUnitName, buildSystemdPathProperties, createCodeServerSystemdLaunchCommand, extractCodeServerSystemdFailure, launchCodeServerWithSystemd, normalizeSystemdUnitName, parseSystemdShowOutput, readCodeServerSystemdJournal, readCodeServerSystemdStatus, restartCodeServerSystemdUnit, summarizeCodeServerSystemdJournal, stopCodeServerSystemdUnit, } from "./systemd.js";
+export type { BuildCodeServerWebSocketHeadersOptions, BuildForwardedHeadersOptions, ClassifyCodeServerProxyFailureOptions, CodeServerDiagnosticCategory, CodeServerEntryKind, CodeServerHtmlResponseOptions, CodeServerInstallation, CodeServerIntegrationPlan, CodeServerKitGenericLogMethod, CodeServerKitLogEvent, CodeServerKitLogger, CodeServerKitLoggerAdapter, CodeServerKitLogMethod, CodeServerLaunchMode, CodeServerLaunchOptions, CodeServerLaunchPlan, CodeServerLaunchSpec, CodeServerLaunchStrategy, CodeServerPackageManagerHints, CodeServerPathAccessMode, CodeServerPathBinding, CodeServerPreparationIssue, CodeServerPreparationMode, CodeServerPreparationOptions, CodeServerPreparationResult, CodeServerPreparationState, CodeServerPreparationStatus, CodeServerProcessExit, CodeServerProcessHandle, CodeServerProfileEntryKind, CodeServerProfileItem, CodeServerProfileLifecycleOptions, CodeServerProfilePathMap, CodeServerProfilePersistPolicy, CodeServerProfileRestorePolicy, CodeServerProfileSignatureMode, CodeServerProfileSkipReason, CodeServerProfileSnapshot, CodeServerProfileSyncEntry, CodeServerProfileSyncPlan, CodeServerProfileSyncResult, CodeServerProxyFailure, CodeServerReadyFailure, CodeServerReadyFailureProbe, CodeServerReadyOptions, CodeServerReadyResult, CodeServerRuntimeDependencyIssue, CodeServerSanitizedDiagnostics, CodeServerSanitizerOptions, CodeServerSessionDiagnostics, CodeServerSessionFailure, CodeServerSessionHealth, CodeServerSessionManager, CodeServerSessionManagerOptions, CodeServerSessionRecord, CodeServerSessionRequest, CodeServerSessionRestartResult, CodeServerSessionStartResult, CodeServerSessionState, CodeServerSessionStatus, CodeServerSessionStopResult, CodeServerSystemdFailure, CodeServerSystemdJournalOptions, CodeServerSystemdLaunchCommand, CodeServerSystemdLaunchOptions, CodeServerSystemdLaunchResult, CodeServerSystemdOptions, CodeServerSystemdScope, CodeServerSystemdStatus, CodeServerSystemdStopOptions, CodeServerStartupDiagnostics, CodeServerTranslatedPath, CodeServerWatchdogMode, CollectCodeServerStartupDiagnosticsOptions, CreateCodeServerLaunchPlanOptions, CreateCodeServerProfileSyncPlanOptions, LaunchCodeServerProcessOptions, NormalizedCodeServerKitLogger, NormalizedCodeServerStartupFailure, PersistCodeServerProfileIfChangedOptions, PersistCodeServerProfileIfChangedResult, ReadCodeServerProfileSignatureOptions, ReadCodeServerProfileSnapshotOptions, ResolveCodeServerInstallationOptions, SyncCodeServerProfileOptions, } from "./types.js";
 export type { CodeServerKitErrorCode } from "./errors.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,6BAA6B,EAC7B,mCAAmC,EACnC,qCAAqC,EACrC,mCAAmC,EACnC,kBAAkB,EAClB,6BAA6B,EAC7B,gCAAgC,EAChC,6BAA6B,EAC7B,uCAAuC,EACvC,2BAA2B,EAC3B,6BAA6B,EAC7B,oBAAoB,GACrB,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,uBAAuB,EAAE,MAAM,aAAa,CAAC;AACtD,OAAO,EACL,YAAY,EACZ,mBAAmB,EACnB,yBAAyB,EACzB,sBAAsB,EACtB,0BAA0B,EAC1B,uBAAuB,GACxB,MAAM,WAAW,CAAC;AACnB,OAAO,EACL,iCAAiC,EACjC,iCAAiC,EACjC,+BAA+B,EAC/B,+BAA+B,EAC/B,qBAAqB,GACtB,MAAM,cAAc,CAAC;AACtB,OAAO,EACL,qBAAqB,EACrB,wBAAwB,EACxB,sBAAsB,GACvB,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,sBAAsB,EAAE,MAAM,gBAAgB,CAAC;AACxD,OAAO,EAAE,6BAA6B,EAAE,MAAM,cAAc,CAAC;AAC7D,OAAO,EACL,iBAAiB,EACjB,0BAA0B,EAC1B,uBAAuB,EACvB,iCAAiC,GAClC,MAAM,WAAW,CAAC;AAEnB,YAAY,EACV,4BAA4B,EAC5B,mBAAmB,EACnB,6BAA6B,EAC7B,sBAAsB,EACtB,oBAAoB,EACpB,uBAAuB,EACvB,oBAAoB,EACpB,oBAAoB,EACpB,wBAAwB,EACxB,qBAAqB,EACrB,qBAAqB,EACrB,uBAAuB,EACvB,0BAA0B,EAC1B,qBAAqB,EACrB,wBAAwB,EACxB,2BAA2B,EAC3B,0BAA0B,EAC1B,yBAAyB,EACzB,2BAA2B,EAC3B,sBAAsB,EACtB,2BAA2B,EAC3B,sBAAsB,EACtB,qBAAqB,EACrB,iCAAiC,EACjC,sCAAsC,EACtC,8BAA8B,EAC9B,kCAAkC,EAClC,oCAAoC,EACpC,4BAA4B,GAC7B,MAAM,YAAY,CAAC;AACpB,YAAY,EAAE,sBAAsB,EAAE,MAAM,aAAa,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/index.js

@@ -1,9 +1,14 @@
-export { CodeServerBinaryNotFoundError, CodeServerEntrypointResolutionError, CodeServerInstallationResolutionError, CodeServerInvalidConfigurationError, CodeServerKitError, CodeServerLaunchPlanningError, CodeServerPackageResolutionError, CodeServerPortAllocationError, CodeServerProcessExitedBeforeReadyError, CodeServerStartupProbeError, CodeServerStartupTimeoutError, isCodeServerKitError, } from "./errors.js";
+export { CodeServerBinaryNotFoundError, CodeServerEntrypointResolutionError, CodeServerInstallationResolutionError, CodeServerInvalidConfigurationError, CodeServerKitError, CodeServerLaunchPlanningError, CodeServerPackageResolutionError, CodeServerPortAllocationError, CodeServerPreparationError, CodeServerProcessExitedBeforeReadyError, CodeServerSessionLifecycleError, CodeServerSessionReuseConflictError, CodeServerStartupProbeError, CodeServerStartupTimeoutError, CodeServerSystemdCollisionError, CodeServerSystemdJournalError, CodeServerSystemdLaunchError, CodeServerSystemdStatusError, isCodeServerKitError, } from "./errors.js";
+export { collectCodeServerStartupDiagnostics, normalizeCodeServerStartupFailure, sanitizeCodeServerDiagnostics, } from "./diagnostics.js";
 export { launchCodeServerProcess } from "./launch.js";
-export { allocatePort, buildCodeServerArgs, buildCodeServerLaunchSpec, createCodeServerLaunch, createCodeServerLaunchPlan, normalizeTrustedOrigins, } from "./plan.js";
-export { DEFAULT_CODE_SERVER_PROFILE_ITEMS, DEFAULT_CODE_SERVER_PROFILE_PATHS, createCodeServerProfileSyncPlan, resolveCodeServerProfilePathMap, syncCodeServerProfile, } from "./profile.js";
-export { buildForwardedHeaders, isCodeServerHtmlResponse, normalizeTrustedOrigin, } from "./proxy.js";
+export { logPackageInitialized, resolveLogger } from "./logging.js";
+export { allocatePort, buildCodeServerArgs, buildCodeServerLaunchSpec, createCodeServerIntegrationPlan, createCodeServerLaunch, createCodeServerLaunchPlan, normalizeTrustedOrigins, } from "./plan.js";
+export { ensureCodeServerPrepared, getCodeServerPreparationStatus, } from "./preparation.js";
+export { DEFAULT_CODE_SERVER_PROFILE_ITEMS, DEFAULT_CODE_SERVER_PROFILE_PATHS, createCodeServerProfileSyncPlan, persistCodeServerProfileIfChanged, readCodeServerProfileSignature, readCodeServerProfileSnapshot, resolveCodeServerProfilePathMap, syncCodeServerProfile, } from "./profile.js";
+export { buildCodeServerWebSocketHeaders, buildForwardedHeaders, classifyCodeServerProxyFailure, isCodeServerHtmlResponse, normalizeTrustedOrigin, } from "./proxy.js";
 export { waitForCodeServerReady } from "./readiness.js";
 export { resolveCodeServerInstallation } from "./resolve.js";
-export { buildPathBindings, createCodeServerLaunchSpec, formatCodeServerCommand, normalizeCodeServerStartupFailure, } from "./spec.js";
+export { createCodeServerSessionManager, getCodeServerSessionStatus, readCodeServerSessionDiagnostics, restartCodeServerSession, startCodeServerSession, stopCodeServerSession, } from "./session.js";
+export { buildPathBindings, createCodeServerLaunchSpec, formatCodeServerCommand, } from "./spec.js";
+export { buildDefaultCodeServerUnitName, buildSystemdPathProperties, createCodeServerSystemdLaunchCommand, extractCodeServerSystemdFailure, launchCodeServerWithSystemd, normalizeSystemdUnitName, parseSystemdShowOutput, readCodeServerSystemdJournal, readCodeServerSystemdStatus, restartCodeServerSystemdUnit, summarizeCodeServerSystemdJournal, stopCodeServerSystemdUnit, } from "./systemd.js";
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,6BAA6B,EAC7B,mCAAmC,EACnC,qCAAqC,EACrC,mCAAmC,EACnC,kBAAkB,EAClB,6BAA6B,EAC7B,gCAAgC,EAChC,6BAA6B,EAC7B,uCAAuC,EACvC,2BAA2B,EAC3B,6BAA6B,EAC7B,oBAAoB,GACrB,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,uBAAuB,EAAE,MAAM,aAAa,CAAC;AACtD,OAAO,EACL,YAAY,EACZ,mBAAmB,EACnB,yBAAyB,EACzB,sBAAsB,EACtB,0BAA0B,EAC1B,uBAAuB,GACxB,MAAM,WAAW,CAAC;AACnB,OAAO,EACL,iCAAiC,EACjC,iCAAiC,EACjC,+BAA+B,EAC/B,+BAA+B,EAC/B,qBAAqB,GACtB,MAAM,cAAc,CAAC;AACtB,OAAO,EACL,qBAAqB,EACrB,wBAAwB,EACxB,sBAAsB,GACvB,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,sBAAsB,EAAE,MAAM,gBAAgB,CAAC;AACxD,OAAO,EAAE,6BAA6B,EAAE,MAAM,cAAc,CAAC;AAC7D,OAAO,EACL,iBAAiB,EACjB,0BAA0B,EAC1B,uBAAuB,EACvB,iCAAiC,GAClC,MAAM,WAAW,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,6BAA6B,EAC7B,mCAAmC,EACnC,qCAAqC,EACrC,mCAAmC,EACnC,kBAAkB,EAClB,6BAA6B,EAC7B,gCAAgC,EAChC,6BAA6B,EAC7B,0BAA0B,EAC1B,uCAAuC,EACvC,+BAA+B,EAC/B,mCAAmC,EACnC,2BAA2B,EAC3B,6BAA6B,EAC7B,+BAA+B,EAC/B,6BAA6B,EAC7B,4BAA4B,EAC5B,4BAA4B,EAC5B,oBAAoB,GACrB,MAAM,aAAa,CAAC;AACrB,OAAO,EACL,mCAAmC,EACnC,iCAAiC,EACjC,6BAA6B,GAC9B,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,uBAAuB,EAAE,MAAM,aAAa,CAAC;AACtD,OAAO,EAAE,qBAAqB,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AACpE,OAAO,EACL,YAAY,EACZ,mBAAmB,EACnB,yBAAyB,EACzB,+BAA+B,EAC/B,sBAAsB,EACtB,0BAA0B,EAC1B,uBAAuB,GACxB,MAAM,WAAW,CAAC;AACnB,OAAO,EACL,wBAAwB,EACxB,8BAA8B,GAC/B,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EACL,iCAAiC,EACjC,iCAAiC,EACjC,+BAA+B,EAC/B,iCAAiC,EACjC,8BAA8B,EAC9B,6BAA6B,EAC7B,+BAA+B,EAC/B,qBAAqB,GACtB,MAAM,cAAc,CAAC;AACtB,OAAO,EACL,+BAA+B,EAC/B,qBAAqB,EACrB,8BAA8B,EAC9B,wBAAwB,EACxB,sBAAsB,GACvB,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,sBAAsB,EAAE,MAAM,gBAAgB,CAAC;AACxD,OAAO,EAAE,6BAA6B,EAAE,MAAM,cAAc,CAAC;AAC7D,OAAO,EACL,8BAA8B,EAC9B,0BAA0B,EAC1B,gCAAgC,EAChC,wBAAwB,EACxB,sBAAsB,EACtB,qBAAqB,GACtB,MAAM,cAAc,CAAC;AACtB,OAAO,EACL,iBAAiB,EACjB,0BAA0B,EAC1B,uBAAuB,GACxB,MAAM,WAAW,CAAC;AACnB,OAAO,EACL,8BAA8B,EAC9B,0BAA0B,EAC1B,oCAAoC,EACpC,+BAA+B,EAC/B,2BAA2B,EAC3B,wBAAwB,EACxB,sBAAsB,EACtB,4BAA4B,EAC5B,2BAA2B,EAC3B,4BAA4B,EAC5B,iCAAiC,EACjC,yBAAyB,GAC1B,MAAM,cAAc,CAAC"}

package/dist/logging.d.ts

@@ -0,0 +1,5 @@
+import { logPackageInitialized } from "@trebired/logger-adapter";
+import type { CodeServerKitLogger, CodeServerKitLoggerAdapter, NormalizedCodeServerKitLogger } from "./types.js";
+declare function resolveLogger(logger?: CodeServerKitLogger, adapter?: CodeServerKitLoggerAdapter): NormalizedCodeServerKitLogger;
+export { logPackageInitialized, resolveLogger, };
+//# sourceMappingURL=logging.d.ts.map

package/dist/logging.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logging.d.ts","sourceRoot":"","sources":["../src/logging.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,qBAAqB,EAEtB,MAAM,0BAA0B,CAAC;AAElC,OAAO,KAAK,EACV,mBAAmB,EACnB,0BAA0B,EAC1B,6BAA6B,EAC9B,MAAM,YAAY,CAAC;AAEpB,iBAAS,aAAa,CACpB,MAAM,CAAC,EAAE,mBAAmB,EAC5B,OAAO,CAAC,EAAE,0BAA0B,GACnC,6BAA6B,CAO/B;AAED,OAAO,EACL,qBAAqB,EACrB,aAAa,GACd,CAAC"}

package/dist/logging.js

@@ -0,0 +1,11 @@
+import { logPackageInitialized, resolveLogger as resolveSharedLogger, } from "@trebired/logger-adapter";
+function resolveLogger(logger, adapter) {
+    return resolveSharedLogger({
+        adapter,
+        fallback: "console",
+        logger,
+        source: "@trebired/code-server-kit",
+    });
+}
+export { logPackageInitialized, resolveLogger, };
+//# sourceMappingURL=logging.js.map

package/dist/logging.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logging.js","sourceRoot":"","sources":["../src/logging.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,qBAAqB,EACrB,aAAa,IAAI,mBAAmB,GACrC,MAAM,0BAA0B,CAAC;AAQlC,SAAS,aAAa,CACpB,MAA4B,EAC5B,OAAoC;IAEpC,OAAO,mBAAmB,CAAC;QACzB,OAAO;QACP,QAAQ,EAAE,SAAS;QACnB,MAAM;QACN,MAAM,EAAE,2BAA2B;KACpC,CAAkC,CAAC;AACtC,CAAC;AAED,OAAO,EACL,qBAAqB,EACrB,aAAa,GACd,CAAC"}

package/dist/plan.d.ts

@@ -1,4 +1,5 @@
-import type { CodeServerLaunchOptions, CodeServerLaunchPlan, CodeServerLaunchSpec, CreateCodeServerLaunchPlanOptions } from "./types.js";
+import type { CodeServerIntegrationPlan, CodeServerLaunchOptions, CodeServerLaunchPlan, CodeServerLaunchSpec, CreateCodeServerLaunchPlanOptions } from "./types.js";
+declare function createCodeServerIntegrationPlan(options: CreateCodeServerLaunchPlanOptions): Promise<CodeServerIntegrationPlan>;
 declare function createCodeServerLaunchPlan(options: CreateCodeServerLaunchPlanOptions): Promise<CodeServerLaunchPlan>;
 declare function createCodeServerLaunch(options: CodeServerLaunchOptions): Promise<CodeServerLaunchPlan>;
 declare function buildCodeServerArgs(options: {
@@ -11,5 +12,5 @@ declare function buildCodeServerArgs(options: {
 declare function buildCodeServerLaunchSpec(plan: CodeServerLaunchPlan): CodeServerLaunchSpec;
 declare function normalizeTrustedOrigins(value?: string[]): string[];
 declare function allocatePort(host: string): Promise<number>;
-export { allocatePort, buildCodeServerArgs, buildCodeServerLaunchSpec, createCodeServerLaunch, createCodeServerLaunchPlan, normalizeTrustedOrigins, };
+export { allocatePort, buildCodeServerArgs, buildCodeServerLaunchSpec, createCodeServerIntegrationPlan, createCodeServerLaunch, createCodeServerLaunchPlan, normalizeTrustedOrigins, };
 //# sourceMappingURL=plan.d.ts.map

package/dist/plan.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"plan.d.ts","sourceRoot":"","sources":["../src/plan.ts"],"names":[],"mappings":"AAWA,OAAO,KAAK,EAEV,uBAAuB,EACvB,oBAAoB,EACpB,oBAAoB,EAGpB,iCAAiC,EAClC,MAAM,YAAY,CAAC;AAKpB,iBAAe,0BAA0B,CAAC,OAAO,EAAE,iCAAiC,GAAG,OAAO,CAAC,oBAAoB,CAAC,CAgGnH;AAED,iBAAe,sBAAsB,CAAC,OAAO,EAAE,uBAAuB,GAAG,OAAO,CAAC,oBAAoB,CAAC,CAErG;AAED,iBAAS,mBAAmB,CAAC,OAAO,EAAE;IACpC,QAAQ,EAAE,MAAM,CAAC;IACjB,aAAa,EAAE,MAAM,CAAC;IACtB,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,WAAW,EAAE,MAAM,CAAC;IACpB,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;CAC9B,GAAG,MAAM,EAAE,CAyBX;AAED,iBAAS,yBAAyB,CAAC,IAAI,EAAE,oBAAoB,GAAG,oBAAoB,CAgCnF;AAED,iBAAS,uBAAuB,CAAC,KAAK,CAAC,EAAE,MAAM,EAAE,GAAG,MAAM,EAAE,CA6B3D;AA+HD,iBAAe,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAmCzD;AAoDD,OAAO,EACL,YAAY,EACZ,mBAAmB,EACnB,yBAAyB,EACzB,sBAAsB,EACtB,0BAA0B,EAC1B,uBAAuB,GACxB,CAAC"}
+{"version":3,"file":"plan.d.ts","sourceRoot":"","sources":["../src/plan.ts"],"names":[],"mappings":"AAYA,OAAO,KAAK,EAEV,yBAAyB,EACzB,uBAAuB,EACvB,oBAAoB,EAEpB,oBAAoB,EAEpB,iCAAiC,EAClC,MAAM,YAAY,CAAC;AAKpB,iBAAe,+BAA+B,CAAC,OAAO,EAAE,iCAAiC,GAAG,OAAO,CAAC,yBAAyB,CAAC,CAwG7H;AAED,iBAAe,0BAA0B,CAAC,OAAO,EAAE,iCAAiC,GAAG,OAAO,CAAC,oBAAoB,CAAC,CAEnH;AAED,iBAAe,sBAAsB,CAAC,OAAO,EAAE,uBAAuB,GAAG,OAAO,CAAC,oBAAoB,CAAC,CAErG;AAED,iBAAS,mBAAmB,CAAC,OAAO,EAAE;IACpC,QAAQ,EAAE,MAAM,CAAC;IACjB,aAAa,EAAE,MAAM,CAAC;IACtB,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,WAAW,EAAE,MAAM,CAAC;IACpB,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;CAC9B,GAAG,MAAM,EAAE,CAyBX;AAED,iBAAS,yBAAyB,CAAC,IAAI,EAAE,oBAAoB,GAAG,oBAAoB,CAgCnF;AAED,iBAAS,uBAAuB,CAAC,KAAK,CAAC,EAAE,MAAM,EAAE,GAAG,MAAM,EAAE,CA6B3D;AA+HD,iBAAe,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAmCzD;AAyCD,OAAO,EACL,YAAY,EACZ,mBAAmB,EACnB,yBAAyB,EACzB,+BAA+B,EAC/B,sBAAsB,EACtB,0BAA0B,EAC1B,uBAAuB,GACxB,CAAC"}

package/dist/plan.js

@@ -2,21 +2,30 @@ import fs from "node:fs";
 import net from "node:net";
 import path from "node:path";
 import { CodeServerBinaryNotFoundError, CodeServerInvalidConfigurationError, CodeServerLaunchPlanningError, CodeServerPortAllocationError, } from "./errors.js";
+import { ensureCodeServerPrepared } from "./preparation.js";
 import { resolveCodeServerInstallation } from "./resolve.js";
 const DEFAULT_BIND_HOST = "127.0.0.1";
 const DIRECT_LAUNCH_ACCESS = fs.constants.X_OK;
-async function createCodeServerLaunchPlan(options) {
+async function createCodeServerIntegrationPlan(options) {
     try {
-        const installation = options.installation ?? resolveCodeServerInstallation({
+        if (options.preparation?.mode !== "skip") {
+            await ensureCodeServerPrepared({
+                resolveFrom: options.resolveFrom,
+                strictWatchdog: options.preparation?.strictWatchdog,
+            });
+        }
+        const installation = options.installation ?? await resolveCodeServerInstallation({
             resolveFrom: options.resolveFrom,
+            strictWatchdog: options.preparation?.strictWatchdog,
         });
         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 cwd = path.resolve(options.cwd ?? installation.packageRoot);
+        const cwd = path.resolve(options.cwd ?? installation.defaultCwd);
         const env = {
+            ...installation.defaultEnv,
             ...(options.env ?? {}),
         };
         const cliArgs = buildCodeServerArgs({
@@ -29,75 +38,76 @@ async function createCodeServerLaunchPlan(options) {
         if (launchMode === "direct") {
             assertDirectLaunchAvailable(installation.entryPoint);
         }
-        const supportBindings = buildSupportBindings(installation);
+        const command = launchMode === "node"
+            ? normalizeNodeCommand(options.nodeCommand)
+            : installation.entryPoint;
+        const args = launchMode === "node"
+            ? [installation.entryPoint, ...cliArgs]
+            : cliArgs;
         const recommendedReadablePaths = uniquePaths([
-            installation.packageRoot,
-            installation.entryPoint,
-            installation.supportRoot,
+            ...installation.recommendedReadablePaths,
             workspacePath,
         ]);
         const recommendedWritablePaths = uniquePaths([
             userDataDir,
             extensionsDir,
         ]);
-        return launchMode === "node"
-            ? {
-                args: [installation.entryPoint, ...cliArgs],
-                bindAddr: binding.bindAddr,
-                codeServerPackageRoot: installation.packageRoot,
-                command: normalizeNodeCommand(options.nodeCommand),
-                cwd,
-                entryKind: installation.entryKind,
-                entryPoint: installation.entryPoint,
-                env,
-                extensionsDir,
-                host: binding.host,
-                installation,
-                launchMode,
-                port: binding.port,
-                recommendedReadablePaths,
-                recommendedWritablePaths,
-                supportBindings,
-                supportRoot: installation.supportRoot,
-                trustedOrigins,
-                userDataDir,
-                workspacePath,
-            }
-            : {
-                args: cliArgs,
-                bindAddr: binding.bindAddr,
-                codeServerPackageRoot: installation.packageRoot,
-                command: installation.entryPoint,
-                cwd,
-                entryKind: installation.entryKind,
-                entryPoint: installation.entryPoint,
-                env,
-                extensionsDir,
-                host: binding.host,
-                installation,
-                launchMode,
-                port: binding.port,
-                recommendedReadablePaths,
-                recommendedWritablePaths,
-                supportBindings,
-                supportRoot: installation.supportRoot,
-                trustedOrigins,
-                userDataDir,
-                workspacePath,
-            };
+        const translatedPaths = uniquePaths([
+            installation.packageRoot,
+            installation.supportRoot,
+            workspacePath,
+            userDataDir,
+            extensionsDir,
+        ]).map((value) => ({
+            hostPath: value,
+            visiblePath: value,
+        }));
+        return {
+            args,
+            bindAddr: binding.bindAddr,
+            codeServerPackageRoot: installation.packageRoot,
+            command,
+            cwd,
+            defaultCwd: installation.defaultCwd,
+            defaultEnv: {
+                ...installation.defaultEnv,
+            },
+            entryKind: installation.entryKind,
+            entryPoint: installation.entryPoint,
+            env,
+            extensionsDir,
+            host: binding.host,
+            hostVisiblePaths: [...recommendedReadablePaths, ...recommendedWritablePaths],
+            installation,
+            launchMode,
+            port: binding.port,
+            preparationStatus: installation.preparationStatus,
+            recommendedReadablePaths,
+            recommendedWritablePaths,
+            sandboxVisiblePaths: translatedPaths.map((value) => value.visiblePath),
+            supportBindings: [...installation.supportBindings],
+            supportRoot: installation.supportRoot,
+            translatedPaths,
+            trustedOrigins,
+            userDataDir,
+            watchdogMode: installation.preparationStatus.watchdogMode,
+            workspacePath,
+        };
     }
     catch (error) {
-        if (error instanceof CodeServerLaunchPlanningError || error instanceof CodeServerInvalidConfigurationError) {
+        if (error instanceof CodeServerLaunchPlanningError ||
+            error instanceof CodeServerInvalidConfigurationError ||
+            error instanceof Error && "code" in error) {
             throw error;
         }
-        if (error instanceof Error && "code" in error) {
-            throw error;
-        }
-        throw new CodeServerLaunchPlanningError("Could not create a code-server launch plan.", {
+        throw new CodeServerLaunchPlanningError("Could not create a code-server integration plan.", {
             cause: error instanceof Error ? error.message : String(error),
         });
     }
 }
+async function createCodeServerLaunchPlan(options) {
+    return await createCodeServerIntegrationPlan(options);
+}
 async function createCodeServerLaunch(options) {
     return await createCodeServerLaunchPlan(options);
 }
@@ -317,16 +327,6 @@ function assertDirectLaunchAvailable(entryPoint) {
         });
     }
 }
-function buildSupportBindings(installation) {
-    if (!installation.supportRoot)
-        return [];
-    return [{
-            access: "read",
-            hostPath: installation.supportRoot,
-            mountPath: installation.supportRoot,
-            reason: "code-server support root",
-        }];
-}
 function uniquePaths(values) {
     const normalized = [];
     for (const value of values) {
@@ -351,5 +351,5 @@ function uniqueBindings(values) {
     }
     return bindings;
 }
-export { allocatePort, buildCodeServerArgs, buildCodeServerLaunchSpec, createCodeServerLaunch, createCodeServerLaunchPlan, normalizeTrustedOrigins, };
+export { allocatePort, buildCodeServerArgs, buildCodeServerLaunchSpec, createCodeServerIntegrationPlan, createCodeServerLaunch, createCodeServerLaunchPlan, normalizeTrustedOrigins, };
 //# sourceMappingURL=plan.js.map