@keystrokehq/hosting 0.1.14 → 0.1.16

package/dist/docker.cjs

@@ -0,0 +1,131 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_wait_for_health = require("./wait-for-health-DM55_NQh.cjs");
+let node_fs_promises = require("node:fs/promises");
+//#region src/docker/create-docker-runtime.ts
+const MINIO_DOCKER_NETWORK = process.env.MINIO_DOCKER_NETWORK ?? "keystroke";
+async function resolveDocker(options) {
+	if (options.docker) return options.docker;
+	const { default: DockerCtor } = await import("dockerode");
+	return new DockerCtor();
+}
+function createDockerRuntime(options = {}) {
+	return {
+		async start(input) {
+			if (input.projects.length === 0) throw new Error("Docker org runtime requires at least one project deploy");
+			const docker = await resolveDocker(options);
+			let launch = require_wait_for_health.resolveRuntimeLaunch(options, input.projects.map((project) => ({
+				projectId: project.projectId,
+				artifactStorageKey: project.artifactStorageKey,
+				artifactId: project.artifactId,
+				artifactVersion: project.artifactVersion
+			})), input.database, input.env);
+			if (options.workspacesMount) {
+				const { hostPath, containerPath } = options.workspacesMount;
+				await (0, node_fs_promises.mkdir)(hostPath, { recursive: true });
+				launch = {
+					...launch,
+					env: {
+						...launch.env,
+						KEYSTROKE_WORKSPACES_ROOT: containerPath
+					}
+				};
+			}
+			await ensureImage(docker, launch.image);
+			await removeExistingContainer(docker, input.organizationId);
+			const binds = [...options.workspacesMount ? [`${options.workspacesMount.hostPath}:${options.workspacesMount.containerPath}`] : [], ...options.extraBinds ?? []];
+			const container = await docker.createContainer({
+				Image: launch.image,
+				name: containerName(input.organizationId),
+				Labels: {
+					"keystroke.organization.id": input.organizationId,
+					"keystroke.project.ids": input.projects.map((project) => project.projectId).join(",")
+				},
+				ExposedPorts: { [`${launch.port}/tcp`]: {} },
+				HostConfig: {
+					ExtraHosts: ["host.docker.internal:host-gateway"],
+					PortBindings: { [`${launch.port}/tcp`]: [{ HostPort: "0" }] },
+					...binds.length > 0 ? { Binds: binds } : {}
+				},
+				NetworkingConfig: { EndpointsConfig: { [MINIO_DOCKER_NETWORK]: {} } },
+				Env: require_wait_for_health.formatDockerEnv(launch.env)
+			});
+			await container.start();
+			const inspect = await container.inspect();
+			const binding = inspect.NetworkSettings.Ports?.[`${launch.port}/tcp`]?.[0];
+			if (!binding?.HostPort) throw new Error("Failed to resolve org container host port");
+			const baseUrl = `http://127.0.0.1:${binding.HostPort}`;
+			await require_wait_for_health.waitForHealth(baseUrl, {
+				fetchImpl: options.fetchImpl,
+				timeoutMs: options.healthTimeoutMs
+			});
+			return {
+				runtimeId: inspect.Id,
+				baseUrl
+			};
+		},
+		async destroy(input) {
+			try {
+				await (await resolveDocker(options)).getContainer(input.runtimeId).remove({ force: true });
+			} catch {}
+		}
+	};
+}
+function containerName(organizationId) {
+	return `keystroke-org-${organizationId}`;
+}
+async function removeExistingContainer(docker, organizationId) {
+	try {
+		const existing = docker.getContainer(containerName(organizationId));
+		await existing.stop({ t: 5 }).catch(() => void 0);
+		await existing.remove({ force: true });
+	} catch {}
+}
+async function ensureImage(docker, image) {
+	try {
+		await docker.getImage(image).inspect();
+		return;
+	} catch {}
+	await new Promise((resolvePromise, reject) => {
+		docker.pull(image, (error, stream) => {
+			if (error) {
+				reject(error);
+				return;
+			}
+			if (!stream) {
+				reject(/* @__PURE__ */ new Error(`Failed to pull image ${image}`));
+				return;
+			}
+			docker.modem.followProgress(stream, (progressError) => {
+				if (progressError) {
+					reject(progressError);
+					return;
+				}
+				resolvePromise();
+			});
+		});
+	});
+}
+//#endregion
+//#region src/docker/plugin.ts
+function dockerPlugin(options = {}) {
+	const env = options.env ?? process.env;
+	return {
+		name: "docker",
+		workerRuntime: require_wait_for_health.resolveWorkerRuntimeConfig(env),
+		createRuntime: () => createDockerRuntime({
+			...options,
+			env
+		})
+	};
+}
+//#endregion
+//#region src/default-plugin.ts
+/** Local Docker hosting — default for platform and dev. */
+function defaultHostingPlugin(options = {}) {
+	return dockerPlugin(options);
+}
+//#endregion
+exports.defaultHostingPlugin = defaultHostingPlugin;
+exports.dockerPlugin = dockerPlugin;
+
+//# sourceMappingURL=docker.cjs.map

