every-plugin 2.10.1 → 3.0.0-rc.0

package/dist/dev/serve.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"serve.cjs","names":["DEV_ENTRY_FILENAME","Effect","loadRemoteWithRetry","getPluginInfo","loadDevConfig","path","pluginLayoutKey","spawn","ensureGeneratedRspackConfig","ensureGeneratedUiRsbuildConfig","fs","http","PLUGIN_ERROR_STATUS_MAP","killChildEscalating"],"sources":["../../src/dev/serve.ts"],"sourcesContent":["import { spawn } from \"node:child_process\";\nimport fs from \"node:fs\";\nimport http from \"node:http\";\nimport path from \"node:path\";\nimport { Effect } from \"effect\";\nimport sirv from \"sirv\";\nimport { DEV_ENTRY_FILENAME } from \"../build/artifact-names\";\nimport { ensureGeneratedRspackConfig } from \"../build/rspack/generated-config\";\nimport { getPluginInfo, loadDevConfig } from \"../build/rspack/utils\";\nimport { ensureGeneratedUiRsbuildConfig, pluginLayoutKey } from \"../build/ui/generated-config\";\nimport { PLUGIN_ERROR_STATUS_MAP } from \"../errors\";\nimport { loadRemoteWithRetry } from \"../remote-entry\";\nimport { killChildEscalating, watchParentDeath } from \"./watch-kill\";\n\nconst corsHeaders = {\n  \"Access-Control-Allow-Origin\": \"*\",\n  \"Access-Control-Allow-Methods\": \"GET, POST, PUT, DELETE, PATCH, OPTIONS\",\n  \"Access-Control-Allow-Headers\": \"X-Requested-With, content-type, Authorization\",\n};\n\nconst applyCorsHeaders = (res: http.ServerResponse) => {\n  Object.entries(corsHeaders).forEach(([key, value]) => {\n    res.setHeader(key, value);\n  });\n};\n\nconst normalizePrefix = (prefix?: string): string => {\n  if (!prefix) return \"\";\n  const cleaned = prefix.replace(/^\\/+|\\/+$/g, \"\");\n  return cleaned ? `/${cleaned}` : \"\";\n};\n\nconst readRuntimeConfigFromEnv = (): any => {\n  const raw = process.env.BOS_RUNTIME_CONFIG;\n  if (!raw) return null;\n  try {\n    return JSON.parse(raw);\n  } catch {\n    return null;\n  }\n};\n\nconst collectSiblingRemotes = (runtimeConfig: any, pluginId: string) => {\n  const siblings: Record<string, { remote: string }> = {};\n\n  const isApi = pluginId === \"api\" || runtimeConfig?.api?.name === pluginId;\n\n  const ownKey = runtimeConfig?.plugins?.[pluginId] ? pluginId : null;\n  let dependsOn: string[] = [];\n  if (ownKey) {\n    dependsOn = runtimeConfig.plugins[ownKey].dependsOn ?? [];\n  } else if (isApi) {\n    dependsOn = runtimeConfig?.api?.dependsOn ?? [];\n  }\n\n  for (const depId of dependsOn) {\n    const dep = runtimeConfig?.plugins?.[depId];\n    if (!dep || dep.source !== \"local\" || !dep.url) continue;\n    if (depId === pluginId) continue;\n    const base = dep.url.replace(/\\/$/, \"\");\n    siblings[depId] = { remote: `${base}/${DEV_ENTRY_FILENAME}` };\n  }\n\n  return { siblings, dependsOn };\n};\n\nconst loadPluginWithRetry = (\n  runtime: any,\n  pluginId: string,\n  remoteUrl: string,\n  options: Record<string, unknown> = { variables: {}, secrets: {} },\n  pluginsMap?: Record<string, unknown>,\n  timeoutMs = 90000,\n): Promise<any> =>\n  Effect.runPromise(\n    loadRemoteWithRetry({\n      label: pluginId,\n      remoteUrl,\n      load: () => runtime.usePlugin(pluginId, options, pluginsMap),\n      timeoutMs,\n    }),\n  );\n\nconst sendJson = (res: http.ServerResponse, status: number, body: unknown) => {\n  res.statusCode = status;\n  res.setHeader(\"content-type\", \"application/json; charset=utf-8\");\n  res.end(JSON.stringify(body));\n};\n\nconst sendText = (res: http.ServerResponse, status: number, text: string) => {\n  res.statusCode = status;\n  res.setHeader(\"content-type\", \"text/plain; charset=utf-8\");\n  res.end(text);\n};\n\nexport interface PluginDevServeOptions {\n  cwd?: string;\n  port?: number;\n  watch?: boolean;\n}\n\nexport interface PluginDevServerHandle {\n  port: number;\n  close: () => Promise<void>;\n}\n\n/**\n * The dev server's plugin id — the workspace's npm package name, the same\n * value the host passes as `runtimeId`. Both initialize sites must agree:\n * `registerRemote` derives the MF remote name from it, and the plugin's\n * database layer derives its migration slug from it, so a pre-normalized\n * remote name here would migrate into a different schema than the host\n * expects. plugin.dev.ts no longer carries a pluginId field.\n */\nexport const resolveDevPluginId = (cwd: string): string => getPluginInfo(cwd).name;\n\nexport async function startPluginDevServer(\n  options: PluginDevServeOptions = {},\n): Promise<PluginDevServerHandle> {\n  process.env.BOS_DEV_SERVER = \"1\";\n  const cwd = options.cwd ?? process.cwd();\n  const pluginInfo = getPluginInfo(cwd);\n  const devConfig = loadDevConfig(path.join(cwd, \"plugin.dev.ts\"));\n  const pluginId = resolveDevPluginId(cwd);\n  const compositionKey = pluginLayoutKey(cwd) ?? pluginId;\n  const port = options.port ?? (Number(process.env.PORT) || devConfig?.port || 3999);\n  const rpcPrefix = normalizePrefix(devConfig?.prefix);\n  const rpcBase = `/api/rpc${rpcPrefix}`;\n\n  const distDir = path.join(cwd, \"dist\");\n  const serveStatic = sirv(distDir, { dev: true });\n\n  // No-watch mode (BOS_NO_WATCH=1): build once, serve the built output.\n  // Regression/CI stacks need no hot reload — watchers are the stack's\n  // heaviest processes and stall runs freeze under their accumulated\n  // footprint. One-shot builds exit; steady state is small static servers.\n  const noWatch = options.watch === false || process.env.BOS_NO_WATCH === \"1\";\n\n  const runOnce = (cmd: string, args: string[]) =>\n    new Promise<void>((resolve, reject) => {\n      const child = spawn(cmd, args, { cwd, stdio: \"inherit\", env: process.env });\n      child.on(\"error\", reject);\n      child.on(\"exit\", (code) => {\n        if (code === 0) resolve();\n        else reject(new Error(`❌ ${cmd} ${args.join(\" \")} exited with ${code}`));\n      });\n    });\n\n  let watcher: ReturnType<typeof spawn> | null = null;\n  if (noWatch) {\n    const generatedConfig = ensureGeneratedRspackConfig(cwd);\n    await runOnce(\"rspack\", generatedConfig ? [\"build\", \"--config\", generatedConfig] : [\"build\"]);\n  } else if (options.watch !== false) {\n    const generatedConfig = ensureGeneratedRspackConfig(cwd);\n    watcher = spawn(\n      \"rspack\",\n      generatedConfig ? [\"build\", \"--watch\", \"--config\", generatedConfig] : [\"build\", \"--watch\"],\n      {\n        cwd,\n        stdio: \"inherit\",\n        env: process.env,\n      },\n    );\n    watcher.on(\"error\", (error) => {\n      console.error(`❌ Failed to spawn rspack build --watch: ${error.message}`);\n    });\n  }\n\n  let uiWatcher: ReturnType<typeof spawn> | null = null;\n  let uiStaticServer: http.Server | null = null;\n  const uiPort = process.env.BOS_UI_PORT;\n  const uiConfig = ensureGeneratedUiRsbuildConfig(cwd);\n  if (uiConfig && noWatch && uiPort) {\n    // Folder-form ui: one-shot build, then serve the ui source root's dist\n    // (the factory's absolute distPath target) statically on the ui port.\n    await runOnce(\"rsbuild\", [\"build\", \"--config\", uiConfig]);\n    const uiDistDir =\n      path.basename(cwd) === \"ui\" ? path.join(cwd, \"dist\") : path.join(cwd, \"ui\", \"dist\");\n    if (!fs.existsSync(path.join(uiDistDir, DEV_ENTRY_FILENAME))) {\n      console.error(\n        `❌ UI dist is missing at ${uiDistDir} — the ui static server would serve 404s for every asset (build output layout mismatch?)`,\n      );\n    }\n    const serveUiStatic = sirv(uiDistDir, { dev: true });\n    uiStaticServer = http.createServer((req, res) => {\n      applyCorsHeaders(res);\n      serveUiStatic(req, res, () => {\n        sendText(res, 404, \"Not Found\");\n      });\n    });\n    await new Promise<void>((resolve, reject) => {\n      uiStaticServer!.once(\"error\", reject);\n      uiStaticServer!.listen(Number(uiPort), () => resolve());\n    });\n    console.log(`├─ 🎨 UI:     http://localhost:${uiPort} (built, no watch)`);\n  } else if (uiConfig) {\n    uiWatcher = spawn(\"rsbuild\", [\"dev\", \"--config\", uiConfig], {\n      cwd,\n      stdio: \"inherit\",\n      env: uiPort ? { ...process.env, PORT: uiPort } : process.env,\n    });\n    uiWatcher.on(\"error\", (error) => {\n      console.error(`❌ Failed to spawn rsbuild ui dev: ${error.message}`);\n    });\n    console.log(`├─ 🎨 UI:     ${uiPort ? `http://localhost:${uiPort}` : \"(rsbuild auto port)\"}`);\n  }\n\n  const handlers: { rpc: any; api: any } = { rpc: null, api: null };\n  const effectContextHolder: { context: unknown } = { context: null };\n  let runtime: { shutdown: () => Promise<void> } | null = null;\n\n  const pathnameOf = (req: http.IncomingMessage): string =>\n    ((req.url ?? \"/\").split(\"?\")[0] ?? \"/\").replace(/\\/+$/, \"\") || \"/\";\n\n  const buildDevContext = (_req: http.IncomingMessage, webRequest: Request) => {\n    const rawClone =\n      webRequest.method === \"GET\" || webRequest.method === \"HEAD\" ? null : webRequest.clone();\n    let cachedRawBody: string | null = null;\n    return {\n      reqHeaders: webRequest.headers,\n      \"effect/context\": effectContextHolder.context,\n      getRawBody: async (): Promise<string> => {\n        if (cachedRawBody !== null) return cachedRawBody;\n        if (!rawClone) {\n          cachedRawBody = \"\";\n          return cachedRawBody;\n        }\n        cachedRawBody = await rawClone.text();\n        return cachedRawBody;\n      },\n    };\n  };\n\n  const toWebRequest = (req: http.IncomingMessage): Request => {\n    const url = `http://localhost:${port}${req.url}`;\n    return new Request(url, {\n      method: req.method,\n      headers: req.headers,\n      body: req.method !== \"GET\" && req.method !== \"HEAD\" ? req : undefined,\n      duplex: req.method !== \"GET\" && req.method !== \"HEAD\" ? \"half\" : undefined,\n    } as RequestInit);\n  };\n\n  const handleOrpc = async (\n    req: http.IncomingMessage,\n    res: http.ServerResponse,\n    handler: any,\n    prefix: string,\n    errorLabel: string,\n  ) => {\n    try {\n      const webRequest = toWebRequest(req);\n      const result = await handler.handle(webRequest, {\n        prefix,\n        context: buildDevContext(req, webRequest),\n      });\n\n      if (result.response) {\n        res.statusCode = result.response.status;\n        result.response.headers.forEach((value: string, key: string) => {\n          res.setHeader(key, value);\n        });\n        const text = await result.response.text();\n        if (!res.getHeader(\"content-length\")) {\n          res.setHeader(\"content-length\", Buffer.byteLength(text).toString());\n        }\n        res.end(text);\n      } else {\n        sendText(res, 404, \"Not Found\");\n      }\n    } catch (error) {\n      console.error(`${errorLabel} error:`, error);\n      sendJson(res, 500, { error: (error as Error).message });\n    }\n  };\n\n  const server = http.createServer((req, res) => {\n    applyCorsHeaders(res);\n    const pathname = pathnameOf(req);\n\n    if (req.method === \"OPTIONS\") {\n      res.statusCode = 200;\n      res.end();\n      return;\n    }\n\n    if (pathname === \"/\" && (req.method === \"GET\" || req.method === \"HEAD\")) {\n      sendJson(res, 200, {\n        ok: true,\n        plugin: pluginInfo.normalizedName,\n        version: pluginInfo.version,\n        status: handlers.rpc ? \"ready\" : \"loading\",\n        endpoints: {\n          health: \"/\",\n          docs: \"/api\",\n          rpc: rpcBase,\n        },\n      });\n      return;\n    }\n\n    if (pathname === \"/health\" && (req.method === \"GET\" || req.method === \"HEAD\")) {\n      sendText(res, 200, \"OK\");\n      return;\n    }\n\n    if (pathname.startsWith(`${rpcBase}/`)) {\n      if (!handlers.rpc) {\n        sendJson(res, 503, { error: \"Plugin still loading...\" });\n        return;\n      }\n      handleOrpc(req, res, handlers.rpc, rpcBase, \"RPC\").catch(() => {});\n      return;\n    }\n\n    if (pathname === \"/api\" || pathname.startsWith(\"/api/\")) {\n      if (!handlers.api) {\n        sendJson(res, 503, { error: \"Plugin still loading...\" });\n        return;\n      }\n      handleOrpc(req, res, handlers.api, \"/api\", \"OpenAPI\").catch(() => {});\n      return;\n    }\n\n    serveStatic(req, res, () => {\n      sendText(res, 404, \"Not Found\");\n    });\n  });\n\n  await new Promise<void>((resolve, reject) => {\n    server.once(\"error\", reject);\n    server.listen(port, () => resolve());\n  });\n\n  console.log(`🚀 ${pluginInfo.name} dev server listening on port ${port}`);\n  console.log(`├─ 📡 RPC:    http://localhost:${port}/api/rpc${rpcPrefix}`);\n  console.log(`├─ 📖 Docs:   http://localhost:${port}/api`);\n  console.log(`└─ 💚 Health: http://localhost:${port}/`);\n\n  const load = async () => {\n    try {\n      // Import framework internals directly. A package self-import can resolve\n      // the published entry while this source-first dev server is running,\n      // which leaves the runtime exports unavailable on Windows.\n      const { createPluginRuntime } = await import(\"../runtime\");\n      const { RPCHandler } = await import(\"@orpc/server/fetch\");\n      const { OpenAPIHandler } = await import(\"@orpc/openapi/fetch\");\n      const { OpenAPIGenerator } = await import(\"@orpc/openapi\");\n      const { OpenAPIReferenceHandlerPlugin } = await import(\"@orpc/openapi/plugins\");\n      const { ZodToJsonSchemaConverter } = await import(\"@orpc/zod\");\n      const { onError } = await import(\"@orpc/server\");\n      const { formatORPCError } = await import(\"../errors\");\n\n      const runtimeConfig = readRuntimeConfigFromEnv();\n      const { siblings, dependsOn } = collectSiblingRemotes(runtimeConfig, compositionKey);\n\n      if (dependsOn.length > 0) {\n        console.log(`🔗 Loading sibling plugin(s): ${dependsOn.join(\", \")}`);\n      }\n\n      const registry: Record<string, { remote: string }> = {\n        [pluginId]: {\n          remote: `http://localhost:${port}/${DEV_ENTRY_FILENAME}`,\n        },\n        ...siblings,\n      };\n\n      const mfRuntime = createPluginRuntime({ registry });\n      runtime = mfRuntime;\n\n      const pluginsMap: Record<string, unknown> = {};\n      const siblingEffectContexts: unknown[] = [];\n      for (const depId of Object.keys(siblings)) {\n        const dep = await loadPluginWithRetry(mfRuntime, depId, siblings[depId]!.remote);\n        pluginsMap[depId] = { client: dep.createClient, router: dep.router };\n        if (dep.initialized?.effectContext) {\n          siblingEffectContexts.push(dep.initialized.effectContext);\n        }\n        console.log(`✅ Loaded dependency plugin: ${depId}`);\n      }\n\n      const loaded: any = await loadPluginWithRetry(\n        mfRuntime,\n        pluginId,\n        registry[pluginId]!.remote,\n        (devConfig?.config ?? { variables: {}, secrets: {} }) as Record<string, unknown>,\n        Object.keys(pluginsMap).length > 0 ? pluginsMap : undefined,\n      );\n\n      const { Context } = await import(\"effect\");\n      effectContextHolder.context = [loaded.initialized?.effectContext, ...siblingEffectContexts]\n        .filter(Boolean)\n        .reduce((acc: any, ctx: any) => Context.merge(acc, ctx), Context.empty());\n\n      handlers.rpc = new RPCHandler(loaded.router, {\n        errorStatusMap: PLUGIN_ERROR_STATUS_MAP,\n        interceptors: [\n          onError((error: any) => {\n            const formatted = formatORPCError(error);\n            if (formatted) console.error(formatted);\n          }),\n        ],\n      });\n\n      const generator = new OpenAPIGenerator({ converters: [new ZodToJsonSchemaConverter()] });\n\n      handlers.api = new OpenAPIHandler(loaded.router, {\n        errorStatusMap: PLUGIN_ERROR_STATUS_MAP,\n        plugins: [\n          new OpenAPIReferenceHandlerPlugin({\n            spec: () => generator.generate(loaded.router, { version: \"3.1.1\" }),\n          }),\n        ],\n        interceptors: [\n          onError((error: any) => {\n            const formatted = formatORPCError(error);\n            if (formatted) console.error(formatted);\n          }),\n        ],\n      });\n\n      console.log(`✅ Plugin ready: ${pluginId}`);\n    } catch (error) {\n      console.error(`❌ Failed to load plugin ${pluginId}:`, error);\n      console.error(\"   Server stays up; fix the build and retry via rebuild.\");\n    }\n  };\n\n  void load();\n\n  const close = async () => {\n    handlers.rpc = null;\n    handlers.api = null;\n    effectContextHolder.context = null;\n    for (const child of [watcher, uiWatcher]) {\n      if (child) {\n        await killChildEscalating(child);\n      }\n    }\n    if (uiStaticServer) {\n      await new Promise<void>((resolve) => uiStaticServer.close(() => resolve()));\n    }\n    if (runtime) await runtime.shutdown().catch(() => {});\n    await new Promise<void>((resolve) => server.close(() => resolve()));\n  };\n\n  process.once(\"SIGINT\", async () => {\n    const timeout = setTimeout(() => process.exit(0), 3000);\n    await close();\n    clearTimeout(timeout);\n    process.exit(0);\n  });\n  process.once(\"SIGTERM\", async () => {\n    const timeout = setTimeout(() => process.exit(0), 3000);\n    await close();\n    clearTimeout(timeout);\n    process.exit(0);\n  });\n\n  watchParentDeath(async () => {\n    const timeout = setTimeout(() => process.exit(0), 3000);\n    await close();\n    clearTimeout(timeout);\n    process.exit(0);\n  });\n\n  return { port, close };\n}\n\nconst invokedAsCli = import.meta.main || (process.argv[1] ?? \"\").includes(\"every-plugin-serve\");\n\nif (invokedAsCli) {\n  startPluginDevServer().catch((error) => {\n    console.error(\"❌ Plugin dev server fatal error:\", error);\n    process.exit(1);\n  });\n}\n"],"mappings":"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"}

