@mysten-incubation/devstack 0.0.0

package/dist/plugins/host-service/index.mjs

@@ -0,0 +1,48 @@
+import { definePlugin, resource } from "../../substrate/plugin.mjs";
+import { pluginErrorContributions } from "../../api/plugin-errors.mjs";
+import { PortBrokerService } from "../../substrate/runtime/port-broker/service.mjs";
+import { CurrentPluginKey } from "../../substrate/runtime/current-plugin.mjs";
+import { makeHostServiceRoutable } from "./routable.mjs";
+import { Logger as Logger$1 } from "../../substrate/runtime/observability/logger.mjs";
+import { HOST_SERVICE_ERROR_TAGS } from "./errors.mjs";
+import { normalizeHostServiceOptions, prepareHostService } from "./service.mjs";
+import { Effect } from "effect";
+//#region src/plugins/host-service/index.ts
+const hostServiceResourceId = (name) => `host-service/${name}`;
+const hostServiceResource = (name) => resource(hostServiceResourceId(name));
+const hostServiceErrorContributions = pluginErrorContributions(HOST_SERVICE_ERROR_TAGS);
+const HOST_SERVICE_PORT_PROBE_HOST = "0.0.0.0";
+const hostService = (options) => {
+	const normalized = normalizeHostServiceOptions(options);
+	const serviceResource = hostServiceResource(normalized.serviceName);
+	const after = options.after ?? [];
+	return definePlugin({
+		id: serviceResource.id,
+		dependsOn: after,
+		role: "service",
+		start: () => Effect.gen(function* () {
+			const portBroker = yield* PortBrokerService;
+			const prepared = yield* prepareHostService(normalized, {
+				allocatePort: (preferredPort) => portBroker.allocate({
+					kind: "http",
+					probeHost: HOST_SERVICE_PORT_PROBE_HOST,
+					...preferredPort === void 0 ? {} : { preferredPort }
+				}).pipe(Effect.map((allocation) => allocation.port)),
+				logger: yield* Logger$1,
+				pluginKey: (yield* CurrentPluginKey).key
+			});
+			yield* prepared.start;
+			return prepared.value;
+		}),
+		errorContributions: hostServiceErrorContributions,
+		capabilities: ({ value }) => [makeHostServiceRoutable({
+			endpointName: value.endpointName,
+			serviceName: value.name,
+			port: value.port
+		})]
+	});
+};
+//#endregion
+export { hostService };
+
+//# sourceMappingURL=index.mjs.map

package/dist/plugins/host-service/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.mjs","names":["Logger"],"sources":["../../../src/plugins/host-service/index.ts"],"sourcesContent":["// Generic host-process service plugin.\n//\n// Use this for browser dev servers and other local host processes that\n// should be supervised by devstack rather than launched manually in a\n// sibling terminal.\n\nimport { Effect } from 'effect';\n\nimport { definePlugin, resource, type AnyResourceRef } from '../../api/define-plugin.ts';\nimport { pluginErrorContributions } from '../../api/plugin-errors.ts';\nimport {\n\tPortBrokerService,\n\ttype PortProbeHost,\n} from '../../substrate/runtime/port-broker/index.ts';\nimport { Logger } from '../../substrate/runtime/observability/index.ts';\nimport { CurrentPluginKey } from '../../substrate/runtime/current-plugin.ts';\n\nimport {\n\tHOST_SERVICE_ERROR_TAGS,\n\tHostServiceAcquireError,\n\ttype HostServiceConfigError,\n\ttype HostServiceError,\n} from './errors.ts';\nimport {\n\tacquireHostService,\n\tnormalizeHostServiceOptions,\n\tprepareHostService,\n\tHOST_SERVICE_PORT_TOKEN,\n\ttype HostServiceOptions,\n\ttype PreparedHostService,\n\ttype HostServiceResolvedOptions,\n\ttype HostServiceValue,\n\ttype HostServiceReadyProbe,\n\ttype HostProcessChild,\n\ttype HostProcessSpawner,\n\ttype HostProcessSpawnOptions,\n\ttype HostServiceAcquireContext,\n} from './service.ts';\nimport { HOST_SERVICE_DEFAULT_ENDPOINT_NAME, makeHostServiceRoutable } from './routable.ts';\n\nexport const hostServiceResourceId = <Name extends string>(name: Name): `host-service/${Name}` =>\n\t`host-service/${name}`;\n\nexport const hostServiceResource = <Name extends string>(name: Name) =>\n\tresource<`host-service/${Name}`, HostServiceValue>(hostServiceResourceId(name));\n\nconst hostServiceErrorContributions = pluginErrorContributions(HOST_SERVICE_ERROR_TAGS);\nconst HOST_SERVICE_PORT_PROBE_HOST: PortProbeHost = '0.0.0.0';\n\nexport type HostServiceAfter = ReadonlyArray<AnyResourceRef>;\n\nexport const hostService = <const After extends HostServiceAfter = readonly []>(\n\toptions: HostServiceOptions<After>,\n) => {\n\tconst normalized = normalizeHostServiceOptions(options);\n\tconst serviceResource = hostServiceResource(normalized.serviceName);\n\tconst after = options.after ?? ([] as unknown as After);\n\n\treturn definePlugin({\n\t\tid: serviceResource.id,\n\t\tdependsOn: after,\n\t\trole: 'service',\n\t\tstart: () =>\n\t\t\tEffect.gen(function* () {\n\t\t\t\tconst portBroker = yield* PortBrokerService;\n\t\t\t\tconst logger = yield* Logger;\n\t\t\t\tconst currentPlugin = yield* CurrentPluginKey;\n\t\t\t\tconst acquireContext = {\n\t\t\t\t\tallocatePort: (preferredPort) =>\n\t\t\t\t\t\tportBroker\n\t\t\t\t\t\t\t.allocate({\n\t\t\t\t\t\t\t\tkind: 'http',\n\t\t\t\t\t\t\t\tprobeHost: HOST_SERVICE_PORT_PROBE_HOST,\n\t\t\t\t\t\t\t\t...(preferredPort === undefined ? {} : { preferredPort }),\n\t\t\t\t\t\t\t})\n\t\t\t\t\t\t\t.pipe(Effect.map((allocation) => allocation.port)),\n\t\t\t\t\tlogger,\n\t\t\t\t\tpluginKey: currentPlugin.key,\n\t\t\t\t} satisfies HostServiceAcquireContext;\n\t\t\t\tconst prepared = yield* prepareHostService(normalized, acquireContext);\n\t\t\t\tyield* prepared.start;\n\t\t\t\treturn prepared.value;\n\t\t\t}),\n\t\terrorContributions: hostServiceErrorContributions,\n\t\tcapabilities: ({ value }) =>\n\t\t\t[\n\t\t\t\tmakeHostServiceRoutable({\n\t\t\t\t\tendpointName: value.endpointName,\n\t\t\t\t\tserviceName: value.name,\n\t\t\t\t\tport: value.port,\n\t\t\t\t}),\n\t\t\t] as const,\n\t});\n};\n\nexport type {\n\tHostServiceAcquireContext,\n\tHostServiceError,\n\tHostServiceOptions,\n\tPreparedHostService,\n\tHostServiceReadyProbe,\n\tHostServiceResolvedOptions,\n\tHostServiceValue,\n\tHostProcessChild,\n\tHostProcessSpawner,\n\tHostProcessSpawnOptions,\n\tHostServiceConfigError,\n};\nexport {\n\tacquireHostService,\n\tprepareHostService,\n\tHOST_SERVICE_DEFAULT_ENDPOINT_NAME,\n\tHOST_SERVICE_ERROR_TAGS,\n\tHOST_SERVICE_PORT_TOKEN,\n\tHostServiceAcquireError,\n\tmakeHostServiceRoutable,\n\tnormalizeHostServiceOptions,\n};\n"],"mappings":";;;;;;;;;;AAwCA,MAAa,yBAA8C,SAC1D,gBAAgB;AAEjB,MAAa,uBAA4C,SACxD,SAAmD,sBAAsB,KAAK,CAAC;AAEhF,MAAM,gCAAgC,yBAAyB,wBAAwB;AACvF,MAAM,+BAA8C;AAIpD,MAAa,eACZ,YACI;CACJ,MAAM,aAAa,4BAA4B,QAAQ;CACvD,MAAM,kBAAkB,oBAAoB,WAAW,YAAY;CACnE,MAAM,QAAQ,QAAQ,SAAU,EAAE;AAElC,QAAO,aAAa;EACnB,IAAI,gBAAgB;EACpB,WAAW;EACX,MAAM;EACN,aACC,OAAO,IAAI,aAAa;GACvB,MAAM,aAAa,OAAO;GAe1B,MAAM,WAAW,OAAO,mBAAmB,YAAY;IAXtD,eAAe,kBACd,WACE,SAAS;KACT,MAAM;KACN,WAAW;KACX,GAAI,kBAAkB,KAAA,IAAY,EAAE,GAAG,EAAE,eAAe;KACxD,CAAC,CACD,KAAK,OAAO,KAAK,eAAe,WAAW,KAAK,CAAC;IACpD,QAAA,OAXqBA;IAYrB,YAAW,OAXiB,kBAWH;IAE2C,CAAC;AACtE,UAAO,SAAS;AAChB,UAAO,SAAS;IACf;EACH,oBAAoB;EACpB,eAAe,EAAE,YAChB,CACC,wBAAwB;GACvB,cAAc,MAAM;GACpB,aAAa,MAAM;GACnB,MAAM,MAAM;GACZ,CAAC,CACF;EACF,CAAC"}