package/dist/docker.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"docker.cjs","names":["resolveRuntimeLaunch","formatDockerEnv","waitForHealth","resolveWorkerRuntimeConfig"],"sources":["../src/docker/create-docker-runtime.ts","../src/docker/plugin.ts","../src/default-plugin.ts"],"sourcesContent":["import { mkdir } from \"node:fs/promises\";\nimport type Docker from \"dockerode\";\n\nimport type { ProjectRuntime } from \"../runtime\";\n\nimport type { HostingOptions } from \"../plugin\";\nimport { formatDockerEnv, resolveRuntimeLaunch } from \"../runtime-env\";\nimport { waitForHealth } from \"../wait-for-health\";\n\nexport type WorkspacesMount = {\n  hostPath: string;\n  containerPath: string;\n};\n\nexport type DockerPluginOptions = HostingOptions & {\n  docker?: Docker;\n  /** Bind a shared host workspace dir into dev workers (VM sandbox proxy mount path). */\n  workspacesMount?: WorkspacesMount;\n  /** Additional Docker bind mounts (`host:container[:options]`). */\n  extraBinds?: string[];\n};\n\nconst MINIO_DOCKER_NETWORK = process.env.MINIO_DOCKER_NETWORK ?? \"keystroke\";\n\nasync function resolveDocker(options: DockerPluginOptions): Promise<Docker> {\n  if (options.docker) {\n    return options.docker;\n  }\n  const { default: DockerCtor } = await import(\"dockerode\");\n  return new DockerCtor();\n}\n\nexport function createDockerRuntime(options: DockerPluginOptions = {}): ProjectRuntime {\n  return {\n    async start(input) {\n      if (input.projects.length === 0) {\n        throw new Error(\"Docker org runtime requires at least one project deploy\");\n      }\n\n      const docker = await resolveDocker(options);\n\n      let launch = resolveRuntimeLaunch(\n        options,\n        input.projects.map((project) => ({\n          projectId: project.projectId,\n          artifactStorageKey: project.artifactStorageKey,\n          artifactId: project.artifactId,\n          artifactVersion: project.artifactVersion,\n        })),\n        input.database,\n        input.env,\n      );\n\n      if (options.workspacesMount) {\n        const { hostPath, containerPath } = options.workspacesMount;\n        await mkdir(hostPath, { recursive: true });\n        launch = {\n          ...launch,\n          env: {\n            ...launch.env,\n            KEYSTROKE_WORKSPACES_ROOT: containerPath,\n          },\n        };\n      }\n\n      await ensureImage(docker, launch.image);\n      await removeExistingContainer(docker, input.organizationId);\n\n      const binds = [\n        ...(options.workspacesMount\n          ? [`${options.workspacesMount.hostPath}:${options.workspacesMount.containerPath}`]\n          : []),\n        ...(options.extraBinds ?? []),\n      ];\n\n      const container = await docker.createContainer({\n        Image: launch.image,\n        name: containerName(input.organizationId),\n        Labels: {\n          \"keystroke.organization.id\": input.organizationId,\n          \"keystroke.project.ids\": input.projects.map((project) => project.projectId).join(\",\"),\n        },\n        ExposedPorts: {\n          [`${launch.port}/tcp`]: {},\n        },\n        HostConfig: {\n          ExtraHosts: [\"host.docker.internal:host-gateway\"],\n          PortBindings: {\n            [`${launch.port}/tcp`]: [{ HostPort: \"0\" }],\n          },\n          ...(binds.length > 0 ? { Binds: binds } : {}),\n        },\n        NetworkingConfig: {\n          EndpointsConfig: {\n            [MINIO_DOCKER_NETWORK]: {},\n          },\n        },\n        Env: formatDockerEnv(launch.env),\n      });\n\n      await container.start();\n\n      const inspect = await container.inspect();\n      const binding = inspect.NetworkSettings.Ports?.[`${launch.port}/tcp`]?.[0];\n      if (!binding?.HostPort) {\n        throw new Error(\"Failed to resolve org container host port\");\n      }\n\n      const baseUrl = `http://127.0.0.1:${binding.HostPort}`;\n      await waitForHealth(baseUrl, {\n        fetchImpl: options.fetchImpl,\n        timeoutMs: options.healthTimeoutMs,\n      });\n\n      return {\n        runtimeId: inspect.Id,\n        baseUrl,\n      };\n    },\n\n    async destroy(input) {\n      try {\n        const docker = await resolveDocker(options);\n        const container = docker.getContainer(input.runtimeId);\n        await container.remove({ force: true });\n      } catch {\n        // Container already removed or never existed.\n      }\n    },\n  };\n}\n\nfunction containerName(organizationId: string): string {\n  return `keystroke-org-${organizationId}`;\n}\n\nasync function removeExistingContainer(docker: Docker, organizationId: string): Promise<void> {\n  try {\n    const existing = docker.getContainer(containerName(organizationId));\n    await existing.stop({ t: 5 }).catch(() => undefined);\n    await existing.remove({ force: true });\n  } catch {\n    // no existing container\n  }\n}\n\nasync function ensureImage(docker: Docker, image: string): Promise<void> {\n  try {\n    await docker.getImage(image).inspect();\n    return;\n  } catch {\n    // pull below\n  }\n\n  await new Promise<void>((resolvePromise, reject) => {\n    docker.pull(image, (error: Error | null, stream: NodeJS.ReadableStream | undefined) => {\n      if (error) {\n        reject(error);\n        return;\n      }\n\n      if (!stream) {\n        reject(new Error(`Failed to pull image ${image}`));\n        return;\n      }\n\n      docker.modem.followProgress(stream, (progressError: Error | null) => {\n        if (progressError) {\n          reject(progressError);\n          return;\n        }\n\n        resolvePromise();\n      });\n    });\n  });\n}\n","import type { HostingPlugin } from \"../plugin\";\nimport { resolveWorkerRuntimeConfig } from \"../worker-runtime-config\";\n\nimport { createDockerRuntime } from \"./create-docker-runtime\";\nimport type { DockerPluginOptions } from \"./create-docker-runtime\";\n\nexport type { DockerPluginOptions } from \"./create-docker-runtime\";\n\nexport function dockerPlugin(options: DockerPluginOptions = {}): HostingPlugin {\n  const env = options.env ?? process.env;\n\n  return {\n    name: \"docker\",\n    workerRuntime: resolveWorkerRuntimeConfig(env),\n    createRuntime: () => createDockerRuntime({ ...options, env }),\n  };\n}\n","import type { HostingPlugin } from \"./plugin\";\nimport { dockerPlugin, type DockerPluginOptions } from \"./docker/plugin\";\n\n/** Local Docker hosting — default for platform and dev. */\nexport function defaultHostingPlugin(options: DockerPluginOptions = {}): HostingPlugin {\n  return dockerPlugin(options);\n}\n"],"mappings":"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"}