package/dist/dev/serve.d.cts

@@ -0,0 +1,23 @@
+//#region src/dev/serve.d.ts
+interface PluginDevServeOptions {
+  cwd?: string;
+  port?: number;
+  watch?: boolean;
+}
+interface PluginDevServerHandle {
+  port: number;
+  close: () => Promise<void>;
+}
+/**
+ * The dev server's plugin id — the workspace's npm package name, the same
+ * value the host passes as `runtimeId`. Both initialize sites must agree:
+ * `registerRemote` derives the MF remote name from it, and the plugin's
+ * database layer derives its migration slug from it, so a pre-normalized
+ * remote name here would migrate into a different schema than the host
+ * expects. plugin.dev.ts no longer carries a pluginId field.
+ */
+declare const resolveDevPluginId: (cwd: string) => string;
+declare function startPluginDevServer(options?: PluginDevServeOptions): Promise<PluginDevServerHandle>;
+//#endregion
+export { PluginDevServeOptions, PluginDevServerHandle, resolveDevPluginId, startPluginDevServer };
+//# sourceMappingURL=serve.d.cts.map

package/dist/dev/serve.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"serve.d.cts","names":[],"sources":["../../src/dev/serve.ts"],"mappings":";UA+FiB;EACf;EACA;EACA;;UAGe;EACf;EACA,aAAa;;;;;;;;;;cAWF,qBAAkB;iBAET,qBACpB,UAAS,wBACR,QAAQ"}

package/dist/dev/serve.d.mts