package/dist/plugins/host-service/routable.mjs

@@ -0,0 +1,24 @@
+const HOST_SERVICE_DEFAULT_ENTRYPOINT_PORT = 5175;
+const HOST_SERVICE_ENTRYPOINTS = [{
+	name: "dev",
+	port: HOST_SERVICE_DEFAULT_ENTRYPOINT_PORT,
+	protocol: "http"
+}];
+const makeHostServiceRoutable = (parts) => ({
+	kind: "routable",
+	endpointName: parts.endpointName,
+	dispatchId: {
+		serviceKey: `host-service.${parts.serviceName}`,
+		role: parts.endpointName
+	},
+	upstream: {
+		type: "host-loopback",
+		port: parts.port
+	},
+	cors: true,
+	wireProtocol: "http"
+});
+//#endregion
+export { HOST_SERVICE_DEFAULT_ENTRYPOINT_PORT, HOST_SERVICE_ENTRYPOINTS, makeHostServiceRoutable };
+
+//# sourceMappingURL=routable.mjs.map

package/dist/plugins/host-service/routable.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"routable.mjs","names":[],"sources":["../../../src/plugins/host-service/routable.ts"],"sourcesContent":["import type { EntrypointDecl, RoutableDecl } from '../../contracts/routable.ts';\n\nexport const HOST_SERVICE_DEFAULT_ENDPOINT_NAME = 'dev' as const;\nexport const HOST_SERVICE_DEFAULT_ENTRYPOINT_PORT = 5175;\n\nexport const HOST_SERVICE_ENTRYPOINTS: ReadonlyArray<EntrypointDecl> = [\n\t{\n\t\tname: HOST_SERVICE_DEFAULT_ENDPOINT_NAME,\n\t\tport: HOST_SERVICE_DEFAULT_ENTRYPOINT_PORT,\n\t\tprotocol: 'http',\n\t},\n];\n\nexport const makeHostServiceRoutable = (parts: {\n\treadonly endpointName: string;\n\treadonly serviceName: string;\n\treadonly port: number;\n}): RoutableDecl => ({\n\tkind: 'routable',\n\tendpointName: parts.endpointName,\n\tdispatchId: {\n\t\tserviceKey: `host-service.${parts.serviceName}`,\n\t\trole: parts.endpointName,\n\t},\n\tupstream: { type: 'host-loopback', port: parts.port },\n\tcors: true,\n\twireProtocol: 'http',\n});\n"],"mappings":"AAGA,MAAa,uCAAuC;AAEpD,MAAa,2BAA0D,CACtE;CACC,MAAA;CACA,MAAM;CACN,UAAU;CACV,CACD;AAED,MAAa,2BAA2B,WAInB;CACpB,MAAM;CACN,cAAc,MAAM;CACpB,YAAY;EACX,YAAY,gBAAgB,MAAM;EAClC,MAAM,MAAM;EACZ;CACD,UAAU;EAAE,MAAM;EAAiB,MAAM,MAAM;EAAM;CACrD,MAAM;CACN,cAAc;CACd"}

package/dist/plugins/host-service/service.d.mts

@@ -0,0 +1,49 @@
+import { AnyResourceRef } from "../../substrate/plugin.mjs";
+import { Effect, Scope } from "effect";
+
+//#region src/plugins/host-service/service.d.ts
+declare const HOST_SERVICE_PORT_TOKEN: "{port}";
+type HostServiceReadyProbe = {
+  readonly kind: 'http';
+  readonly url?: string;
+  readonly timeoutMs?: number;
+  readonly intervalMs?: number;
+} | {
+  readonly kind: 'log';
+  readonly pattern: string | RegExp;
+  readonly stream?: 'stdout' | 'stderr' | 'both';
+  readonly timeoutMs?: number;
+};
+interface HostServiceBaseOptions<After extends ReadonlyArray<AnyResourceRef>> {
+  readonly name?: string;
+  readonly endpointName?: string;
+  readonly after?: After;
+  readonly cwd?: string;
+  readonly port?: number;
+  readonly env?: Readonly<Record<string, string>>;
+  readonly ready?: HostServiceReadyProbe;
+  readonly shutdownGraceMs?: number;
+}
+interface HostServiceCommandOptions<After extends ReadonlyArray<AnyResourceRef>> extends HostServiceBaseOptions<After> {
+  readonly command: string;
+  readonly args?: ReadonlyArray<string>;
+  readonly script?: never;
+}
+interface HostServiceScriptOptions<After extends ReadonlyArray<AnyResourceRef>> extends HostServiceBaseOptions<After> {
+  readonly script: string;
+  readonly command?: never;
+  readonly args?: never;
+}
+type HostServiceOptions<After extends ReadonlyArray<AnyResourceRef> = ReadonlyArray<AnyResourceRef>> = HostServiceCommandOptions<After> | HostServiceScriptOptions<After>;
+interface HostServiceValue {
+  readonly name: string;
+  readonly endpointName: string;
+  readonly command: string;
+  readonly args: ReadonlyArray<string>;
+  readonly cwd: string;
+  readonly port: number;
+  readonly url: string;
+}
+//#endregion
+export { HOST_SERVICE_PORT_TOKEN, HostServiceOptions, HostServiceReadyProbe, HostServiceValue };
+//# sourceMappingURL=service.d.mts.map

package/dist/plugins/host-service/service.mjs

