@undefineds.co/xpod 0.2.0 → 0.2.1

package/dist/runtime/environment.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"environment.js","sourceRoot":"","sources":["../../src/runtime/environment.ts"],"names":[],"mappings":";;AAYA,0EAuBC;AAnCD,2CAAoD;AACpD,2CAAiG;AACjG,6EAA0E;AAU1E,SAAgB,+BAA+B,CAC7C,KAA4B,EAC5B,OAA2B,EAC3B,WAA4B,yCAAmB;IAE/C,MAAM,WAAW,GAAG,KAAK,CAAC,WAAW,CAAC,CAAC,CAAC,IAAA,uBAAW,EAAC,KAAK,CAAC,WAAW,EAAE,QAAQ,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IACtF,MAAM,GAAG,GAAG,IAAA,2BAAe,EAAC,KAAK,EAAE,OAAO,EAAE,WAAW,CAAC,CAAC;IACzD,MAAM,UAAU,GAAG,IAAA,oBAAQ,EAAC,GAAG,EAAE,QAAQ,CAAC,CAAC;IAC3C,MAAM,SAAS,GAAG,IAAA,iCAAqB,EAAC,GAAG,EAAE,OAAO,EAAE,KAAK,EAAE,QAAQ,CAAC,OAAO,CAAC,CAAC;IAE/E,IAAI,QAAQ,GAAG,KAAK,CAAC;IAErB,OAAO;QACL,GAAG;QACH,SAAS;QACT,OAAO,EAAE,GAAS,EAAE;YAClB,IAAI,QAAQ,EAAE,CAAC;gBACb,OAAO;YACT,CAAC;YACD,QAAQ,GAAG,IAAI,CAAC;YAChB,UAAU,EAAE,CAAC;QACf,CAAC;KACF,CAAC;AACJ,CAAC","sourcesContent":["import { applyEnv, loadEnvFile } from './env-utils';\nimport { buildRuntimeEnv, buildRuntimeShorthand, type RuntimeBootstrapState } from './bootstrap';\nimport { nodeRuntimePlatform } from './platform/node/NodeRuntimePlatform';\nimport type { RuntimePlatform } from './platform/types';\nimport type { XpodRuntimeOptions } from './runtime-types';\n\nexport interface RuntimeEnvironmentSession {\n  env: Record<string, string | undefined>;\n  shorthand: Record<string, string | number | boolean>;\n  restore: () => void;\n}\n\nexport function createRuntimeEnvironmentSession(\n  state: RuntimeBootstrapState,\n  options: XpodRuntimeOptions,\n  platform: RuntimePlatform = nodeRuntimePlatform,\n): RuntimeEnvironmentSession {\n  const envFromFile = state.envFilePath ? loadEnvFile(state.envFilePath, platform) : {};\n  const env = buildRuntimeEnv(state, options, envFromFile);\n  const restoreEnv = applyEnv(env, platform);\n  const shorthand = buildRuntimeShorthand(env, options, state, platform.baseEnv);\n\n  let restored = false;\n\n  return {\n    env,\n    shorthand,\n    restore: (): void => {\n      if (restored) {\n        return;\n      }\n      restored = true;\n      restoreEnv();\n    },\n  };\n}\n"]}

package/dist/runtime/host/node/NodeRuntimeHost.d.ts

@@ -0,0 +1,21 @@
+import type { RuntimeConnectionTarget, RuntimeHost, RuntimeListenEndpoint, RuntimeListenableServer, RuntimePortAllocationOptions, RuntimePorts, RuntimeTransport, RuntimeTransportPreference } from '../types';
+export declare class NodeRuntimeHost implements RuntimeHost {
+    readonly name = "node";
+    resolveTransport(preference?: RuntimeTransportPreference): RuntimeTransport;
+    allocatePorts(options?: RuntimePortAllocationOptions): Promise<RuntimePorts>;
+    createListenEndpoint(options: {
+        port?: number;
+        host?: string;
+        socketPath?: string;
+    }): RuntimeListenEndpoint;
+    formatListenEndpoint(endpoint: RuntimeListenEndpoint): string;
+    listen(server: RuntimeListenableServer, endpoint: RuntimeListenEndpoint): Promise<void>;
+    close(server: RuntimeListenableServer, endpoint?: RuntimeListenEndpoint): Promise<void>;
+    waitForPortReady(port: number, host?: string, timeoutMs?: number): Promise<void>;
+    isConnectionTargetReady(target: RuntimeConnectionTarget, timeoutMs?: number): Promise<boolean>;
+    registerSocketOrigins(origin: string, socketPath: string): () => Promise<void>;
+    cleanupSocketPath(socketPath: string): void;
+    private waitForSocketReady;
+    private waitForTcpProbe;
+}
+export declare const nodeRuntimeHost: NodeRuntimeHost;

package/dist/runtime/host/node/NodeRuntimeHost.js