@@ -0,0 +1,23 @@
+//#region src/dev/serve.d.ts
+interface PluginDevServeOptions {
+  cwd?: string;
+  port?: number;
+  watch?: boolean;
+}
+interface PluginDevServerHandle {
+  port: number;
+  close: () => Promise<void>;
+}
+/**
+ * The dev server's plugin id — the workspace's npm package name, the same
+ * value the host passes as `runtimeId`. Both initialize sites must agree:
+ * `registerRemote` derives the MF remote name from it, and the plugin's
+ * database layer derives its migration slug from it, so a pre-normalized
+ * remote name here would migrate into a different schema than the host
+ * expects. plugin.dev.ts no longer carries a pluginId field.
+ */
+declare const resolveDevPluginId: (cwd: string) => string;
+declare function startPluginDevServer(options?: PluginDevServeOptions): Promise<PluginDevServerHandle>;
+//#endregion
+export { PluginDevServeOptions, PluginDevServerHandle, resolveDevPluginId, startPluginDevServer };
+//# sourceMappingURL=serve.d.mts.map

package/dist/dev/serve.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"serve.d.mts","names":[],"sources":["../../src/dev/serve.ts"],"mappings":";UA+FiB;EACf;EACA;EACA;;UAGe;EACf;EACA,aAAa;;;;;;;;;;cAWF,qBAAkB;iBAET,qBACpB,UAAS,wBACR,QAAQ"}

package/dist/dev/serve.mjs