@@ -0,0 +1,375 @@
+import { observeProcessLines, readableToByteStream } from "../../substrate/runtime/observability/process-lines.mjs";
+import { SpanAttr } from "../../substrate/runtime/observability/spans.mjs";
+import { expectNonEmptyString, expectOneOf, expectOptionalNonEmptyString, expectOptionalPort, expectOptionalPositiveInteger, expectStringRecord } from "../../substrate/runtime/config-validation.mjs";
+import { waitForHttpEndpoint } from "../../substrate/runtime/http-probe.mjs";
+import { awaitManagedProcessReady, describeProcessExitStatus, nodeProcessSpawner, onceProcessError, onceProcessExit, terminateManagedProcess } from "../../substrate/runtime/process-supervisor.mjs";
+import { HostServiceAcquireError, hostServiceConfigError } from "./errors.mjs";
+import { Effect, Exit, Ref } from "effect";
+import { resolve } from "node:path";
+//#region src/plugins/host-service/service.ts
+const HOST_SERVICE_PORT_TOKEN = "{port}";
+const DEFAULT_SHUTDOWN_GRACE_MS = 5e3;
+const DEFAULT_HTTP_READY_TIMEOUT_MS = 6e4;
+const DEFAULT_HTTP_READY_INTERVAL_MS = 250;
+const DEFAULT_LOG_READY_TIMEOUT_MS = 6e4;
+const shellInvocationFor = (script) => {
+	if (process.platform === "win32") return {
+		command: process.env.ComSpec ?? process.env.COMSPEC ?? "cmd.exe",
+		args: [
+			"/d",
+			"/s",
+			"/c",
+			script
+		]
+	};
+	return {
+		command: "/bin/sh",
+		args: ["-c", script]
+	};
+};
+const configErrorFor = (serviceName) => (issue) => hostServiceConfigError(serviceName, issue);
+const normalizeReadyProbe = (serviceName, ready) => {
+	if (ready === void 0) return void 0;
+	const mkError = configErrorFor(serviceName);
+	if (ready.kind === "http") {
+		expectOptionalNonEmptyString(ready.url, {
+			field: "ready.url",
+			mkError
+		});
+		expectOptionalPositiveInteger(ready.timeoutMs, {
+			field: "ready.timeoutMs",
+			mkError
+		});
+		expectOptionalPositiveInteger(ready.intervalMs, {
+			field: "ready.intervalMs",
+			mkError
+		});
+		return ready;
+	}
+	if (ready.kind === "log") {
+		if (typeof ready.pattern !== "string" && !(ready.pattern instanceof RegExp)) throw mkError({
+			field: "ready.pattern",
+			message: "must be a string or RegExp"
+		});
+		if (ready.stream !== void 0) expectOneOf(ready.stream, [
+			"stdout",
+			"stderr",
+			"both"
+		], {
+			field: "ready.stream",
+			mkError
+		});
+		expectOptionalPositiveInteger(ready.timeoutMs, {
+			field: "ready.timeoutMs",
+			mkError
+		});
+		return ready;
+	}
+	throw mkError({
+		field: "ready.kind",
+		message: "must be 'http' or 'log'"
+	});
+};
+const normalizeHostServiceOptions = (options) => {
+	const endpointName = options.endpointName ?? "dev";
+	const serviceName = options.name ?? endpointName;
+	const mkError = configErrorFor(serviceName);
+	expectNonEmptyString(serviceName, {
+		field: "name",
+		mkError
+	});
+	expectNonEmptyString(endpointName, {
+		field: "endpointName",
+		mkError
+	});
+	const rawCommand = options.command;
+	const rawArgs = options.args;
+	const rawScript = options.script;
+	if (rawCommand !== void 0 && rawScript !== void 0) throw mkError({
+		field: "command",
+		message: "use either command or script, not both"
+	});
+	if (rawCommand === void 0 && rawScript === void 0) throw mkError({
+		field: "command",
+		message: "is required unless script is provided"
+	});
+	if (rawScript !== void 0 && rawArgs !== void 0) throw mkError({
+		field: "args",
+		message: "args are only supported with command"
+	});
+	const preferredPort = expectOptionalPort(options.port, {
+		field: "port",
+		mkError
+	});
+	const cwd = resolve(options.cwd ?? process.cwd());
+	const env = expectStringRecord(options.env, {
+		field: "env",
+		mkError
+	});
+	const shutdownGraceMs = expectOptionalPositiveInteger(options.shutdownGraceMs, {
+		field: "shutdownGraceMs",
+		mkError
+	}) ?? DEFAULT_SHUTDOWN_GRACE_MS;
+	const ready = normalizeReadyProbe(serviceName, options.ready);
+	const invocation = rawScript !== void 0 ? shellInvocationFor(expectNonEmptyString(rawScript, {
+		field: "script",
+		mkError
+	})) : {
+		command: expectNonEmptyString(rawCommand, {
+			field: "command",
+			mkError
+		}),
+		args: options.args ?? []
+	};
+	return {
+		serviceName,
+		endpointName,
+		command: invocation.command,
+		args: invocation.args,
+		cwd,
+		...preferredPort === void 0 ? {} : { preferredPort },
+		env,
+		...ready === void 0 ? {} : { ready },
+		shutdownGraceMs
+	};
+};
+const renderPortToken = (value, port) => value.replaceAll(HOST_SERVICE_PORT_TOKEN, String(port));
+const renderCommand = (options, port) => {
+	const renderedEnv = {};
+	for (const [key, value] of Object.entries(options.env)) renderedEnv[key] = renderPortToken(value, port);
+	return {
+		command: renderPortToken(options.command, port),
+		args: options.args.map((arg) => renderPortToken(arg, port)),
+		env: renderedEnv
+	};
+};
+const hostServiceValue = (options, port, rendered) => ({
+	name: options.serviceName,
+	endpointName: options.endpointName,
+	command: rendered.command,
+	args: rendered.args,
+	cwd: options.cwd,
+	port,
+	url: `http://127.0.0.1:${port}`
+});
+const terminateChild = (child, timeoutMs, logger, pluginKey, tag) => terminateManagedProcess(child, {
+	graceMs: timeoutMs,
+	processGroup: true,
+	onEscalate: () => logger.log(tag, pluginKey, {
+		level: "warn",
+		message: "host service did not exit after SIGTERM; sending SIGKILL",
+		fields: { [SpanAttr.event]: "process.shutdown.escalated" }
+	})
+});
+const httpReady = (url, timeoutMs, intervalMs, exit, processError, error) => awaitManagedProcessReady({
+	ready: waitForHttpEndpoint({
+		endpoint: url,
+		timeoutMs,
+		intervalMs,
+		validate: () => true
+	}).pipe(Effect.mapError((cause) => new HostServiceAcquireError({
+		...error,
+		phase: "ready",
+		message: `host service did not become ready at ${url} within ${timeoutMs}ms`,
+		cause
+	}))),
+	exit,
+	processError,
+	onExitBeforeReady: (status) => new HostServiceAcquireError({
+		...error,
+		phase: "exit",
+		message: "host service exited before readiness",
+		exitCode: status.code,
+		signal: status.signal
+	}),
+	onProcessErrorBeforeReady: (cause) => new HostServiceAcquireError({
+		...error,
+		phase: "spawn",
+		message: "host service process failed before readiness",
+		cause
+	})
+});
+const logReady = (ready, readySignal, exit, processError, error) => awaitManagedProcessReady({
+	ready: Effect.tryPromise({
+		try: () => new Promise((resolveReady, rejectReady) => {
+			const timeout = setTimeout(() => {
+				rejectReady(new HostServiceAcquireError({
+					...error,
+					phase: "ready",
+					message: `host service did not emit readiness log within ${ready.timeoutMs ?? DEFAULT_LOG_READY_TIMEOUT_MS}ms`
+				}));
+			}, ready.timeoutMs ?? DEFAULT_LOG_READY_TIMEOUT_MS);
+			readySignal.then(() => {
+				clearTimeout(timeout);
+				resolveReady();
+			});
+		}),
+		catch: (cause) => cause instanceof HostServiceAcquireError ? cause : error
+	}),
+	exit,
+	processError,
+	onExitBeforeReady: (status) => new HostServiceAcquireError({
+		...error,
+		phase: "exit",
+		message: "host service exited before readiness",
+		exitCode: status.code,
+		signal: status.signal
+	}),
+	onProcessErrorBeforeReady: (cause) => new HostServiceAcquireError({
+		...error,
+		phase: "spawn",
+		message: "host service process failed before readiness",
+		cause
+	})
+});
+const allocateHostPort = (options, ctx) => ctx.allocatePort(options.preferredPort).pipe(Effect.mapError((cause) => new HostServiceAcquireError({
+	serviceName: options.serviceName,
+	cwd: options.cwd,
+	command: options.command,
+	args: options.args,
+	phase: "allocate-port",
+	message: "host service failed to allocate HTTP port",
+	cause
+})));
+const startHostProcess = (options, ctx, port) => Effect.gen(function* () {
+	const rendered = renderCommand(options, port);
+	const env = {
+		...ctx.processEnv ?? process.env,
+		...rendered.env,
+		PORT: String(port)
+	};
+	const tag = `host-service/${options.serviceName}`;
+	let resolveLogReady;
+	const logReadySignal = options.ready?.kind === "log" ? new Promise((resolveReady) => {
+		resolveLogReady = resolveReady;
+	}) : null;
+	const observeReadinessLine = (line, stream) => {
+		if (options.ready?.kind !== "log") return;
+		if (options.ready.stream !== void 0 && options.ready.stream !== "both" && options.ready.stream !== stream) return;
+		if (typeof options.ready.pattern === "string" ? line.includes(options.ready.pattern) : options.ready.pattern.test(line)) resolveLogReady?.();
+	};
+	const spawnChild = ctx.spawner ?? nodeProcessSpawner;
+	const child = yield* Effect.try({
+		try: () => spawnChild(rendered.command, rendered.args, {
+			cwd: options.cwd,
+			env,
+			stdio: "pipe",
+			detached: process.platform !== "win32"
+		}),
+		catch: (cause) => new HostServiceAcquireError({
+			serviceName: options.serviceName,
+			cwd: options.cwd,
+			command: rendered.command,
+			args: rendered.args,
+			phase: "spawn",
+			message: "host service spawn failed",
+			cause
+		})
+	});
+	let shuttingDown = false;
+	let exitStatus = null;
+	const exited = onceProcessExit(child).then((status) => {
+		exitStatus = status;
+		return status;
+	});
+	const processError = onceProcessError(child);
+	yield* observeProcessLines({
+		stdout: readableToByteStream(child.stdout),
+		stderr: readableToByteStream(child.stderr)
+	}, {
+		logger: ctx.logger,
+		pluginKey: ctx.pluginKey,
+		tag,
+		fields: { [SpanAttr.serviceName]: options.serviceName },
+		onLine: ({ line, stream }) => Effect.sync(() => {
+			observeReadinessLine(line, stream);
+		})
+	});
+	yield* Effect.addFinalizer(() => Effect.gen(function* () {
+		shuttingDown = true;
+		if (exitStatus !== null) return;
+		yield* terminateChild(child, options.shutdownGraceMs, ctx.logger, ctx.pluginKey, tag);
+	}));
+	const baseError = new HostServiceAcquireError({
+		serviceName: options.serviceName,
+		cwd: options.cwd,
+		command: rendered.command,
+		args: rendered.args,
+		phase: "ready",
+		message: "host service readiness failed"
+	});
+	const awaitReadiness = (() => {
+		if (options.ready?.kind === "http") return httpReady(renderPortToken(options.ready.url ?? "http://127.0.0.1:{port}", port), options.ready.timeoutMs ?? DEFAULT_HTTP_READY_TIMEOUT_MS, options.ready.intervalMs ?? DEFAULT_HTTP_READY_INTERVAL_MS, exited, processError, baseError);
+		if (options.ready?.kind === "log" && logReadySignal !== null) return logReady(options.ready, logReadySignal, exited, processError, baseError);
+		return Effect.gen(function* () {
+			yield* awaitManagedProcessReady({
+				ready: Effect.promise(() => new Promise((resolveReady) => setTimeout(resolveReady, 0))),
+				exit: exited,
+				processError,
+				onExitBeforeReady: (status) => new HostServiceAcquireError({
+					...baseError,
+					phase: "exit",
+					message: "host service exited before readiness",
+					exitCode: status.code,
+					signal: status.signal
+				}),
+				onProcessErrorBeforeReady: (cause) => new HostServiceAcquireError({
+					...baseError,
+					phase: "spawn",
+					message: "host service process failed before readiness",
+					cause
+				})
+			});
+		});
+	})();
+	const readinessExit = yield* Effect.exit(awaitReadiness);
+	if (Exit.isFailure(readinessExit)) {
+		shuttingDown = true;
+		if (exitStatus === null) yield* terminateChild(child, options.shutdownGraceMs, ctx.logger, ctx.pluginKey, tag);
+		return yield* Effect.failCause(readinessExit.cause);
+	}
+	exited.then((status) => {
+		if (shuttingDown) return;
+		Effect.runPromise(ctx.logger.log(tag, ctx.pluginKey, {
+			level: "error",
+			message: "host service exited after readiness",
+			fields: {
+				[SpanAttr.event]: "process.exited",
+				[SpanAttr.serviceName]: options.serviceName,
+				[SpanAttr.exitCode]: status.code,
+				[SpanAttr.exitSignal]: status.signal,
+				[SpanAttr.exitStatus]: describeProcessExitStatus(status)
+			}
+		})).catch(() => {});
+	});
+	processError.then((cause) => {
+		if (shuttingDown) return;
+		Effect.runPromise(ctx.logger.log(tag, ctx.pluginKey, {
+			level: "error",
+			message: "host service process emitted an error after readiness",
+			fields: {
+				[SpanAttr.event]: "process.error",
+				[SpanAttr.serviceName]: options.serviceName,
+				[SpanAttr.errorCause]: cause
+			}
+		})).catch(() => {});
+	});
+});
+const prepareHostService = (options, ctx) => Effect.gen(function* () {
+	const port = yield* allocateHostPort(options, ctx);
+	const rendered = renderCommand(options, port);
+	const started = yield* Ref.make(false);
+	const start = Effect.gen(function* () {
+		if (yield* Ref.get(started)) return;
+		yield* startHostProcess(options, ctx, port);
+		yield* Ref.set(started, true);
+	});
+	return {
+		value: hostServiceValue(options, port, rendered),
+		start
+	};
+});
+//#endregion
+export { HOST_SERVICE_PORT_TOKEN, normalizeHostServiceOptions, prepareHostService };
+
+//# sourceMappingURL=service.mjs.map