package/dist/docker.d.cts

@@ -0,0 +1,23 @@
+import { n as HostingPlugin, t as HostingOptions } from "./plugin-is5oPt6x.cjs";
+import Docker from "dockerode";
+
+//#region src/docker/create-docker-runtime.d.ts
+type WorkspacesMount = {
+  hostPath: string;
+  containerPath: string;
+};
+type DockerPluginOptions = HostingOptions & {
+  docker?: Docker; /** Bind a shared host workspace dir into dev workers (VM sandbox proxy mount path). */
+  workspacesMount?: WorkspacesMount; /** Additional Docker bind mounts (`host:container[:options]`). */
+  extraBinds?: string[];
+};
+//#endregion
+//#region src/docker/plugin.d.ts
+declare function dockerPlugin(options?: DockerPluginOptions): HostingPlugin;
+//#endregion
+//#region src/default-plugin.d.ts
+/** Local Docker hosting — default for platform and dev. */
+declare function defaultHostingPlugin(options?: DockerPluginOptions): HostingPlugin;
+//#endregion
+export { type DockerPluginOptions, defaultHostingPlugin, dockerPlugin };
+//# sourceMappingURL=docker.d.cts.map

package/dist/docker.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"docker.d.cts","names":[],"sources":["../src/docker/create-docker-runtime.ts","../src/docker/plugin.ts","../src/default-plugin.ts"],"mappings":";;;;KASY,eAAA;EACV,QAAA;EACA,aAAa;AAAA;AAAA,KAGH,mBAAA,GAAsB,cAAA;EAChC,MAAA,GAAS,MAAA,EADC;EAGV,eAAA,GAAkB,eAAA;EAElB,UAAA;AAAA;;;iBCXc,YAAA,CAAa,OAAA,GAAS,mBAAA,GAA2B,aAAa;;;;iBCJ9D,oBAAA,CAAqB,OAAA,GAAS,mBAAA,GAA2B,aAAa"}