@@ -0,0 +1,384 @@
+#!/usr/bin/env node
+import { PLUGIN_ERROR_STATUS_MAP } from "../errors.mjs";
+import { DEV_ENTRY_FILENAME } from "../build/artifact-names.mjs";
+import { loadRemoteWithRetry } from "../remote-entry.mjs";
+import { getPluginInfo, loadDevConfig } from "../build/rspack/utils.mjs";
+import { ensureGeneratedUiRsbuildConfig, pluginLayoutKey } from "../build/ui/generated-config.mjs";
+import { ensureGeneratedRspackConfig } from "../build/rspack/generated-config.mjs";
+import { killChildEscalating, watchParentDeath } from "./watch-kill.mjs";
+import { Effect } from "effect";
+import fs from "node:fs";
+import path from "node:path";
+import { spawn } from "node:child_process";
+import http from "node:http";
+import sirv from "sirv";
+
+//#region src/dev/serve.ts
+const corsHeaders = {
+	"Access-Control-Allow-Origin": "*",
+	"Access-Control-Allow-Methods": "GET, POST, PUT, DELETE, PATCH, OPTIONS",
+	"Access-Control-Allow-Headers": "X-Requested-With, content-type, Authorization"
+};
+const applyCorsHeaders = (res) => {
+	Object.entries(corsHeaders).forEach(([key, value]) => {
+		res.setHeader(key, value);
+	});
+};
+const normalizePrefix = (prefix) => {
+	if (!prefix) return "";
+	const cleaned = prefix.replace(/^\/+|\/+$/g, "");
+	return cleaned ? `/${cleaned}` : "";
+};
+const readRuntimeConfigFromEnv = () => {
+	const raw = process.env.BOS_RUNTIME_CONFIG;
+	if (!raw) return null;
+	try {
+		return JSON.parse(raw);
+	} catch {
+		return null;
+	}
+};
+const collectSiblingRemotes = (runtimeConfig, pluginId) => {
+	const siblings = {};
+	const isApi = pluginId === "api" || runtimeConfig?.api?.name === pluginId;
+	const ownKey = runtimeConfig?.plugins?.[pluginId] ? pluginId : null;
+	let dependsOn = [];
+	if (ownKey) dependsOn = runtimeConfig.plugins[ownKey].dependsOn ?? [];
+	else if (isApi) dependsOn = runtimeConfig?.api?.dependsOn ?? [];
+	for (const depId of dependsOn) {
+		const dep = runtimeConfig?.plugins?.[depId];
+		if (!dep || dep.source !== "local" || !dep.url) continue;
+		if (depId === pluginId) continue;
+		siblings[depId] = { remote: `${dep.url.replace(/\/$/, "")}/${DEV_ENTRY_FILENAME}` };
+	}
+	return {
+		siblings,
+		dependsOn
+	};
+};
+const loadPluginWithRetry = (runtime, pluginId, remoteUrl, options = {
+	variables: {},
+	secrets: {}
+}, pluginsMap, timeoutMs = 9e4) => Effect.runPromise(loadRemoteWithRetry({
+	label: pluginId,
+	remoteUrl,
+	load: () => runtime.usePlugin(pluginId, options, pluginsMap),
+	timeoutMs
+}));
+const sendJson = (res, status, body) => {
+	res.statusCode = status;
+	res.setHeader("content-type", "application/json; charset=utf-8");
+	res.end(JSON.stringify(body));
+};
+const sendText = (res, status, text) => {
+	res.statusCode = status;
+	res.setHeader("content-type", "text/plain; charset=utf-8");
+	res.end(text);
+};
+/**
+* The dev server's plugin id — the workspace's npm package name, the same
+* value the host passes as `runtimeId`. Both initialize sites must agree:
+* `registerRemote` derives the MF remote name from it, and the plugin's
+* database layer derives its migration slug from it, so a pre-normalized
+* remote name here would migrate into a different schema than the host
+* expects. plugin.dev.ts no longer carries a pluginId field.
+*/
+const resolveDevPluginId = (cwd) => getPluginInfo(cwd).name;
+async function startPluginDevServer(options = {}) {
+	process.env.BOS_DEV_SERVER = "1";
+	const cwd = options.cwd ?? process.cwd();
+	const pluginInfo = getPluginInfo(cwd);
+	const devConfig = loadDevConfig(path.join(cwd, "plugin.dev.ts"));
+	const pluginId = resolveDevPluginId(cwd);
+	const compositionKey = pluginLayoutKey(cwd) ?? pluginId;
+	const port = options.port ?? (Number(process.env.PORT) || devConfig?.port || 3999);
+	const rpcPrefix = normalizePrefix(devConfig?.prefix);
+	const rpcBase = `/api/rpc${rpcPrefix}`;
+	const distDir = path.join(cwd, "dist");
+	const serveStatic = sirv(distDir, { dev: true });
+	const noWatch = options.watch === false || process.env.BOS_NO_WATCH === "1";
+	const runOnce = (cmd, args) => new Promise((resolve, reject) => {
+		const child = spawn(cmd, args, {
+			cwd,
+			stdio: "inherit",
+			env: process.env
+		});
+		child.on("error", reject);
+		child.on("exit", (code) => {
+			if (code === 0) resolve();
+			else reject(/* @__PURE__ */ new Error(`❌ ${cmd} ${args.join(" ")} exited with ${code}`));
+		});
+	});
+	let watcher = null;
+	if (noWatch) {
+		const generatedConfig = ensureGeneratedRspackConfig(cwd);
+		await runOnce("rspack", generatedConfig ? [
+			"build",
+			"--config",
+			generatedConfig
+		] : ["build"]);
+	} else if (options.watch !== false) {
+		const generatedConfig = ensureGeneratedRspackConfig(cwd);
+		watcher = spawn("rspack", generatedConfig ? [
+			"build",
+			"--watch",
+			"--config",
+			generatedConfig
+		] : ["build", "--watch"], {
+			cwd,
+			stdio: "inherit",
+			env: process.env
+		});
+		watcher.on("error", (error) => {
+			console.error(`❌ Failed to spawn rspack build --watch: ${error.message}`);
+		});
+	}
+	let uiWatcher = null;
+	let uiStaticServer = null;
+	const uiPort = process.env.BOS_UI_PORT;
+	const uiConfig = ensureGeneratedUiRsbuildConfig(cwd);
+	if (uiConfig && noWatch && uiPort) {
+		await runOnce("rsbuild", [
+			"build",
+			"--config",
+			uiConfig
+		]);
+		const uiDistDir = path.basename(cwd) === "ui" ? path.join(cwd, "dist") : path.join(cwd, "ui", "dist");
+		if (!fs.existsSync(path.join(uiDistDir, "remoteEntry.js"))) console.error(`❌ UI dist is missing at ${uiDistDir} — the ui static server would serve 404s for every asset (build output layout mismatch?)`);
+		const serveUiStatic = sirv(uiDistDir, { dev: true });
+		uiStaticServer = http.createServer((req, res) => {
+			applyCorsHeaders(res);
+			serveUiStatic(req, res, () => {
+				sendText(res, 404, "Not Found");
+			});
+		});
+		await new Promise((resolve, reject) => {
+			uiStaticServer.once("error", reject);
+			uiStaticServer.listen(Number(uiPort), () => resolve());
+		});
+		console.log(`├─ 🎨 UI:     http://localhost:${uiPort} (built, no watch)`);
+	} else if (uiConfig) {
+		uiWatcher = spawn("rsbuild", [
+			"dev",
+			"--config",
+			uiConfig
+		], {
+			cwd,
+			stdio: "inherit",
+			env: uiPort ? {
+				...process.env,
+				PORT: uiPort
+			} : process.env
+		});
+		uiWatcher.on("error", (error) => {
+			console.error(`❌ Failed to spawn rsbuild ui dev: ${error.message}`);
+		});
+		console.log(`├─ 🎨 UI:     ${uiPort ? `http://localhost:${uiPort}` : "(rsbuild auto port)"}`);
+	}
+	const handlers = {
+		rpc: null,
+		api: null
+	};
+	const effectContextHolder = { context: null };
+	let runtime = null;
+	const pathnameOf = (req) => ((req.url ?? "/").split("?")[0] ?? "/").replace(/\/+$/, "") || "/";
+	const buildDevContext = (_req, webRequest) => {
+		const rawClone = webRequest.method === "GET" || webRequest.method === "HEAD" ? null : webRequest.clone();
+		let cachedRawBody = null;
+		return {
+			reqHeaders: webRequest.headers,
+			"effect/context": effectContextHolder.context,
+			getRawBody: async () => {
+				if (cachedRawBody !== null) return cachedRawBody;
+				if (!rawClone) {
+					cachedRawBody = "";
+					return cachedRawBody;
+				}
+				cachedRawBody = await rawClone.text();
+				return cachedRawBody;
+			}
+		};
+	};
+	const toWebRequest = (req) => {
+		const url = `http://localhost:${port}${req.url}`;
+		return new Request(url, {
+			method: req.method,
+			headers: req.headers,
+			body: req.method !== "GET" && req.method !== "HEAD" ? req : void 0,
+			duplex: req.method !== "GET" && req.method !== "HEAD" ? "half" : void 0
+		});
+	};
+	const handleOrpc = async (req, res, handler, prefix, errorLabel) => {
+		try {
+			const webRequest = toWebRequest(req);
+			const result = await handler.handle(webRequest, {
+				prefix,
+				context: buildDevContext(req, webRequest)
+			});
+			if (result.response) {
+				res.statusCode = result.response.status;
+				result.response.headers.forEach((value, key) => {
+					res.setHeader(key, value);
+				});
+				const text = await result.response.text();
+				if (!res.getHeader("content-length")) res.setHeader("content-length", Buffer.byteLength(text).toString());
+				res.end(text);
+			} else sendText(res, 404, "Not Found");
+		} catch (error) {
+			console.error(`${errorLabel} error:`, error);
+			sendJson(res, 500, { error: error.message });
+		}
+	};
+	const server = http.createServer((req, res) => {
+		applyCorsHeaders(res);
+		const pathname = pathnameOf(req);
+		if (req.method === "OPTIONS") {
+			res.statusCode = 200;
+			res.end();
+			return;
+		}
+		if (pathname === "/" && (req.method === "GET" || req.method === "HEAD")) {
+			sendJson(res, 200, {
+				ok: true,
+				plugin: pluginInfo.normalizedName,
+				version: pluginInfo.version,
+				status: handlers.rpc ? "ready" : "loading",
+				endpoints: {
+					health: "/",
+					docs: "/api",
+					rpc: rpcBase
+				}
+			});
+			return;
+		}
+		if (pathname === "/health" && (req.method === "GET" || req.method === "HEAD")) {
+			sendText(res, 200, "OK");
+			return;
+		}
+		if (pathname.startsWith(`${rpcBase}/`)) {
+			if (!handlers.rpc) {
+				sendJson(res, 503, { error: "Plugin still loading..." });
+				return;
+			}
+			handleOrpc(req, res, handlers.rpc, rpcBase, "RPC").catch(() => {});
+			return;
+		}
+		if (pathname === "/api" || pathname.startsWith("/api/")) {
+			if (!handlers.api) {
+				sendJson(res, 503, { error: "Plugin still loading..." });
+				return;
+			}
+			handleOrpc(req, res, handlers.api, "/api", "OpenAPI").catch(() => {});
+			return;
+		}
+		serveStatic(req, res, () => {
+			sendText(res, 404, "Not Found");
+		});
+	});
+	await new Promise((resolve, reject) => {
+		server.once("error", reject);
+		server.listen(port, () => resolve());
+	});
+	console.log(`🚀 ${pluginInfo.name} dev server listening on port ${port}`);
+	console.log(`├─ 📡 RPC:    http://localhost:${port}/api/rpc${rpcPrefix}`);
+	console.log(`├─ 📖 Docs:   http://localhost:${port}/api`);
+	console.log(`└─ 💚 Health: http://localhost:${port}/`);
+	const load = async () => {
+		try {
+			const { createPluginRuntime } = await import("../runtime/index.mjs");
+			const { RPCHandler } = await import("@orpc/server/fetch");
+			const { OpenAPIHandler } = await import("@orpc/openapi/fetch");
+			const { OpenAPIGenerator } = await import("@orpc/openapi");
+			const { OpenAPIReferenceHandlerPlugin } = await import("@orpc/openapi/plugins");
+			const { ZodToJsonSchemaConverter } = await import("@orpc/zod");
+			const { onError } = await import("@orpc/server");
+			const { formatORPCError } = await import("../errors.mjs");
+			const runtimeConfig = readRuntimeConfigFromEnv();
+			const { siblings, dependsOn } = collectSiblingRemotes(runtimeConfig, compositionKey);
+			if (dependsOn.length > 0) console.log(`🔗 Loading sibling plugin(s): ${dependsOn.join(", ")}`);
+			const registry = {
+				[pluginId]: { remote: `http://localhost:${port}/${DEV_ENTRY_FILENAME}` },
+				...siblings
+			};
+			const mfRuntime = createPluginRuntime({ registry });
+			runtime = mfRuntime;
+			const pluginsMap = {};
+			const siblingEffectContexts = [];
+			for (const depId of Object.keys(siblings)) {
+				const dep = await loadPluginWithRetry(mfRuntime, depId, siblings[depId].remote);
+				pluginsMap[depId] = {
+					client: dep.createClient,
+					router: dep.router
+				};
+				if (dep.initialized?.effectContext) siblingEffectContexts.push(dep.initialized.effectContext);
+				console.log(`✅ Loaded dependency plugin: ${depId}`);
+			}
+			const loaded = await loadPluginWithRetry(mfRuntime, pluginId, registry[pluginId].remote, devConfig?.config ?? {
+				variables: {},
+				secrets: {}
+			}, Object.keys(pluginsMap).length > 0 ? pluginsMap : void 0);
+			const { Context } = await import("effect");
+			effectContextHolder.context = [loaded.initialized?.effectContext, ...siblingEffectContexts].filter(Boolean).reduce((acc, ctx) => Context.merge(acc, ctx), Context.empty());
+			handlers.rpc = new RPCHandler(loaded.router, {
+				errorStatusMap: PLUGIN_ERROR_STATUS_MAP,
+				interceptors: [onError((error) => {
+					const formatted = formatORPCError(error);
+					if (formatted) console.error(formatted);
+				})]
+			});
+			const generator = new OpenAPIGenerator({ converters: [new ZodToJsonSchemaConverter()] });
+			handlers.api = new OpenAPIHandler(loaded.router, {
+				errorStatusMap: PLUGIN_ERROR_STATUS_MAP,
+				plugins: [new OpenAPIReferenceHandlerPlugin({ spec: () => generator.generate(loaded.router, { version: "3.1.1" }) })],
+				interceptors: [onError((error) => {
+					const formatted = formatORPCError(error);
+					if (formatted) console.error(formatted);
+				})]
+			});
+			console.log(`✅ Plugin ready: ${pluginId}`);
+		} catch (error) {
+			console.error(`❌ Failed to load plugin ${pluginId}:`, error);
+			console.error("   Server stays up; fix the build and retry via rebuild.");
+		}
+	};
+	load();
+	const close = async () => {
+		handlers.rpc = null;
+		handlers.api = null;
+		effectContextHolder.context = null;
+		for (const child of [watcher, uiWatcher]) if (child) await killChildEscalating(child);
+		if (uiStaticServer) await new Promise((resolve) => uiStaticServer.close(() => resolve()));
+		if (runtime) await runtime.shutdown().catch(() => {});
+		await new Promise((resolve) => server.close(() => resolve()));
+	};
+	process.once("SIGINT", async () => {
+		const timeout = setTimeout(() => process.exit(0), 3e3);
+		await close();
+		clearTimeout(timeout);
+		process.exit(0);
+	});
+	process.once("SIGTERM", async () => {
+		const timeout = setTimeout(() => process.exit(0), 3e3);
+		await close();
+		clearTimeout(timeout);
+		process.exit(0);
+	});
+	watchParentDeath(async () => {
+		const timeout = setTimeout(() => process.exit(0), 3e3);
+		await close();
+		clearTimeout(timeout);
+		process.exit(0);
+	});
+	return {
+		port,
+		close
+	};
+}
+if (import.meta.main || (process.argv[1] ?? "").includes("every-plugin-serve")) startPluginDevServer().catch((error) => {
+	console.error("❌ Plugin dev server fatal error:", error);
+	process.exit(1);
+});
+
+//#endregion
+export { resolveDevPluginId, startPluginDevServer };
+//# sourceMappingURL=serve.mjs.map

package/dist/dev/serve.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"serve.mjs","names":[],"sources":["../../src/dev/serve.ts"],"sourcesContent":["import { spawn } from \"node:child_process\";\nimport fs from \"node:fs\";\nimport http from \"node:http\";\nimport path from \"node:path\";\nimport { Effect } from \"effect\";\nimport sirv from \"sirv\";\nimport { DEV_ENTRY_FILENAME } from \"../build/artifact-names\";\nimport { ensureGeneratedRspackConfig } from \"../build/rspack/generated-config\";\nimport { getPluginInfo, loadDevConfig } from \"../build/rspack/utils\";\nimport { ensureGeneratedUiRsbuildConfig, pluginLayoutKey } from \"../build/ui/generated-config\";\nimport { PLUGIN_ERROR_STATUS_MAP } from \"../errors\";\nimport { loadRemoteWithRetry } from \"../remote-entry\";\nimport { killChildEscalating, watchParentDeath } from \"./watch-kill\";\n\nconst corsHeaders = {\n  \"Access-Control-Allow-Origin\": \"*\",\n  \"Access-Control-Allow-Methods\": \"GET, POST, PUT, DELETE, PATCH, OPTIONS\",\n  \"Access-Control-Allow-Headers\": \"X-Requested-With, content-type, Authorization\",\n};\n\nconst applyCorsHeaders = (res: http.ServerResponse) => {\n  Object.entries(corsHeaders).forEach(([key, value]) => {\n    res.setHeader(key, value);\n  });\n};\n\nconst normalizePrefix = (prefix?: string): string => {\n  if (!prefix) return \"\";\n  const cleaned = prefix.replace(/^\\/+|\\/+$/g, \"\");\n  return cleaned ? `/${cleaned}` : \"\";\n};\n\nconst readRuntimeConfigFromEnv = (): any => {\n  const raw = process.env.BOS_RUNTIME_CONFIG;\n  if (!raw) return null;\n  try {\n    return JSON.parse(raw);\n  } catch {\n    return null;\n  }\n};\n\nconst collectSiblingRemotes = (runtimeConfig: any, pluginId: string) => {\n  const siblings: Record<string, { remote: string }> = {};\n\n  const isApi = pluginId === \"api\" || runtimeConfig?.api?.name === pluginId;\n\n  const ownKey = runtimeConfig?.plugins?.[pluginId] ? pluginId : null;\n  let dependsOn: string[] = [];\n  if (ownKey) {\n    dependsOn = runtimeConfig.plugins[ownKey].dependsOn ?? [];\n  } else if (isApi) {\n    dependsOn = runtimeConfig?.api?.dependsOn ?? [];\n  }\n\n  for (const depId of dependsOn) {\n    const dep = runtimeConfig?.plugins?.[depId];\n    if (!dep || dep.source !== \"local\" || !dep.url) continue;\n    if (depId === pluginId) continue;\n    const base = dep.url.replace(/\\/$/, \"\");\n    siblings[depId] = { remote: `${base}/${DEV_ENTRY_FILENAME}` };\n  }\n\n  return { siblings, dependsOn };\n};\n\nconst loadPluginWithRetry = (\n  runtime: any,\n  pluginId: string,\n  remoteUrl: string,\n  options: Record<string, unknown> = { variables: {}, secrets: {} },\n  pluginsMap?: Record<string, unknown>,\n  timeoutMs = 90000,\n): Promise<any> =>\n  Effect.runPromise(\n    loadRemoteWithRetry({\n      label: pluginId,\n      remoteUrl,\n      load: () => runtime.usePlugin(pluginId, options, pluginsMap),\n      timeoutMs,\n    }),\n  );\n\nconst sendJson = (res: http.ServerResponse, status: number, body: unknown) => {\n  res.statusCode = status;\n  res.setHeader(\"content-type\", \"application/json; charset=utf-8\");\n  res.end(JSON.stringify(body));\n};\n\nconst sendText = (res: http.ServerResponse, status: number, text: string) => {\n  res.statusCode = status;\n  res.setHeader(\"content-type\", \"text/plain; charset=utf-8\");\n  res.end(text);\n};\n\nexport interface PluginDevServeOptions {\n  cwd?: string;\n  port?: number;\n  watch?: boolean;\n}\n\nexport interface PluginDevServerHandle {\n  port: number;\n  close: () => Promise<void>;\n}\n\n/**\n * The dev server's plugin id — the workspace's npm package name, the same\n * value the host passes as `runtimeId`. Both initialize sites must agree:\n * `registerRemote` derives the MF remote name from it, and the plugin's\n * database layer derives its migration slug from it, so a pre-normalized\n * remote name here would migrate into a different schema than the host\n * expects. plugin.dev.ts no longer carries a pluginId field.\n */\nexport const resolveDevPluginId = (cwd: string): string => getPluginInfo(cwd).name;\n\nexport async function startPluginDevServer(\n  options: PluginDevServeOptions = {},\n): Promise<PluginDevServerHandle> {\n  process.env.BOS_DEV_SERVER = \"1\";\n  const cwd = options.cwd ?? process.cwd();\n  const pluginInfo = getPluginInfo(cwd);\n  const devConfig = loadDevConfig(path.join(cwd, \"plugin.dev.ts\"));\n  const pluginId = resolveDevPluginId(cwd);\n  const compositionKey = pluginLayoutKey(cwd) ?? pluginId;\n  const port = options.port ?? (Number(process.env.PORT) || devConfig?.port || 3999);\n  const rpcPrefix = normalizePrefix(devConfig?.prefix);\n  const rpcBase = `/api/rpc${rpcPrefix}`;\n\n  const distDir = path.join(cwd, \"dist\");\n  const serveStatic = sirv(distDir, { dev: true });\n\n  // No-watch mode (BOS_NO_WATCH=1): build once, serve the built output.\n  // Regression/CI stacks need no hot reload — watchers are the stack's\n  // heaviest processes and stall runs freeze under their accumulated\n  // footprint. One-shot builds exit; steady state is small static servers.\n  const noWatch = options.watch === false || process.env.BOS_NO_WATCH === \"1\";\n\n  const runOnce = (cmd: string, args: string[]) =>\n    new Promise<void>((resolve, reject) => {\n      const child = spawn(cmd, args, { cwd, stdio: \"inherit\", env: process.env });\n      child.on(\"error\", reject);\n      child.on(\"exit\", (code) => {\n        if (code === 0) resolve();\n        else reject(new Error(`❌ ${cmd} ${args.join(\" \")} exited with ${code}`));\n      });\n    });\n\n  let watcher: ReturnType<typeof spawn> | null = null;\n  if (noWatch) {\n    const generatedConfig = ensureGeneratedRspackConfig(cwd);\n    await runOnce(\"rspack\", generatedConfig ? [\"build\", \"--config\", generatedConfig] : [\"build\"]);\n  } else if (options.watch !== false) {\n    const generatedConfig = ensureGeneratedRspackConfig(cwd);\n    watcher = spawn(\n      \"rspack\",\n      generatedConfig ? [\"build\", \"--watch\", \"--config\", generatedConfig] : [\"build\", \"--watch\"],\n      {\n        cwd,\n        stdio: \"inherit\",\n        env: process.env,\n      },\n    );\n    watcher.on(\"error\", (error) => {\n      console.error(`❌ Failed to spawn rspack build --watch: ${error.message}`);\n    });\n  }\n\n  let uiWatcher: ReturnType<typeof spawn> | null = null;\n  let uiStaticServer: http.Server | null = null;\n  const uiPort = process.env.BOS_UI_PORT;\n  const uiConfig = ensureGeneratedUiRsbuildConfig(cwd);\n  if (uiConfig && noWatch && uiPort) {\n    // Folder-form ui: one-shot build, then serve the ui source root's dist\n    // (the factory's absolute distPath target) statically on the ui port.\n    await runOnce(\"rsbuild\", [\"build\", \"--config\", uiConfig]);\n    const uiDistDir =\n      path.basename(cwd) === \"ui\" ? path.join(cwd, \"dist\") : path.join(cwd, \"ui\", \"dist\");\n    if (!fs.existsSync(path.join(uiDistDir, DEV_ENTRY_FILENAME))) {\n      console.error(\n        `❌ UI dist is missing at ${uiDistDir} — the ui static server would serve 404s for every asset (build output layout mismatch?)`,\n      );\n    }\n    const serveUiStatic = sirv(uiDistDir, { dev: true });\n    uiStaticServer = http.createServer((req, res) => {\n      applyCorsHeaders(res);\n      serveUiStatic(req, res, () => {\n        sendText(res, 404, \"Not Found\");\n      });\n    });\n    await new Promise<void>((resolve, reject) => {\n      uiStaticServer!.once(\"error\", reject);\n      uiStaticServer!.listen(Number(uiPort), () => resolve());\n    });\n    console.log(`├─ 🎨 UI:     http://localhost:${uiPort} (built, no watch)`);\n  } else if (uiConfig) {\n    uiWatcher = spawn(\"rsbuild\", [\"dev\", \"--config\", uiConfig], {\n      cwd,\n      stdio: \"inherit\",\n      env: uiPort ? { ...process.env, PORT: uiPort } : process.env,\n    });\n    uiWatcher.on(\"error\", (error) => {\n      console.error(`❌ Failed to spawn rsbuild ui dev: ${error.message}`);\n    });\n    console.log(`├─ 🎨 UI:     ${uiPort ? `http://localhost:${uiPort}` : \"(rsbuild auto port)\"}`);\n  }\n\n  const handlers: { rpc: any; api: any } = { rpc: null, api: null };\n  const effectContextHolder: { context: unknown } = { context: null };\n  let runtime: { shutdown: () => Promise<void> } | null = null;\n\n  const pathnameOf = (req: http.IncomingMessage): string =>\n    ((req.url ?? \"/\").split(\"?\")[0] ?? \"/\").replace(/\\/+$/, \"\") || \"/\";\n\n  const buildDevContext = (_req: http.IncomingMessage, webRequest: Request) => {\n    const rawClone =\n      webRequest.method === \"GET\" || webRequest.method === \"HEAD\" ? null : webRequest.clone();\n    let cachedRawBody: string | null = null;\n    return {\n      reqHeaders: webRequest.headers,\n      \"effect/context\": effectContextHolder.context,\n      getRawBody: async (): Promise<string> => {\n        if (cachedRawBody !== null) return cachedRawBody;\n        if (!rawClone) {\n          cachedRawBody = \"\";\n          return cachedRawBody;\n        }\n        cachedRawBody = await rawClone.text();\n        return cachedRawBody;\n      },\n    };\n  };\n\n  const toWebRequest = (req: http.IncomingMessage): Request => {\n    const url = `http://localhost:${port}${req.url}`;\n    return new Request(url, {\n      method: req.method,\n      headers: req.headers,\n      body: req.method !== \"GET\" && req.method !== \"HEAD\" ? req : undefined,\n      duplex: req.method !== \"GET\" && req.method !== \"HEAD\" ? \"half\" : undefined,\n    } as RequestInit);\n  };\n\n  const handleOrpc = async (\n    req: http.IncomingMessage,\n    res: http.ServerResponse,\n    handler: any,\n    prefix: string,\n    errorLabel: string,\n  ) => {\n    try {\n      const webRequest = toWebRequest(req);\n      const result = await handler.handle(webRequest, {\n        prefix,\n        context: buildDevContext(req, webRequest),\n      });\n\n      if (result.response) {\n        res.statusCode = result.response.status;\n        result.response.headers.forEach((value: string, key: string) => {\n          res.setHeader(key, value);\n        });\n        const text = await result.response.text();\n        if (!res.getHeader(\"content-length\")) {\n          res.setHeader(\"content-length\", Buffer.byteLength(text).toString());\n        }\n        res.end(text);\n      } else {\n        sendText(res, 404, \"Not Found\");\n      }\n    } catch (error) {\n      console.error(`${errorLabel} error:`, error);\n      sendJson(res, 500, { error: (error as Error).message });\n    }\n  };\n\n  const server = http.createServer((req, res) => {\n    applyCorsHeaders(res);\n    const pathname = pathnameOf(req);\n\n    if (req.method === \"OPTIONS\") {\n      res.statusCode = 200;\n      res.end();\n      return;\n    }\n\n    if (pathname === \"/\" && (req.method === \"GET\" || req.method === \"HEAD\")) {\n      sendJson(res, 200, {\n        ok: true,\n        plugin: pluginInfo.normalizedName,\n        version: pluginInfo.version,\n        status: handlers.rpc ? \"ready\" : \"loading\",\n        endpoints: {\n          health: \"/\",\n          docs: \"/api\",\n          rpc: rpcBase,\n        },\n      });\n      return;\n    }\n\n    if (pathname === \"/health\" && (req.method === \"GET\" || req.method === \"HEAD\")) {\n      sendText(res, 200, \"OK\");\n      return;\n    }\n\n    if (pathname.startsWith(`${rpcBase}/`)) {\n      if (!handlers.rpc) {\n        sendJson(res, 503, { error: \"Plugin still loading...\" });\n        return;\n      }\n      handleOrpc(req, res, handlers.rpc, rpcBase, \"RPC\").catch(() => {});\n      return;\n    }\n\n    if (pathname === \"/api\" || pathname.startsWith(\"/api/\")) {\n      if (!handlers.api) {\n        sendJson(res, 503, { error: \"Plugin still loading...\" });\n        return;\n      }\n      handleOrpc(req, res, handlers.api, \"/api\", \"OpenAPI\").catch(() => {});\n      return;\n    }\n\n    serveStatic(req, res, () => {\n      sendText(res, 404, \"Not Found\");\n    });\n  });\n\n  await new Promise<void>((resolve, reject) => {\n    server.once(\"error\", reject);\n    server.listen(port, () => resolve());\n  });\n\n  console.log(`🚀 ${pluginInfo.name} dev server listening on port ${port}`);\n  console.log(`├─ 📡 RPC:    http://localhost:${port}/api/rpc${rpcPrefix}`);\n  console.log(`├─ 📖 Docs:   http://localhost:${port}/api`);\n  console.log(`└─ 💚 Health: http://localhost:${port}/`);\n\n  const load = async () => {\n    try {\n      // Import framework internals directly. A package self-import can resolve\n      // the published entry while this source-first dev server is running,\n      // which leaves the runtime exports unavailable on Windows.\n      const { createPluginRuntime } = await import(\"../runtime\");\n      const { RPCHandler } = await import(\"@orpc/server/fetch\");\n      const { OpenAPIHandler } = await import(\"@orpc/openapi/fetch\");\n      const { OpenAPIGenerator } = await import(\"@orpc/openapi\");\n      const { OpenAPIReferenceHandlerPlugin } = await import(\"@orpc/openapi/plugins\");\n      const { ZodToJsonSchemaConverter } = await import(\"@orpc/zod\");\n      const { onError } = await import(\"@orpc/server\");\n      const { formatORPCError } = await import(\"../errors\");\n\n      const runtimeConfig = readRuntimeConfigFromEnv();\n      const { siblings, dependsOn } = collectSiblingRemotes(runtimeConfig, compositionKey);\n\n      if (dependsOn.length > 0) {\n        console.log(`🔗 Loading sibling plugin(s): ${dependsOn.join(\", \")}`);\n      }\n\n      const registry: Record<string, { remote: string }> = {\n        [pluginId]: {\n          remote: `http://localhost:${port}/${DEV_ENTRY_FILENAME}`,\n        },\n        ...siblings,\n      };\n\n      const mfRuntime = createPluginRuntime({ registry });\n      runtime = mfRuntime;\n\n      const pluginsMap: Record<string, unknown> = {};\n      const siblingEffectContexts: unknown[] = [];\n      for (const depId of Object.keys(siblings)) {\n        const dep = await loadPluginWithRetry(mfRuntime, depId, siblings[depId]!.remote);\n        pluginsMap[depId] = { client: dep.createClient, router: dep.router };\n        if (dep.initialized?.effectContext) {\n          siblingEffectContexts.push(dep.initialized.effectContext);\n        }\n        console.log(`✅ Loaded dependency plugin: ${depId}`);\n      }\n\n      const loaded: any = await loadPluginWithRetry(\n        mfRuntime,\n        pluginId,\n        registry[pluginId]!.remote,\n        (devConfig?.config ?? { variables: {}, secrets: {} }) as Record<string, unknown>,\n        Object.keys(pluginsMap).length > 0 ? pluginsMap : undefined,\n      );\n\n      const { Context } = await import(\"effect\");\n      effectContextHolder.context = [loaded.initialized?.effectContext, ...siblingEffectContexts]\n        .filter(Boolean)\n        .reduce((acc: any, ctx: any) => Context.merge(acc, ctx), Context.empty());\n\n      handlers.rpc = new RPCHandler(loaded.router, {\n        errorStatusMap: PLUGIN_ERROR_STATUS_MAP,\n        interceptors: [\n          onError((error: any) => {\n            const formatted = formatORPCError(error);\n            if (formatted) console.error(formatted);\n          }),\n        ],\n      });\n\n      const generator = new OpenAPIGenerator({ converters: [new ZodToJsonSchemaConverter()] });\n\n      handlers.api = new OpenAPIHandler(loaded.router, {\n        errorStatusMap: PLUGIN_ERROR_STATUS_MAP,\n        plugins: [\n          new OpenAPIReferenceHandlerPlugin({\n            spec: () => generator.generate(loaded.router, { version: \"3.1.1\" }),\n          }),\n        ],\n        interceptors: [\n          onError((error: any) => {\n            const formatted = formatORPCError(error);\n            if (formatted) console.error(formatted);\n          }),\n        ],\n      });\n\n      console.log(`✅ Plugin ready: ${pluginId}`);\n    } catch (error) {\n      console.error(`❌ Failed to load plugin ${pluginId}:`, error);\n      console.error(\"   Server stays up; fix the build and retry via rebuild.\");\n    }\n  };\n\n  void load();\n\n  const close = async () => {\n    handlers.rpc = null;\n    handlers.api = null;\n    effectContextHolder.context = null;\n    for (const child of [watcher, uiWatcher]) {\n      if (child) {\n        await killChildEscalating(child);\n      }\n    }\n    if (uiStaticServer) {\n      await new Promise<void>((resolve) => uiStaticServer.close(() => resolve()));\n    }\n    if (runtime) await runtime.shutdown().catch(() => {});\n    await new Promise<void>((resolve) => server.close(() => resolve()));\n  };\n\n  process.once(\"SIGINT\", async () => {\n    const timeout = setTimeout(() => process.exit(0), 3000);\n    await close();\n    clearTimeout(timeout);\n    process.exit(0);\n  });\n  process.once(\"SIGTERM\", async () => {\n    const timeout = setTimeout(() => process.exit(0), 3000);\n    await close();\n    clearTimeout(timeout);\n    process.exit(0);\n  });\n\n  watchParentDeath(async () => {\n    const timeout = setTimeout(() => process.exit(0), 3000);\n    await close();\n    clearTimeout(timeout);\n    process.exit(0);\n  });\n\n  return { port, close };\n}\n\nconst invokedAsCli = import.meta.main || (process.argv[1] ?? \"\").includes(\"every-plugin-serve\");\n\nif (invokedAsCli) {\n  startPluginDevServer().catch((error) => {\n    console.error(\"❌ Plugin dev server fatal error:\", error);\n    process.exit(1);\n  });\n}\n"],"mappings":";;;;;;;;;;;;;;;AAcA,MAAM,cAAc;CAClB,+BAA+B;CAC/B,gCAAgC;CAChC,gCAAgC;AAClC;AAEA,MAAM,oBAAoB,QAA6B;CACrD,OAAO,QAAQ,WAAW,CAAC,CAAC,SAAS,CAAC,KAAK,WAAW;EACpD,IAAI,UAAU,KAAK,KAAK;CAC1B,CAAC;AACH;AAEA,MAAM,mBAAmB,WAA4B;CACnD,IAAI,CAAC,QAAQ,OAAO;CACpB,MAAM,UAAU,OAAO,QAAQ,cAAc,EAAE;CAC/C,OAAO,UAAU,IAAI,YAAY;AACnC;AAEA,MAAM,iCAAsC;CAC1C,MAAM,MAAM,QAAQ,IAAI;CACxB,IAAI,CAAC,KAAK,OAAO;CACjB,IAAI;EACF,OAAO,KAAK,MAAM,GAAG;CACvB,QAAQ;EACN,OAAO;CACT;AACF;AAEA,MAAM,yBAAyB,eAAoB,aAAqB;CACtE,MAAM,WAA+C,CAAC;CAEtD,MAAM,QAAQ,aAAa,SAAS,eAAe,KAAK,SAAS;CAEjE,MAAM,SAAS,eAAe,UAAU,YAAY,WAAW;CAC/D,IAAI,YAAsB,CAAC;CAC3B,IAAI,QACF,YAAY,cAAc,QAAQ,OAAO,CAAC,aAAa,CAAC;MACnD,IAAI,OACT,YAAY,eAAe,KAAK,aAAa,CAAC;CAGhD,KAAK,MAAM,SAAS,WAAW;EAC7B,MAAM,MAAM,eAAe,UAAU;EACrC,IAAI,CAAC,OAAO,IAAI,WAAW,WAAW,CAAC,IAAI,KAAK;EAChD,IAAI,UAAU,UAAU;EAExB,SAAS,SAAS,EAAE,QAAQ,GADf,IAAI,IAAI,QAAQ,OAAO,EACF,EAAE,GAAG,qBAAqB;CAC9D;CAEA,OAAO;EAAE;EAAU;CAAU;AAC/B;AAEA,MAAM,uBACJ,SACA,UACA,WACA,UAAmC;CAAE,WAAW,CAAC;CAAG,SAAS,CAAC;AAAE,GAChE,YACA,YAAY,QAEZ,OAAO,WACL,oBAAoB;CAClB,OAAO;CACP;CACA,YAAY,QAAQ,UAAU,UAAU,SAAS,UAAU;CAC3D;AACF,CAAC,CACH;AAEF,MAAM,YAAY,KAA0B,QAAgB,SAAkB;CAC5E,IAAI,aAAa;CACjB,IAAI,UAAU,gBAAgB,iCAAiC;CAC/D,IAAI,IAAI,KAAK,UAAU,IAAI,CAAC;AAC9B;AAEA,MAAM,YAAY,KAA0B,QAAgB,SAAiB;CAC3E,IAAI,aAAa;CACjB,IAAI,UAAU,gBAAgB,2BAA2B;CACzD,IAAI,IAAI,IAAI;AACd;;;;;;;;;AAqBA,MAAa,sBAAsB,QAAwB,cAAc,GAAG,CAAC,CAAC;AAE9E,eAAsB,qBACpB,UAAiC,CAAC,GACF;CAChC,QAAQ,IAAI,iBAAiB;CAC7B,MAAM,MAAM,QAAQ,OAAO,QAAQ,IAAI;CACvC,MAAM,aAAa,cAAc,GAAG;CACpC,MAAM,YAAY,cAAc,KAAK,KAAK,KAAK,eAAe,CAAC;CAC/D,MAAM,WAAW,mBAAmB,GAAG;CACvC,MAAM,iBAAiB,gBAAgB,GAAG,KAAK;CAC/C,MAAM,OAAO,QAAQ,SAAS,OAAO,QAAQ,IAAI,IAAI,KAAK,WAAW,QAAQ;CAC7E,MAAM,YAAY,gBAAgB,WAAW,MAAM;CACnD,MAAM,UAAU,WAAW;CAE3B,MAAM,UAAU,KAAK,KAAK,KAAK,MAAM;CACrC,MAAM,cAAc,KAAK,SAAS,EAAE,KAAK,KAAK,CAAC;CAM/C,MAAM,UAAU,QAAQ,UAAU,SAAS,QAAQ,IAAI,iBAAiB;CAExE,MAAM,WAAW,KAAa,SAC5B,IAAI,SAAe,SAAS,WAAW;EACrC,MAAM,QAAQ,MAAM,KAAK,MAAM;GAAE;GAAK,OAAO;GAAW,KAAK,QAAQ;EAAI,CAAC;EAC1E,MAAM,GAAG,SAAS,MAAM;EACxB,MAAM,GAAG,SAAS,SAAS;GACzB,IAAI,SAAS,GAAG,QAAQ;QACnB,uBAAO,IAAI,MAAM,KAAK,IAAI,GAAG,KAAK,KAAK,GAAG,EAAE,eAAe,MAAM,CAAC;EACzE,CAAC;CACH,CAAC;CAEH,IAAI,UAA2C;CAC/C,IAAI,SAAS;EACX,MAAM,kBAAkB,4BAA4B,GAAG;EACvD,MAAM,QAAQ,UAAU,kBAAkB;GAAC;GAAS;GAAY;EAAe,IAAI,CAAC,OAAO,CAAC;CAC9F,OAAO,IAAI,QAAQ,UAAU,OAAO;EAClC,MAAM,kBAAkB,4BAA4B,GAAG;EACvD,UAAU,MACR,UACA,kBAAkB;GAAC;GAAS;GAAW;GAAY;EAAe,IAAI,CAAC,SAAS,SAAS,GACzF;GACE;GACA,OAAO;GACP,KAAK,QAAQ;EACf,CACF;EACA,QAAQ,GAAG,UAAU,UAAU;GAC7B,QAAQ,MAAM,2CAA2C,MAAM,SAAS;EAC1E,CAAC;CACH;CAEA,IAAI,YAA6C;CACjD,IAAI,iBAAqC;CACzC,MAAM,SAAS,QAAQ,IAAI;CAC3B,MAAM,WAAW,+BAA+B,GAAG;CACnD,IAAI,YAAY,WAAW,QAAQ;EAGjC,MAAM,QAAQ,WAAW;GAAC;GAAS;GAAY;EAAQ,CAAC;EACxD,MAAM,YACJ,KAAK,SAAS,GAAG,MAAM,OAAO,KAAK,KAAK,KAAK,MAAM,IAAI,KAAK,KAAK,KAAK,MAAM,MAAM;EACpF,IAAI,CAAC,GAAG,WAAW,KAAK,KAAK,2BAA6B,CAAC,GACzD,QAAQ,MACN,2BAA2B,UAAU,yFACvC;EAEF,MAAM,gBAAgB,KAAK,WAAW,EAAE,KAAK,KAAK,CAAC;EACnD,iBAAiB,KAAK,cAAc,KAAK,QAAQ;GAC/C,iBAAiB,GAAG;GACpB,cAAc,KAAK,WAAW;IAC5B,SAAS,KAAK,KAAK,WAAW;GAChC,CAAC;EACH,CAAC;EACD,MAAM,IAAI,SAAe,SAAS,WAAW;GAC3C,eAAgB,KAAK,SAAS,MAAM;GACpC,eAAgB,OAAO,OAAO,MAAM,SAAS,QAAQ,CAAC;EACxD,CAAC;EACD,QAAQ,IAAI,kCAAkC,OAAO,mBAAmB;CAC1E,OAAO,IAAI,UAAU;EACnB,YAAY,MAAM,WAAW;GAAC;GAAO;GAAY;EAAQ,GAAG;GAC1D;GACA,OAAO;GACP,KAAK,SAAS;IAAE,GAAG,QAAQ;IAAK,MAAM;GAAO,IAAI,QAAQ;EAC3D,CAAC;EACD,UAAU,GAAG,UAAU,UAAU;GAC/B,QAAQ,MAAM,qCAAqC,MAAM,SAAS;EACpE,CAAC;EACD,QAAQ,IAAI,iBAAiB,SAAS,oBAAoB,WAAW,uBAAuB;CAC9F;CAEA,MAAM,WAAmC;EAAE,KAAK;EAAM,KAAK;CAAK;CAChE,MAAM,sBAA4C,EAAE,SAAS,KAAK;CAClE,IAAI,UAAoD;CAExD,MAAM,cAAc,UAChB,IAAI,OAAO,IAAG,CAAE,MAAM,GAAG,CAAC,CAAC,MAAM,IAAG,CAAE,QAAQ,QAAQ,EAAE,KAAK;CAEjE,MAAM,mBAAmB,MAA4B,eAAwB;EAC3E,MAAM,WACJ,WAAW,WAAW,SAAS,WAAW,WAAW,SAAS,OAAO,WAAW,MAAM;EACxF,IAAI,gBAA+B;EACnC,OAAO;GACL,YAAY,WAAW;GACvB,kBAAkB,oBAAoB;GACtC,YAAY,YAA6B;IACvC,IAAI,kBAAkB,MAAM,OAAO;IACnC,IAAI,CAAC,UAAU;KACb,gBAAgB;KAChB,OAAO;IACT;IACA,gBAAgB,MAAM,SAAS,KAAK;IACpC,OAAO;GACT;EACF;CACF;CAEA,MAAM,gBAAgB,QAAuC;EAC3D,MAAM,MAAM,oBAAoB,OAAO,IAAI;EAC3C,OAAO,IAAI,QAAQ,KAAK;GACtB,QAAQ,IAAI;GACZ,SAAS,IAAI;GACb,MAAM,IAAI,WAAW,SAAS,IAAI,WAAW,SAAS,MAAM;GAC5D,QAAQ,IAAI,WAAW,SAAS,IAAI,WAAW,SAAS,SAAS;EACnE,CAAgB;CAClB;CAEA,MAAM,aAAa,OACjB,KACA,KACA,SACA,QACA,eACG;EACH,IAAI;GACF,MAAM,aAAa,aAAa,GAAG;GACnC,MAAM,SAAS,MAAM,QAAQ,OAAO,YAAY;IAC9C;IACA,SAAS,gBAAgB,KAAK,UAAU;GAC1C,CAAC;GAED,IAAI,OAAO,UAAU;IACnB,IAAI,aAAa,OAAO,SAAS;IACjC,OAAO,SAAS,QAAQ,SAAS,OAAe,QAAgB;KAC9D,IAAI,UAAU,KAAK,KAAK;IAC1B,CAAC;IACD,MAAM,OAAO,MAAM,OAAO,SAAS,KAAK;IACxC,IAAI,CAAC,IAAI,UAAU,gBAAgB,GACjC,IAAI,UAAU,kBAAkB,OAAO,WAAW,IAAI,CAAC,CAAC,SAAS,CAAC;IAEpE,IAAI,IAAI,IAAI;GACd,OACE,SAAS,KAAK,KAAK,WAAW;EAElC,SAAS,OAAO;GACd,QAAQ,MAAM,GAAG,WAAW,UAAU,KAAK;GAC3C,SAAS,KAAK,KAAK,EAAE,OAAQ,MAAgB,QAAQ,CAAC;EACxD;CACF;CAEA,MAAM,SAAS,KAAK,cAAc,KAAK,QAAQ;EAC7C,iBAAiB,GAAG;EACpB,MAAM,WAAW,WAAW,GAAG;EAE/B,IAAI,IAAI,WAAW,WAAW;GAC5B,IAAI,aAAa;GACjB,IAAI,IAAI;GACR;EACF;EAEA,IAAI,aAAa,QAAQ,IAAI,WAAW,SAAS,IAAI,WAAW,SAAS;GACvE,SAAS,KAAK,KAAK;IACjB,IAAI;IACJ,QAAQ,WAAW;IACnB,SAAS,WAAW;IACpB,QAAQ,SAAS,MAAM,UAAU;IACjC,WAAW;KACT,QAAQ;KACR,MAAM;KACN,KAAK;IACP;GACF,CAAC;GACD;EACF;EAEA,IAAI,aAAa,cAAc,IAAI,WAAW,SAAS,IAAI,WAAW,SAAS;GAC7E,SAAS,KAAK,KAAK,IAAI;GACvB;EACF;EAEA,IAAI,SAAS,WAAW,GAAG,QAAQ,EAAE,GAAG;GACtC,IAAI,CAAC,SAAS,KAAK;IACjB,SAAS,KAAK,KAAK,EAAE,OAAO,0BAA0B,CAAC;IACvD;GACF;GACA,WAAW,KAAK,KAAK,SAAS,KAAK,SAAS,KAAK,CAAC,CAAC,YAAY,CAAC,CAAC;GACjE;EACF;EAEA,IAAI,aAAa,UAAU,SAAS,WAAW,OAAO,GAAG;GACvD,IAAI,CAAC,SAAS,KAAK;IACjB,SAAS,KAAK,KAAK,EAAE,OAAO,0BAA0B,CAAC;IACvD;GACF;GACA,WAAW,KAAK,KAAK,SAAS,KAAK,QAAQ,SAAS,CAAC,CAAC,YAAY,CAAC,CAAC;GACpE;EACF;EAEA,YAAY,KAAK,WAAW;GAC1B,SAAS,KAAK,KAAK,WAAW;EAChC,CAAC;CACH,CAAC;CAED,MAAM,IAAI,SAAe,SAAS,WAAW;EAC3C,OAAO,KAAK,SAAS,MAAM;EAC3B,OAAO,OAAO,YAAY,QAAQ,CAAC;CACrC,CAAC;CAED,QAAQ,IAAI,MAAM,WAAW,KAAK,gCAAgC,MAAM;CACxE,QAAQ,IAAI,kCAAkC,KAAK,UAAU,WAAW;CACxE,QAAQ,IAAI,kCAAkC,KAAK,KAAK;CACxD,QAAQ,IAAI,kCAAkC,KAAK,EAAE;CAErD,MAAM,OAAO,YAAY;EACvB,IAAI;GAIF,MAAM,EAAE,wBAAwB,MAAM,OAAO;GAC7C,MAAM,EAAE,eAAe,MAAM,OAAO;GACpC,MAAM,EAAE,mBAAmB,MAAM,OAAO;GACxC,MAAM,EAAE,qBAAqB,MAAM,OAAO;GAC1C,MAAM,EAAE,kCAAkC,MAAM,OAAO;GACvD,MAAM,EAAE,6BAA6B,MAAM,OAAO;GAClD,MAAM,EAAE,YAAY,MAAM,OAAO;GACjC,MAAM,EAAE,oBAAoB,MAAM,OAAO;GAEzC,MAAM,gBAAgB,yBAAyB;GAC/C,MAAM,EAAE,UAAU,cAAc,sBAAsB,eAAe,cAAc;GAEnF,IAAI,UAAU,SAAS,GACrB,QAAQ,IAAI,iCAAiC,UAAU,KAAK,IAAI,GAAG;GAGrE,MAAM,WAA+C;KAClD,WAAW,EACV,QAAQ,oBAAoB,KAAK,GAAG,qBACtC;IACA,GAAG;GACL;GAEA,MAAM,YAAY,oBAAoB,EAAE,SAAS,CAAC;GAClD,UAAU;GAEV,MAAM,aAAsC,CAAC;GAC7C,MAAM,wBAAmC,CAAC;GAC1C,KAAK,MAAM,SAAS,OAAO,KAAK,QAAQ,GAAG;IACzC,MAAM,MAAM,MAAM,oBAAoB,WAAW,OAAO,SAAS,MAAM,CAAE,MAAM;IAC/E,WAAW,SAAS;KAAE,QAAQ,IAAI;KAAc,QAAQ,IAAI;IAAO;IACnE,IAAI,IAAI,aAAa,eACnB,sBAAsB,KAAK,IAAI,YAAY,aAAa;IAE1D,QAAQ,IAAI,+BAA+B,OAAO;GACpD;GAEA,MAAM,SAAc,MAAM,oBACxB,WACA,UACA,SAAS,SAAS,CAAE,QACnB,WAAW,UAAU;IAAE,WAAW,CAAC;IAAG,SAAS,CAAC;GAAE,GACnD,OAAO,KAAK,UAAU,CAAC,CAAC,SAAS,IAAI,aAAa,MACpD;GAEA,MAAM,EAAE,YAAY,MAAM,OAAO;GACjC,oBAAoB,UAAU,CAAC,OAAO,aAAa,eAAe,GAAG,qBAAqB,CAAC,CACxF,OAAO,OAAO,CAAC,CACf,QAAQ,KAAU,QAAa,QAAQ,MAAM,KAAK,GAAG,GAAG,QAAQ,MAAM,CAAC;GAE1E,SAAS,MAAM,IAAI,WAAW,OAAO,QAAQ;IAC3C,gBAAgB;IAChB,cAAc,CACZ,SAAS,UAAe;KACtB,MAAM,YAAY,gBAAgB,KAAK;KACvC,IAAI,WAAW,QAAQ,MAAM,SAAS;IACxC,CAAC,CACH;GACF,CAAC;GAED,MAAM,YAAY,IAAI,iBAAiB,EAAE,YAAY,CAAC,IAAI,yBAAyB,CAAC,EAAE,CAAC;GAEvF,SAAS,MAAM,IAAI,eAAe,OAAO,QAAQ;IAC/C,gBAAgB;IAChB,SAAS,CACP,IAAI,8BAA8B,EAChC,YAAY,UAAU,SAAS,OAAO,QAAQ,EAAE,SAAS,QAAQ,CAAC,EACpE,CAAC,CACH;IACA,cAAc,CACZ,SAAS,UAAe;KACtB,MAAM,YAAY,gBAAgB,KAAK;KACvC,IAAI,WAAW,QAAQ,MAAM,SAAS;IACxC,CAAC,CACH;GACF,CAAC;GAED,QAAQ,IAAI,mBAAmB,UAAU;EAC3C,SAAS,OAAO;GACd,QAAQ,MAAM,2BAA2B,SAAS,IAAI,KAAK;GAC3D,QAAQ,MAAM,0DAA0D;EAC1E;CACF;CAEA,AAAK,KAAK;CAEV,MAAM,QAAQ,YAAY;EACxB,SAAS,MAAM;EACf,SAAS,MAAM;EACf,oBAAoB,UAAU;EAC9B,KAAK,MAAM,SAAS,CAAC,SAAS,SAAS,GACrC,IAAI,OACF,MAAM,oBAAoB,KAAK;EAGnC,IAAI,gBACF,MAAM,IAAI,SAAe,YAAY,eAAe,YAAY,QAAQ,CAAC,CAAC;EAE5E,IAAI,SAAS,MAAM,QAAQ,SAAS,CAAC,CAAC,YAAY,CAAC,CAAC;EACpD,MAAM,IAAI,SAAe,YAAY,OAAO,YAAY,QAAQ,CAAC,CAAC;CACpE;CAEA,QAAQ,KAAK,UAAU,YAAY;EACjC,MAAM,UAAU,iBAAiB,QAAQ,KAAK,CAAC,GAAG,GAAI;EACtD,MAAM,MAAM;EACZ,aAAa,OAAO;EACpB,QAAQ,KAAK,CAAC;CAChB,CAAC;CACD,QAAQ,KAAK,WAAW,YAAY;EAClC,MAAM,UAAU,iBAAiB,QAAQ,KAAK,CAAC,GAAG,GAAI;EACtD,MAAM,MAAM;EACZ,aAAa,OAAO;EACpB,QAAQ,KAAK,CAAC;CAChB,CAAC;CAED,iBAAiB,YAAY;EAC3B,MAAM,UAAU,iBAAiB,QAAQ,KAAK,CAAC,GAAG,GAAI;EACtD,MAAM,MAAM;EACZ,aAAa,OAAO;EACpB,QAAQ,KAAK,CAAC;CAChB,CAAC;CAED,OAAO;EAAE;EAAM;CAAM;AACvB;AAIA,IAFqB,YAAY,SAAS,QAAQ,KAAK,MAAM,GAAE,CAAE,SAAS,oBAAoB,GAG5F,qBAAqB,CAAC,CAAC,OAAO,UAAU;CACtC,QAAQ,MAAM,oCAAoC,KAAK;CACvD,QAAQ,KAAK,CAAC;AAChB,CAAC"}