@@ -0,0 +1,165 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.nodeRuntimeHost = exports.NodeRuntimeHost = void 0;
+const node_net_1 = __importDefault(require("node:net"));
+const port_finder_1 = require("../../port-finder");
+const socket_fetch_1 = require("../../socket-fetch");
+const socket_http_1 = require("../../socket-http");
+const socket_utils_1 = require("../../socket-utils");
+class NodeRuntimeHost {
+    constructor() {
+        this.name = 'node';
+    }
+    resolveTransport(preference) {
+        if (preference === 'socket' || preference === 'port') {
+            return preference;
+        }
+        return process.platform === 'win32' ? 'port' : 'socket';
+    }
+    async allocatePorts(options = {}) {
+        const gateway = options.gatewayPort ?? await (0, port_finder_1.getFreePort)(options.basePort ?? 5600);
+        const css = options.cssPort ?? await (0, port_finder_1.getFreePort)(gateway + 1);
+        const api = options.apiPort ?? await (0, port_finder_1.getFreePort)(css + 1);
+        return { gateway, css, api };
+    }
+    createListenEndpoint(options) {
+        if (options.socketPath) {
+            return {
+                type: 'socket',
+                socketPath: options.socketPath,
+            };
+        }
+        return {
+            type: 'port',
+            host: options.host ?? '0.0.0.0',
+            port: options.port ?? 0,
+        };
+    }
+    formatListenEndpoint(endpoint) {
+        if (endpoint.type === 'socket') {
+            return `unix://${endpoint.socketPath}`;
+        }
+        return `http://${endpoint.host}:${endpoint.port}`;
+    }
+    async listen(server, endpoint) {
+        await new Promise((resolve, reject) => {
+            server.once('error', reject);
+            if (endpoint.type === 'socket') {
+                (0, socket_utils_1.prepareSocketPath)(endpoint.socketPath);
+                server.listen(endpoint.socketPath, () => resolve());
+                return;
+            }
+            server.listen(endpoint.port, endpoint.host, () => resolve());
+        });
+    }
+    async close(server, endpoint) {
+        await new Promise((resolve, reject) => {
+            server.close((error) => {
+                if (error) {
+                    reject(error);
+                    return;
+                }
+                resolve();
+            });
+        });
+        if (endpoint?.type === 'socket') {
+            (0, socket_utils_1.removeSocketPath)(endpoint.socketPath);
+        }
+    }
+    async waitForPortReady(port, host = '127.0.0.1', timeoutMs = 5_000) {
+        const deadline = Date.now() + timeoutMs;
+        while (Date.now() < deadline) {
+            const ready = await new Promise((resolve) => {
+                const socket = new node_net_1.default.Socket();
+                socket.setTimeout(500);
+                socket.once('connect', () => {
+                    socket.destroy();
+                    resolve(true);
+                });
+                socket.once('error', () => {
+                    socket.destroy();
+                    resolve(false);
+                });
+                socket.once('timeout', () => {
+                    socket.destroy();
+                    resolve(false);
+                });
+                socket.connect(port, host);
+            });
+            if (ready) {
+                return;
+            }
+            await new Promise((resolve) => setTimeout(resolve, 100));
+        }
+        throw new Error(`Timed out waiting for service on ${host}:${port}`);
+    }
+    async isConnectionTargetReady(target, timeoutMs = 1_500) {
+        try {
+            if (target.socketPath) {
+                return await this.waitForSocketReady(target.socketPath, timeoutMs);
+            }
+            if (target.url) {
+                const url = new URL(target.url);
+                const port = parseInt(url.port || (url.protocol === 'https:' ? '443' : '80'), 10);
+                return await this.waitForTcpProbe(port, url.hostname, timeoutMs);
+            }
+            return false;
+        }
+        catch {
+            return false;
+        }
+    }
+    registerSocketOrigins(origin, socketPath) {
+        const unregisterSocketFetch = (0, socket_fetch_1.registerSocketFetchOrigin)(origin, socketPath);
+        const unregisterSocketHttp = (0, socket_http_1.registerSocketHttpOrigin)(origin, socketPath);
+        return async () => {
+            await unregisterSocketFetch();
+            await unregisterSocketHttp();
+        };
+    }
+    cleanupSocketPath(socketPath) {
+        (0, socket_utils_1.removeSocketPath)(socketPath);
+    }
+    async waitForSocketReady(socketPath, timeoutMs) {
+        const deadline = Date.now() + timeoutMs;
+        while (Date.now() < deadline) {
+            const ready = await new Promise((resolve) => {
+                const socket = new node_net_1.default.Socket();
+                socket.setTimeout(500);
+                socket.once('connect', () => {
+                    socket.destroy();
+                    resolve(true);
+                });
+                socket.once('error', () => {
+                    socket.destroy();
+                    resolve(false);
+                });
+                socket.once('timeout', () => {
+                    socket.destroy();
+                    resolve(false);
+                });
+                socket.connect(socketPath);
+            });
+            if (ready) {
+                return true;
+            }
+            await new Promise((resolve) => setTimeout(resolve, 100));
+        }
+        return false;
+    }
+    async waitForTcpProbe(port, host, timeoutMs) {
+        try {
+            await this.waitForPortReady(port, host, timeoutMs);
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+}
+exports.NodeRuntimeHost = NodeRuntimeHost;
+exports.nodeRuntimeHost = new NodeRuntimeHost();
+//# sourceMappingURL=NodeRuntimeHost.js.map

package/dist/runtime/host/node/NodeRuntimeHost.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"NodeRuntimeHost.js","sourceRoot":"","sources":["../../../../src/runtime/host/node/NodeRuntimeHost.ts"],"names":[],"mappings":"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","sourcesContent":["import net from 'node:net';\nimport { getFreePort } from '../../port-finder';\nimport { registerSocketFetchOrigin } from '../../socket-fetch';\nimport { registerSocketHttpOrigin } from '../../socket-http';\nimport { prepareSocketPath, removeSocketPath } from '../../socket-utils';\nimport type {\n  RuntimeConnectionTarget,\n  RuntimeHost,\n  RuntimeListenEndpoint,\n  RuntimeListenableServer,\n  RuntimePortAllocationOptions,\n  RuntimePorts,\n  RuntimeTransport,\n  RuntimeTransportPreference,\n} from '../types';\n\nexport class NodeRuntimeHost implements RuntimeHost {\n  public readonly name = 'node';\n\n  public resolveTransport(preference?: RuntimeTransportPreference): RuntimeTransport {\n    if (preference === 'socket' || preference === 'port') {\n      return preference;\n    }\n\n    return process.platform === 'win32' ? 'port' : 'socket';\n  }\n\n  public async allocatePorts(options: RuntimePortAllocationOptions = {}): Promise<RuntimePorts> {\n    const gateway = options.gatewayPort ?? await getFreePort(options.basePort ?? 5600);\n    const css = options.cssPort ?? await getFreePort(gateway + 1);\n    const api = options.apiPort ?? await getFreePort(css + 1);\n\n    return { gateway, css, api };\n  }\n\n  public createListenEndpoint(options: { port?: number; host?: string; socketPath?: string }): RuntimeListenEndpoint {\n    if (options.socketPath) {\n      return {\n        type: 'socket',\n        socketPath: options.socketPath,\n      };\n    }\n\n    return {\n      type: 'port',\n      host: options.host ?? '0.0.0.0',\n      port: options.port ?? 0,\n    };\n  }\n\n  public formatListenEndpoint(endpoint: RuntimeListenEndpoint): string {\n    if (endpoint.type === 'socket') {\n      return `unix://${endpoint.socketPath}`;\n    }\n\n    return `http://${endpoint.host}:${endpoint.port}`;\n  }\n\n  public async listen(server: RuntimeListenableServer, endpoint: RuntimeListenEndpoint): Promise<void> {\n    await new Promise<void>((resolve, reject) => {\n      server.once('error', reject);\n\n      if (endpoint.type === 'socket') {\n        prepareSocketPath(endpoint.socketPath);\n        server.listen(endpoint.socketPath, () => resolve());\n        return;\n      }\n\n      server.listen(endpoint.port, endpoint.host, () => resolve());\n    });\n  }\n\n  public async close(server: RuntimeListenableServer, endpoint?: RuntimeListenEndpoint): Promise<void> {\n    await new Promise<void>((resolve, reject) => {\n      server.close((error) => {\n        if (error) {\n          reject(error);\n          return;\n        }\n        resolve();\n      });\n    });\n\n    if (endpoint?.type === 'socket') {\n      removeSocketPath(endpoint.socketPath);\n    }\n  }\n\n  public async waitForPortReady(port: number, host = '127.0.0.1', timeoutMs = 5_000): Promise<void> {\n    const deadline = Date.now() + timeoutMs;\n\n    while (Date.now() < deadline) {\n      const ready = await new Promise<boolean>((resolve) => {\n        const socket = new net.Socket();\n        socket.setTimeout(500);\n        socket.once('connect', () => {\n          socket.destroy();\n          resolve(true);\n        });\n        socket.once('error', () => {\n          socket.destroy();\n          resolve(false);\n        });\n        socket.once('timeout', () => {\n          socket.destroy();\n          resolve(false);\n        });\n        socket.connect(port, host);\n      });\n\n      if (ready) {\n        return;\n      }\n\n      await new Promise((resolve) => setTimeout(resolve, 100));\n    }\n\n    throw new Error(`Timed out waiting for service on ${host}:${port}`);\n  }\n\n  public async isConnectionTargetReady(target: RuntimeConnectionTarget, timeoutMs = 1_500): Promise<boolean> {\n    try {\n      if (target.socketPath) {\n        return await this.waitForSocketReady(target.socketPath, timeoutMs);\n      }\n\n      if (target.url) {\n        const url = new URL(target.url);\n        const port = parseInt(url.port || (url.protocol === 'https:' ? '443' : '80'), 10);\n        return await this.waitForTcpProbe(port, url.hostname, timeoutMs);\n      }\n\n      return false;\n    } catch {\n      return false;\n    }\n  }\n\n  public registerSocketOrigins(origin: string, socketPath: string): () => Promise<void> {\n    const unregisterSocketFetch = registerSocketFetchOrigin(origin, socketPath);\n    const unregisterSocketHttp = registerSocketHttpOrigin(origin, socketPath);\n\n    return async(): Promise<void> => {\n      await unregisterSocketFetch();\n      await unregisterSocketHttp();\n    };\n  }\n\n  public cleanupSocketPath(socketPath: string): void {\n    removeSocketPath(socketPath);\n  }\n\n  private async waitForSocketReady(socketPath: string, timeoutMs: number): Promise<boolean> {\n    const deadline = Date.now() + timeoutMs;\n\n    while (Date.now() < deadline) {\n      const ready = await new Promise<boolean>((resolve) => {\n        const socket = new net.Socket();\n        socket.setTimeout(500);\n        socket.once('connect', () => {\n          socket.destroy();\n          resolve(true);\n        });\n        socket.once('error', () => {\n          socket.destroy();\n          resolve(false);\n        });\n        socket.once('timeout', () => {\n          socket.destroy();\n          resolve(false);\n        });\n        socket.connect(socketPath);\n      });\n\n      if (ready) {\n        return true;\n      }\n\n      await new Promise((resolve) => setTimeout(resolve, 100));\n    }\n\n    return false;\n  }\n\n  private async waitForTcpProbe(port: number, host: string, timeoutMs: number): Promise<boolean> {\n    try {\n      await this.waitForPortReady(port, host, timeoutMs);\n      return true;\n    } catch {\n      return false;\n    }\n  }\n}\n\nexport const nodeRuntimeHost = new NodeRuntimeHost();\n"]}

package/dist/runtime/host/types.d.ts

@@ -0,0 +1,50 @@
+export type RuntimeTransport = 'socket' | 'port';
+export type RuntimeTransportPreference = 'auto' | RuntimeTransport;
+export interface RuntimePortListenEndpoint {
+    type: 'port';
+    host: string;
+    port: number;
+}
+export interface RuntimeSocketListenEndpoint {
+    type: 'socket';
+    socketPath: string;
+}
+export type RuntimeListenEndpoint = RuntimePortListenEndpoint | RuntimeSocketListenEndpoint;
+export interface RuntimeConnectionTarget {
+    url?: string;
+    socketPath?: string;
+}
+export interface RuntimeListenableServer {
+    once(event: 'error', listener: (error: Error) => void): unknown;
+    listen(socketPath: string, listeningListener?: () => void): unknown;
+    listen(port: number, host: string, listeningListener?: () => void): unknown;
+    close(callback: (error?: Error | null) => void): unknown;
+}
+export interface RuntimePortAllocationOptions {
+    gatewayPort?: number;
+    cssPort?: number;
+    apiPort?: number;
+    basePort?: number;
+}
+export interface RuntimePorts {
+    gateway: number;
+    css: number;
+    api: number;
+}
+export interface RuntimeHost {
+    readonly name: string;
+    resolveTransport(preference?: RuntimeTransportPreference): RuntimeTransport;
+    allocatePorts(options?: RuntimePortAllocationOptions): Promise<RuntimePorts>;
+    createListenEndpoint(options: {
+        port?: number;
+        host?: string;
+        socketPath?: string;
+    }): RuntimeListenEndpoint;
+    formatListenEndpoint(endpoint: RuntimeListenEndpoint): string;
+    listen(server: RuntimeListenableServer, endpoint: RuntimeListenEndpoint): Promise<void>;
+    close(server: RuntimeListenableServer, endpoint?: RuntimeListenEndpoint): Promise<void>;
+    waitForPortReady(port: number, host?: string, timeoutMs?: number): Promise<void>;
+    isConnectionTargetReady(target: RuntimeConnectionTarget, timeoutMs?: number): Promise<boolean>;
+    registerSocketOrigins(origin: string, socketPath: string): () => Promise<void>;
+    cleanupSocketPath(socketPath: string): void;
+}

package/dist/runtime/host/types.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/dist/runtime/host/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/runtime/host/types.ts"],"names":[],"mappings":"","sourcesContent":["export type RuntimeTransport = 'socket' | 'port';\nexport type RuntimeTransportPreference = 'auto' | RuntimeTransport;\n\nexport interface RuntimePortListenEndpoint {\n  type: 'port';\n  host: string;\n  port: number;\n}\n\nexport interface RuntimeSocketListenEndpoint {\n  type: 'socket';\n  socketPath: string;\n}\n\nexport type RuntimeListenEndpoint = RuntimePortListenEndpoint | RuntimeSocketListenEndpoint;\n\nexport interface RuntimeConnectionTarget {\n  url?: string;\n  socketPath?: string;\n}\n\nexport interface RuntimeListenableServer {\n  once(event: 'error', listener: (error: Error) => void): unknown;\n  listen(socketPath: string, listeningListener?: () => void): unknown;\n  listen(port: number, host: string, listeningListener?: () => void): unknown;\n  close(callback: (error?: Error | null) => void): unknown;\n}\n\nexport interface RuntimePortAllocationOptions {\n  gatewayPort?: number;\n  cssPort?: number;\n  apiPort?: number;\n  basePort?: number;\n}\n\nexport interface RuntimePorts {\n  gateway: number;\n  css: number;\n  api: number;\n}\n\nexport interface RuntimeHost {\n  readonly name: string;\n  resolveTransport(preference?: RuntimeTransportPreference): RuntimeTransport;\n  allocatePorts(options?: RuntimePortAllocationOptions): Promise<RuntimePorts>;\n  createListenEndpoint(options: { port?: number; host?: string; socketPath?: string }): RuntimeListenEndpoint;\n  formatListenEndpoint(endpoint: RuntimeListenEndpoint): string;\n  listen(server: RuntimeListenableServer, endpoint: RuntimeListenEndpoint): Promise<void>;\n  close(server: RuntimeListenableServer, endpoint?: RuntimeListenEndpoint): Promise<void>;\n  waitForPortReady(port: number, host?: string, timeoutMs?: number): Promise<void>;\n  isConnectionTargetReady(target: RuntimeConnectionTarget, timeoutMs?: number): Promise<boolean>;\n  registerSocketOrigins(origin: string, socketPath: string): () => Promise<void>;\n  cleanupSocketPath(socketPath: string): void;\n}\n"]}

package/dist/runtime/index.d.ts

@@ -1,7 +1,25 @@
-export declare const PACKAGE_ROOT: string;
+import './configure-drizzle-solid';
+export { PACKAGE_ROOT, findPackageRoot } from './package-root';
+export { ensureBunUndiciCompat } from './compat/ensureBunUndiciCompat';
+export { buildRuntimeEnv, buildRuntimeShorthand, createCssRuntimeConfig, initRuntimeLogger, resolveRuntimeBootstrap, } from './bootstrap';
+export { NodeRuntimeDriver, nodeRuntimeDriver } from './driver/node/NodeRuntimeDriver';
+export type { RuntimeDriver } from './driver/types';
+export { createRuntimeEnvironmentSession } from './environment';
+export type { RuntimeEnvironmentSession } from './environment';
+export { createOpenAuthContext, registerManagedRuntimeServices, startApiRuntime, startCssRuntime, startGatewayRuntime, stopRuntimeServices, } from './lifecycle';
+export type { RuntimeServices } from './lifecycle';
 export { GatewayProxy } from './Proxy';
 export { getFreePort } from './port-finder';
 export { applyEnv, loadEnvFile } from './env-utils';
+export { NodeRuntimeHost, nodeRuntimeHost } from './host/node/NodeRuntimeHost';
+export { NodeRuntimePlatform, nodeRuntimePlatform } from './platform/node/NodeRuntimePlatform';
 export { registerSocketFetchOrigin } from './socket-fetch';
+export { registerSocketOriginShims } from './socket-shim';
+export { CommunitySolidServerCssRunner, communitySolidServerCssRunner, } from './runner/node/CommunitySolidServerCssRunner';
+export { NodeApiRuntimeRunner, nodeApiRuntimeRunner } from './runner/node/NodeApiRuntimeRunner';
+export { NodeGatewayRuntimeRunner, nodeGatewayRuntimeRunner, } from './runner/node/NodeGatewayRuntimeRunner';
+export type { RuntimeConnectionTarget, RuntimeHost, RuntimeListenEndpoint, RuntimeListenableServer, RuntimePortAllocationOptions, RuntimePorts, RuntimeTransport, RuntimeTransportPreference, } from './host/types';
+export type { RuntimePlatform } from './platform/types';
+export type { ApiRuntimeRunner, ApiRuntimeRunnerStartOptions, CssRuntimeRunner, CssRuntimeRunnerStartOptions, GatewayRuntimeHandle, GatewayRuntimeRunner, GatewayRuntimeRunnerStartOptions, } from './runner/types';
 export { startXpodRuntime } from './XpodRuntime';
-export type { XpodRuntimeOptions, XpodRuntimeHandle } from './XpodRuntime';
+export type { XpodRuntimeHandle, XpodRuntimeOptions, XpodRuntimePorts, XpodRuntimeSockets, } from './runtime-types';

package/dist/runtime/index.js

@@ -1,23 +1,30 @@
 "use strict";
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.startXpodRuntime = exports.registerSocketFetchOrigin = exports.loadEnvFile = exports.applyEnv = exports.getFreePort = exports.GatewayProxy = exports.PACKAGE_ROOT = void 0;
-const path_1 = __importDefault(require("path"));
-const fs_1 = __importDefault(require("fs"));
-/** xpod package root: walk up from __dirname until we find package.json */
-function findPackageRoot(dir) {
-    let current = dir;
-    while (current !== path_1.default.dirname(current)) {
-        if (fs_1.default.existsSync(path_1.default.join(current, 'package.json'))) {
-            return current;
-        }
-        current = path_1.default.dirname(current);
-    }
-    return dir;
-}
-exports.PACKAGE_ROOT = findPackageRoot(__dirname);
+exports.startXpodRuntime = exports.nodeGatewayRuntimeRunner = exports.NodeGatewayRuntimeRunner = exports.nodeApiRuntimeRunner = exports.NodeApiRuntimeRunner = exports.communitySolidServerCssRunner = exports.CommunitySolidServerCssRunner = exports.registerSocketOriginShims = exports.registerSocketFetchOrigin = exports.nodeRuntimePlatform = exports.NodeRuntimePlatform = exports.nodeRuntimeHost = exports.NodeRuntimeHost = exports.loadEnvFile = exports.applyEnv = exports.getFreePort = exports.GatewayProxy = exports.stopRuntimeServices = exports.startGatewayRuntime = exports.startCssRuntime = exports.startApiRuntime = exports.registerManagedRuntimeServices = exports.createOpenAuthContext = exports.createRuntimeEnvironmentSession = exports.nodeRuntimeDriver = exports.NodeRuntimeDriver = exports.resolveRuntimeBootstrap = exports.initRuntimeLogger = exports.createCssRuntimeConfig = exports.buildRuntimeShorthand = exports.buildRuntimeEnv = exports.ensureBunUndiciCompat = exports.findPackageRoot = exports.PACKAGE_ROOT = void 0;
+require("./configure-drizzle-solid");
+var package_root_1 = require("./package-root");
+Object.defineProperty(exports, "PACKAGE_ROOT", { enumerable: true, get: function () { return package_root_1.PACKAGE_ROOT; } });
+Object.defineProperty(exports, "findPackageRoot", { enumerable: true, get: function () { return package_root_1.findPackageRoot; } });
+var ensureBunUndiciCompat_1 = require("./compat/ensureBunUndiciCompat");
+Object.defineProperty(exports, "ensureBunUndiciCompat", { enumerable: true, get: function () { return ensureBunUndiciCompat_1.ensureBunUndiciCompat; } });
+var bootstrap_1 = require("./bootstrap");
+Object.defineProperty(exports, "buildRuntimeEnv", { enumerable: true, get: function () { return bootstrap_1.buildRuntimeEnv; } });
+Object.defineProperty(exports, "buildRuntimeShorthand", { enumerable: true, get: function () { return bootstrap_1.buildRuntimeShorthand; } });
+Object.defineProperty(exports, "createCssRuntimeConfig", { enumerable: true, get: function () { return bootstrap_1.createCssRuntimeConfig; } });
+Object.defineProperty(exports, "initRuntimeLogger", { enumerable: true, get: function () { return bootstrap_1.initRuntimeLogger; } });
+Object.defineProperty(exports, "resolveRuntimeBootstrap", { enumerable: true, get: function () { return bootstrap_1.resolveRuntimeBootstrap; } });
+var NodeRuntimeDriver_1 = require("./driver/node/NodeRuntimeDriver");
+Object.defineProperty(exports, "NodeRuntimeDriver", { enumerable: true, get: function () { return NodeRuntimeDriver_1.NodeRuntimeDriver; } });
+Object.defineProperty(exports, "nodeRuntimeDriver", { enumerable: true, get: function () { return NodeRuntimeDriver_1.nodeRuntimeDriver; } });
+var environment_1 = require("./environment");
+Object.defineProperty(exports, "createRuntimeEnvironmentSession", { enumerable: true, get: function () { return environment_1.createRuntimeEnvironmentSession; } });
+var lifecycle_1 = require("./lifecycle");
+Object.defineProperty(exports, "createOpenAuthContext", { enumerable: true, get: function () { return lifecycle_1.createOpenAuthContext; } });
+Object.defineProperty(exports, "registerManagedRuntimeServices", { enumerable: true, get: function () { return lifecycle_1.registerManagedRuntimeServices; } });
+Object.defineProperty(exports, "startApiRuntime", { enumerable: true, get: function () { return lifecycle_1.startApiRuntime; } });
+Object.defineProperty(exports, "startCssRuntime", { enumerable: true, get: function () { return lifecycle_1.startCssRuntime; } });
+Object.defineProperty(exports, "startGatewayRuntime", { enumerable: true, get: function () { return lifecycle_1.startGatewayRuntime; } });
+Object.defineProperty(exports, "stopRuntimeServices", { enumerable: true, get: function () { return lifecycle_1.stopRuntimeServices; } });
 var Proxy_1 = require("./Proxy");
 Object.defineProperty(exports, "GatewayProxy", { enumerable: true, get: function () { return Proxy_1.GatewayProxy; } });
 var port_finder_1 = require("./port-finder");
@@ -25,8 +32,25 @@ Object.defineProperty(exports, "getFreePort", { enumerable: true, get: function
 var env_utils_1 = require("./env-utils");
 Object.defineProperty(exports, "applyEnv", { enumerable: true, get: function () { return env_utils_1.applyEnv; } });
 Object.defineProperty(exports, "loadEnvFile", { enumerable: true, get: function () { return env_utils_1.loadEnvFile; } });
+var NodeRuntimeHost_1 = require("./host/node/NodeRuntimeHost");
+Object.defineProperty(exports, "NodeRuntimeHost", { enumerable: true, get: function () { return NodeRuntimeHost_1.NodeRuntimeHost; } });
+Object.defineProperty(exports, "nodeRuntimeHost", { enumerable: true, get: function () { return NodeRuntimeHost_1.nodeRuntimeHost; } });
+var NodeRuntimePlatform_1 = require("./platform/node/NodeRuntimePlatform");
+Object.defineProperty(exports, "NodeRuntimePlatform", { enumerable: true, get: function () { return NodeRuntimePlatform_1.NodeRuntimePlatform; } });
+Object.defineProperty(exports, "nodeRuntimePlatform", { enumerable: true, get: function () { return NodeRuntimePlatform_1.nodeRuntimePlatform; } });
 var socket_fetch_1 = require("./socket-fetch");
 Object.defineProperty(exports, "registerSocketFetchOrigin", { enumerable: true, get: function () { return socket_fetch_1.registerSocketFetchOrigin; } });
+var socket_shim_1 = require("./socket-shim");
+Object.defineProperty(exports, "registerSocketOriginShims", { enumerable: true, get: function () { return socket_shim_1.registerSocketOriginShims; } });
+var CommunitySolidServerCssRunner_1 = require("./runner/node/CommunitySolidServerCssRunner");
+Object.defineProperty(exports, "CommunitySolidServerCssRunner", { enumerable: true, get: function () { return CommunitySolidServerCssRunner_1.CommunitySolidServerCssRunner; } });
+Object.defineProperty(exports, "communitySolidServerCssRunner", { enumerable: true, get: function () { return CommunitySolidServerCssRunner_1.communitySolidServerCssRunner; } });
+var NodeApiRuntimeRunner_1 = require("./runner/node/NodeApiRuntimeRunner");
+Object.defineProperty(exports, "NodeApiRuntimeRunner", { enumerable: true, get: function () { return NodeApiRuntimeRunner_1.NodeApiRuntimeRunner; } });
+Object.defineProperty(exports, "nodeApiRuntimeRunner", { enumerable: true, get: function () { return NodeApiRuntimeRunner_1.nodeApiRuntimeRunner; } });
+var NodeGatewayRuntimeRunner_1 = require("./runner/node/NodeGatewayRuntimeRunner");
+Object.defineProperty(exports, "NodeGatewayRuntimeRunner", { enumerable: true, get: function () { return NodeGatewayRuntimeRunner_1.NodeGatewayRuntimeRunner; } });
+Object.defineProperty(exports, "nodeGatewayRuntimeRunner", { enumerable: true, get: function () { return NodeGatewayRuntimeRunner_1.nodeGatewayRuntimeRunner; } });
 var XpodRuntime_1 = require("./XpodRuntime");
 Object.defineProperty(exports, "startXpodRuntime", { enumerable: true, get: function () { return XpodRuntime_1.startXpodRuntime; } });
 //# sourceMappingURL=index.js.map

package/dist/runtime/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/runtime/index.ts"],"names":[],"mappings":";;;;;;AAAA,gDAAwB;AACxB,4CAAoB;AAEpB,2EAA2E;AAC3E,SAAS,eAAe,CAAC,GAAW;IAClC,IAAI,OAAO,GAAG,GAAG,CAAC;IAClB,OAAO,OAAO,KAAK,cAAI,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC;QACzC,IAAI,YAAE,CAAC,UAAU,CAAC,cAAI,CAAC,IAAI,CAAC,OAAO,EAAE,cAAc,CAAC,CAAC,EAAE,CAAC;YACtD,OAAO,OAAO,CAAC;QACjB,CAAC;QACD,OAAO,GAAG,cAAI,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;IAClC,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAEY,QAAA,YAAY,GAAG,eAAe,CAAC,SAAS,CAAC,CAAC;AAEvD,iCAAuC;AAA9B,qGAAA,YAAY,OAAA;AACrB,6CAA4C;AAAnC,0GAAA,WAAW,OAAA;AACpB,yCAAoD;AAA3C,qGAAA,QAAQ,OAAA;AAAE,wGAAA,WAAW,OAAA;AAC9B,+CAA2D;AAAlD,yHAAA,yBAAyB,OAAA;AAClC,6CAAiD;AAAxC,+GAAA,gBAAgB,OAAA","sourcesContent":["import path from 'path';\nimport fs from 'fs';\n\n/** xpod package root: walk up from __dirname until we find package.json */\nfunction findPackageRoot(dir: string): string {\n  let current = dir;\n  while (current !== path.dirname(current)) {\n    if (fs.existsSync(path.join(current, 'package.json'))) {\n      return current;\n    }\n    current = path.dirname(current);\n  }\n  return dir;\n}\n\nexport const PACKAGE_ROOT = findPackageRoot(__dirname);\n\nexport { GatewayProxy } from './Proxy';\nexport { getFreePort } from './port-finder';\nexport { applyEnv, loadEnvFile } from './env-utils';\nexport { registerSocketFetchOrigin } from './socket-fetch';\nexport { startXpodRuntime } from './XpodRuntime';\nexport type { XpodRuntimeOptions, XpodRuntimeHandle } from './XpodRuntime';\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/runtime/index.ts"],"names":[],"mappings":";;;AAAA,qCAAmC;AACnC,+CAA+D;AAAtD,4GAAA,YAAY,OAAA;AAAE,+GAAA,eAAe,OAAA;AACtC,wEAAuE;AAA9D,8HAAA,qBAAqB,OAAA;AAC9B,yCAMqB;AALnB,4GAAA,eAAe,OAAA;AACf,kHAAA,qBAAqB,OAAA;AACrB,mHAAA,sBAAsB,OAAA;AACtB,8GAAA,iBAAiB,OAAA;AACjB,oHAAA,uBAAuB,OAAA;AAEzB,qEAAuF;AAA9E,sHAAA,iBAAiB,OAAA;AAAE,sHAAA,iBAAiB,OAAA;AAE7C,6CAAgE;AAAvD,8HAAA,+BAA+B,OAAA;AAExC,yCAOqB;AANnB,kHAAA,qBAAqB,OAAA;AACrB,2HAAA,8BAA8B,OAAA;AAC9B,4GAAA,eAAe,OAAA;AACf,4GAAA,eAAe,OAAA;AACf,gHAAA,mBAAmB,OAAA;AACnB,gHAAA,mBAAmB,OAAA;AAGrB,iCAAuC;AAA9B,qGAAA,YAAY,OAAA;AACrB,6CAA4C;AAAnC,0GAAA,WAAW,OAAA;AACpB,yCAAoD;AAA3C,qGAAA,QAAQ,OAAA;AAAE,wGAAA,WAAW,OAAA;AAC9B,+DAA+E;AAAtE,kHAAA,eAAe,OAAA;AAAE,kHAAA,eAAe,OAAA;AACzC,2EAA+F;AAAtF,0HAAA,mBAAmB,OAAA;AAAE,0HAAA,mBAAmB,OAAA;AACjD,+CAA2D;AAAlD,yHAAA,yBAAyB,OAAA;AAClC,6CAA0D;AAAjD,wHAAA,yBAAyB,OAAA;AAClC,6FAGqD;AAFnD,8IAAA,6BAA6B,OAAA;AAC7B,8IAAA,6BAA6B,OAAA;AAE/B,2EAAgG;AAAvF,4HAAA,oBAAoB,OAAA;AAAE,4HAAA,oBAAoB,OAAA;AACnD,mFAGgD;AAF9C,oIAAA,wBAAwB,OAAA;AACxB,oIAAA,wBAAwB,OAAA;AAsB1B,6CAAiD;AAAxC,+GAAA,gBAAgB,OAAA","sourcesContent":["import './configure-drizzle-solid';\nexport { PACKAGE_ROOT, findPackageRoot } from './package-root';\nexport { ensureBunUndiciCompat } from './compat/ensureBunUndiciCompat';\nexport {\n  buildRuntimeEnv,\n  buildRuntimeShorthand,\n  createCssRuntimeConfig,\n  initRuntimeLogger,\n  resolveRuntimeBootstrap,\n} from './bootstrap';\nexport { NodeRuntimeDriver, nodeRuntimeDriver } from './driver/node/NodeRuntimeDriver';\nexport type { RuntimeDriver } from './driver/types';\nexport { createRuntimeEnvironmentSession } from './environment';\nexport type { RuntimeEnvironmentSession } from './environment';\nexport {\n  createOpenAuthContext,\n  registerManagedRuntimeServices,\n  startApiRuntime,\n  startCssRuntime,\n  startGatewayRuntime,\n  stopRuntimeServices,\n} from './lifecycle';\nexport type { RuntimeServices } from './lifecycle';\nexport { GatewayProxy } from './Proxy';\nexport { getFreePort } from './port-finder';\nexport { applyEnv, loadEnvFile } from './env-utils';\nexport { NodeRuntimeHost, nodeRuntimeHost } from './host/node/NodeRuntimeHost';\nexport { NodeRuntimePlatform, nodeRuntimePlatform } from './platform/node/NodeRuntimePlatform';\nexport { registerSocketFetchOrigin } from './socket-fetch';\nexport { registerSocketOriginShims } from './socket-shim';\nexport {\n  CommunitySolidServerCssRunner,\n  communitySolidServerCssRunner,\n} from './runner/node/CommunitySolidServerCssRunner';\nexport { NodeApiRuntimeRunner, nodeApiRuntimeRunner } from './runner/node/NodeApiRuntimeRunner';\nexport {\n  NodeGatewayRuntimeRunner,\n  nodeGatewayRuntimeRunner,\n} from './runner/node/NodeGatewayRuntimeRunner';\nexport type {\n  RuntimeConnectionTarget,\n  RuntimeHost,\n  RuntimeListenEndpoint,\n  RuntimeListenableServer,\n  RuntimePortAllocationOptions,\n  RuntimePorts,\n  RuntimeTransport,\n  RuntimeTransportPreference,\n} from './host/types';\nexport type { RuntimePlatform } from './platform/types';\nexport type {\n  ApiRuntimeRunner,\n  ApiRuntimeRunnerStartOptions,\n  CssRuntimeRunner,\n  CssRuntimeRunnerStartOptions,\n  GatewayRuntimeHandle,\n  GatewayRuntimeRunner,\n  GatewayRuntimeRunnerStartOptions,\n} from './runner/types';\nexport { startXpodRuntime } from './XpodRuntime';\nexport type {\n  XpodRuntimeHandle,\n  XpodRuntimeOptions,\n  XpodRuntimePorts,\n  XpodRuntimeSockets,\n} from './runtime-types';\n"]}

package/dist/runtime/lifecycle.d.ts

@@ -0,0 +1,53 @@
+import type { App } from '@solid/community-server';
+import type { AuthContext } from '../api/auth/AuthContext';
+import type { ApiServiceHandle } from '../api/runtime';
+import { Supervisor } from '../supervisor/Supervisor';
+import type { Logger } from 'global-logger-factory';
+import type { RuntimeHost } from './host/types';
+import type { RuntimeBootstrapState } from './bootstrap';
+import type { ApiRuntimeRunner, CssRuntimeRunner, GatewayRuntimeHandle, GatewayRuntimeRunner } from './runner/types';
+export interface RuntimeServices {
+    cssApp?: App;
+    apiService?: ApiServiceHandle;
+    gateway?: GatewayRuntimeHandle;
+}
+interface StartCssRuntimeOptions {
+    state: RuntimeBootstrapState;
+    host: RuntimeHost;
+    runtimeShorthand: Record<string, string | number | boolean>;
+    supervisor: Supervisor;
+    open: boolean;
+    createCssRuntimeConfig: (state: RuntimeBootstrapState, open: boolean) => string;
+    cssRunner: CssRuntimeRunner;
+}
+interface StartApiRuntimeOptions {
+    state: RuntimeBootstrapState;
+    host: RuntimeHost;
+    supervisor: Supervisor;
+    authContext?: AuthContext;
+    apiRunner: ApiRuntimeRunner;
+}
+interface StartGatewayRuntimeOptions {
+    state: RuntimeBootstrapState;
+    host: RuntimeHost;
+    supervisor: Supervisor;
+    shutdownHandler: () => Promise<void>;
+    gatewayRunner: GatewayRuntimeRunner;
+}
+interface StopRuntimeServicesOptions {
+    services: RuntimeServices;
+    supervisor: Supervisor;
+    logger: Logger;
+    host: RuntimeHost;
+    state: RuntimeBootstrapState;
+    unregisterSocketOrigins: () => Promise<void>;
+    closeIdentityConnections: () => Promise<void>;
+    restoreRuntimeEnv: () => void;
+}
+export declare function createOpenAuthContext(baseUrl: string, override?: AuthContext): AuthContext;
+export declare function registerManagedRuntimeServices(supervisor: Supervisor, services: RuntimeServices): void;
+export declare function startCssRuntime({ state, host, runtimeShorthand, supervisor, open, createCssRuntimeConfig, cssRunner, }: StartCssRuntimeOptions): Promise<App>;
+export declare function startApiRuntime({ state, host, supervisor, authContext, apiRunner, }: StartApiRuntimeOptions): Promise<ApiServiceHandle>;
+export declare function startGatewayRuntime({ state, host, supervisor, shutdownHandler, gatewayRunner, }: StartGatewayRuntimeOptions): Promise<GatewayRuntimeHandle>;
+export declare function stopRuntimeServices({ services, supervisor, logger, host, state, unregisterSocketOrigins, closeIdentityConnections, restoreRuntimeEnv, }: StopRuntimeServicesOptions): Promise<void>;
+export {};

package/dist/runtime/lifecycle.js

@@ -0,0 +1,137 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createOpenAuthContext = createOpenAuthContext;
+exports.registerManagedRuntimeServices = registerManagedRuntimeServices;
+exports.startCssRuntime = startCssRuntime;
+exports.startApiRuntime = startApiRuntime;
+exports.startGatewayRuntime = startGatewayRuntime;
+exports.stopRuntimeServices = stopRuntimeServices;
+const package_root_1 = require("./package-root");
+const RedisClientLifecycle_1 = require("../storage/redis/RedisClientLifecycle");
+function ensureTrailingSlash(url) {
+    return url.endsWith('/') ? url : `${url}/`;
+}
+function createOpenAuthContext(baseUrl, override) {
+    if (override) {
+        return override;
+    }
+    return {
+        type: 'solid',
+        webId: new URL('test/profile/card#me', ensureTrailingSlash(baseUrl)).href,
+        accountId: 'xpod-open-account',
+        displayName: 'Xpod Open Mode',
+    };
+}
+function registerManagedRuntimeServices(supervisor, services) {
+    supervisor.registerManaged('css', async () => {
+        if (services.cssApp) {
+            await services.cssApp.stop();
+        }
+    });
+    supervisor.registerManaged('api', async () => {
+        if (services.apiService) {
+            await services.apiService.stop();
+        }
+    });
+    supervisor.registerManaged('gateway', async () => {
+        if (services.gateway) {
+            await services.gateway.stop();
+        }
+    });
+}
+async function startCssRuntime({ state, host, runtimeShorthand, supervisor, open, createCssRuntimeConfig, cssRunner, }) {
+    const cssConfigPath = createCssRuntimeConfig(state, open || state.cssAuthMode === 'allow-all');
+    supervisor.setStatus('css', 'starting', { startTime: Date.now() });
+    const cssApp = await cssRunner.start({
+        configPath: cssConfigPath,
+        packageRoot: package_root_1.PACKAGE_ROOT,
+        logLevel: state.logLevel,
+        shorthand: {
+            ...(state.sockets.css ? { socket: state.sockets.css } : { port: state.ports.css }),
+            ...runtimeShorthand,
+        },
+    });
+    if (state.sockets.css) {
+        const ready = await host.isConnectionTargetReady({ socketPath: state.sockets.css }, 5_000);
+        if (!ready) {
+            throw new Error(`Timed out waiting for CSS socket ${state.sockets.css}`);
+        }
+        supervisor.addLog('css', 'info', `CSS started (unix://${state.sockets.css})`);
+    }
+    else {
+        await host.waitForPortReady(state.ports.css, '127.0.0.1');
+        supervisor.addLog('css', 'info', `CSS started (http://127.0.0.1:${state.ports.css})`);
+    }
+    supervisor.setStatus('css', 'running', { startTime: Date.now() });
+    return cssApp;
+}
+async function startApiRuntime({ state, host, supervisor, authContext, apiRunner, }) {
+    supervisor.setStatus('api', 'starting', { startTime: Date.now() });
+    const apiService = await apiRunner.start({
+        open: state.apiOpen,
+        authContext: createOpenAuthContext(state.baseUrl, authContext),
+        runtimeHost: host,
+    });
+    supervisor.addLog('api', 'info', `API started (${state.transport === 'socket' ? `unix://${state.sockets.api}` : `http://127.0.0.1:${state.ports.api}`})`);
+    supervisor.setStatus('api', 'running', { startTime: Date.now() });
+    return apiService;
+}
+async function startGatewayRuntime({ state, host, supervisor, shutdownHandler, gatewayRunner, }) {
+    supervisor.setStatus('gateway', 'starting', { startTime: Date.now() });
+    const gateway = await gatewayRunner.start({
+        port: state.ports.gateway,
+        bindHost: state.bindHost,
+        socketPath: state.sockets.gateway,
+        shutdownHandler,
+        baseUrl: state.baseUrl,
+        runtimeHost: host,
+        supervisor,
+        targets: {
+            css: state.transport === 'socket' ? { socketPath: state.sockets.css } : { url: `http://127.0.0.1:${state.ports.css}` },
+            api: state.transport === 'socket' ? { socketPath: state.sockets.api } : { url: `http://127.0.0.1:${state.ports.api}` },
+        },
+    });
+    supervisor.addLog('xpod', 'info', `Gateway started (${state.transport === 'socket' ? `unix://${state.sockets.gateway}` : state.baseUrl})`);
+    supervisor.setStatus('gateway', 'running', { startTime: Date.now() });
+    return gateway;
+}
+async function stopRuntimeServices({ services, supervisor, logger, host, state, unregisterSocketOrigins, closeIdentityConnections, restoreRuntimeEnv, }) {
+    try {
+        if (services.gateway) {
+            await services.gateway.stop();
+            supervisor.setStatus('gateway', 'stopped');
+        }
+    }
+    catch (error) {
+        logger.warn(`Failed to stop gateway: ${String(error)}`);
+    }
+    try {
+        if (services.apiService) {
+            await services.apiService.stop();
+            supervisor.setStatus('api', 'stopped');
+        }
+    }
+    catch (error) {
+        logger.warn(`Failed to stop api: ${String(error)}`);
+    }
+    try {
+        if (services.cssApp) {
+            await services.cssApp.stop();
+            supervisor.setStatus('css', 'stopped');
+        }
+    }
+    catch (error) {
+        logger.warn(`Failed to stop css: ${String(error)}`);
+    }
+    await (0, RedisClientLifecycle_1.closeManagedRedisClients)();
+    if (state.sockets.css) {
+        host.cleanupSocketPath(state.sockets.css);
+    }
+    if (state.sockets.api) {
+        host.cleanupSocketPath(state.sockets.api);
+    }
+    await unregisterSocketOrigins();
+    await closeIdentityConnections();
+    restoreRuntimeEnv();
+}
+//# sourceMappingURL=lifecycle.js.map

package/dist/runtime/lifecycle.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lifecycle.js","sourceRoot":"","sources":["../../src/runtime/lifecycle.ts"],"names":[],"mappings":"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","sourcesContent":["import type { App } from '@solid/community-server';\nimport type { AuthContext } from '../api/auth/AuthContext';\nimport type { ApiServiceHandle } from '../api/runtime';\nimport { Supervisor } from '../supervisor/Supervisor';\nimport type { Logger } from 'global-logger-factory';\nimport { PACKAGE_ROOT } from './package-root';\nimport type { RuntimeHost } from './host/types';\nimport type { RuntimeBootstrapState } from './bootstrap';\nimport { closeManagedRedisClients } from '../storage/redis/RedisClientLifecycle';\nimport type {\n  ApiRuntimeRunner,\n  CssRuntimeRunner,\n  GatewayRuntimeHandle,\n  GatewayRuntimeRunner,\n} from './runner/types';\n\nexport interface RuntimeServices {\n  cssApp?: App;\n  apiService?: ApiServiceHandle;\n  gateway?: GatewayRuntimeHandle;\n}\n\ninterface StartCssRuntimeOptions {\n  state: RuntimeBootstrapState;\n  host: RuntimeHost;\n  runtimeShorthand: Record<string, string | number | boolean>;\n  supervisor: Supervisor;\n  open: boolean;\n  createCssRuntimeConfig: (state: RuntimeBootstrapState, open: boolean) => string;\n  cssRunner: CssRuntimeRunner;\n}\n\ninterface StartApiRuntimeOptions {\n  state: RuntimeBootstrapState;\n  host: RuntimeHost;\n  supervisor: Supervisor;\n  authContext?: AuthContext;\n  apiRunner: ApiRuntimeRunner;\n}\n\ninterface StartGatewayRuntimeOptions {\n  state: RuntimeBootstrapState;\n  host: RuntimeHost;\n  supervisor: Supervisor;\n  shutdownHandler: () => Promise<void>;\n  gatewayRunner: GatewayRuntimeRunner;\n}\n\ninterface StopRuntimeServicesOptions {\n  services: RuntimeServices;\n  supervisor: Supervisor;\n  logger: Logger;\n  host: RuntimeHost;\n  state: RuntimeBootstrapState;\n  unregisterSocketOrigins: () => Promise<void>;\n  closeIdentityConnections: () => Promise<void>;\n  restoreRuntimeEnv: () => void;\n}\n\nfunction ensureTrailingSlash(url: string): string {\n  return url.endsWith('/') ? url : `${url}/`;\n}\n\nexport function createOpenAuthContext(baseUrl: string, override?: AuthContext): AuthContext {\n  if (override) {\n    return override;\n  }\n\n  return {\n    type: 'solid',\n    webId: new URL('test/profile/card#me', ensureTrailingSlash(baseUrl)).href,\n    accountId: 'xpod-open-account',\n    displayName: 'Xpod Open Mode',\n  };\n}\n\nexport function registerManagedRuntimeServices(\n  supervisor: Supervisor,\n  services: RuntimeServices,\n): void {\n  supervisor.registerManaged('css', async() => {\n    if (services.cssApp) {\n      await services.cssApp.stop();\n    }\n  });\n\n  supervisor.registerManaged('api', async() => {\n    if (services.apiService) {\n      await services.apiService.stop();\n    }\n  });\n\n  supervisor.registerManaged('gateway', async() => {\n    if (services.gateway) {\n      await services.gateway.stop();\n    }\n  });\n}\n\nexport async function startCssRuntime({\n  state,\n  host,\n  runtimeShorthand,\n  supervisor,\n  open,\n  createCssRuntimeConfig,\n  cssRunner,\n}: StartCssRuntimeOptions): Promise<App> {\n  const cssConfigPath = createCssRuntimeConfig(state, open || state.cssAuthMode === 'allow-all');\n\n  supervisor.setStatus('css', 'starting', { startTime: Date.now() });\n  const cssApp = await cssRunner.start({\n    configPath: cssConfigPath,\n    packageRoot: PACKAGE_ROOT,\n    logLevel: state.logLevel,\n    shorthand: {\n      ...(state.sockets.css ? { socket: state.sockets.css } : { port: state.ports.css! }),\n      ...runtimeShorthand,\n    },\n  });\n\n  if (state.sockets.css) {\n    const ready = await host.isConnectionTargetReady({ socketPath: state.sockets.css }, 5_000);\n    if (!ready) {\n      throw new Error(`Timed out waiting for CSS socket ${state.sockets.css}`);\n    }\n    supervisor.addLog('css', 'info', `CSS started (unix://${state.sockets.css})`);\n  } else {\n    await host.waitForPortReady(state.ports.css!, '127.0.0.1');\n    supervisor.addLog('css', 'info', `CSS started (http://127.0.0.1:${state.ports.css})`);\n  }\n  supervisor.setStatus('css', 'running', { startTime: Date.now() });\n  return cssApp;\n}\n\nexport async function startApiRuntime({\n  state,\n  host,\n  supervisor,\n  authContext,\n  apiRunner,\n}: StartApiRuntimeOptions): Promise<ApiServiceHandle> {\n  supervisor.setStatus('api', 'starting', { startTime: Date.now() });\n\n  const apiService = await apiRunner.start({\n    open: state.apiOpen,\n    authContext: createOpenAuthContext(state.baseUrl, authContext),\n    runtimeHost: host,\n  });\n\n  supervisor.addLog('api', 'info', `API started (${state.transport === 'socket' ? `unix://${state.sockets.api}` : `http://127.0.0.1:${state.ports.api}`})`);\n  supervisor.setStatus('api', 'running', { startTime: Date.now() });\n  return apiService;\n}\n\nexport async function startGatewayRuntime({\n  state,\n  host,\n  supervisor,\n  shutdownHandler,\n  gatewayRunner,\n}: StartGatewayRuntimeOptions): Promise<GatewayRuntimeHandle> {\n  supervisor.setStatus('gateway', 'starting', { startTime: Date.now() });\n\n  const gateway = await gatewayRunner.start({\n    port: state.ports.gateway,\n    bindHost: state.bindHost,\n    socketPath: state.sockets.gateway,\n    shutdownHandler,\n    baseUrl: state.baseUrl,\n    runtimeHost: host,\n    supervisor,\n    targets: {\n      css: state.transport === 'socket' ? { socketPath: state.sockets.css! } : { url: `http://127.0.0.1:${state.ports.css}` },\n      api: state.transport === 'socket' ? { socketPath: state.sockets.api! } : { url: `http://127.0.0.1:${state.ports.api}` },\n    },\n  });\n  supervisor.addLog('xpod', 'info', `Gateway started (${state.transport === 'socket' ? `unix://${state.sockets.gateway}` : state.baseUrl})`);\n  supervisor.setStatus('gateway', 'running', { startTime: Date.now() });\n  return gateway;\n}\n\nexport async function stopRuntimeServices({\n  services,\n  supervisor,\n  logger,\n  host,\n  state,\n  unregisterSocketOrigins,\n  closeIdentityConnections,\n  restoreRuntimeEnv,\n}: StopRuntimeServicesOptions): Promise<void> {\n  try {\n    if (services.gateway) {\n      await services.gateway.stop();\n      supervisor.setStatus('gateway', 'stopped');\n    }\n  } catch (error) {\n    logger.warn(`Failed to stop gateway: ${String(error)}`);\n  }\n\n  try {\n    if (services.apiService) {\n      await services.apiService.stop();\n      supervisor.setStatus('api', 'stopped');\n    }\n  } catch (error) {\n    logger.warn(`Failed to stop api: ${String(error)}`);\n  }\n\n  try {\n    if (services.cssApp) {\n      await services.cssApp.stop();\n      supervisor.setStatus('css', 'stopped');\n    }\n  } catch (error) {\n    logger.warn(`Failed to stop css: ${String(error)}`);\n  }\n\n  await closeManagedRedisClients();\n\n  if (state.sockets.css) {\n    host.cleanupSocketPath(state.sockets.css);\n  }\n  if (state.sockets.api) {\n    host.cleanupSocketPath(state.sockets.api);\n  }\n\n  await unregisterSocketOrigins();\n  await closeIdentityConnections();\n  restoreRuntimeEnv();\n}\n"]}