package/dist/docker.d.mts

@@ -0,0 +1,23 @@
+import { n as HostingPlugin, t as HostingOptions } from "./plugin-qEl5Sx4m.mjs";
+import Docker from "dockerode";
+
+//#region src/docker/create-docker-runtime.d.ts
+type WorkspacesMount = {
+  hostPath: string;
+  containerPath: string;
+};
+type DockerPluginOptions = HostingOptions & {
+  docker?: Docker; /** Bind a shared host workspace dir into dev workers (VM sandbox proxy mount path). */
+  workspacesMount?: WorkspacesMount; /** Additional Docker bind mounts (`host:container[:options]`). */
+  extraBinds?: string[];
+};
+//#endregion
+//#region src/docker/plugin.d.ts
+declare function dockerPlugin(options?: DockerPluginOptions): HostingPlugin;
+//#endregion
+//#region src/default-plugin.d.ts
+/** Local Docker hosting — default for platform and dev. */
+declare function defaultHostingPlugin(options?: DockerPluginOptions): HostingPlugin;
+//#endregion
+export { type DockerPluginOptions, defaultHostingPlugin, dockerPlugin };
+//# sourceMappingURL=docker.d.mts.map

package/dist/docker.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"docker.d.mts","names":[],"sources":["../src/docker/create-docker-runtime.ts","../src/docker/plugin.ts","../src/default-plugin.ts"],"mappings":";;;;KASY,eAAA;EACV,QAAA;EACA,aAAa;AAAA;AAAA,KAGH,mBAAA,GAAsB,cAAA;EAChC,MAAA,GAAS,MAAA,EADC;EAGV,eAAA,GAAkB,eAAA;EAElB,UAAA;AAAA;;;iBCXc,YAAA,CAAa,OAAA,GAAS,mBAAA,GAA2B,aAAa;;;;iBCJ9D,oBAAA,CAAqB,OAAA,GAAS,mBAAA,GAA2B,aAAa"}