package/dist/dev/watch-kill.cjs

@@ -0,0 +1,39 @@
+//#region src/dev/watch-kill.ts
+const waitForExit = (child, timeoutMs) => new Promise((resolve) => {
+	if (child.exitCode !== null) {
+		resolve(true);
+		return;
+	}
+	const onExit = () => {
+		clearTimeout(timer);
+		resolve(true);
+	};
+	const timer = setTimeout(() => {
+		child.removeListener("exit", onExit);
+		resolve(false);
+	}, timeoutMs);
+	child.addListener("exit", onExit);
+});
+const killChildEscalating = async (child, terminateMs = 2e3) => {
+	if (child.exitCode !== null || child.killed) return;
+	child.kill("SIGTERM");
+	if (!await waitForExit(child, terminateMs)) child.kill("SIGKILL");
+};
+const watchParentDeath = (onParentDeath, opts) => {
+	const getPpid = opts?.getPpid ?? (() => process.ppid);
+	const intervalMs = opts?.intervalMs ?? 200;
+	const initialPpid = getPpid();
+	const timer = setInterval(() => {
+		if (getPpid() !== initialPpid) {
+			clearInterval(timer);
+			onParentDeath();
+		}
+	}, intervalMs);
+	timer.unref?.();
+	return { stop: () => clearInterval(timer) };
+};
+
+//#endregion
+exports.killChildEscalating = killChildEscalating;
+exports.watchParentDeath = watchParentDeath;
+//# sourceMappingURL=watch-kill.cjs.map