package/dist/plugins/host-service/service.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"service.mjs","names":[],"sources":["../../../src/plugins/host-service/service.ts"],"sourcesContent":["import { resolve } from 'node:path';\n\nimport { Effect, Exit, Ref } from 'effect';\nimport type { Scope } from 'effect';\n\nimport type { PluginKey } from '../../substrate/brand.ts';\nimport type { AnyResourceRef } from '../../api/define-plugin.ts';\nimport {\n\texpectNonEmptyString,\n\texpectOneOf,\n\texpectOptionalNonEmptyString,\n\texpectOptionalPort,\n\texpectOptionalPositiveInteger,\n\texpectStringRecord,\n} from '../../substrate/runtime/config-validation.ts';\nimport {\n\tobserveProcessLines,\n\treadableToByteStream,\n\tSpanAttr,\n\ttype LoggerShape,\n} from '../../substrate/runtime/observability/index.ts';\nimport { waitForHttpEndpoint } from '../../substrate/runtime/http-probe.ts';\nimport type { PortBrokerError } from '../../substrate/runtime/port-broker/index.ts';\nimport {\n\tawaitManagedProcessReady,\n\tdescribeProcessExitStatus,\n\tnodeProcessSpawner,\n\tonceProcessError,\n\tonceProcessExit,\n\tterminateManagedProcess,\n\ttype ManagedProcessChild,\n\ttype ManagedProcessSpawner,\n\ttype ManagedProcessSpawnOptions,\n} from '../../substrate/runtime/process-supervisor.ts';\n\nimport { HOST_SERVICE_DEFAULT_ENDPOINT_NAME } from './routable.ts';\nimport { hostServiceConfigError, HostServiceAcquireError } from './errors.ts';\n\nexport const HOST_SERVICE_PORT_TOKEN = '{port}' as const;\n\nexport type HostServiceReadyProbe =\n\t| {\n\t\t\treadonly kind: 'http';\n\t\t\treadonly url?: string;\n\t\t\treadonly timeoutMs?: number;\n\t\t\treadonly intervalMs?: number;\n\t  }\n\t| {\n\t\t\treadonly kind: 'log';\n\t\t\treadonly pattern: string | RegExp;\n\t\t\treadonly stream?: 'stdout' | 'stderr' | 'both';\n\t\t\treadonly timeoutMs?: number;\n\t  };\n\ninterface HostServiceBaseOptions<After extends ReadonlyArray<AnyResourceRef>> {\n\treadonly name?: string;\n\treadonly endpointName?: string;\n\treadonly after?: After;\n\treadonly cwd?: string;\n\treadonly port?: number;\n\treadonly env?: Readonly<Record<string, string>>;\n\treadonly ready?: HostServiceReadyProbe;\n\treadonly shutdownGraceMs?: number;\n}\n\ninterface HostServiceCommandOptions<\n\tAfter extends ReadonlyArray<AnyResourceRef>,\n> extends HostServiceBaseOptions<After> {\n\treadonly command: string;\n\treadonly args?: ReadonlyArray<string>;\n\treadonly script?: never;\n}\n\ninterface HostServiceScriptOptions<\n\tAfter extends ReadonlyArray<AnyResourceRef>,\n> extends HostServiceBaseOptions<After> {\n\treadonly script: string;\n\treadonly command?: never;\n\treadonly args?: never;\n}\n\nexport type HostServiceOptions<\n\tAfter extends ReadonlyArray<AnyResourceRef> = ReadonlyArray<AnyResourceRef>,\n> = HostServiceCommandOptions<After> | HostServiceScriptOptions<After>;\n\nexport interface HostServiceResolvedOptions {\n\treadonly serviceName: string;\n\treadonly endpointName: string;\n\treadonly command: string;\n\treadonly args: ReadonlyArray<string>;\n\treadonly cwd: string;\n\treadonly preferredPort?: number;\n\treadonly env: Readonly<Record<string, string>>;\n\treadonly ready?: HostServiceReadyProbe;\n\treadonly shutdownGraceMs: number;\n}\n\nexport interface HostServiceValue {\n\treadonly name: string;\n\treadonly endpointName: string;\n\treadonly command: string;\n\treadonly args: ReadonlyArray<string>;\n\treadonly cwd: string;\n\treadonly port: number;\n\treadonly url: string;\n}\n\nexport interface PreparedHostService {\n\treadonly value: HostServiceValue;\n\treadonly start: Effect.Effect<void, HostServiceAcquireError, Scope.Scope>;\n}\n\nexport type HostProcessChild = ManagedProcessChild;\nexport type HostProcessSpawnOptions = ManagedProcessSpawnOptions;\nexport type HostProcessSpawner = ManagedProcessSpawner;\n\nexport interface HostServiceAcquireContext {\n\treadonly allocatePort: (\n\t\tpreferredPort: number | undefined,\n\t) => Effect.Effect<number, PortBrokerError, Scope.Scope>;\n\treadonly logger: LoggerShape;\n\treadonly pluginKey: PluginKey;\n\treadonly spawner?: HostProcessSpawner;\n\treadonly processEnv?: NodeJS.ProcessEnv;\n}\n\nconst DEFAULT_SHUTDOWN_GRACE_MS = 5_000;\nconst DEFAULT_HTTP_READY_TIMEOUT_MS = 60_000;\nconst DEFAULT_HTTP_READY_INTERVAL_MS = 250;\nconst DEFAULT_LOG_READY_TIMEOUT_MS = 60_000;\n\nconst shellInvocationFor = (script: string): { command: string; args: ReadonlyArray<string> } => {\n\tif (process.platform === 'win32') {\n\t\treturn {\n\t\t\tcommand: process.env.ComSpec ?? process.env.COMSPEC ?? 'cmd.exe',\n\t\t\targs: ['/d', '/s', '/c', script],\n\t\t};\n\t}\n\treturn {\n\t\tcommand: '/bin/sh',\n\t\targs: ['-c', script],\n\t};\n};\n\nconst configErrorFor =\n\t(serviceName: string) => (issue: Parameters<typeof hostServiceConfigError>[1]) =>\n\t\thostServiceConfigError(serviceName, issue);\n\nconst normalizeReadyProbe = (\n\tserviceName: string,\n\tready: HostServiceReadyProbe | undefined,\n): HostServiceReadyProbe | undefined => {\n\tif (ready === undefined) return undefined;\n\tconst mkError = configErrorFor(serviceName);\n\tif (ready.kind === 'http') {\n\t\texpectOptionalNonEmptyString(ready.url, { field: 'ready.url', mkError });\n\t\texpectOptionalPositiveInteger(ready.timeoutMs, { field: 'ready.timeoutMs', mkError });\n\t\texpectOptionalPositiveInteger(ready.intervalMs, { field: 'ready.intervalMs', mkError });\n\t\treturn ready;\n\t}\n\tif (ready.kind === 'log') {\n\t\tif (typeof ready.pattern !== 'string' && !(ready.pattern instanceof RegExp)) {\n\t\t\tthrow mkError({ field: 'ready.pattern', message: 'must be a string or RegExp' });\n\t\t}\n\t\tif (ready.stream !== undefined) {\n\t\t\texpectOneOf(ready.stream, ['stdout', 'stderr', 'both'] as const, {\n\t\t\t\tfield: 'ready.stream',\n\t\t\t\tmkError,\n\t\t\t});\n\t\t}\n\t\texpectOptionalPositiveInteger(ready.timeoutMs, { field: 'ready.timeoutMs', mkError });\n\t\treturn ready;\n\t}\n\tthrow mkError({ field: 'ready.kind', message: \"must be 'http' or 'log'\" });\n};\n\nexport const normalizeHostServiceOptions = (\n\toptions: HostServiceOptions,\n): HostServiceResolvedOptions => {\n\tconst endpointName = options.endpointName ?? HOST_SERVICE_DEFAULT_ENDPOINT_NAME;\n\tconst serviceName = options.name ?? endpointName;\n\tconst mkError = configErrorFor(serviceName);\n\texpectNonEmptyString(serviceName, { field: 'name', mkError });\n\texpectNonEmptyString(endpointName, { field: 'endpointName', mkError });\n\n\tconst rawCommand = (options as { readonly command?: unknown }).command;\n\tconst rawArgs = (options as { readonly args?: unknown }).args;\n\tconst rawScript = (options as { readonly script?: unknown }).script;\n\tif (rawCommand !== undefined && rawScript !== undefined) {\n\t\tthrow mkError({ field: 'command', message: 'use either command or script, not both' });\n\t}\n\tif (rawCommand === undefined && rawScript === undefined) {\n\t\tthrow mkError({ field: 'command', message: 'is required unless script is provided' });\n\t}\n\tif (rawScript !== undefined && rawArgs !== undefined) {\n\t\tthrow mkError({ field: 'args', message: 'args are only supported with command' });\n\t}\n\n\tconst preferredPort = expectOptionalPort(options.port, { field: 'port', mkError });\n\tconst cwd = resolve(options.cwd ?? process.cwd());\n\tconst env = expectStringRecord(options.env, { field: 'env', mkError });\n\tconst shutdownGraceMs =\n\t\texpectOptionalPositiveInteger(options.shutdownGraceMs, {\n\t\t\tfield: 'shutdownGraceMs',\n\t\t\tmkError,\n\t\t}) ?? DEFAULT_SHUTDOWN_GRACE_MS;\n\tconst ready = normalizeReadyProbe(serviceName, options.ready);\n\tconst invocation =\n\t\trawScript !== undefined\n\t\t\t? shellInvocationFor(expectNonEmptyString(rawScript, { field: 'script', mkError }))\n\t\t\t: {\n\t\t\t\t\tcommand: expectNonEmptyString(rawCommand, { field: 'command', mkError }),\n\t\t\t\t\targs: options.args ?? [],\n\t\t\t\t};\n\n\treturn {\n\t\tserviceName,\n\t\tendpointName,\n\t\tcommand: invocation.command,\n\t\targs: invocation.args,\n\t\tcwd,\n\t\t...(preferredPort === undefined ? {} : { preferredPort }),\n\t\tenv,\n\t\t...(ready === undefined ? {} : { ready }),\n\t\tshutdownGraceMs,\n\t};\n};\n\nconst renderPortToken = (value: string, port: number): string =>\n\tvalue.replaceAll(HOST_SERVICE_PORT_TOKEN, String(port));\n\nconst renderCommand = (\n\toptions: HostServiceResolvedOptions,\n\tport: number,\n): {\n\treadonly command: string;\n\treadonly args: ReadonlyArray<string>;\n\treadonly env: NodeJS.ProcessEnv;\n} => {\n\tconst renderedEnv: NodeJS.ProcessEnv = {};\n\tfor (const [key, value] of Object.entries(options.env)) {\n\t\trenderedEnv[key] = renderPortToken(value, port);\n\t}\n\treturn {\n\t\tcommand: renderPortToken(options.command, port),\n\t\targs: options.args.map((arg) => renderPortToken(arg, port)),\n\t\tenv: renderedEnv,\n\t};\n};\n\nconst hostServiceValue = (\n\toptions: HostServiceResolvedOptions,\n\tport: number,\n\trendered: { readonly command: string; readonly args: ReadonlyArray<string> },\n): HostServiceValue => ({\n\tname: options.serviceName,\n\tendpointName: options.endpointName,\n\tcommand: rendered.command,\n\targs: rendered.args,\n\tcwd: options.cwd,\n\tport,\n\turl: `http://127.0.0.1:${port}`,\n});\n\nconst terminateChild = (\n\tchild: HostProcessChild,\n\ttimeoutMs: number,\n\tlogger: LoggerShape,\n\tpluginKey: PluginKey,\n\ttag: string,\n): Effect.Effect<void> =>\n\tterminateManagedProcess(child, {\n\t\tgraceMs: timeoutMs,\n\t\tprocessGroup: true,\n\t\tonEscalate: () =>\n\t\t\tlogger.log(tag, pluginKey, {\n\t\t\t\tlevel: 'warn',\n\t\t\t\tmessage: 'host service did not exit after SIGTERM; sending SIGKILL',\n\t\t\t\tfields: { [SpanAttr.event]: 'process.shutdown.escalated' },\n\t\t\t}),\n\t});\n\nconst httpReady = (\n\turl: string,\n\ttimeoutMs: number,\n\tintervalMs: number,\n\texit: Promise<{ readonly code: number | null; readonly signal: NodeJS.Signals | null }>,\n\tprocessError: Promise<unknown>,\n\terror: HostServiceAcquireError,\n): Effect.Effect<void, HostServiceAcquireError> =>\n\tawaitManagedProcessReady({\n\t\tready: waitForHttpEndpoint({\n\t\t\tendpoint: url,\n\t\t\ttimeoutMs,\n\t\t\tintervalMs,\n\t\t\t// Host services only need to prove their listener is up. App-level\n\t\t\t// 4xx/5xx responses can be transient while devstack writes generated files.\n\t\t\tvalidate: () => true,\n\t\t}).pipe(\n\t\t\tEffect.mapError(\n\t\t\t\t(cause) =>\n\t\t\t\t\tnew HostServiceAcquireError({\n\t\t\t\t\t\t...error,\n\t\t\t\t\t\tphase: 'ready',\n\t\t\t\t\t\tmessage: `host service did not become ready at ${url} within ${timeoutMs}ms`,\n\t\t\t\t\t\tcause,\n\t\t\t\t\t}),\n\t\t\t),\n\t\t),\n\t\texit,\n\t\tprocessError,\n\t\tonExitBeforeReady: (status) =>\n\t\t\tnew HostServiceAcquireError({\n\t\t\t\t...error,\n\t\t\t\tphase: 'exit',\n\t\t\t\tmessage: 'host service exited before readiness',\n\t\t\t\texitCode: status.code,\n\t\t\t\tsignal: status.signal,\n\t\t\t}),\n\t\tonProcessErrorBeforeReady: (cause) =>\n\t\t\tnew HostServiceAcquireError({\n\t\t\t\t...error,\n\t\t\t\tphase: 'spawn',\n\t\t\t\tmessage: 'host service process failed before readiness',\n\t\t\t\tcause,\n\t\t\t}),\n\t});\n\nconst logReady = (\n\tready: Extract<HostServiceReadyProbe, { readonly kind: 'log' }>,\n\treadySignal: Promise<void>,\n\texit: Promise<{ readonly code: number | null; readonly signal: NodeJS.Signals | null }>,\n\tprocessError: Promise<unknown>,\n\terror: HostServiceAcquireError,\n): Effect.Effect<void, HostServiceAcquireError> =>\n\tawaitManagedProcessReady({\n\t\tready: Effect.tryPromise({\n\t\t\ttry: () =>\n\t\t\t\tnew Promise<void>((resolveReady, rejectReady) => {\n\t\t\t\t\tconst timeout = setTimeout(() => {\n\t\t\t\t\t\trejectReady(\n\t\t\t\t\t\t\tnew HostServiceAcquireError({\n\t\t\t\t\t\t\t\t...error,\n\t\t\t\t\t\t\t\tphase: 'ready',\n\t\t\t\t\t\t\t\tmessage: `host service did not emit readiness log within ${ready.timeoutMs ?? DEFAULT_LOG_READY_TIMEOUT_MS}ms`,\n\t\t\t\t\t\t\t}),\n\t\t\t\t\t\t);\n\t\t\t\t\t}, ready.timeoutMs ?? DEFAULT_LOG_READY_TIMEOUT_MS);\n\t\t\t\t\treadySignal.then(() => {\n\t\t\t\t\t\tclearTimeout(timeout);\n\t\t\t\t\t\tresolveReady();\n\t\t\t\t\t});\n\t\t\t\t}),\n\t\t\tcatch: (cause) => (cause instanceof HostServiceAcquireError ? cause : error),\n\t\t}),\n\t\texit,\n\t\tprocessError,\n\t\tonExitBeforeReady: (status) =>\n\t\t\tnew HostServiceAcquireError({\n\t\t\t\t...error,\n\t\t\t\tphase: 'exit',\n\t\t\t\tmessage: 'host service exited before readiness',\n\t\t\t\texitCode: status.code,\n\t\t\t\tsignal: status.signal,\n\t\t\t}),\n\t\tonProcessErrorBeforeReady: (cause) =>\n\t\t\tnew HostServiceAcquireError({\n\t\t\t\t...error,\n\t\t\t\tphase: 'spawn',\n\t\t\t\tmessage: 'host service process failed before readiness',\n\t\t\t\tcause,\n\t\t\t}),\n\t});\n\nconst allocateHostPort = (\n\toptions: HostServiceResolvedOptions,\n\tctx: HostServiceAcquireContext,\n): Effect.Effect<number, HostServiceAcquireError, Scope.Scope> =>\n\tctx.allocatePort(options.preferredPort).pipe(\n\t\tEffect.mapError(\n\t\t\t(cause) =>\n\t\t\t\tnew HostServiceAcquireError({\n\t\t\t\t\tserviceName: options.serviceName,\n\t\t\t\t\tcwd: options.cwd,\n\t\t\t\t\tcommand: options.command,\n\t\t\t\t\targs: options.args,\n\t\t\t\t\tphase: 'allocate-port',\n\t\t\t\t\tmessage: 'host service failed to allocate HTTP port',\n\t\t\t\t\tcause,\n\t\t\t\t}),\n\t\t),\n\t);\n\nconst startHostProcess = (\n\toptions: HostServiceResolvedOptions,\n\tctx: HostServiceAcquireContext,\n\tport: number,\n): Effect.Effect<void, HostServiceAcquireError, Scope.Scope> =>\n\tEffect.gen(function* () {\n\t\tconst rendered = renderCommand(options, port);\n\t\tconst env: NodeJS.ProcessEnv = {\n\t\t\t...(ctx.processEnv ?? process.env),\n\t\t\t...rendered.env,\n\t\t\tPORT: String(port),\n\t\t};\n\t\tconst tag = `host-service/${options.serviceName}`;\n\t\tlet resolveLogReady: (() => void) | undefined;\n\t\tconst logReadySignal =\n\t\t\toptions.ready?.kind === 'log'\n\t\t\t\t? new Promise<void>((resolveReady) => {\n\t\t\t\t\t\tresolveLogReady = resolveReady;\n\t\t\t\t\t})\n\t\t\t\t: null;\n\t\tconst observeReadinessLine = (line: string, stream: 'stdout' | 'stderr'): void => {\n\t\t\tif (options.ready?.kind !== 'log') return;\n\t\t\tif (\n\t\t\t\toptions.ready.stream !== undefined &&\n\t\t\t\toptions.ready.stream !== 'both' &&\n\t\t\t\toptions.ready.stream !== stream\n\t\t\t) {\n\t\t\t\treturn;\n\t\t\t}\n\t\t\tconst matches =\n\t\t\t\ttypeof options.ready.pattern === 'string'\n\t\t\t\t\t? line.includes(options.ready.pattern)\n\t\t\t\t\t: options.ready.pattern.test(line);\n\t\t\tif (matches) resolveLogReady?.();\n\t\t};\n\n\t\tconst spawnChild = ctx.spawner ?? nodeProcessSpawner;\n\t\tconst child = yield* Effect.try({\n\t\t\ttry: () =>\n\t\t\t\tspawnChild(rendered.command, rendered.args, {\n\t\t\t\t\tcwd: options.cwd,\n\t\t\t\t\tenv,\n\t\t\t\t\tstdio: 'pipe',\n\t\t\t\t\tdetached: process.platform !== 'win32',\n\t\t\t\t}),\n\t\t\tcatch: (cause) =>\n\t\t\t\tnew HostServiceAcquireError({\n\t\t\t\t\tserviceName: options.serviceName,\n\t\t\t\t\tcwd: options.cwd,\n\t\t\t\t\tcommand: rendered.command,\n\t\t\t\t\targs: rendered.args,\n\t\t\t\t\tphase: 'spawn',\n\t\t\t\t\tmessage: 'host service spawn failed',\n\t\t\t\t\tcause,\n\t\t\t\t}),\n\t\t});\n\t\tlet shuttingDown = false;\n\t\tlet exitStatus: {\n\t\t\treadonly code: number | null;\n\t\t\treadonly signal: NodeJS.Signals | null;\n\t\t} | null = null;\n\t\tconst exited = onceProcessExit(child).then((status) => {\n\t\t\texitStatus = status;\n\t\t\treturn status;\n\t\t});\n\t\tconst processError = onceProcessError(child);\n\t\tyield* observeProcessLines(\n\t\t\t{\n\t\t\t\tstdout: readableToByteStream(\n\t\t\t\t\tchild.stdout as unknown as AsyncIterable<Uint8Array> | null | undefined,\n\t\t\t\t),\n\t\t\t\tstderr: readableToByteStream(\n\t\t\t\t\tchild.stderr as unknown as AsyncIterable<Uint8Array> | null | undefined,\n\t\t\t\t),\n\t\t\t},\n\t\t\t{\n\t\t\t\tlogger: ctx.logger,\n\t\t\t\tpluginKey: ctx.pluginKey,\n\t\t\t\ttag,\n\t\t\t\tfields: { [SpanAttr.serviceName]: options.serviceName },\n\t\t\t\tonLine: ({ line, stream }) =>\n\t\t\t\t\tEffect.sync(() => {\n\t\t\t\t\t\tobserveReadinessLine(line, stream);\n\t\t\t\t\t}),\n\t\t\t},\n\t\t);\n\t\tyield* Effect.addFinalizer(() =>\n\t\t\tEffect.gen(function* () {\n\t\t\t\tshuttingDown = true;\n\t\t\t\tif (exitStatus !== null) return;\n\t\t\t\tyield* terminateChild(child, options.shutdownGraceMs, ctx.logger, ctx.pluginKey, tag);\n\t\t\t}),\n\t\t);\n\n\t\tconst baseError = new HostServiceAcquireError({\n\t\t\tserviceName: options.serviceName,\n\t\t\tcwd: options.cwd,\n\t\t\tcommand: rendered.command,\n\t\t\targs: rendered.args,\n\t\t\tphase: 'ready',\n\t\t\tmessage: 'host service readiness failed',\n\t\t});\n\t\tconst awaitReadiness = (() => {\n\t\t\tif (options.ready?.kind === 'http') {\n\t\t\t\tconst url = renderPortToken(options.ready.url ?? 'http://127.0.0.1:{port}', port);\n\t\t\t\treturn httpReady(\n\t\t\t\t\turl,\n\t\t\t\t\toptions.ready.timeoutMs ?? DEFAULT_HTTP_READY_TIMEOUT_MS,\n\t\t\t\t\toptions.ready.intervalMs ?? DEFAULT_HTTP_READY_INTERVAL_MS,\n\t\t\t\t\texited,\n\t\t\t\t\tprocessError,\n\t\t\t\t\tbaseError,\n\t\t\t\t);\n\t\t\t}\n\t\t\tif (options.ready?.kind === 'log' && logReadySignal !== null) {\n\t\t\t\treturn logReady(options.ready, logReadySignal, exited, processError, baseError);\n\t\t\t}\n\t\t\treturn Effect.gen(function* () {\n\t\t\t\tyield* awaitManagedProcessReady({\n\t\t\t\t\tready: Effect.promise(\n\t\t\t\t\t\t() => new Promise<void>((resolveReady) => setTimeout(resolveReady, 0)),\n\t\t\t\t\t),\n\t\t\t\t\texit: exited,\n\t\t\t\t\tprocessError,\n\t\t\t\t\tonExitBeforeReady: (status) =>\n\t\t\t\t\t\tnew HostServiceAcquireError({\n\t\t\t\t\t\t\t...baseError,\n\t\t\t\t\t\t\tphase: 'exit',\n\t\t\t\t\t\t\tmessage: 'host service exited before readiness',\n\t\t\t\t\t\t\texitCode: status.code,\n\t\t\t\t\t\t\tsignal: status.signal,\n\t\t\t\t\t\t}),\n\t\t\t\t\tonProcessErrorBeforeReady: (cause) =>\n\t\t\t\t\t\tnew HostServiceAcquireError({\n\t\t\t\t\t\t\t...baseError,\n\t\t\t\t\t\t\tphase: 'spawn',\n\t\t\t\t\t\t\tmessage: 'host service process failed before readiness',\n\t\t\t\t\t\t\tcause,\n\t\t\t\t\t\t}),\n\t\t\t\t});\n\t\t\t});\n\t\t})();\n\t\tconst readinessExit = yield* Effect.exit(awaitReadiness);\n\t\tif (Exit.isFailure(readinessExit)) {\n\t\t\tshuttingDown = true;\n\t\t\tif (exitStatus === null) {\n\t\t\t\tyield* terminateChild(child, options.shutdownGraceMs, ctx.logger, ctx.pluginKey, tag);\n\t\t\t}\n\t\t\treturn yield* Effect.failCause(readinessExit.cause);\n\t\t}\n\n\t\tvoid exited.then((status) => {\n\t\t\tif (shuttingDown) return;\n\t\t\tvoid Effect.runPromise(\n\t\t\t\tctx.logger.log(tag, ctx.pluginKey, {\n\t\t\t\t\tlevel: 'error',\n\t\t\t\t\tmessage: 'host service exited after readiness',\n\t\t\t\t\tfields: {\n\t\t\t\t\t\t[SpanAttr.event]: 'process.exited',\n\t\t\t\t\t\t[SpanAttr.serviceName]: options.serviceName,\n\t\t\t\t\t\t[SpanAttr.exitCode]: status.code,\n\t\t\t\t\t\t[SpanAttr.exitSignal]: status.signal,\n\t\t\t\t\t\t[SpanAttr.exitStatus]: describeProcessExitStatus(status),\n\t\t\t\t\t},\n\t\t\t\t}),\n\t\t\t).catch(() => {});\n\t\t});\n\t\tvoid processError.then((cause) => {\n\t\t\tif (shuttingDown) return;\n\t\t\tvoid Effect.runPromise(\n\t\t\t\tctx.logger.log(tag, ctx.pluginKey, {\n\t\t\t\t\tlevel: 'error',\n\t\t\t\t\tmessage: 'host service process emitted an error after readiness',\n\t\t\t\t\tfields: {\n\t\t\t\t\t\t[SpanAttr.event]: 'process.error',\n\t\t\t\t\t\t[SpanAttr.serviceName]: options.serviceName,\n\t\t\t\t\t\t[SpanAttr.errorCause]: cause,\n\t\t\t\t\t},\n\t\t\t\t}),\n\t\t\t).catch(() => {});\n\t\t});\n\t});\n\nexport const prepareHostService = (\n\toptions: HostServiceResolvedOptions,\n\tctx: HostServiceAcquireContext,\n): Effect.Effect<PreparedHostService, HostServiceAcquireError, Scope.Scope> =>\n\tEffect.gen(function* () {\n\t\tconst port = yield* allocateHostPort(options, ctx);\n\t\tconst rendered = renderCommand(options, port);\n\t\tconst started = yield* Ref.make(false);\n\t\tconst start = Effect.gen(function* () {\n\t\t\tif (yield* Ref.get(started)) return;\n\t\t\tyield* startHostProcess(options, ctx, port);\n\t\t\tyield* Ref.set(started, true);\n\t\t});\n\n\t\treturn {\n\t\t\tvalue: hostServiceValue(options, port, rendered),\n\t\t\tstart,\n\t\t};\n\t});\n\nexport const acquireHostService = (\n\toptions: HostServiceResolvedOptions,\n\tctx: HostServiceAcquireContext,\n): Effect.Effect<HostServiceValue, HostServiceAcquireError, Scope.Scope> =>\n\tEffect.gen(function* () {\n\t\tconst prepared = yield* prepareHostService(options, ctx);\n\t\tyield* prepared.start;\n\t\treturn prepared.value;\n\t});\n"],"mappings":"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"}