package/dist/docker.mjs

@@ -0,0 +1,129 @@
+import { a as formatDockerEnv, c as resolveRuntimeLaunch, h as resolveWorkerRuntimeConfig, t as waitForHealth } from "./wait-for-health-XEzPPQIO.mjs";
+import { mkdir } from "node:fs/promises";
+//#region src/docker/create-docker-runtime.ts
+const MINIO_DOCKER_NETWORK = process.env.MINIO_DOCKER_NETWORK ?? "keystroke";
+async function resolveDocker(options) {
+	if (options.docker) return options.docker;
+	const { default: DockerCtor } = await import("dockerode");
+	return new DockerCtor();
+}
+function createDockerRuntime(options = {}) {
+	return {
+		async start(input) {
+			if (input.projects.length === 0) throw new Error("Docker org runtime requires at least one project deploy");
+			const docker = await resolveDocker(options);
+			let launch = resolveRuntimeLaunch(options, input.projects.map((project) => ({
+				projectId: project.projectId,
+				artifactStorageKey: project.artifactStorageKey,
+				artifactId: project.artifactId,
+				artifactVersion: project.artifactVersion
+			})), input.database, input.env);
+			if (options.workspacesMount) {
+				const { hostPath, containerPath } = options.workspacesMount;
+				await mkdir(hostPath, { recursive: true });
+				launch = {
+					...launch,
+					env: {
+						...launch.env,
+						KEYSTROKE_WORKSPACES_ROOT: containerPath
+					}
+				};
+			}
+			await ensureImage(docker, launch.image);
+			await removeExistingContainer(docker, input.organizationId);
+			const binds = [...options.workspacesMount ? [`${options.workspacesMount.hostPath}:${options.workspacesMount.containerPath}`] : [], ...options.extraBinds ?? []];
+			const container = await docker.createContainer({
+				Image: launch.image,
+				name: containerName(input.organizationId),
+				Labels: {
+					"keystroke.organization.id": input.organizationId,
+					"keystroke.project.ids": input.projects.map((project) => project.projectId).join(",")
+				},
+				ExposedPorts: { [`${launch.port}/tcp`]: {} },
+				HostConfig: {
+					ExtraHosts: ["host.docker.internal:host-gateway"],
+					PortBindings: { [`${launch.port}/tcp`]: [{ HostPort: "0" }] },
+					...binds.length > 0 ? { Binds: binds } : {}
+				},
+				NetworkingConfig: { EndpointsConfig: { [MINIO_DOCKER_NETWORK]: {} } },
+				Env: formatDockerEnv(launch.env)
+			});
+			await container.start();
+			const inspect = await container.inspect();
+			const binding = inspect.NetworkSettings.Ports?.[`${launch.port}/tcp`]?.[0];
+			if (!binding?.HostPort) throw new Error("Failed to resolve org container host port");
+			const baseUrl = `http://127.0.0.1:${binding.HostPort}`;
+			await waitForHealth(baseUrl, {
+				fetchImpl: options.fetchImpl,
+				timeoutMs: options.healthTimeoutMs
+			});
+			return {
+				runtimeId: inspect.Id,
+				baseUrl
+			};
+		},
+		async destroy(input) {
+			try {
+				await (await resolveDocker(options)).getContainer(input.runtimeId).remove({ force: true });
+			} catch {}
+		}
+	};
+}
+function containerName(organizationId) {
+	return `keystroke-org-${organizationId}`;
+}
+async function removeExistingContainer(docker, organizationId) {
+	try {
+		const existing = docker.getContainer(containerName(organizationId));
+		await existing.stop({ t: 5 }).catch(() => void 0);
+		await existing.remove({ force: true });
+	} catch {}
+}
+async function ensureImage(docker, image) {
+	try {
+		await docker.getImage(image).inspect();
+		return;
+	} catch {}
+	await new Promise((resolvePromise, reject) => {
+		docker.pull(image, (error, stream) => {
+			if (error) {
+				reject(error);
+				return;
+			}
+			if (!stream) {
+				reject(/* @__PURE__ */ new Error(`Failed to pull image ${image}`));
+				return;
+			}
+			docker.modem.followProgress(stream, (progressError) => {
+				if (progressError) {
+					reject(progressError);
+					return;
+				}
+				resolvePromise();
+			});
+		});
+	});
+}
+//#endregion
+//#region src/docker/plugin.ts
+function dockerPlugin(options = {}) {
+	const env = options.env ?? process.env;
+	return {
+		name: "docker",
+		workerRuntime: resolveWorkerRuntimeConfig(env),
+		createRuntime: () => createDockerRuntime({
+			...options,
+			env
+		})
+	};
+}
+//#endregion
+//#region src/default-plugin.ts
+/** Local Docker hosting — default for platform and dev. */
+function defaultHostingPlugin(options = {}) {
+	return dockerPlugin(options);
+}
+//#endregion
+export { defaultHostingPlugin, dockerPlugin };
+
+//# sourceMappingURL=docker.mjs.map