package/dist/dev/watch-kill.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"watch-kill.cjs","names":[],"sources":["../../src/dev/watch-kill.ts"],"sourcesContent":["interface KillableChild {\n  pid?: number | undefined;\n  kill: (signal?: NodeJS.Signals) => void;\n  exitCode: number | null;\n  killed: boolean;\n  addListener: (event: \"exit\", listener: () => void) => unknown;\n  removeListener: (event: \"exit\", listener: () => void) => unknown;\n}\n\nconst waitForExit = (child: KillableChild, timeoutMs: number): Promise<boolean> =>\n  new Promise((resolve) => {\n    if (child.exitCode !== null) {\n      resolve(true);\n      return;\n    }\n    const onExit = () => {\n      clearTimeout(timer);\n      resolve(true);\n    };\n    const timer = setTimeout(() => {\n      child.removeListener(\"exit\", onExit);\n      resolve(false);\n    }, timeoutMs);\n    child.addListener(\"exit\", onExit);\n  });\n\nexport const killChildEscalating = async (\n  child: KillableChild,\n  terminateMs = 2000,\n): Promise<void> => {\n  if (child.exitCode !== null || child.killed) return;\n  child.kill(\"SIGTERM\");\n  const exited = await waitForExit(child, terminateMs);\n  if (!exited) child.kill(\"SIGKILL\");\n};\n\nexport interface WatchParentDeathOptions {\n  intervalMs?: number;\n  getPpid?: () => number;\n  onParentDeath?: () => void | Promise<void>;\n}\n\nexport const watchParentDeath = (\n  onParentDeath: () => void | Promise<void>,\n  opts?: Omit<WatchParentDeathOptions, \"onParentDeath\">,\n): { stop: () => void } => {\n  const getPpid = opts?.getPpid ?? (() => process.ppid);\n  const intervalMs = opts?.intervalMs ?? 200;\n  const initialPpid = getPpid();\n  const timer = setInterval(() => {\n    if (getPpid() !== initialPpid) {\n      clearInterval(timer);\n      void onParentDeath();\n    }\n  }, intervalMs);\n  timer.unref?.();\n  return { stop: () => clearInterval(timer) };\n};\n"],"mappings":";AASA,MAAM,eAAe,OAAsB,cACzC,IAAI,SAAS,YAAY;CACvB,IAAI,MAAM,aAAa,MAAM;EAC3B,QAAQ,IAAI;EACZ;CACF;CACA,MAAM,eAAe;EACnB,aAAa,KAAK;EAClB,QAAQ,IAAI;CACd;CACA,MAAM,QAAQ,iBAAiB;EAC7B,MAAM,eAAe,QAAQ,MAAM;EACnC,QAAQ,KAAK;CACf,GAAG,SAAS;CACZ,MAAM,YAAY,QAAQ,MAAM;AAClC,CAAC;AAEH,MAAa,sBAAsB,OACjC,OACA,cAAc,QACI;CAClB,IAAI,MAAM,aAAa,QAAQ,MAAM,QAAQ;CAC7C,MAAM,KAAK,SAAS;CAEpB,IAAI,CAAC,MADgB,YAAY,OAAO,WAAW,GACtC,MAAM,KAAK,SAAS;AACnC;AAQA,MAAa,oBACX,eACA,SACyB;CACzB,MAAM,UAAU,MAAM,kBAAkB,QAAQ;CAChD,MAAM,aAAa,MAAM,cAAc;CACvC,MAAM,cAAc,QAAQ;CAC5B,MAAM,QAAQ,kBAAkB;EAC9B,IAAI,QAAQ,MAAM,aAAa;GAC7B,cAAc,KAAK;GACnB,AAAK,cAAc;EACrB;CACF,GAAG,UAAU;CACb,MAAM,QAAQ;CACd,OAAO,EAAE,YAAY,cAAc,KAAK,EAAE;AAC5C"}