package/dist/plugins/package/build.d.mts

@@ -0,0 +1 @@
+import { Effect, Scope } from "effect";

package/dist/plugins/package/build.mjs

@@ -0,0 +1,24 @@
+import { hashMoveSources as hashMoveSources$1, runMoveBuild as runMoveBuild$1, scrubLocksHost as scrubLocksHost$1 } from "../../substrate/runtime/sui-move-build/index.mjs";
+import { publishError } from "./errors.mjs";
+import { Effect } from "effect";
+//#region src/plugins/package/build.ts
+const toPublishError = (err) => publishError(err.phase, {
+	sourcePath: err.sourcePath,
+	packageName: err.packageName,
+	message: err.message,
+	...err.cause !== void 0 ? { cause: err.cause } : { cause: err }
+});
+const hashMoveSources = (sourcePath) => hashMoveSources$1(sourcePath).pipe(Effect.mapError(toPublishError));
+const scrubLocksHost = (sourcePath, moveHomeRoot, options) => scrubLocksHost$1(sourcePath, moveHomeRoot, options).pipe(Effect.mapError(toPublishError));
+const runMoveBuild = (inputs) => runMoveBuild$1({
+	sourcePath: inputs.sourcePath,
+	packageName: inputs.packageName,
+	chainId: inputs.chainId,
+	...inputs.buildContainer !== void 0 ? { buildContainer: inputs.buildContainer } : {},
+	...inputs.runtime !== void 0 ? { runtime: inputs.runtime } : {},
+	...inputs.buildImage !== void 0 ? { buildImage: inputs.buildImage } : {}
+}).pipe(Effect.mapError(toPublishError));
+//#endregion
+export { hashMoveSources, runMoveBuild, scrubLocksHost };
+
+//# sourceMappingURL=build.mjs.map