package/dist/docker.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"docker.mjs","names":[],"sources":["../src/docker/create-docker-runtime.ts","../src/docker/plugin.ts","../src/default-plugin.ts"],"sourcesContent":["import { mkdir } from \"node:fs/promises\";\nimport type Docker from \"dockerode\";\n\nimport type { ProjectRuntime } from \"../runtime\";\n\nimport type { HostingOptions } from \"../plugin\";\nimport { formatDockerEnv, resolveRuntimeLaunch } from \"../runtime-env\";\nimport { waitForHealth } from \"../wait-for-health\";\n\nexport type WorkspacesMount = {\n  hostPath: string;\n  containerPath: string;\n};\n\nexport type DockerPluginOptions = HostingOptions & {\n  docker?: Docker;\n  /** Bind a shared host workspace dir into dev workers (VM sandbox proxy mount path). */\n  workspacesMount?: WorkspacesMount;\n  /** Additional Docker bind mounts (`host:container[:options]`). */\n  extraBinds?: string[];\n};\n\nconst MINIO_DOCKER_NETWORK = process.env.MINIO_DOCKER_NETWORK ?? \"keystroke\";\n\nasync function resolveDocker(options: DockerPluginOptions): Promise<Docker> {\n  if (options.docker) {\n    return options.docker;\n  }\n  const { default: DockerCtor } = await import(\"dockerode\");\n  return new DockerCtor();\n}\n\nexport function createDockerRuntime(options: DockerPluginOptions = {}): ProjectRuntime {\n  return {\n    async start(input) {\n      if (input.projects.length === 0) {\n        throw new Error(\"Docker org runtime requires at least one project deploy\");\n      }\n\n      const docker = await resolveDocker(options);\n\n      let launch = resolveRuntimeLaunch(\n        options,\n        input.projects.map((project) => ({\n          projectId: project.projectId,\n          artifactStorageKey: project.artifactStorageKey,\n          artifactId: project.artifactId,\n          artifactVersion: project.artifactVersion,\n        })),\n        input.database,\n        input.env,\n      );\n\n      if (options.workspacesMount) {\n        const { hostPath, containerPath } = options.workspacesMount;\n        await mkdir(hostPath, { recursive: true });\n        launch = {\n          ...launch,\n          env: {\n            ...launch.env,\n            KEYSTROKE_WORKSPACES_ROOT: containerPath,\n          },\n        };\n      }\n\n      await ensureImage(docker, launch.image);\n      await removeExistingContainer(docker, input.organizationId);\n\n      const binds = [\n        ...(options.workspacesMount\n          ? [`${options.workspacesMount.hostPath}:${options.workspacesMount.containerPath}`]\n          : []),\n        ...(options.extraBinds ?? []),\n      ];\n\n      const container = await docker.createContainer({\n        Image: launch.image,\n        name: containerName(input.organizationId),\n        Labels: {\n          \"keystroke.organization.id\": input.organizationId,\n          \"keystroke.project.ids\": input.projects.map((project) => project.projectId).join(\",\"),\n        },\n        ExposedPorts: {\n          [`${launch.port}/tcp`]: {},\n        },\n        HostConfig: {\n          ExtraHosts: [\"host.docker.internal:host-gateway\"],\n          PortBindings: {\n            [`${launch.port}/tcp`]: [{ HostPort: \"0\" }],\n          },\n          ...(binds.length > 0 ? { Binds: binds } : {}),\n        },\n        NetworkingConfig: {\n          EndpointsConfig: {\n            [MINIO_DOCKER_NETWORK]: {},\n          },\n        },\n        Env: formatDockerEnv(launch.env),\n      });\n\n      await container.start();\n\n      const inspect = await container.inspect();\n      const binding = inspect.NetworkSettings.Ports?.[`${launch.port}/tcp`]?.[0];\n      if (!binding?.HostPort) {\n        throw new Error(\"Failed to resolve org container host port\");\n      }\n\n      const baseUrl = `http://127.0.0.1:${binding.HostPort}`;\n      await waitForHealth(baseUrl, {\n        fetchImpl: options.fetchImpl,\n        timeoutMs: options.healthTimeoutMs,\n      });\n\n      return {\n        runtimeId: inspect.Id,\n        baseUrl,\n      };\n    },\n\n    async destroy(input) {\n      try {\n        const docker = await resolveDocker(options);\n        const container = docker.getContainer(input.runtimeId);\n        await container.remove({ force: true });\n      } catch {\n        // Container already removed or never existed.\n      }\n    },\n  };\n}\n\nfunction containerName(organizationId: string): string {\n  return `keystroke-org-${organizationId}`;\n}\n\nasync function removeExistingContainer(docker: Docker, organizationId: string): Promise<void> {\n  try {\n    const existing = docker.getContainer(containerName(organizationId));\n    await existing.stop({ t: 5 }).catch(() => undefined);\n    await existing.remove({ force: true });\n  } catch {\n    // no existing container\n  }\n}\n\nasync function ensureImage(docker: Docker, image: string): Promise<void> {\n  try {\n    await docker.getImage(image).inspect();\n    return;\n  } catch {\n    // pull below\n  }\n\n  await new Promise<void>((resolvePromise, reject) => {\n    docker.pull(image, (error: Error | null, stream: NodeJS.ReadableStream | undefined) => {\n      if (error) {\n        reject(error);\n        return;\n      }\n\n      if (!stream) {\n        reject(new Error(`Failed to pull image ${image}`));\n        return;\n      }\n\n      docker.modem.followProgress(stream, (progressError: Error | null) => {\n        if (progressError) {\n          reject(progressError);\n          return;\n        }\n\n        resolvePromise();\n      });\n    });\n  });\n}\n","import type { HostingPlugin } from \"../plugin\";\nimport { resolveWorkerRuntimeConfig } from \"../worker-runtime-config\";\n\nimport { createDockerRuntime } from \"./create-docker-runtime\";\nimport type { DockerPluginOptions } from \"./create-docker-runtime\";\n\nexport type { DockerPluginOptions } from \"./create-docker-runtime\";\n\nexport function dockerPlugin(options: DockerPluginOptions = {}): HostingPlugin {\n  const env = options.env ?? process.env;\n\n  return {\n    name: \"docker\",\n    workerRuntime: resolveWorkerRuntimeConfig(env),\n    createRuntime: () => createDockerRuntime({ ...options, env }),\n  };\n}\n","import type { HostingPlugin } from \"./plugin\";\nimport { dockerPlugin, type DockerPluginOptions } from \"./docker/plugin\";\n\n/** Local Docker hosting — default for platform and dev. */\nexport function defaultHostingPlugin(options: DockerPluginOptions = {}): HostingPlugin {\n  return dockerPlugin(options);\n}\n"],"mappings":"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"}