package/dist/dev/watch-kill.mjs

@@ -0,0 +1,38 @@
+//#region src/dev/watch-kill.ts
+const waitForExit = (child, timeoutMs) => new Promise((resolve) => {
+	if (child.exitCode !== null) {
+		resolve(true);
+		return;
+	}
+	const onExit = () => {
+		clearTimeout(timer);
+		resolve(true);
+	};
+	const timer = setTimeout(() => {
+		child.removeListener("exit", onExit);
+		resolve(false);
+	}, timeoutMs);
+	child.addListener("exit", onExit);
+});
+const killChildEscalating = async (child, terminateMs = 2e3) => {
+	if (child.exitCode !== null || child.killed) return;
+	child.kill("SIGTERM");
+	if (!await waitForExit(child, terminateMs)) child.kill("SIGKILL");
+};
+const watchParentDeath = (onParentDeath, opts) => {
+	const getPpid = opts?.getPpid ?? (() => process.ppid);
+	const intervalMs = opts?.intervalMs ?? 200;
+	const initialPpid = getPpid();
+	const timer = setInterval(() => {
+		if (getPpid() !== initialPpid) {
+			clearInterval(timer);
+			onParentDeath();
+		}
+	}, intervalMs);
+	timer.unref?.();
+	return { stop: () => clearInterval(timer) };
+};
+
+//#endregion
+export { killChildEscalating, watchParentDeath };
+//# sourceMappingURL=watch-kill.mjs.map