package/dist/plugins/package/build.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"build.mjs","names":["hashMoveSourcesNeutral","scrubLocksHostNeutral","runMoveBuildNeutral"],"sources":["../../../src/plugins/package/build.ts"],"sourcesContent":["// Package plugin compatibility wrapper for shared Sui Move build helpers.\n\nimport { Effect, type Scope } from 'effect';\n\nimport type { ContainerRuntime, ImageRef } from '../../contracts/container-runtime.ts';\nimport type { ChainId, ContentHash } from '../../substrate/brand.ts';\nimport {\n\thashMoveSources as hashMoveSourcesNeutral,\n\trunMoveBuild as runMoveBuildNeutral,\n\tscrubLocksHost as scrubLocksHostNeutral,\n\ttype BuildOutput,\n\ttype MoveBuildError,\n\ttype ScrubLocksHostOptions,\n\ttype MoveBuildContainer,\n} from '../../substrate/runtime/sui-move-build/index.ts';\nimport type { ChainBuildContainer } from '../sui/chain-build-container.ts';\nimport { publishError, type PublishError } from './errors.ts';\n\nexport {\n\tcontainerInnerScript,\n\textractTrailingJson,\n\thostBuildArgv,\n\tparseBuildOutput,\n\tscrubLocksContainerShellScript,\n\tstripPinnedSections,\n\ttype MoveBuildContainer,\n\ttype MoveBuildError,\n\ttype MoveBuildPhase,\n\ttype MoveBuildInput,\n\ttype MoveBuildOutput,\n} from '../../substrate/runtime/sui-move-build/index.ts';\nexport type { BuildOutput };\n\nexport interface BuildInputs {\n\treadonly sourcePath: string;\n\treadonly packageName: string;\n\treadonly chainId: ChainId;\n\treadonly buildContainer?: ChainBuildContainer;\n\treadonly runtime?: ContainerRuntime;\n\treadonly buildImage?: ImageRef;\n}\n\nconst toPublishError = (err: MoveBuildError): PublishError =>\n\tpublishError(err.phase, {\n\t\tsourcePath: err.sourcePath,\n\t\tpackageName: err.packageName,\n\t\tmessage: err.message,\n\t\t...(err.cause !== undefined ? { cause: err.cause } : { cause: err }),\n\t});\n\nexport const hashMoveSources = (sourcePath: string): Effect.Effect<ContentHash, PublishError> =>\n\thashMoveSourcesNeutral(sourcePath).pipe(Effect.mapError(toPublishError));\n\nexport const scrubLocksHost = (\n\tsourcePath: string,\n\tmoveHomeRoot: string,\n\toptions?: ScrubLocksHostOptions,\n): Effect.Effect<void, PublishError, Scope.Scope> =>\n\tscrubLocksHostNeutral(sourcePath, moveHomeRoot, options).pipe(Effect.mapError(toPublishError));\n\nexport const runMoveBuild = (\n\tinputs: BuildInputs,\n): Effect.Effect<BuildOutput, PublishError, Scope.Scope> =>\n\trunMoveBuildNeutral({\n\t\tsourcePath: inputs.sourcePath,\n\t\tpackageName: inputs.packageName,\n\t\tchainId: inputs.chainId,\n\t\t...(inputs.buildContainer !== undefined\n\t\t\t? { buildContainer: inputs.buildContainer satisfies MoveBuildContainer }\n\t\t\t: {}),\n\t\t...(inputs.runtime !== undefined ? { runtime: inputs.runtime } : {}),\n\t\t...(inputs.buildImage !== undefined ? { buildImage: inputs.buildImage } : {}),\n\t}).pipe(Effect.mapError(toPublishError));\n"],"mappings":";;;;AA0CA,MAAM,kBAAkB,QACvB,aAAa,IAAI,OAAO;CACvB,YAAY,IAAI;CAChB,aAAa,IAAI;CACjB,SAAS,IAAI;CACb,GAAI,IAAI,UAAU,KAAA,IAAY,EAAE,OAAO,IAAI,OAAO,GAAG,EAAE,OAAO,KAAK;CACnE,CAAC;AAEH,MAAa,mBAAmB,eAC/BA,kBAAuB,WAAW,CAAC,KAAK,OAAO,SAAS,eAAe,CAAC;AAEzE,MAAa,kBACZ,YACA,cACA,YAEAC,iBAAsB,YAAY,cAAc,QAAQ,CAAC,KAAK,OAAO,SAAS,eAAe,CAAC;AAE/F,MAAa,gBACZ,WAEAC,eAAoB;CACnB,YAAY,OAAO;CACnB,aAAa,OAAO;CACpB,SAAS,OAAO;CAChB,GAAI,OAAO,mBAAmB,KAAA,IAC3B,EAAE,gBAAgB,OAAO,gBAA6C,GACtE,EAAE;CACL,GAAI,OAAO,YAAY,KAAA,IAAY,EAAE,SAAS,OAAO,SAAS,GAAG,EAAE;CACnE,GAAI,OAAO,eAAe,KAAA,IAAY,EAAE,YAAY,OAAO,YAAY,GAAG,EAAE;CAC5E,CAAC,CAAC,KAAK,OAAO,SAAS,eAAe,CAAC"}

package/dist/plugins/package/codegen.d.mts

@@ -0,0 +1,19 @@
+//#region src/plugins/package/codegen.d.ts
+/** Codegenable shape — what each Package contributes to the codegen
+ *  orchestrator. Two variants mirror the local/known split. */
+interface PackageBindings {
+  readonly name: string;
+  readonly packageId: string;
+  readonly mvrPlaceholder: string;
+  /** Present for local packages only — the bindings emitter reads
+   *  this; KnownPackages omit it and the orchestrator skips them
+   *  for bindings emission (compile-time enforcement at the
+   *  factory layer per distilled doc Invariant 9). */
+  readonly sourcePath: string | null;
+  /** Per-package opt-out (distilled doc §Inputs — "Codegen
+   *  exclusion flag"). */
+  readonly excluded: boolean;
+}
+//#endregion
+export { PackageBindings };
+//# sourceMappingURL=codegen.d.mts.map